Tabelle in SAS (Conversion Tools)

Zusammenfassung

Konvertiert eine Tabelle in ein SAS-Dataset.

Verwendung

Dieses Werkzeug unterstützt die Verbindung zu SAS Desktop, das auf einem lokalen Computer installiert ist, oder die Verbindung zu SAS Cloud Analytic Services (CAS). Wenn Sie CAS verwenden, ändert sich während der Konvertierung möglicherweise die Reihenfolge der Datensätze.

Hinweis:

Seit September 2025 ist das Python-Paket swat nicht mehr kompatibel mit Python Version 3.13, der erforderlichen Version für ArcGIS Pro 3.6. Da CAS-Verbindungen auf diesem Paket basieren, führt der Versuch, dieses Werkzeug mit CAS auszuführen, zu einem Fehler. Die Unterstützung für CAS-Verbindungen wird wieder aktiviert, wenn das swat-Paket mit der in ArcGIS Pro enthaltenen Python-Version kompatibel ist.
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 ArcGIS Pro installiert ist, ist keine Konfigurationsdatei erforderlich.

Weitere Informationen zu SAS-Sitzungskonfigurationen
Stellen Sie das SAS-Dataset im Formular libref.tablename bereit, in dem libref der Name einer SAS-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.

Weitere Informationen zu Autoexec-Konfigurationen
Bei der Verbindungsherstellung zu CAS haben Sie zur Authentifizierung der Anmeldeinformationen die folgenden 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.

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 ein vorhandenes SAS-Dataset in der Ausgabe überschrieben wird. Aktiviert—Das Ausgabe-SAS-Dataset darf ein vorhandenes Dataset überschreiben. Deaktiviert—Das Ausgabe-SAS-Dataset darf ein vorhandenes Dataset nicht überschreiben. Dies ist die Standardeinstellung.	Boolean
Beschreibungen für Domänen und Subtypes verwenden (Optional)	Gibt an, ob Domänen- und Subtype-Beschreibungen im Ausgabe-SAS-Dataset enthalten sind. Aktiviert—Domänen- und Subtype-Beschreibungen sind im Ausgabe-SAS-Dataset enthalten. Deaktiviert—Domänen- und Subtype-Beschreibungen sind im Ausgabe-SAS-Dataset nicht enthalten. Dies ist die Standardeinstellung.	Boolean
SAS-Dataset in SAS Cloud Analytic Services (CAS) hochladen (Optional)	Gibt an, ob das Ausgabe-SAS-Dataset in CAS hochgeladen oder in einer lokalen SAS-Bibliothek gespeichert wird. Aktiviert—Das Ausgabe-SAS-Dataset wird in CAS hochgeladen. Deaktiviert—Das Ausgabe-SAS-Dataset wird in einer lokalen SAS-Bibliothek gespeichert. Dies ist die Standardeinstellung.	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

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. `OVERWRITE`—Das Ausgabe-SAS-Dataset darf ein vorhandenes Dataset überschreiben. `NO_OVERWRITE`—Das Ausgabe-SAS-Dataset darf ein vorhandenes Dataset nicht überschreiben. Dies ist die Standardeinstellung.	Boolean
use_domain_and_subtype_description (Optional)	Gibt an, ob Domänen- und Subtype-Beschreibungen im Ausgabe-SAS-Dataset enthalten sind. `USE_DOMAIN`—Domänen- und Subtype-Beschreibungen sind im Ausgabe-SAS-Dataset enthalten. `NO_DOMAIN`—Domänen- und Subtype-Beschreibungen sind im Ausgabe-SAS-Dataset nicht enthalten. Dies ist die Standardeinstellung.	Boolean
use_cas_connection (Optional)	Gibt an, ob das Ausgabe-SAS-Dataset in CAS hochgeladen oder in einer lokalen SAS-Bibliothek gespeichert wird. `USE_CAS`—Das Ausgabe-SAS-Dataset wird in CAS hochgeladen. `LOCAL_SAS`—Das Ausgabe-SAS-Dataset wird in einer lokalen SAS-Bibliothek gespeichert. Dies ist die Standardeinstellung.	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

TableToSAS: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion TableToSAS zusammen mit einer SAS-Installation verwenden.

import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
                            "USE_DOMAIN", "LOCAL_SAS")

TableToSAS: Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion TableToSAS verwenden.

# 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())

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja