Résumé
Crée une chaîne de connexion que les outils de géotraitement peuvent utiliser pour se connecter à une base de données ou à une géodatabase d’entreprise.
Utilisation
Utilisez cet outil à la place des fichiers de connexion lorsque vous disposez d’un processus de géotraitement automatique (script ou modèle) qui utilise les jeux de données d’une base de données ou d’une géodatabase d’entreprise. Vous pouvez générer une chaîne de connexion qui peut être utilisée comme entrée dans n’importe quel outil de géotraitement prenant en charge le type de jeu de données spécifié, plutôt que d’utiliser un chemin vers la base de données via l’espace de travail du fichier de connexion.
Les connexions depuis ArcGIS vers Altibase et Netezza ne sont plus prises en charge.
Syntaxe
CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
Paramètre | Explication | Type de données |
database_platform | Spécifie la plateforme de la base de données avec laquelle la connexion est établie.
| String |
instance | Serveur de base de données ou instance avec lesquels la connexion est établie. La valeur de ce paramètre dépend de la valeur sélectionnée pour le paramètre Database Platform (Plateforme de la base de données). | String |
account_authentication (Facultatif) | Spécifie le type d’authentification utilisé.
| Boolean |
username (Facultatif) | Nom d’utilisateur de la base de données utilisé en cas de recours à l’authentification de la base de données. | String |
password (Facultatif) | Mot de passe de l’utilisateur de base de données utilisé en cas de recours à l’authentification de la base de données. | Encrypted String |
database (Facultatif) | Nom de la base de données à laquelle vous allez vous connecter. Ce paramètre ne s'applique qu'aux plateformes PostgreSQL et SQL Server. | String |
object_name (Facultatif) | Nom du jeu de données ou de l’objet de la base de données vers lequel la chaîne de connexion pointe. Cette chaîne de connexion peut être utilisée comme chemin vers le jeu de données spécifié. | String |
data_type (Facultatif) | Type de jeu de données ou d’objet auquel le nom d’objet du jeu de données fait référence. Si plusieurs objets de la base de données portent le même nom, vous devrez peut-être spécifier le type de données de l’objet pour lequel vous voulez créer une chaîne de connexion. | String |
feature_dataset (Facultatif) | Nom du jeu de classes d’entités qui contient le jeu de données ou l’objet pour lequel vous voulez créer une chaîne de connexion. Si le jeu de données ne se trouve pas dans un jeu de classes d’entités (par exemple, s’il se trouve à la racine de la base de données), ne spécifiez pas de jeu de classes d’entités cible. | String |
schema (Facultatif) | Géodatabase de structure utilisateur à laquelle vous allez vous connecter. Cette option ne s'applique qu'aux bases de données Oracle qui contiennent au moins une géodatabase de structure utilisateur. La valeur par défaut pour ce paramètre consiste à utiliser la géodatabase de structure sde (principale). | String |
version_type (Facultatif) | Spécifie le type de version auquel vous allez vous connecter. Ce paramètre s’applique uniquement lorsque vous vous connectez à une géodatabase.
Remarque :Si vous sélectionnez Historical (Historique) et qu’aucun nom n’est attribué, la version transactionnelle par défaut est utilisée. Si vous sélectionnez Point in time (Moment temporel) et qu’aucune date n’est attribuée au paramètre Date and Time (Date et heure), la version transactionnelle par défaut est utilisée. | String |
version (Facultatif) | Version transactionnelle de la géodatabase ou repère chronologique auxquels se connecter. L’option par défaut utilise la version transactionnelle par défaut. Si vous choisissez un type de version de branche, la connexion est toujours établie avec la version de branche par défaut. | String |
date (Facultatif) | Valeur représentant la date et l’heure utilisées pour se connecter à la base de données lors de l’utilisation de données archivables. Vous pouvez indiquer les dates dans les formats suivants :
Remarque :
| Date |
Sortie dérivée
Nom | Explication | Type de données |
out_connection_string | Chaîne de connexion CIMDATA. | Chaîne |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction CreateDatabaseConnectionString en mode immédiat.
import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"",
"gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?