Étiquette | Explication | Type 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.
| 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.
| 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.
| 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 |
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 AllSource.
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.
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
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 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.
| 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.
| 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.
| 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
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")
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
Vous avez un commentaire à formuler concernant cette rubrique ?