Table vers SAS (Outils de conversion)

Résumé

Convertit une table en jeu de données SAS.

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.
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
Input Table (Table en entrée)	Table en entrée.	Table View
Jeu de données SAS en sortie (libref.tablename)	Jeu de données SAS en sortie. Fournissez le jeu de données sous la forme `libref.table`, où `libref` est le nom d’une bibliothèque SAS et `table`, le nom de la table SAS.	String
Remplacer le jeu de données SAS (Facultatif)	Spécifie si un jeu de données SAS existant est remplacé dans la sortie. Activé—Le jeu de données SAS en sortie peut remplacer un jeu de données existant. Décoché—Le jeu de données SAS en sortie ne peut pas remplacer un jeu de données existant. Il s’agit de l’option par défaut.	Boolean
Utiliser les descriptions de domaine et sous-type (Facultatif)	Spécifie si les descriptions de domaine et de sous-type sont incluses dans le jeu de données SAS en sortie. Activé—Les descriptions de domaine et de sous-type sont incluses dans le jeu de données SAS en sortie. Décoché—Les descriptions de domaine et de sous-type ne sont pas incluses dans le jeu de données SAS en sortie. Il s’agit de l’option par défaut.	Boolean
Charger le jeu de données SAS sur SAS Cloud Analytic Services (CAS) (Facultatif)	Spécifie si le jeu de données SAS en sortie est chargé sur CAS ou enregistré dans une bibliothèque SAS locale. Activé—Le jeu de données SAS en sortie est chargé sur CAS. Décoché—Le jeu de données SAS en sortie est enregistré dans 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.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})

Nom	Explication	Type de données
in_table	Table en entrée.	Table View
out_sas_dataset	Jeu de données SAS en sortie. Fournissez le jeu de données sous la forme `libref.table`, où `libref` est le nom d’une bibliothèque SAS et `table`, le nom de la table SAS.	String
replace_sas_dataset (Facultatif)	Spécifie si un jeu de données SAS existant est remplacé dans la sortie. `OVERWRITE`—Le jeu de données SAS en sortie peut remplacer un jeu de données existant. `NO_OVERWRITE`—Le jeu de données SAS en sortie ne peut pas remplacer un jeu de données existant. Il s’agit de l’option par défaut.	Boolean
use_domain_and_subtype_description (Facultatif)	Spécifie si les descriptions de domaine et de sous-type sont incluses dans le jeu de données SAS en sortie. `USE_DOMAIN`—Les descriptions de domaine et de sous-type sont incluses dans le jeu de données SAS en sortie. `NO_DOMAIN`—Les descriptions de domaine et de sous-type ne sont pas incluses dans le jeu de données SAS en sortie. Il s’agit de l’option par défaut.	Boolean
use_cas_connection (Facultatif)	Spécifie si le jeu de données SAS en sortie est chargé sur CAS ou enregistré dans une bibliothèque SAS locale. `USE_CAS`—Le jeu de données SAS en sortie est chargé sur CAS. `LOCAL_SAS`—Le jeu de données SAS en sortie est enregistré dans 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 TableToSAS (fenêtre Python)

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

import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
                            "USE_DOMAIN", "LOCAL_SAS")

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

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

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

Environnements

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

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui