Etiqueta | Explicación | Tipo 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.
| 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 |
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 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 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.
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
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 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.
| 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
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")
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
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí