Table vers SAS (Conversion)

Synthèse

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 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 ArcGIS 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.

  • 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
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 dans laquelle libref est le nom d’une bibliothèque SAS et table est le nom de la table SAS.

String
Remplacer le jeu de données SAS
(Facultatif)

Spécifie si la sortie peut remplacer un jeu de données SAS existant.

  • Sélectionné : le jeu de données SAS en sortie peut remplacer un jeu de données existant.
  • Non sélectionné : 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ésactivé : 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ésactivé : le jeu de données SAS en entrée 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 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.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})
NomExplicationType 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 dans laquelle libref est le nom d’une bibliothèque SAS et table est le nom de la table SAS.

String
replace_sas_dataset
(Facultatif)

Spécifie si un jeu de données SAS existant sera remplacé dans la sortie.

  • OVERWRITELe jeu de données SAS en sortie peut remplacer un jeu de données existant.
  • NO_OVERWRITELe 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_DOMAINLes descriptions de domaine et de sous-type sont incluses dans le jeu de données SAS en sortie.
  • NO_DOMAINLes 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_CASLe jeu de données SAS en sortie est chargé sur CAS.
  • LOCAL_SASLe jeu de données SAS en entrée 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 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 TableToSAS (fenêtre Python)

Le script ci-dessous pour la fenêtre Python indique 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 autonome Python ci-dessous illustre l’utilisation de la fonction TableToSAS à l’aide d’une connexion 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())

Environnements

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