Datenbankverbindung erstellen (Data Management Tools)

Zusammenfassung

Erstellt eine Datei, die ArcGIS zur Verbindung mit einer Datenbank, einem Cloud Data Warehouse oder einer Enterprise-Geodatabase verwendet.

Verwendung

Nachdem gültige Verbindungsinformationen im Dialogfeld des Werkzeugs zum Herstellen einer Verbindung eingegeben wurden, stellt das Werkzeug eine Verbindung mit der Datenbank her, um zu ermitteln, ob sie das Geodatabase-Schema enthält.
- Bei Datenbanken werden alle Parameter in der Parameterkategorie Geodatabase-Verbindungseigenschaften des Bereichs Geoverarbeitung ignoriert.
- Bei Geodatabases wird die Parameterkategorie Geodatabase-Verbindungseigenschaften automatisch durch das Werkzeug ausgefüllt. Als Parameter Schema wird das SDE-Schema (nur für Geodatabases mit Oracle-Benutzerschema), der standardmäßige Wert Versionstyp für die Geodatabase und die Default-Version festgelegt.
Wenn Sie die Verbindungsinformationen weder im Fenster Ergebnisse noch in den Protokolldateien des Geoverarbeitungsverlaufs speichern möchten, müssen Sie alle Protokollierungsoptionen für den Geoverarbeitungsverlauf deaktivieren und die Verbindungsdatei speichern, ohne dabei die Verbindungsinformationen zu speichern.
Verbindungen von ArcGIS mit Altibase und Netezza werden nicht mehr unterstützt.

Beschriftung	Erläuterung	Datentyp
Speicherort der Verbindungsdatei	Der Ordner, in dem die Datenbankverbindungsdatei (`.sde` oder `.dbconn`) gespeichert wird.	Folder
Name der Verbindungsdatei	Der Name der Datenbankverbindungsdatei. Die Ausgabedatei hat die Erweiterung `.sde`.	String
Datenbankplattform	Gibt die Datenbankmanagementsystem-Plattform an, zu der die Verbindung hergestellt werden soll. Die folgenden Optionen sind gültig: BigQuery—Die Verbindung wird hergestellt zu: Google BigQuery. Dameng—Die Verbindung wird hergestellt zu: Dameng. Db2—Die Verbindung wird hergestellt zu: IBM Db2 (für Linux, UNIX oder Windows). Elasticsearch—Die Verbindung wird hergestellt zu: Elasticsearch. OpenSearch—Die Verbindung wird hergestellt zu: OpenSearch. Oracle—Die Verbindung wird hergestellt zu: Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing. PostgreSQL—Die Verbindung wird hergestellt zu: PostgreSQL, Amazon Aurora (PostgreSQL-Compatible Edition), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL oder Microsoft Azure Cosmos DB for PostgreSQL. Redshift—Die Verbindung wird hergestellt zu: Amazon Redshift. SAP HANA—Die Verbindung wird hergestellt zu: SAP HANA oder SAP HANA Cloud. Snowflake—Die Verbindung wird hergestellt zu: Snowflake. SQL Server—Die Verbindung wird hergestellt zu: Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance, Amazon Relational Database Service (RDS) for SQL Server oder Google Cloud SQL for SQL Server. Teradata—Die Verbindung wird hergestellt zu: Teradata Vantage.	String
Instanz/Server (Optional)	Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll. Der Wert, den Sie aus der Dropdown-Liste Datenbankplattform auswählen, gibt den Typ der Datenbank oder des Cloud Data Warehouse an, mit der bzw. dem eine Verbindung hergestellt wird. Abhängig vom ausgewählten Typ der Datenbankplattform müssen Sie für den Parameter Instanz/Server unterschiedliche Informationen angeben. Informationen zu den Angaben, die für jede Plattform bereitgestellt werden müssen, finden Sie nachstehend. Dameng—Der Name des Servers, auf dem die Dameng-Datenbank installiert ist Db2—Der Name der katalogisierten Db2-Datenbank Elasticsearch—Nicht unterstützt OpenSearch—Nicht unterstützt Oracle—Der TNS-Name oder die Oracle Easy Connection-Zeichenfolge zum Herstellen der Verbindung mit der Oracle-Datenbank bzw. dem Datenbank-Service PostgreSQL—Der Name des Servers, auf dem PostgreSQL installiert ist, oder der Name der PostgreSQL-Datenbank-Service-Instanz Redshift—Die URL für den Redshift-Server SAP HANA—Der Datenquellenname der ODBC-Verbindung (Open Database Connectivity) für die SAP HANA-Datenbank bzw. den Datenbank-Service Snowflake—Die URL des Snowflake-Servers SQL Server—Der Name der SQL Server-Datenbankinstanz oder der Name der Datenbank-Service-Instanz Teradata—Der ODBC-Datenquellenname für die Teradata-Datenbank	String
Datenbankauthentifizierung (Optional)	Gibt den zu verwendenden Authentifizierungstyp an. Aktiviert—Die Datenbankauthentifizierung wird verwendet. Die Verbindung mit der Datenbank wird über einen internen Datenbankbenutzernamen und ein internes Datenbankkennwort hergestellt. Sie müssen zum Erstellen einer Verbindung Ihren Benutzernamen und Ihr Kennwort nicht angeben. In diesem Fall werden Sie jedoch dazu aufgefordert, wenn eine Verbindung hergestellt wird. Hinweis: Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank oder Geodatabase gewährt, müssen Sie einen Benutzernamen und ein Kennwort einschließen. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird. Deaktiviert—Die Betriebssystemauthentifizierung wird verwendet. Sie müssen keinen Benutzernamen und kein Kennwort angeben. Die Verbindung wird mit dem Benutzernamen und dem Kennwort hergestellt, die für die Anmeldung beim Betriebssystem verwendet wurden. Falls es sich bei den Login-Daten für das Betriebssystem nicht um ein gültiges Datenbank-Login handelt, kann keine Verbindung hergestellt werden.	Boolean
Benutzername (Optional)	Der Datenbankbenutzername, der für die Datenbankauthentifizierung verwendet wird	String
Kennwort (Optional)	Das Datenbankkennwort, das für die Datenbankauthentifizierung verwendet wird	Encrypted String
Benutzername und Kennwort speichern (Optional)	Gibt an, ob der Benutzername und das Kennwort gespeichert werden. Aktiviert—Der Benutzername und das Kennwort werden in der Verbindungsdatei gespeichert. Dies ist die Standardeinstellung. Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank, Geodatabase oder das Cloud Data Warehouse gewährt, müssen Sie den Benutzernamen und das Kennwort speichern. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird. Deaktiviert—Der Benutzername und das Kennwort werden nicht in der Verbindungsdatei gespeichert. Bei jedem Versuch, mit der Datei eine Verbindung herzustellen, werden Sie aufgefordert, den Benutzernamen und das Kennwort einzugeben. Hinweis: ArcGIS Pro verschiebt die Anmeldeinformationen der ersten erfolgreichen Datenbankverbindung, für die Sie den Benutzernamen und das Kennwort nicht speichern, in den Cache. Wenn Sie dann in derselben ArcGIS Pro-Sitzung eine zweite Verbindung mit derselben Datenbank-, Geodatabase- oder Cloud-Data-Warehouse-Instanz herstellen und die Anmeldeinformationen nicht speichern, werden die im Cache abgelegten Anmeldeinformationen aus der ersten Verbindung verwendet, selbst wenn Sie in der zweiten Verbindungsdatei andere Anmeldeinformationen angeben. Wenn Sie mit anderen Anmeldeinformationen und ohne Speichern von Benutzername und Kennwort eine Verbindung herstellen möchten, müssen Sie eine neue ArcGIS Pro-Sitzung starten.	Boolean
Datenbank (Optional)	Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter gilt für die Plattformen PostgreSQL, Redshift, Snowflake und SQL Server.	String
Schema (nur Oracle-Benutzerschema-Geodatabases) (Optional)	Benutzerschema-Geodatabases werden nicht mehr unterstützt.	String
Versionstyp (Optional)	Gibt den Versionstyp an, zu dem die Verbindung hergestellt wird. Dieser Parameter gilt nur beim Verbinden mit einer Geodatabase. Hinweis: Wenn Historisch ausgewählt ist und kein Name angegeben ist, wird die standardmäßige transaktionale Version verwendet. Wenn Zeitpunkt ausgewählt ist und für den Parameter Datum und Uhrzeit kein Wert angegeben ist, wird die standardmäßige transaktionale Version verwendet. Transaktional—Die Verbindung wird zu einer transaktionalen Version hergestellt. Wenn Transaktional ausgewählt ist, wird der Parameter Folgende Version wird verwendet mit einer Liste von transaktionalen Versionen gefüllt, und der Parameter Datum und Uhrzeit ist inaktiv. Dies ist die Standardeinstellung. Historical—Die Verbindung wird zu einem historischen Marker hergestellt. Wenn Historisch ausgewählt ist, wird der Parameter Folgende Version wird verwendet mit einer Liste von historischen Markern gefüllt, und der Parameter Datum und Uhrzeit ist inaktiv. Zeitpunkt—Die Verbindung wird zu einem bestimmten Zeitpunkt hergestellt. Wenn Zeitpunkt ausgewählt ist, wird der Parameter Folgende Version wird verwendet deaktiviert und der Parameter Datum und Uhrzeit aktiviert. Verzweigung—Die Verbindung wird zur Standard-Verzweigungsversion hergestellt.	String
Folgende Version wird verwendet (Optional)	Die transaktionale Version oder der historische Marker der Geodatabase, zu der bzw. dem eine Verbindung hergestellt werden soll. Bei der Standardoption wird die transaktionale Default-Version verwendet. Wenn Sie einen Verzweigungsversionstyp auswählen, wird immer eine Verbindung mit der Standard-Verzweigungsversion hergestellt.	String
Datum und Uhrzeit (Optional)	Der Datums- und Uhrzeitwert, der für die Verbindung mit der Datenbank verwendet wird. Dieser Parameter wird mit Daten mit aktivierter Archivierung verwendet. Verwenden Sie die Zeitauswahl, um die entsprechende Zeit auszuwählen. Bei einer manuellen Eingabe von Zeit- und Datumsangaben stehen die folgenden Formate zur Verfügung: 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Hinweis: Wird lediglich eine Uhrzeit ohne Datum angegeben, wird das folgende Standarddatum verwendet: 30. Dezember 1899. Wird lediglich ein Datum ohne Uhrzeit angegeben, wird die folgende Standarduhrzeit verwendet: 12:00:00 AM.	Date
Erweiterter Authentifizierungstyp (Optional)	Gibt den erweiterten Authentifizierungstyp an, der bei der Verbindung zu einem Cloud Data Warehouse, Microsoft Azure SQL Database, Azure SQL Managed Instance, Elasticsearch oder OpenSearch verwendet wird. Microsoft Entra-MFA—Der Microsoft Entra-Multi-Faktor-Authentifizierungstyp (MFA) wird verwendet, aber nicht das Kennwort. Wenn Sie eine Verbindung herstellen, wird Ihnen per Textmeldung, E-Mail oder MFA-Gerät ein Code zugesandt, oder die Authentifizierung erfolgt durch Scannen des Fingerabdrucks. Dieser zweite Teil des Authentifizierungsprozesses ist davon abhängig, wie Ihre Netzwerk- und Authentifizierungsprotokolle konfiguriert sind. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. Microsoft Entra-Kennwort—Der Microsoft Entra-Kennwort-Authentifizierungstyp, bei dem Benutzername und Kennwort als Parameterwerte eingegeben werden müssen, wird verwendet. Benutzernamen dürfen maximal 30 Zeichen lang sein. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. Microsoft Entra-integriert—Der Microsoft Entra-integrierte Authentifizierungstyp wird verwendet. Sie müssen keinen Benutzernamen und kein Kennwort angeben. Die Verbindung wird mit dem Benutzernamen und dem Kennwort hergestellt, die für die Anmeldung beim Betriebssystem verwendet wurden. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. Serviceauthentifizierung—Der Service-Authentifizierungstyp, der für die Herstellung einer Verbindung mit Google BigQuery verwendet werden soll. Weitere Informationen finden Sie in der Google BigQuery-Dokumentation zur Authentifizierung. Standard—Der Standard-Authentifizierungstyp, der für die Herstellung einer Verbindung mit Amazon Redshift verwendet werden soll. Informationen zur Standardauthentifizierung finden Sie im Handbuch zur Installation und Konfiguration des ODBC-Datenkonnektors von Amazon Redshift. Benutzer—Eine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden müssen, wird für die Verbindung mit Snowflake verwendet. Benutzerauthentifizierung—Der Benutzerauthentifizierungstyp, der für die Herstellung einer Verbindung mit Google BigQuery verwendet werden soll. Weitere Informationen finden Sie in der Google BigQuery-Dokumentation zur Authentifizierung. Basic—Eine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden müssen, wird für die Verbindung mit Elasticsearch oder OpenSearch verwendet.	String
Project ID (Optional)	Die Projekt-ID für die Google BigQuery-Verbindung. Öffentliche Datenprojekte werden nicht unterstützt.	String
Standard-Dataset (Optional)	Das Standard-Dataset für die Google BigQuery-Verbindung. Geben Sie nur den Dataset-Namen an; der vollständig qualifizierte Dataset-Name wird nicht unterstützt. Der Dataset-Name darf höchstens 32 Zeichen enthalten. Öffentliche Datasets werden nicht unterstützt.	String
Aktualisierungstoken (Optional)	Der Wert des Aktualisierungstoken. Dieser Parameter trifft nur auf Google BigQuery-Verbindungen zu, wenn der erweiterte Authentifizierungstyp "Benutzerauthentifizierung" lautet.	Encrypted String
Schlüsseldatei (Optional)	Der Wert der Schlüsseldatei. Dieser Parameter trifft nur auf Google BigQuery-Verbindungen zu, wenn der erweiterte Authentifizierungstyp "Serverauthentifizierung" lautet.	File
Role (Optional)	Der Rollenwert für eine Cloud Data Warehouse-Verbindung. Der Parameter ist nur für Snowflake-Verbindungen relevant.	String
Warehouse (Optional)	Der Warehouse-Wert für die Verbindung. Der Parameter ist nur für Snowflake-Verbindungen relevant.	String
Erweiterte Optionen (Optional)	Die erweiterten Optionen für die Verbindung. Dies sind optionale Verbindungsinformationen, die spezifisch für die Cloud Data Warehouse-Plattform (Google BigQuery, Amazon Redshift oder Snowflake) sind, zu der Sie eine Verbindung herstellen. Geben Sie erweiterte Optionen mit `option=<value>` getrennt durch Semikolons an, zum Beispiel `option1=value1;option2=value2;`. Informationen über optionale Verbindungsoptionen finden Sie in der Dokumentation zum Cloud Data Warehouse.	String
Host-URL (Optional)	Die URL für die Verbindung zu Elasticsearch oder zu OpenSearch. Der Parameter ist nur für Elasticsearch oder OpenSearch-Verbindungen relevant.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Workspace	Die Ausgabe-Datenbankverbindungsdatei (`.sde` oder `.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})

Name	Erläuterung	Datentyp
out_folder_path	Der Ordner, in dem die Datenbankverbindungsdatei (`.sde` oder `.dbconn`) gespeichert wird.	Folder
out_name	Der Name der Datenbankverbindungsdatei. Die Ausgabedatei hat die Erweiterung `.sde`.	String
database_platform	Gibt die Datenbankmanagementsystem-Plattform an, zu der die Verbindung hergestellt werden soll. Die folgenden Optionen sind gültig: `BIGQUERY`—Die Verbindung wird hergestellt zu: Google BigQuery. `DAMENG`—Die Verbindung wird hergestellt zu: Dameng. `DB2`—Die Verbindung wird hergestellt zu: IBM Db2 (für Linux, UNIX oder Windows). `ELASTICSEARCH`—Die Verbindung wird hergestellt zu: Elasticsearch. `OPENSEARCH`—Die Verbindung wird hergestellt zu: OpenSearch. `ORACLE`—Die Verbindung wird hergestellt zu: Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing. `POSTGRESQL`—Die Verbindung wird hergestellt zu: PostgreSQL, Amazon Aurora (PostgreSQL-Compatible Edition), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL oder Microsoft Azure Cosmos DB for PostgreSQL. `REDSHIFT`—Die Verbindung wird hergestellt zu: Amazon Redshift. `SAP HANA`—Die Verbindung wird hergestellt zu: SAP HANA oder SAP HANA Cloud. `SNOWFLAKE`—Die Verbindung wird hergestellt zu: Snowflake. `SQL_SERVER`—Die Verbindung wird hergestellt zu: Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance, Amazon Relational Database Service (RDS) for SQL Server oder Google Cloud SQL for SQL Server. `TERADATA`—Die Verbindung wird hergestellt zu: Teradata Vantage.	String
instance (Optional)	Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll. Der für den Parameter `database_platform` angegebene Wert gibt den Typ der Datenbank oder des Cloud Data Warehouse an, mit der bzw. dem die Verbindung hergestellt werden soll. Abhängig von der angegebenen Plattform müssen Sie für den Parameter `instance` unterschiedliche Informationen angeben. Informationen zu den Angaben, die für jede Plattform bereitgestellt werden müssen, finden Sie nachstehend. Dameng—Der Name des Servers, auf dem die Dameng-Datenbank installiert ist Db2—Der Name der katalogisierten Db2-Datenbank Elasticsearch—Nicht unterstützt OpenSearch—Nicht unterstützt Oracle—Der TNS-Name oder die Oracle Easy Connection-Zeichenfolge zum Herstellen der Verbindung mit der Oracle-Datenbank bzw. dem Datenbank-Service PostgreSQL—Der Name des Servers, auf dem PostgreSQL installiert ist, oder der Name der PostgreSQL-Datenbank-Service-Instanz Redshift—Die URL für den Redshift-Server SAP HANA—Der Datenquellenname der ODBC-Verbindung (Open Database Connectivity) für die SAP HANA-Datenbank bzw. den Datenbank-Service Snowflake—Die URL des Snowflake-Servers SQL Server—Der Name der SQL Server-Datenbankinstanz oder der Name der Datenbank-Service-Instanz Teradata—Der ODBC-Datenquellenname für die Teradata-Datenbank	String
account_authentication (Optional)	Gibt den zu verwendenden Authentifizierungstyp an. `DATABASE_AUTH`—Die Datenbankauthentifizierung wird verwendet. Die Verbindung mit der Datenbank wird über einen internen Datenbankbenutzernamen und ein internes Datenbankkennwort hergestellt. Sie müssen zum Erstellen einer Verbindung Ihren Benutzernamen und Ihr Kennwort nicht angeben. In diesem Fall werden Sie jedoch dazu aufgefordert, wenn eine Verbindung hergestellt wird. Hinweis: Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank oder Geodatabase gewährt, müssen Sie einen Benutzernamen und ein Kennwort einschließen. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird. `OPERATING_SYSTEM_AUTH`—Die Betriebssystemauthentifizierung wird verwendet. Sie müssen keinen Benutzernamen und kein Kennwort angeben. Die Verbindung wird mit dem Benutzernamen und dem Kennwort hergestellt, die für die Anmeldung beim Betriebssystem verwendet wurden. Falls es sich bei den Login-Daten für das Betriebssystem nicht um ein gültiges Datenbank-Login handelt, kann keine Verbindung hergestellt werden.	Boolean
username (Optional)	Der Datenbankbenutzername, der für die Datenbankauthentifizierung verwendet wird	String
password (Optional)	Das Datenbankkennwort, das für die Datenbankauthentifizierung verwendet wird	Encrypted String
save_user_pass (Optional)	Gibt an, ob der Benutzername und das Kennwort gespeichert werden. `SAVE_USERNAME`—Der Benutzername und das Kennwort werden in der Verbindungsdatei gespeichert. Dies ist die Standardeinstellung. Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank, Geodatabase oder das Cloud Data Warehouse gewährt, müssen Sie den Benutzernamen und das Kennwort speichern. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird. `DO_NOT_SAVE_USERNAME`—Der Benutzername und das Kennwort werden nicht in der Verbindungsdatei gespeichert. Bei jedem Versuch, mit der Datei eine Verbindung herzustellen, werden Sie aufgefordert, den Benutzernamen und das Kennwort einzugeben. Hinweis: ArcGIS Pro verschiebt die Anmeldeinformationen der ersten erfolgreichen Datenbankverbindung, für die Sie den Benutzernamen und das Kennwort nicht speichern, in den Cache. Wenn Sie dann in derselben ArcGIS Pro-Sitzung eine zweite Verbindung mit derselben Datenbank-, Geodatabase- oder Cloud-Data-Warehouse-Instanz herstellen und die Anmeldeinformationen nicht speichern, werden die im Cache abgelegten Anmeldeinformationen aus der ersten Verbindung verwendet, selbst wenn Sie in der zweiten Verbindungsdatei andere Anmeldeinformationen angeben. Wenn Sie mit anderen Anmeldeinformationen und ohne Speichern von Benutzername und Kennwort eine Verbindung herstellen möchten, müssen Sie eine neue ArcGIS Pro-Sitzung starten.	Boolean
database (Optional)	Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter gilt für die Plattformen PostgreSQL, Redshift, Snowflake und SQL Server.	String
schema (Optional)	Benutzerschema-Geodatabases werden nicht mehr unterstützt.	String
version_type (Optional)	Gibt den Versionstyp an, zu dem die Verbindung hergestellt wird. Hinweis: Bei Verwendung von `TRANSACTIONAL` oder `HISTORICAL` wird der Parameter `date` ignoriert. Wenn `HISTORICAL` verwendet wird und für den Parameter `version` kein Name angegeben ist, wird die standardmäßige transaktionale Version verwendet. Wenn `POINT_IN_TIME` verwendet wird und für den Parameter `date` kein Datum angegeben ist, wird die standardmäßige transaktionale Version verwendet. `TRANSACTIONAL`—Die Verbindung wird zu einer herkömmlichen transaktionalen Version hergestellt. Hinweis: Diese Option gilt nicht für Geodatabases in SAP HANA. `HISTORICAL`—Die Verbindung wird zu einem historischen Marker hergestellt. `POINT_IN_TIME`—Die Verbindung wird zu einem bestimmten Zeitpunkt hergestellt. Wenn diese Option verwendet wird, wird der Parameter `version` ignoriert. `BRANCH`—Die Verbindung wird zur Standard-Verzweigungsversion hergestellt.	String
version (Optional)	Die transaktionale Version oder der historische Marker der Geodatabase, zu der bzw. dem eine Verbindung hergestellt werden soll. Bei der Standardoption wird die transaktionale Default-Version verwendet. Wenn Sie einen Verzweigungsversionstyp auswählen, wird immer eine Verbindung mit der Standard-Verzweigungsversion hergestellt.	String
date (Optional)	Der Datums- und Uhrzeitwert, der für die Verbindung mit der Datenbank verwendet wird, wenn mit Daten mit aktivierter Archivierung gearbeitet wird. Für die Eingabe der Datums- und Zeitangaben stehen die folgenden Formate zur Verfügung: 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Hinweis: Wird lediglich eine Uhrzeit ohne Datum angegeben, wird das folgende Standarddatum verwendet: 30. Dezember 1899. Wird lediglich ein Datum ohne Uhrzeit angegeben, wird die folgende Standarduhrzeit verwendet: 12:00:00 AM.	Date
auth_type (Optional)	Gibt den erweiterten Authentifizierungstyp an, der bei der Verbindung zu einem Cloud Data Warehouse, Microsoft Azure SQL Database, Azure SQL Managed Instance, Elasticsearch oder OpenSearch verwendet wird. `AZURE_ACTIVE_DIRECTORY_UNIVERSAL_WITH_MFA`—Der Microsoft Entra-Multi-Faktor-Authentifizierungstyp (MFA) wird verwendet, aber nicht das Kennwort. Wenn Sie eine Verbindung herstellen, wird Ihnen per Textmeldung, E-Mail oder MFA-Gerät ein Code zugesandt, oder die Authentifizierung erfolgt durch Scannen des Fingerabdrucks. Dieser zweite Teil des Authentifizierungsprozesses ist davon abhängig, wie Ihre Netzwerk- und Authentifizierungsprotokolle konfiguriert sind. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. `AZURE_ACTIVE_DIRECTORY_PASSWORD`—Der Microsoft Entra-Kennwort-Authentifizierungstyp, bei dem Benutzername und Kennwort als Parameterwerte eingegeben werden müssen, wird verwendet. Benutzernamen dürfen maximal 30 Zeichen lang sein. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. `AZURE_ACTIVE_DIRECTORY_INTEGRATEDSERVICE_AUTHENTICATION`—Der Microsoft Entra-integrierte Authentifizierungstyp wird verwendet. Sie müssen keinen Benutzernamen und kein Kennwort angeben. Die Verbindung wird mit dem Benutzernamen und dem Kennwort hergestellt, die für die Anmeldung beim Betriebssystem verwendet wurden. Diese Option wird nur für Azure SQL Database und Azure SQL Managed Instance unterstützt. `SERVICE_AUTHENTICATION`—Der Service-Authentifizierungstyp, der für die Herstellung einer Verbindung mit Google BigQuery verwendet werden soll. Weitere Informationen finden Sie in der Google BigQuery-Dokumentation zur Authentifizierung. `STANDARD`—Der Standard-Authentifizierungstyp, der für die Herstellung einer Verbindung mit Amazon Redshift verwendet werden soll. Informationen zur Standardauthentifizierung finden Sie im Handbuch zur Installation und Konfiguration des ODBC-Datenkonnektors von Amazon Redshift. `USER`—Eine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden müssen, wird für die Verbindung mit Snowflake verwendet. `USER_AUTHENTICATION`—Der Benutzerauthentifizierungstyp, der für die Herstellung einer Verbindung mit Google BigQuery verwendet werden soll. Weitere Informationen finden Sie in der Google BigQuery-Dokumentation zur Authentifizierung. `BASIC`—Eine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden müssen, wird für die Verbindung mit Elasticsearch oder OpenSearch verwendet.	String
project_id (Optional)	Die Projekt-ID für die Google BigQuery-Verbindung. Öffentliche Datenprojekte werden nicht unterstützt.	String
default_dataset (Optional)	Das Standard-Dataset für die Google BigQuery-Verbindung. Geben Sie nur den Dataset-Namen an; der vollständig qualifizierte Dataset-Name wird nicht unterstützt. Der Dataset-Name darf höchstens 32 Zeichen enthalten. Öffentliche Datasets werden nicht unterstützt.	String
refresh_token (Optional)	Der Wert des Aktualisierungstoken. Dieser Parameter trifft nur auf Google BigQuery-Verbindungen zu, wenn der erweiterte Authentifizierungstyp "Benutzerauthentifizierung" lautet.	Encrypted String
key_file (Optional)	Der Wert der Schlüsseldatei. Dieser Parameter trifft nur auf Google BigQuery-Verbindungen zu, wenn der erweiterte Authentifizierungstyp "Serverauthentifizierung" lautet.	File
role (Optional)	Der Rollenwert für eine Cloud Data Warehouse-Verbindung. Der Parameter ist nur für Snowflake-Verbindungen relevant.	String
warehouse (Optional)	Der Warehouse-Wert für die Verbindung. Der Parameter ist nur für Snowflake-Verbindungen relevant.	String
advanced_options (Optional)	Die erweiterten Optionen für die Verbindung. Dies sind optionale Verbindungsinformationen, die spezifisch für die Cloud Data Warehouse-Plattform (Google BigQuery, Amazon Redshift oder Snowflake) sind, zu der Sie eine Verbindung herstellen. Geben Sie erweiterte Optionen mit `option=<value>` getrennt durch Semikolons an, zum Beispiel `option1=value1;option2=value2;`. Informationen über optionale Verbindungsoptionen finden Sie in der Dokumentation zum Cloud Data Warehouse.	String
host_url (Optional)	Die URL für die Verbindung zu Elasticsearch oder zu OpenSearch. Der Parameter ist nur für Elasticsearch oder OpenSearch-Verbindungen relevant.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_workspace	Die Ausgabe-Datenbankverbindungsdatei (`.sde` oder `.dbconn`).	Workspace

Codebeispiel

CreateDatabaseConnection: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CreateDatabaseConnection im Direkt-Modus verwendet wird.

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

CreateDatabaseConnection: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion CreateDatabaseConnection verwendet wird.

# 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")

CreateDatabaseConnection: Beispiel 3 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug CreateDatabaseConnection verwenden, um eine Verbindung mit einem historischen Marker herzustellen.

# 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",
                                          "#")

CreateDatabaseConnection: Beispiel 4 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion CreateDatabaseConnection verwenden, um die Verbindung zu einem bestimmten Zeitpunkt herzustellen.

# 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")

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

Basic: Nein
Standard: Ja
Advanced: Ja

Datenbankverbindung erstellen (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Hinweis:

Hinweis:

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen