SAS in Tabelle (Conversion Tools)

Zusammenfassung

Konvertiert ein SAS-Dataset in eine Tabelle.

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.
Spaltenformate von SAS-Datasets werden in der Ausgabetabelle nicht beibehalten.
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
Eingabe-SAS-Dataset (libref.tablename)	Das Eingabe-SAS-Dataset. Stellen Sie das Dataset im Formular `libref.tablename` bereit, in dem `libref` der Name einer SAS-Bibliothek und `tablename` der Name des SAS-Datasets ist.	String
Ausgabetabelle	Dies ist die Ausgabetabelle.	Table
SAS-Dataset von SAS Cloud Analytic Services (CAS) herunterladen (Optional)	Gibt an, ob das Eingabe-SAS-Dataset von CAS heruntergeladen wird oder der Zugriff über eine lokale SAS-Bibliothek erfolgt. Aktiviert—Das Eingabe-SAS-Dataset wird von CAS heruntergeladen. Deaktiviert—Der Zugriff auf das Eingabe-SAS-Dataset erfolgt über eine lokale SAS-Bibliothek. 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.SASToTable(in_sas_dataset, out_table, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})

Name	Erläuterung	Datentyp
in_sas_dataset	Das Eingabe-SAS-Dataset. Stellen Sie das Dataset im Formular `libref.tablename` bereit, in dem `libref` der Name einer SAS-Bibliothek und `tablename` der Name des SAS-Datasets ist.	String
out_table	Dies ist die Ausgabetabelle.	Table
use_cas_connection (Optional)	Gibt an, ob das Eingabe-SAS-Dataset von CAS heruntergeladen wird oder der Zugriff über eine lokale SAS-Bibliothek erfolgt. `USE_CAS`—Das Eingabe-SAS-Dataset wird von CAS heruntergeladen. `LOCAL_SAS`—Der Zugriff auf das Eingabe-SAS-Dataset erfolgt über eine lokale SAS-Bibliothek. 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

SASToTable: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.conversion.SASToTable("sashelp.cars", "CarsTable", "LOCAL_SAS")

SASToTable: Beispiel 2 (eigenständiges Skript)

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

# Import system modules
import arcpy
import getpass

# Provide tool parameters
in_SASDS = "casuser.MySASData"
out_table = "MyEsriData"
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:\\SASToTable\\MyData.gdb"
    arcpy.conversion.SASToTable(in_SASDS, out_table, 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