De SAS a tabla (Conversión)

Resumen

Convierte un dataset SAS en una tabla.

Uso

  • Esta herramienta admite la conexión a SAS Desktop instalado en un equipo local o conexión a SAS Cloud Analytic Services (CAS). Si utiliza CAS, el orden de los registros puede cambiar durante la conversión.

  • El parámetro Archivo de configuración de sesión personalizada se debe utilizar para implementaciones remotas de SAS, como el Servidor de espacio de trabajo, UNIX y Mainframe. Si SAS está instalado en el mismo equipo que ArcGIS AllSource, no es necesario el archivo de configuración.

    Más información sobre las configuraciones de las sesiones de SAS

  • Proporcione el dataset SAS con la forma libref.tablename en la que libref es el nombre de una biblioteca SAS o CAS y tablename es el nombre de un dataset SAS. Por ejemplo, SASUSER.MYTABLE hace referencia a un dataset SAS denominado MYTABLE en la biblioteca SASUSER.

  • Las bibliotecas SAS, los nombres de dataset y los nombres de columnas no distinguen entre mayúsculas y minúsculas. Por ejemplo, SASUSER.MYTABLE se trata igual que sasuser.mytable y SASUser.MyTable.

  • El número de registros que se pueden convertir depende de la memoria disponible del equipo.

  • Los formatos de columna del dataset SAS no se conservarán en la tabla de salida.

  • Para una implementación local de SAS, las bibliotecas de SASUSER, SASHELP, MAPS, MAPSSAS y MAPSGFK están disponibles por defecto. Para utilizar una biblioteca personalizada, el libref se debe definir en el archivo Autoexec de SAS.

    Más información sobre las configuraciones de Autoexec

  • Al conectarse a CAS, puede autenticar sus credenciales de dos maneras:

    • Facilitar su nombre de usuario y contraseña utilizando los parámetros Nombre de usuario y Contraseña de CAS. La contraseña estará oculta y no se podrá acceder a ella a través del historial de geoprocesamiento.
    • Facilitar un archivo de autorización (Authinfo) usando el parámetro Archivo de autorización CAS (Authinfo) que contiene su nombre de usuario y contraseña codificada. Esta opción le permite evitar tener que volver a escribir su contraseña cada vez que ejecuta la herramienta.

      Para usar automáticamente un archivo Authinfo cada vez que usa la herramienta, asigne un nombre al archivo _authinfo (incluido el guión bajo) y guárdelo en el directorio de inicio de Windows (normalmente C:\Users\<username>). El archivo puede tener cualquier extensión de archivo, por ejemplo, _authinfo.txt o _authinfo.netrc. Si el archivo existe en su directorio de inicio, el parámetro Archivo de autorización CAS (Authinfo) se completará automáticamente con el archivo. Esto le permite evitar buscar el mismo archivo Authinfo cada vez que use la herramienta.

      El archivo Authinfo puede contener información de conexión para múltiples hosts y puertos, pero para el caso más simple de un solo usuario que se conecta a un solo host y puerto, el archivo Authinfo será una sola línea con la siguiente sintaxis:

      default user MYUSERNAME password {SAS004}1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ

      Puede codificar su contraseña para el archivo utilizando el procedimiento PROC PWENCODE SAS.

      Más información sobre la creación de archivos Authinfo y la codificación de contraseñas

  • La biblioteca de WORK es un espacio de trabajo temporal que se crea cuando se inicia una sesión SAS, y todos los archivos se eliminan cuando se cierra la sesión. Esta herramienta inicia y cierra una nueva sesión SAS durante la ejecución, por lo que no debe usar la biblioteca de WORK en esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset SAS de entrada (libref.tablename)

El dataset SAS de entrada. Proporcione el dataset con la forma libref.tablename en la que libref es el nombre de una biblioteca SAS y tablename es el nombre de un dataset SAS.

String
Tabla de Salida

La tabla de salida.

Table
Descargar dataset SAS desde SAS Cloud Analytic Services (CAS)
(Opcional)

Especifica si el dataset SAS de entrada se descargará desde CAS o se accederá a él desde una biblioteca local SAS.

  • Activado: el dataset SAS de entrada se descargará desde CAS.
  • Desactivado: se accederá al dataset SAS de entrada desde una biblioteca local SAS. Esta es la opción predeterminada.

Boolean
Dirección URL del nombre de host CAS
(Opcional)

La URL del host CAS.

String
Puerto
(Opcional)

El puerto de la conexión CAS.

Long
Nombre de usuario CAS
(Opcional)

El nombre de usuario para la conexión CAS.

String
Contraseña
(Opcional)

La contraseña de la conexión CAS. Esta contraseña está oculta y no se puede acceder a ella después de ejecutar la herramienta.

String Hidden
Archivo de configuración de sesión personalizada
(Opcional)

El archivo que especifica las configuraciones personalizadas para la sesión de SAS. El archivo solo es necesario para las implementaciones personalizadas locales o remotas de SAS.

File
Archivo de autorización CAS (Authinfo)
(Opcional)

El archivo que contiene información de autenticación cuando se conecta a CAS. El archivo debe contener el nombre de usuario y la contraseña codificada para la conexión. Si se facilita un archivo, no es necesario especificar los parámetros Nombre de usuario y Contraseña de CAS.

File

arcpy.conversion.SASToTable(in_sas_dataset, out_table, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})
NombreExplicaciónTipo de datos
in_sas_dataset

El dataset SAS de entrada. Proporcione el dataset con la forma libref.tablename en la que libref es el nombre de una biblioteca SAS y tablename es el nombre de un dataset SAS.

String
out_table

La tabla de salida.

Table
use_cas_connection
(Opcional)

Especifica si el dataset SAS de entrada se descargará desde CAS o se accederá a él desde una biblioteca local SAS.

  • USE_CASEl dataset SAS de entrada se descargará desde CAS.
  • LOCAL_SASSe accederá al dataset SAS de entrada desde una biblioteca local SAS. Esta es la opción predeterminada.
Boolean
hostname
(Opcional)

La URL del host CAS.

String
port
(Opcional)

El puerto de la conexión CAS.

Long
username
(Opcional)

El nombre de usuario para la conexión CAS.

String
password
(Opcional)

La contraseña de la conexión CAS. Esta contraseña está oculta y no se puede acceder a ella después de ejecutar la herramienta.

String Hidden
custom_cfg_file
(Opcional)

El archivo que especifica las configuraciones personalizadas para la sesión de SAS. El archivo solo es necesario para las implementaciones personalizadas locales o remotas de SAS.

File
authinfo_file
(Opcional)

El archivo que contiene información de autenticación cuando se conecta a CAS. El archivo debe contener el nombre de usuario y la contraseña codificada para la conexión. Si se facilita un archivo, no es necesario especificar los parámetros username y password.

File

Muestra de código

Ejemplo 1 de SASToTable (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función SASToTable con una instalación local de SAS.


import arcpy
arcpy.conversion.SASToTable("sashelp.cars", "CarsTable", "LOCAL_SAS")
Ejemplo 2 de SASToTable (script independiente)

El siguiente script de Python independiente muestra cómo utilizar la función SASToTable con una conexión a CAS.


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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.