De SAS a tabla (Herramientas de conversión)

Resumen

Convierte un dataset SAS en una tabla.

Uso

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

Nota:

A partir de septiembre de 2025, el paquete de Python swat deja de ser compatible con Python versión 3.13, que es la versión necesaria para ArcGIS Pro 3.6. Dado que las conexiones de CAS se basan en este paquete, intentar ejecutar esta herramienta con CAS dará lugar a un error. La compatibilidad para las conexiones de CAS se activará de nuevo cuando el paquete de swat sea compatible con la versión de Python incluida con ArcGIS Pro.
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 Pro, no es necesario el archivo de configuración.

Más información sobre las configuraciones de las sesiones de SAS
Proporcione el dataset SAS en 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 de forma predeterminada. 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 como se indica a continuación:
- 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 de SAS PROC PWENCODE.
  
  Más información sobre cómo crear archivos Authinfo y codificar contraseñas
La biblioteca de WORK es un espacio de trabajo temporal que se crea cuando se inicia una sesión de SAS, y todos los archivos se eliminan cuando se cierra la sesión. Esta herramienta inicia y cierra una nueva sesión de SAS durante la ejecución, por lo que no debe usar la biblioteca de WORK en esta herramienta.

Etiqueta	Explicación	Tipo de datos
Dataset SAS de entrada (libref.tablename)	El dataset SAS de entrada. Proporcione el dataset en 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 SAS local. 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 para 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 CAS y Contraseña.	File

arcpy.conversion.SASToTable(in_sas_dataset, out_table, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})

Nombre	Explicación	Tipo de datos
in_sas_dataset	El dataset SAS de entrada. Proporcione el dataset en 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_CAS`—El dataset SAS de entrada se descargará desde CAS. `LOCAL_SAS`—Se accederá al dataset SAS de entrada desde una biblioteca SAS local. 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 para 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 de SAS.

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

Ejemplo 2 de SASToTable (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la función SASToTable utilizando 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.

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

De SAS a tabla (Herramientas de conversión)

Resumen

Uso

Nota:

Parámetros

Entornos

Información de licenciamiento

Temas relacionados