Créer une connexion à une base de données (Outils de gestion des données)

Résumé

Crée un fichier utilisé par ArcGIS pour se connecter à une base de données, un entrepôt de données Cloud ou à une géodatabase d’entreprise.

Utilisation

Une fois les informations de connexion valides fournies dans la boîte de dialogue de l’outil pour établir une connexion, l’outil se connecte à la base de données pour déterminer si elle contient la structure de géodatabase.
- Pour les bases de données, tous les paramètres de la catégorie de paramètres Geodatabase Connection Properties (Propriétés de la connexion à la géodatabase) dans la fenêtre Geoprocessing (Géotraitement) sont ignorés.
- Pour les géodatabases, l’outil renseigne automatiquement la catégorie de paramètres Geodatabase Connection Properties (Propriétés de la connexion à la géodatabase). Le paramètre Schema (Structure) est défini avec la structure sde (pour les géodatabases de structure utilisateur Oracle uniquement), la valeur de Version Type (Type de version) par défaut pour la géodatabase et la version par défaut.
Si vous ne souhaitez pas enregistrer les informations de connexion dans la fenêtre Results (Résultats) ou si vous ne souhaitez pas les stocker dans les fichiers journaux de l’historique de géotraitement, désactivez toutes les options de journalisation de l’historique de géotraitement et enregistrez le fichier de connexion sans enregistrer les informations de connexion.
Les connexions d’ArcGIS vers Altibase et Netezza ne sont plus prises en charge.

Etiqueter	Explication	Type de données
Emplacement du fichier de connexion	Chemin d’accès au dossier dans lequel le fichier de connexion à la base de données (`.sde` ou `.dbconn`) est stocké.	Folder
Nom du fichier de connexion	Nom du fichier de connexion à la base de données. Le fichier en sortie porte l’extension `.sde`.	String
Plateforme de base de données	Spécifie la plateforme de système de gestion de base de données avec laquelle la connexion est établie. Les options valides sont les suivantes : BigQuery—La connexion est établie avec Google BigQuery. Dameng—La connexion est établie avec Dameng. Db2—La connexion est établie avec IBM Db2 pour Linux, UNIX ou Windows. Elasticsearch—La connexion est établie avec Elasticsearch. OpenSearch—La connexion est établie avec OpenSearch. Oracle—La connexion est établie avec Oracle, Amazon Relational Database Service (RDS) for Oracle ou Autonomous Transaction Processing. PostgreSQL—La connexion est établie avec PostgreSQL, Amazon Aurora (édition compatible avec PostgreSQL), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL ou Microsoft Azure Cosmos DB for PostgreSQL. Redshift—La connexion est établie avec Amazon Redshift. SAP HANA—La connexion est établie avec SAP HANA ou SAP HANA Cloud. Snowflake—La connexion est établie avec Snowflake. SQL Server—La connexion est établie avec Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance, Amazon Relational Database Service (RDS) for SQL Server ou Google Cloud SQL for SQL Server. Teradata—La connexion est établie avec Teradata Vantage.	String
Instance/Serveur (Facultatif)	Serveur de base de données ou instance avec lesquels la connexion est établie. La valeur que vous choisissez dans la liste déroulante Database Platform (Plateforme de base de données) indique le type de base de données ou d’entrepôt de données Cloud avec lequel la connexion est établie. Les informations que vous devez fournir pour le paramètre Instance/Server (Instance/Serveur) dépendent du type de plateforme de base de données que vous choisissez. Vous trouverez ci-dessous les informations à fournir pour chaque plateforme. Dameng—Nom du serveur sur lequel la base de données Dameng est installée Db2—Nom de la base de données Db2 cataloguée Elasticsearch—Non pris en charge OpenSearch—Non pris en charge Oracle—Nom TNS ou chaîne Easy Connection d’Oracle pour la connexion à la base de données ou au service de base de données Oracle PostgreSQL—Nom du serveur sur lequel PostgreSQL est installé ou nom de l’instance du service de base de données PostgreSQL Redshift—URL du serveur Redshift SAP HANA—Nom de la source de données ODBC (Open Database Connectivity) pour la base de données ou le service de base de données Snowflake—URL du serveur Snowflake SQL Server—Nom de l’instance de la base de données SQL Server ou nom de l’instance du service de base de données Teradata—Nom de la source de données ODBC pour la base de données Teradata	String
Authentification de la base de données (Facultatif)	Spécifie le type d’authentification utilisé. Activé—L’authentification de la base de données est utilisée. Un nom d’utilisateur et un mot de passe de base de données interne sont utilisés pour la connexion à la base de données. Vous n’êtes pas obligé de fournir votre nom d’utilisateur et votre mot de passe pour créer une connexion. Cependant, si vous ne le faites pas, il vous sera demandé de les saisir lors de l’établissement d’une connexion. Remarque : Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données ou à la géodatabase, ou si vous souhaitez utiliser la recherche dans le catalogue pour localiser les données accessibles via ce fichier de connexion, vous devez inclure un nom d’utilisateur et un mot de passe. Décoché—L’authentification du système d’exploitation est utilisée. Vous n’avez pas besoin de fournir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe utilisés pour l’ouverture d’une session sur le système d’exploitation. Si les identifiants de connexion utilisés pour le système d’exploitation ne sont pas des identifiants de connexion à la base de données valides, la connexion échoue.	Boolean
Nom d’utilisateur (Facultatif)	Nom d’utilisateur de la base de données utilisé pour l’authentification de la base de données.	String
Mot de passe (Facultatif)	Mot de passe d’utilisateur de la base de données utilisé pour l’authentification de la base de données.	Encrypted String
Enregistrer le nom d’utilisateur et le mot de passe (Facultatif)	Indique si le nom d’utilisateur et le mot de passe sont enregistrés. Activé—Le nom d’utilisateur et le mot de passe sont enregistrés dans le fichier de connexion. Il s’agit de l’option par défaut. Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données, à la géodatabase ou à l’entrepôt de données Cloud, ou si vous souhaitez utiliser la recherche dans le catalogue pour localiser les données accessibles via ce fichier de connexion, vous devez enregistrer le nom d’utilisateur et le mot de passe. Décoché—Le nom d’utilisateur et le mot de passe ne sont pas enregistrés dans le fichier de connexion. Chaque fois que vous essayez de vous connecter à l’aide du fichier, vous êtes invité à saisir le nom d’utilisateur et le mot de passe. Remarque : ArcGIS Pro met en cache les informations d’identification de la première connexion réussie à la base de données pour laquelle vous n’enregistrez pas le nom d’utilisateur et le mot de passe. Si vous créez une deuxième connexion à la même instance de base de données, de géodatabase ou d’entrepôt de données Cloud dans la même session ArcGIS Pro et que vous n’enregistrez pas les informations d’identification, les informations d’identification mises en cache lors de la première connexion sont utilisées même si vous en indiquez d’autres dans le deuxième fichier de connexion. Pour vous connecter avec d’autres informations d’identification sans enregistrer le nom d’utilisateur et le mot de passe, démarrez une nouvelle session ArcGIS Pro.	Boolean
Base de données (Facultatif)	Nom de la base de données avec laquelle la connexion est établie. Ce paramètre s’applique aux plateformes PostgreSQL, Redshift, Snowflake et SQL Server.	String
Structure (géodatabases de structure utilisateur Oracle uniquement) (Facultatif)	Les géodatabases de structure utilisateur ne sont plus prises en charge.	String
Type de version (Facultatif)	Spécifie le type de version avec lequel la connexion est établie. Ce paramètre s’applique uniquement lors de la connexion à une géodatabase. Remarque : Si vous sélectionnez Historical (Historique) et qu’aucun nom n’est indiqué, 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. Transactionnelle—La connexion est établie avec une version transactionnelle. Si vous sélectionnez Transactional (Transactionnel), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec une liste de versions transactionnelles et le paramètre Date and Time (Date et heure) est inactif. Il s’agit de l’option par défaut. Historique—La connexion est établie avec un repère chronologique. Si vous sélectionnez Historical (Historique), le paramètre The following version will be used (La version suivante est utilisée) est renseigné avec la liste des repères chronologiques et le paramètre Date and Time (Date et heure) est inactif. Moment temporel—La connexion est établie à un point donné dans le temps. Si vous sélectionnez Point in time (Moment temporel), le paramètre The following version will be used (La version suivante est utilisée) est inactif et le paramètre Date and Time (Date et heur) est actif. Branche—La connexion est établie avec la version de branche par défaut.	String
La version suivante est utilisée (Facultatif)	Version transactionnelle de la géodatabase ou repère chronologique avec laquelle ou lequel la connexion est établie. 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 et heure (Facultatif)	Valeur représentant la date et l’heure utilisées pour se connecter à la base de données. Ce paramètre est utilisé avec des données archivables. Utilisez le sélecteur de date/heure pour choisir la date appropriée. Pour saisir une date manuellement, utilisez les formats suivants : 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Remarque : – Si une heure est saisie sans date, la date par défaut du 30 décembre 1899 est utilisée. – Si une date est saisie sans heure, l’heure par défaut 12:00:00 AM est utilisée.	Date
Type d’authentification avancé (Facultatif)	Spécifie le type d’authentification avancé qui sera utilisé lors de la connexion à un entrepôt de données Cloud, à Microsoft Azure SQL Database, Azure SQL Managed Instance, Elasticsearch ou OpenSearch. Authentification multifacteur Microsoft Entra—Le type d’authentification par nom d’utilisateur pour l’authentification multifacteur (MFA) Microsoft Entra sera utilisé, mais pas le mot de passe. Lorsque vous vous connectez, un code vous est envoyé dans un message texte, un e-mail ou sur un appareil d’authentification multifacteur (MFA), ou un lecteur d’empreintes digitales peut être utilisé pour l’authentification. Cette deuxième partie du processus d’authentification varie selon la manière dont vos protocoles de réseau et d’authentification sont configurés. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. Mot de passe Microsoft Entra—Le type d’authentification par mot de passe Microsoft Entra, qui exige des valeurs pour les paramètres de nom d’utilisateur et de mot de passe, sera utilisé. La longueur maximale des noms d’utilisateur est de 30 caractères. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. Authentification multifacteur intégrée Microsoft Entra—Le type d’authentification multifacteur intégrée sera utilisé. Vous n’avez pas besoin de fournir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe utilisés pour l’ouverture d’une session sur le système d’exploitation. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. Authentification du service—Lors de la connexion à Google BigQuery, le type d’authentification du service est utilisé. Consultez la documentation Google BigQuery sur l’authentification pour en savoir plus. Standard—Lors de la connexion à Amazon Redshift, le type d’authentification standard est utilisé. Consultez le guide d’installation et de configuration des connecteurs de données ODBC Amazon Redshift pour en savoir plus sur l’authentification standard. Utilisation—Une méthode d’authentification qui exige un nom d’utilisateur et un mot de passe est utilisée lors de la connexion à Snowflake. User Authentication (Authentification de l’utilisateur)—Lors de la connexion à Google BigQuery, le type d’authentification de l’utilisateur est utilisé. Consultez la documentation Google BigQuery sur l’authentification pour en savoir plus. Basic—Une méthode d’authentification qui exige un nom d’utilisateur et un mot de passe est utilisée lors de la connexion à Elasticsearch ou OpenSearch.	String
ID de projet (Facultatif)	ID de projet pour la connexion Google BigQuery. Les projets de données publiques ne sont pas pris en charge.	String
Jeu de données par défaut (Facultatif)	Jeu de données par défaut pour la connexion Google BigQuery. Renseigner uniquement le nom du jeu de données ; le nom complet du jeu de données n’est pas pris en charge. Le nom du jeu de données doit comporter moins de 32 caractères. Les jeux de données publiques ne sont pas pris en charge.	String
Jeton d’actualisation (Facultatif)	Valeur du jeton d’actualisation. Ce paramètre ne s’applique qu’aux connexions Google BigQuery lorsque le type d’authentification avancé est l’authentification de l’utilisateur.	Encrypted String
Fichier de clé (Facultatif)	Valeur du fichier de clé. Ce paramètre ne s’applique qu’aux connexions Google BigQuery lorsque le type d’authentification avancé est l’authentification du serveur.	File
Rôle (Facultatif)	Valeur de rôle d’une connexion à l’entrepôt de données Cloud. Ce paramètre ne s’applique qu’aux connexions à Snowflake.	String
Entrepôt (Facultatif)	Valeur d’entrepôt de la connexion. Ce paramètre ne s’applique qu’aux connexions à Snowflake.	String
Options avancées (Facultatif)	Options avancées de la connexion. Il s’agit d’informations de connexion facultatives spécifiques à la plateforme d’entrepôt de données Cloud (Google BigQuery, Amazon Redshift ou Snowflake) à laquelle vous vous connectez. Spécifiez des options avancées en utilisant `option=<value>` séparé par des points-virgules. Par exemple, `option1=value1;option2=value2;`. Consultez la documentation de l’entrepôt de données Cloud pour obtenir des informations sur les options de connexion facultatives.	String
URL de l’hôte (Facultatif)	URL permettant de se connecter à Elasticsearch ou OpenSearch. Ce paramètre ne s’applique qu’aux connexions à Elasticsearch ou OpenSearch.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Espace de travail en sortie	Fichier de connexion à une base de données en sortie (`.sde` or `.dbconn`).	Workspace

arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, {instance}, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date}, {auth_type}, {project_id}, {default_dataset}, {refresh_token}, {key_file}, {role}, {warehouse}, {advanced_options}, {host_url})

Nom	Explication	Type de données
out_folder_path	Chemin d’accès au dossier dans lequel le fichier de connexion à la base de données (`.sde` ou `.dbconn`) est stocké.	Folder
out_name	Nom du fichier de connexion à la base de données. Le fichier en sortie porte l’extension `.sde`.	String
database_platform	Spécifie la plateforme de système de gestion de base de données avec laquelle la connexion est établie. Les options valides sont les suivantes : `BIGQUERY`—La connexion est établie avec Google BigQuery. `DAMENG`—La connexion est établie avec Dameng. `DB2`—La connexion est établie avec IBM Db2 pour Linux, UNIX ou Windows. `ELASTICSEARCH`—La connexion est établie avec Elasticsearch. `OPENSEARCH`—La connexion est établie avec OpenSearch. `ORACLE`—La connexion est établie avec Oracle, Amazon Relational Database Service (RDS) for Oracle ou Autonomous Transaction Processing. `POSTGRESQL`—La connexion est établie avec PostgreSQL, Amazon Aurora (édition compatible avec PostgreSQL), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL ou Microsoft Azure Cosmos DB for PostgreSQL. `REDSHIFT`—La connexion est établie avec Amazon Redshift. `SAP HANA`—La connexion est établie avec SAP HANA ou SAP HANA Cloud. `SNOWFLAKE`—La connexion est établie avec Snowflake. `SQL_SERVER`—La connexion est établie avec Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance, Amazon Relational Database Service (RDS) for SQL Server ou Google Cloud SQL for SQL Server. `TERADATA`—La connexion est établie avec Teradata Vantage.	String
instance (Facultatif)	Serveur de base de données ou instance avec lesquels la connexion est établie. La valeur que vous attribuez au paramètre `database_platform` indique le type de base de données ou d’entrepôt de données Cloud avec lequel la connexion est établie. Les informations que vous devez fournir pour le paramètre `instance` dépendent de la plateforme que vous spécifiez. Vous trouverez ci-dessous les informations à fournir pour chaque plateforme. Dameng—Nom du serveur sur lequel la base de données Dameng est installée Db2—Nom de la base de données Db2 cataloguée Elasticsearch—Non pris en charge OpenSearch—Non pris en charge Oracle—Nom TNS ou chaîne Easy Connection d’Oracle pour la connexion à la base de données ou au service de base de données Oracle PostgreSQL—Nom du serveur sur lequel PostgreSQL est installé ou nom de l’instance du service de base de données PostgreSQL Redshift—URL du serveur Redshift SAP HANA—Nom de la source de données ODBC (Open Database Connectivity) pour la base de données ou le service de base de données Snowflake—URL du serveur Snowflake SQL Server—Nom de l’instance de la base de données SQL Server ou nom de l’instance du service de base de données Teradata—Nom de la source de données ODBC pour la base de données Teradata	String
account_authentication (Facultatif)	Spécifie le type d’authentification utilisé. `DATABASE_AUTH`—L’authentification de la base de données est utilisée. Un nom d’utilisateur et un mot de passe de base de données interne sont utilisés pour la connexion à la base de données. Vous n’êtes pas obligé de fournir votre nom d’utilisateur et votre mot de passe pour créer une connexion. Cependant, si vous ne le faites pas, il vous sera demandé de les saisir lors de l’établissement d’une connexion. Remarque : Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données ou à la géodatabase, ou si vous souhaitez utiliser la recherche dans le catalogue pour localiser les données accessibles via ce fichier de connexion, vous devez inclure un nom d’utilisateur et un mot de passe. `OPERATING_SYSTEM_AUTH`—L’authentification du système d’exploitation est utilisée. Vous n’avez pas besoin de fournir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe utilisés pour l’ouverture d’une session sur le système d’exploitation. Si les identifiants de connexion utilisés pour le système d’exploitation ne sont pas des identifiants de connexion à la base de données valides, la connexion échoue.	Boolean
username (Facultatif)	Nom d’utilisateur de la base de données utilisé pour l’authentification de la base de données.	String
password (Facultatif)	Mot de passe d’utilisateur de la base de données utilisé pour l’authentification de la base de données.	Encrypted String
save_user_pass (Facultatif)	Indique si le nom d’utilisateur et le mot de passe sont enregistrés. `SAVE_USERNAME`—Le nom d’utilisateur et le mot de passe sont enregistrés dans le fichier de connexion. Il s’agit de l’option par défaut. Si le fichier de connexion que vous créez est destiné à offrir des services ArcGIS avec accès à la base de données, à la géodatabase ou à l’entrepôt de données Cloud, ou si vous souhaitez utiliser la recherche dans le catalogue pour localiser les données accessibles via ce fichier de connexion, vous devez enregistrer le nom d’utilisateur et le mot de passe. `DO_NOT_SAVE_USERNAME`—Le nom d’utilisateur et le mot de passe ne sont pas enregistrés dans le fichier de connexion. Chaque fois que vous essayez de vous connecter à l’aide du fichier, vous êtes invité à saisir le nom d’utilisateur et le mot de passe. Remarque : ArcGIS Pro met en cache les informations d’identification de la première connexion réussie à la base de données pour laquelle vous n’enregistrez pas le nom d’utilisateur et le mot de passe. Si vous créez une deuxième connexion à la même instance de base de données, de géodatabase ou d’entrepôt de données Cloud dans la même session ArcGIS Pro et que vous n’enregistrez pas les informations d’identification, les informations d’identification mises en cache lors de la première connexion sont utilisées même si vous en indiquez d’autres dans le deuxième fichier de connexion. Pour vous connecter avec d’autres informations d’identification sans enregistrer le nom d’utilisateur et le mot de passe, démarrez une nouvelle session ArcGIS Pro.	Boolean
database (Facultatif)	Nom de la base de données avec laquelle la connexion est établie. Ce paramètre s’applique aux plateformes PostgreSQL, Redshift, Snowflake et SQL Server.	String
schema (Facultatif)	Les géodatabases de structure utilisateur ne sont plus prises en charge.	String
version_type (Facultatif)	Spécifie le type de version avec lequel la connexion est établie. Remarque : Si vous utilisez `TRANSACTIONAL` ou `HISTORICAL`, le paramètre `date` est ignoré. Si vous utilisez `HISTORICAL` et qu’aucun nom n’est spécifié pour le paramètre `version`, la version transactionnelle par défaut est utilisée. Si vous utilisez `POINT_IN_TIME` et qu’aucune date n’est attribuée au paramètre `date`, la version transactionnelle par défaut est utilisée. `TRANSACTIONAL`—La connexion est établie avec une version transactionnelle classique. Remarque : Cette option ne s’applique pas aux géodatabases dans SAP HANA. `HISTORICAL`—La connexion est établie avec un repère chronologique. `POINT_IN_TIME`—La connexion est établie à un point donné dans le temps. Si cette option est utilisée, le paramètre `version` est ignoré. `BRANCH`—La connexion est établie avec la version de branche par défaut.	String
version (Facultatif)	Version transactionnelle de la géodatabase ou repère chronologique avec laquelle ou lequel la connexion est établie. 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 saisir les dates dans les formats suivants : 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Remarque : – Si une heure est saisie sans date, la date par défaut du 30 décembre 1899 est utilisée. – Si une date est saisie sans heure, l’heure par défaut 12:00:00 AM est utilisée.	Date
auth_type (Facultatif)	Spécifie le type d’authentification avancé qui sera utilisé lors de la connexion à un entrepôt de données Cloud, à Microsoft Azure SQL Database, Azure SQL Managed Instance, Elasticsearch ou OpenSearch. `AZURE_ACTIVE_DIRECTORY_UNIVERSAL_WITH_MFA`—Le type d’authentification par nom d’utilisateur pour l’authentification multifacteur (MFA) Microsoft Entra sera utilisé, mais pas le mot de passe. Lorsque vous vous connectez, un code vous est envoyé dans un message texte, un e-mail ou sur un appareil d’authentification multifacteur (MFA), ou un lecteur d’empreintes digitales peut être utilisé pour l’authentification. Cette deuxième partie du processus d’authentification varie selon la manière dont vos protocoles de réseau et d’authentification sont configurés. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. `AZURE_ACTIVE_DIRECTORY_PASSWORD`—Le type d’authentification par mot de passe Microsoft Entra, qui exige des valeurs pour les paramètres de nom d’utilisateur et de mot de passe, sera utilisé. La longueur maximale des noms d’utilisateur est de 30 caractères. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. `AZURE_ACTIVE_DIRECTORY_INTEGRATEDSERVICE_AUTHENTICATION`—Le type d’authentification multifacteur intégrée sera utilisé. Vous n’avez pas besoin de fournir de nom d’utilisateur et de mot de passe. La connexion est établie avec le nom d’utilisateur et le mot de passe utilisés pour l’ouverture d’une session sur le système d’exploitation. Cette option n’est prise en charge que pour Azure SQL Database et Azure SQL Managed Instance. `SERVICE_AUTHENTICATION`—Lors de la connexion à Google BigQuery, le type d’authentification du service est utilisé. Consultez la documentation Google BigQuery sur l’authentification pour en savoir plus. `STANDARD`—Lors de la connexion à Amazon Redshift, le type d’authentification standard est utilisé. Consultez le guide d’installation et de configuration des connecteurs de données ODBC Amazon Redshift pour en savoir plus sur l’authentification standard. `USER`—Une méthode d’authentification qui exige un nom d’utilisateur et un mot de passe est utilisée lors de la connexion à Snowflake. `USER_AUTHENTICATION`—Lors de la connexion à Google BigQuery, le type d’authentification de l’utilisateur est utilisé. Consultez la documentation Google BigQuery sur l’authentification pour en savoir plus. `BASIC`—Une méthode d’authentification qui exige un nom d’utilisateur et un mot de passe est utilisée lors de la connexion à Elasticsearch ou OpenSearch.	String
project_id (Facultatif)	ID de projet pour la connexion Google BigQuery. Les projets de données publiques ne sont pas pris en charge.	String
default_dataset (Facultatif)	Jeu de données par défaut pour la connexion Google BigQuery. Renseigner uniquement le nom du jeu de données ; le nom complet du jeu de données n’est pas pris en charge. Le nom du jeu de données doit comporter moins de 32 caractères. Les jeux de données publiques ne sont pas pris en charge.	String
refresh_token (Facultatif)	Valeur du jeton d’actualisation. Ce paramètre ne s’applique qu’aux connexions Google BigQuery lorsque le type d’authentification avancé est l’authentification de l’utilisateur.	Encrypted String
key_file (Facultatif)	Valeur du fichier de clé. Ce paramètre ne s’applique qu’aux connexions Google BigQuery lorsque le type d’authentification avancé est l’authentification du serveur.	File
role (Facultatif)	Valeur de rôle d’une connexion à l’entrepôt de données Cloud. Ce paramètre ne s’applique qu’aux connexions à Snowflake.	String
warehouse (Facultatif)	Valeur d’entrepôt de la connexion. Ce paramètre ne s’applique qu’aux connexions à Snowflake.	String
advanced_options (Facultatif)	Options avancées de la connexion. Il s’agit d’informations de connexion facultatives spécifiques à la plateforme d’entrepôt de données Cloud (Google BigQuery, Amazon Redshift ou Snowflake) à laquelle vous vous connectez. Spécifiez des options avancées en utilisant `option=<value>` séparé par des points-virgules. Par exemple, `option1=value1;option2=value2;`. Consultez la documentation de l’entrepôt de données Cloud pour obtenir des informations sur les options de connexion facultatives.	String
host_url (Facultatif)	URL permettant de se connecter à Elasticsearch ou OpenSearch. Ce paramètre ne s’applique qu’aux connexions à Elasticsearch ou OpenSearch.	String

Sortie dérivée

Nom	Explication	Type de données
out_workspace	Fichier de connexion à une base de données en sortie (`.sde` or `.dbconn`).	Workspace

Exemple de code

Exemple 1 d’utilisation de la fonction CreateDatabaseConnection (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CreateDatabaseConnection en mode immédiat.

import arcpy
arcpy.management.CreateDatabaseConnection("C:\\MyProject",
                                          "utah.sde",
                                          "SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb",
                                          "SAVE_USERNAME",
                                          "garfield",
                                          "#",
                                          "TRANSACTIONAL",
                                          "sde.DEFAULT")

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

Le script autonome ci-après illustre l’utilisation de la fonction CreateDatabaseConnection.

# Name: CreateDatabaseConnection2.py
# Description: Connects to a database using Easy Connect string
#              and operating system authentication.

# Import system modules
import arcpy

# Run the tool
arcpy.management.CreateDatabaseConnection("C:\\MyProject",
                                          "zion.sde",
                                          "ORACLE",
                                          "zionserver/ORCL",
                                          "OPERATING_SYSTEM_AUTH")

Exemple 3 d’utilisation de la fonction CreateDatabaseConnection (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CreateDatabaseConnection pour établir une connexion avec un repère chronologique.

# Name: CreateDatabaseConnection3.py
# Description: Connects to a geodatabase historical marker using a
#              cataloged DB2 database and database authentication.

# Import system modules
import arcpy

# Run the tool
arcpy.management.CreateDatabaseConnection("C:\\MyProject",
                                          "history.sde",
                                          "DB2",
                                          "DB2_DS",
                                          "DATABASE_AUTH",
                                          "butch",
                                          "sundance",
                                          "SAVE_USERNAME",
                                          "#",
                                          "#",
                                          "HISTORICAL",
                                          "June 9, 2010",
                                          "#")

Exemple 4 d’utilisation de la fonction CreateDatabaseConnection (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CreateDatabaseConnection pour établir une connexion avec un moment temporel.

# Name: CreateDatabaseConnection4.py
# Description: Connects to a point in time in the geodatabase in
#              PostgreSQL using database authentication.

# Import system modules
import arcpy

# Run the tool
arcpy.management.CreateDatabaseConnection("C:\\MyProject",
                                          "history.sde",
                                          "POSTGRESQL",
                                          "dbserver",
                                          "DATABASE_AUTH",
                                          "stevie",
                                          "smith",
                                          "SAVE_USERNAME",
                                          "archivedb",
                                          "#",
                                          "POINT_IN_TIME",
                                          "#",
                                          "5/19/2011 8:43:41 AM")

Environnements

Espace de travail courant

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Créer une connexion à une base de données (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Remarque :

Remarque :

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes