SAS in Tabelle (Conversion)

Zusammenfassung

Konvertiert ein SAS-Dataset in eine Tabelle.

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 ArcGIS AllSource 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- 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.

  • 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 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

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
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_CASDas Eingabe-SAS-Dataset wird von CAS heruntergeladen.
  • LOCAL_SASDer 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 für das Python-Fenster veranschaulicht, wie die Funktion SASToTable mit einer lokalen SAS-Installation verwendet wird.


import arcpy
arcpy.conversion.SASToTable("sashelp.cars", "CarsTable", "LOCAL_SAS")
SASToTable – Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion SASToTable über eine Verbindung zu CAS verwendet wird.


# 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.

Verwandte Themen