Tabelle in SAS (Konvertierung)

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

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

  • 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 nicht im Ausgabe-SAS-Dataset 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 wird 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})
NameErläuterungDatentyp
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.

  • OVERWRITEDas Ausgabe-SAS-Dataset darf ein vorhandenes Dataset überschreiben.
  • NO_OVERWRITEDas 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_DOMAINDomänen- und Subtype-Beschreibungen sind im Ausgabe- SAS-Dataset enthalten.
  • NO_DOMAINDomänen- und Subtype-Beschreibungen sind nicht im Ausgabe-SAS-Dataset enthalten. Dies ist die Standardeinstellung.
Boolean
use_cas_connection
(optional)

Gibt an, ob das Ausgabe-SAS-Dataset in CAS hochgeladen wird oder in einer lokalen SAS-Bibliothek gespeichert wird.

  • USE_CASDas Ausgabe-SAS-Dataset wird in CAS hochgeladen.
  • LOCAL_SASDas 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 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")
TableToSAS – Beispiel 2 (eigenständiges Skript)

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.