| Etiqueta | Explicación | Tipo de datos |
Tabla de entrada | La tabla de entrada. | Table View |
Dataset SAS de salida (libref.tablename) | El dataset SAS de salida. Proporcione el dataset con la forma libref.table en la que libref es el nombre de una biblioteca SAS y table es el nombre de una tabla SAS. | String |
Reemplazar dataset SAS (Opcional) | Especifica si la salida puede sobrescribir un dataset SAS existente.
| Boolean |
Usar descripciones de dominio y subtipo (Opcional) | Especifica si las descripciones de dominios y subtipos se incluirán en el dataset SAS de salida.
| Boolean |
Cargar dataset SAS en SAS Cloud Analytic Services (CAS) (Opcional) | Especifica si el dataset SAS de salida se cargará en CAS o se guardará en una biblioteca SAS local.
| 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 una tabla en un dataset SAS.
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.
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.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})| Nombre | Explicación | Tipo de datos |
in_table | La tabla de entrada. | Table View |
out_sas_dataset | El dataset SAS de salida. Proporcione el dataset con la forma libref.table en la que libref es el nombre de una biblioteca SAS y table es el nombre de una tabla SAS. | String |
replace_sas_dataset (Opcional) | Especifica si se sobrescribirá un dataset SAS existente en la salida.
| Boolean |
use_domain_and_subtype_description (Opcional) | Especifica si las descripciones de dominios y subtipos se incluirán en el dataset SAS de salida.
| Boolean |
use_cas_connection (Opcional) | Especifica si el dataset SAS de salida se cargará en CAS o se guardará en una biblioteca SAS local.
| 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 TableToSAS con una instalación local de SAS.
import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
"USE_DOMAIN", "LOCAL_SAS")El siguiente script de Python independiente muestra cómo utilizar la función TableToSAS con una conexión a CAS.
# 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())Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí