SAS vers table (Outils de conversion)

Résumé

Convertit un jeu de données SAS en table.

Utilisation

Cet outil prend en charge la connexion à SAS Desktop installé sur un ordinateur local ou à SAS Cloud Analytic Services (CAS). Si vous utilisez CAS, l’ordre des enregistrements peut changer au cours de la conversion.

Remarque :

À compter de septembre 2025, le paquetage Python swat n’est pas compatible avec Python version 3.13, qui est la version requise pour ArcGIS Pro 3.6. Les connexions CAS reposant sur ce paquetage, toute tentative d’exécution de cet outil avec CAS génère une erreur. Les connexions CAS seront de nouveau prises en charge une fois que le paquetage swat est compatible avec la version Python incluse avec ArcGIS Pro.
Le paramètre Custom Session Configuration File (Fichier de configuration de session personnalisée) doit être utilisé pour les déploiements à distance de SAS, tels que Workspace Server, UNIX et Mainframe. Le fichier de configuration n’est pas nécessaire si SAS est installé sur la même machine qu’ArcGIS Pro.

En savoir plus sur les configurations de session SAS
Fournissez le jeu de données SAS sous la forme libref.tablename, où libref est le nom d’une bibliothèque SAS ou CAS et tablename, le nom du jeu de données SAS. Par exemple, le jeu de données SASUSER.MYTABLE fait référence à un jeu de données SAS nommé MYTABLE dans la bibliothèque SASUSER.
Les bibliothèques SAS, les noms de jeu de données et les noms de colonne ne sont pas sensibles à la casse. Par exemple, SASUSER.MYTABLE est traité de la même manière que sasuser.mytable et SASUser.MyTable.
Le nombre d’enregistrements qu’il est possible de convertir dépend de la mémoire disponible de l’ordinateur.
Les formats de colonne du jeu de données SAS ne sont pas conservés dans la table en sortie.
Dans le cas d’un déploiement SAS local, les bibliothèques SASUSER, SASHELP, MAPS, MAPSSAS et MAPSGFK sont disponibles par défaut. Pour que vous puissiez utiliser une bibliothèque personnalisée, libref doit être défini dans votre fichier SAS Autoexec.

En savoir plus sur les configurations Autoexec
Lorsque vous vous connectez à CAS, vous pouvez authentifier vos informations d’identification de deux manières :
- Saisissez votre nom d’utilisateur et votre mot de passe à l’aide des paramètres CAS Username (Nom d’utilisateur CAS) et Password (Mot de passe). Le mot de passe sera masqué et non accessible via l’historique du géotraitement.
- Fournissez un fichier d’autorisation (Authinfo) à l’aide du paramètre CAS Authorization (Authinfo) File (Fichier d’autorisation [Authinfo] CAS) contenant votre nom d’utilisateur et votre mot de passe codé. Grâce à cette option, vous n’avez pas besoin de ressaisir votre mot de passe à chaque exécution de l’outil.
  
  Pour utiliser automatiquement un fichier Authinfo chaque fois que vous exécutez l’outil, nommez le fichier _authinfo (avec le trait de soulignement) et enregistrez-le dans le répertoire d’accueil de Windows (généralement C:\Users\<username>). Le fichier peut avoir n’importe quelle extension (par exemple, _authinfo.txt ou _authinfo.netrc). Si le fichier existe dans le répertoire d’accueil, le paramètre CAS Authorization (Authinfo) File (Fichier d’autorisation [Authinfo] CAS) est automatiquement renseigné avec lui. Vous n’avez ainsi pas besoin de rechercher le même fichier Authinfo chaque fois que vous utilisez l’outil.
  
  Le fichier Authinfo contient des informations de connexion pour plusieurs hôtes et ports. Cependant, dans le cas le plus simple d’un utilisateur unique se connectant à un seul hôte ou port, le fichier Authinfo consiste en une ligne unique présentant la syntaxe suivante :
  
  default user MYUSERNAME password {SAS004}1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ
  
  Vous pouvez coder votre mot de passe pour le fichier à l’aide de la procédure SAS PROC PWENCODE.
  
  En savoir plus sur la création de fichiers Authinfo et le codage des mots de passe
La bibliothèque WORK est un espace de travail temporaire créé au démarrage d’une session SAS. Tous les fichiers sont supprimés à la fermeture de la session. Cet outil démarre et ferme une nouvelle session SAS lors de son exécution. Vous ne devez donc pas utiliser la bibliothèque WORK dans cet outil.

Etiqueter	Explication	Type de données
Jeu de données SAS en entrée (libref.tablename)	Jeu de données SAS en entrée. Fournissez le jeu de données sous la forme `libref.tablename`, où `libref` est le nom d’une bibliothèque SAS et `tablename`, le nom du jeu de données SAS.	String
Table en sortie	Table en sortie.	Table
Télécharger le jeu de données SAS à partir des services SAS Cloud Analytic Services (CAS) (Facultatif)	Spécifie si le jeu de données SAS en entrée est téléchargé depuis CAS ou s’il est accessible à partir d’une bibliothèque SAS locale. Activé—Le jeu de données SAS en entrée est téléchargé depuis CAS. Décoché—Le jeu de données SAS en entrée est accessible à partir d’une bibliothèque SAS locale. Il s’agit de l’option par défaut.	Boolean
URL de nom d’hôte CAS (Facultatif)	Adresse URL de l’hôte CAS.	String
Port (Facultatif)	Port de la connexion CAS.	Long
Nom d’utilisateur CAS (Facultatif)	Nom d’utilisateur de la connexion CAS.	String
Mot de passe (Facultatif)	Mot de passe de la connexion CAS. Ce mot de passe est masqué et n’est pas accessible après l’exécution de l’outil.	String Hidden
Fichier de configuration de session personnalisée (Facultatif)	Fichier spécifiant les configurations personnalisées de la session SAS. Ce fichier est requis uniquement pour les déploiements SAS locaux ou distants personnalisés.	File
Fichier d’autorisation (Authinfo) CAS (Facultatif)	Fichier contenant les informations d’authentification lors de la connexion à CAS. Ce fichier doit contenir le nom d’utilisateur et le mot de passe codé pour la connexion. Si un fichier est fourni, il n’est pas nécessaire de spécifier les paramètres CAS Username (Nom d’utilisateur CAS) et Password (Mot de passe).	File

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

Nom	Explication	Type de données
in_sas_dataset	Jeu de données SAS en entrée. Fournissez le jeu de données sous la forme `libref.tablename`, où `libref` est le nom d’une bibliothèque SAS et `tablename`, le nom du jeu de données SAS.	String
out_table	Table en sortie.	Table
use_cas_connection (Facultatif)	Spécifie si le jeu de données SAS en entrée est téléchargé depuis CAS ou s’il est accessible à partir d’une bibliothèque SAS locale. `USE_CAS`—Le jeu de données SAS en entrée est téléchargé depuis CAS. `LOCAL_SAS`—Le jeu de données SAS en entrée est accessible à partir d’une bibliothèque SAS locale. Il s’agit de l’option par défaut.	Boolean
hostname (Facultatif)	Adresse URL de l’hôte CAS.	String
port (Facultatif)	Port de la connexion CAS.	Long
username (Facultatif)	Nom d’utilisateur de la connexion CAS.	String
password (Facultatif)	Mot de passe de la connexion CAS. Ce mot de passe est masqué et n’est pas accessible après l’exécution de l’outil.	String Hidden
custom_cfg_file (Facultatif)	Fichier spécifiant les configurations personnalisées de la session SAS. Ce fichier est requis uniquement pour les déploiements SAS locaux ou distants personnalisés.	File
authinfo_file (Facultatif)	Fichier contenant les informations d’authentification lors de la connexion à CAS. Ce fichier doit contenir le nom d’utilisateur et le mot de passe codé pour la connexion. Si un fichier est fourni, il n’est pas nécessaire de spécifier les paramètres `username` et `password`.	File

Exemple de code

Exemple 1 d’utilisation de la fonction SASToTable (fenêtre Python)

Le script de fenêtre Python ci-après montre comment utiliser la fonction SASToTable avec une installation SAS locale.

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

Exemple 2 d’utilisation de la fonction SASToTable (script autonome)

Le script Python autonome ci-après illustre l’utilisation de la fonction SASToTable à l’aide d’une connexion à SAS.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui