| Beschriftung | Erläuterung | Datentyp |
Eingabetabelle | Die Eingabetabelle. | Table View |
Ausgabe-SAS-Dataset (libref.tablename) | Das Ausgabe-SAS-Dataset. Stellen Sie das Dataset im Formular libref.table bereit, in dem libref der Name einer SAS-Bibliothek und table der Name der SAS-Tabelle ist. | String |
SAS-Dataset ersetzen (optional) | Gibt an, ob die Ausgabe ein vorhandenes SAS-Dataset überschreiben darf.
| Boolean |
Beschreibungen für Domänen und Subtypes verwenden (optional) | Gibt an, ob Domänen- und Subtype-Beschreibungen im Ausgabe-SAS-Dataset enthalten sind.
| Boolean |
SAS-Dataset in SAS Cloud Analytic Services (CAS) hochladen (optional) | Gibt an, ob das Ausgabe-SAS-Dataset in CAS hochgeladen wird oder in einer lokalen SAS-Bibliothek gespeichert wird.
| Boolean |
URL des CAS-Hostnamens (optional) | Die URL des CAS-Hosts. | String |
Port (optional) | Der Port der CAS-Verbindung. | Long |
CAS-Benutzername (optional) | Der Benutzername für die CAS-Verbindung. | String |
Kennwort (optional) | Das Kennwort für die CAS-Verbindung. Das Kennwort wird ausgeblendet und ist nach dem Ausführen des Werkzeugs nicht zugänglich. | String Hidden |
Benutzerdefinierte Sitzungskonfigurationsdatei (optional) | Die Datei mit benutzerdefinierten Konfigurationen für die SAS-Sitzung. Die Datei ist nur für benutzerdefinierte lokale oder Remote-Bereitstellungen von SAS erforderlich. | File |
CAS-Autorisierungsdatei (Authinfo) (optional) | Die Datei mit Authentifizierungsinformationen für die Verbindungsherstellung zu CAS. Die Datei muss den Benutzernamen und das codierte Kennwort für die Verbindung enthalten. Wird eine Datei angegeben, ist die Angabe der Parameter CAS-Benutzername und Kennwort nicht erforderlich. | File |
Zusammenfassung
Konvertiert eine Tabelle in ein SAS-Dataset.
Verwendung
Dieses Werkzeug unterstützt die Verbindung zur Desktopversion von SAS, die auf einem lokalen Computer installiert ist, oder die Verbindung mit SAS Cloud Analytic Services (CAS). Wenn Sie CAS verwenden, ändert sich während der Konvertierung möglicherweise die Reihenfolge der Datensätze.
Der Parameter Benutzerdefinierte Sitzungskonfigurationsdatei muss für Remote-Bereitstellungen von SAS, z. B. Workspace Server, UNIX und Mainframe, verwendet werden. Wenn SAS auf demselben Computer wie AllSource installiert ist, ist keine Konfigurationsdatei erforderlich.
Stellen Sie das SAS-Dataset im Formular libref.tablename bereit, in dem libref der Name einer SAS- oder CAS-Bibliothek und tablename der Name des SAS-Datasets ist. Beispielsweise referenziert SASUSER.MYTABLE ein SAS-Dataset namens MYTABLE in der Bibliothek SASUSER.
Bei SAS-Bibliotheken, Dataset-Namen und Spaltennamen wird die Groß-/Kleinschreibung nicht beachtet. SASUSER.MYTABLE wird beispielsweise genauso behandelt wie sasuser.mytable und SASUser.MyTable.
Die Anzahl der Datensätze, die konvertiert werden können, ist vom verfügbaren Speicher Ihres Computers abhängig.
Für eine lokale SAS-Bereitstellung sind die Bibliotheken SASUSER, SASHELP, MAPS, MAPSSAS und MAPSGFK standardmäßig verfügbar. Um eine benutzerdefinierte Bibliothek zu verwenden, muss die Bibliotheksreferenz (libref) in der SAS-Autoexec-Datei definiert werden.
Bei der Verbindungsherstellung zu CAS haben Sie zur Authentifizierung der Anmeldeinformationen zwei Möglichkeiten:
- Geben Sie Kennwort und Benutzername über die Parameter CAS-Benutzername und Kennwort an. Das Kennwort wird ausgeblendet, sodass der Zugriff über den Geoverarbeitungsverlauf nicht möglich ist.
Geben Sie über den Parameter CAS-Autorisierungsdatei (Authinfo) eine Autorisierungsdatei (Authinfo) an, die den Benutzernamen und das codierte Kennwort enthält. Durch Auswahl dieser Option ist es nicht erforderlich, bei jeder Ausführung des Werkzeugs das Kennwort einzugeben.
Damit bei jeder Verwendung des Werkzeugs eine Authinfo-Datei verwendet wird, müssen Sie der Datei den Namen _authinfo (inklusive Unterstrich) geben und sie im Windows-Stammverzeichnis speichern (in der Regel C:\Users\<username>). Die Datei kann eine beliebige Dateierweiterung aufweisen, z. B. _authinfo.txt oder _authinfo.netrc. Wenn die Datei im Stammverzeichnis abgelegt wurde, wird der Parameter CAS-Autorisierungsdatei (Authinfo) automatisch mit der Datei befüllt. Dadurch ist es nicht erforderlich, bei jeder Verwendung des Werkzeugs zur Authinfo-Datei zu navigieren.
Die Authinfo-Datei kann Verbindungsinformationen für mehrere Hosts und Ports enthalten. Im einfachsten Anwendungsfall, wenn ein einzelner Benutzer eine Verbindung zu nur einem Host und Port herstellen möchte, besteht die Authinfo-Datei aus einer Zeile mit der folgenden Syntax:
default user MYUSERNAME password {SAS004}1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ
Zum Encodieren des Kennworts können Sie die SAS-Prozedur PROC PWENCODE verwenden.
Weitere Informationen zum Erstellen von Authinfo-Dateien und zum Encodieren von Kennwörtern
Die Bibliothek WORK ist ein temporärer Workspace, der erstellt wird, wenn eine SAS-Sitzung startet. Wenn die Sitzung geschlossen wird, werden alle Dateien gelöscht. Dieses Werkzeug startet und schließt eine neue SAS-Sitzung während der Ausführung. Daher sollten Sie in diesem Werkzeug die Bibliothek WORK nicht verwenden.
Parameter
arcpy.conversion.TableToSAS(in_table, out_sas_dataset, {replace_sas_dataset}, {use_domain_and_subtype_description}, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})| Name | Erläuterung | Datentyp |
in_table | Die Eingabetabelle. | Table View |
out_sas_dataset | Das Ausgabe-SAS-Dataset. Stellen Sie das Dataset im Formular libref.table bereit, in dem libref der Name einer SAS-Bibliothek und table der Name der SAS-Tabelle ist. | String |
replace_sas_dataset (optional) | Gibt an, ob ein vorhandenes SAS-Dataset in der Ausgabe überschrieben wird.
| Boolean |
use_domain_and_subtype_description (optional) | Gibt an, ob Domänen- und Subtype-Beschreibungen im Ausgabe-SAS-Dataset enthalten sind.
| Boolean |
use_cas_connection (optional) | Gibt an, ob das Ausgabe-SAS-Dataset in CAS hochgeladen wird oder in einer lokalen SAS-Bibliothek gespeichert wird.
| Boolean |
hostname (optional) | Die URL des CAS-Hosts. | String |
port (optional) | Der Port der CAS-Verbindung. | Long |
username (optional) | Der Benutzername für die CAS-Verbindung. | String |
password (optional) | Das Kennwort für die CAS-Verbindung. Das Kennwort wird ausgeblendet und ist nach dem Ausführen des Werkzeugs nicht zugänglich. | String Hidden |
custom_cfg_file (optional) | Die Datei mit benutzerdefinierten Konfigurationen für die SAS-Sitzung. Die Datei ist nur für benutzerdefinierte lokale oder Remote-Bereitstellungen von SAS erforderlich. | File |
authinfo_file (optional) | Die Datei mit Authentifizierungsinformationen für die Verbindungsherstellung zu CAS. Die Datei muss den Benutzernamen und das codierte Kennwort für die Verbindung enthalten. Wird eine Datei angegeben, ist die Angabe der Parameter username und password nicht erforderlich. | File |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion TableToSAS mit einer lokalen SAS-Installation verwendet wird.
import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
"USE_DOMAIN", "LOCAL_SAS")Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion TableToSAS über eine Verbindung zu CAS verwendet wird.
# Import system modules
import arcpy
import getpass
# Provide tool parameters
in_table = "MyData"
out_SASDS = "casuser.MySASData"
replace_output = "OVERWRITE"
field_domains = "USE_DOMAIN"
connection = "USE_CAS"
hosturl = https://XXX.vdp.sas.com/XXX-XXXXX-default-http/
port = 100
username = "CAS_user"
# Provide password securely
password = getpass.getpass()
try:
# Set the workspace and run the tool.
arcpy.env.workspace = r"C:\\TableToSAS\\MyData.gdb"
arcpy.conversion.TableToSAS(in_table, out_SASDS, replace_output,
field_domains, connection, hosturl, port,
username, password)
except arcpy.ExecuteError:
# If an error occurred when running the tool, print the error message.
print(arcpy.GetMessages())