SAS vers table (Conversion)

Synthèse

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 via une connexion à SAS Cloud Analytic Services (CAS). Si vous utilisez CAS, l’ordre des enregistrements peut changer au cours de la conversion.

  • Le paramètre 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 que AllSource.

    En savoir plus sur les configurations de sessions SAS

  • Fournissez le jeu de données SAS sous la forme libref.tablename dans laquelle libref est le nom d’une bibliothèque SAS ou CAS et tablename est 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 Nom d’utilisateur CAS et 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 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 (y compris 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 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 PROC PWENCODE SAS.

      En savoir plus sur la création des fichiers Authinfo et le codage de 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.

Paramètres

ÉtiquetteExplicationType 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 dans laquelle libref est le nom d’une bibliothèque SAS et tablename est 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ésactivé : 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 pour 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 Nom d’utilisateur CAS et Mot de passe.

File

arcpy.conversion.SASToTable(in_sas_dataset, out_table, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})
NomExplicationType 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 dans laquelle libref est le nom d’une bibliothèque SAS et tablename est 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_CASLe jeu de données SAS en entrée est téléchargé depuis CAS.
  • LOCAL_SASLe 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 pour 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 ci-dessous pour la fenêtre Python indique 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 autonome Python ci-dessous illustre l’utilisation de la fonction SASToTable à l’aide d’une connexion 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())

Environnements

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