Datenbankverbindung erstellen (Data Management)

Zusammenfassung

Erstellt eine Datei, die ArcGIS zur Verbindung mit einer Datenbank 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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Speicherort der Verbindungsdatei	Der Ordner, in dem die Datenbankverbindungsdatei (.sde) 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 zu IBM Db2 hergestellt (für Linux, UNIX oder Windows). 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. Teradata—Die Verbindung wird hergestellt zu: Teradata Vantage. 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.	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 Verbindungstyp 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 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-Datenquellennamen für die Teradata-Datenbank	String
Datenbankauthentifizierung (optional)	Gibt den zu verwendenden Authentifizierungstyp an. Datenbankauthentifizierung—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. Betriebssystemauthentifizierung—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, die Geodatabase oder das Cloud Data Warehouse gewährt, müssen Sie den Benutzernamen und das Kennwort speichern, wenn Sie die Katalogsuche zum Suchen von Daten, auf die über diese Verbindungsdatei zugegriffen wird, verwenden müssen oder wenn Sie die Verbindungsdatei in einem Skript verwenden möchten. 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 Benutzernamen 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)	Die Benutzerschema-Geodatabase, mit der eine Verbindung hergestellt wird. Das Werkzeug ermittelt, ob eine Verbindung mit einer Oracle-Datenbank hergestellt wurde, die eine Benutzerschema-Geodatabase enthält. Wenn die Oracle-Datenbank ein Benutzerschema enthält, ist diese Option aktiv. Andernfalls bleibt diese Option inaktiv. Die Standardeinstellung für diesen Parameter ist die Verwendung der Geodatabase mit SDE-Schema.	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. Historisch—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. Die Standardoption verwendet die standardmäßige transaktionale Version. 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. Diese Option 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, zu einer Microsoft Azure SQL Database oder zu einer Azure SQL Managed Instance verwendet wird. Microsoft Entra MFA—Der Microsoft Entra multifactor authentication (MFA)-Benutzername-Authentifizierungstyp 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 die Azure SQL Database und die Azure SQL Managed Instance unterstützt. Microsoft Entra Password—Der Microsoft Entra Password-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 die Azure SQL Database und die Azure SQL Managed Instance unterstützt. Microsoft Entra Integrated—Der Microsoft Entra Integrated-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 die Azure SQL Database und die 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 muss, wird für die Verbindung mit Snowflake verwendet. Benutzerauthentifizierung—Der Benutzer-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.	String
Projekt-ID (optional)	Die Projekt-ID für die Google BigQuery-Verbindung.	String
Standard-Dataset (optional)	Das Standard-Dataset für die Google BigQuery-Datenbankverbindung.	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
Rolle (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=<Wert>" getrennt durch Semikolons an. Beispiel: option1=value1;option2=value2;. Informationen über optionale Verbindungsoptionen finden Sie in der Dokumentation zum Cloud Data Warehouse.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Workspace	Die Ausgabe-Datenbankverbindungsdatei (.sde)	workspace

Python

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})

Name	Erläuterung	Datentyp
out_folder_path	Der Ordner, in dem die Datenbankverbindungsdatei (.sde) 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 zu IBM Db2 hergestellt (für Linux, UNIX oder Windows). 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 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-Datenquellennamen 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 Benutzernamen 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)	Die Benutzerschema-Geodatabase, mit der eine Verbindung hergestellt wird. Diese Option wird nur für Oracle-Datenbanken verwendet, die mindestens eine Benutzerschema-Geodatabase enthalten. Der Standardwert für diesen Parameter ist die Verwendung der Geodatabase mit SDE-Schema.	String
version_type (optional)	Gibt den Versionstyp an, zu dem die Verbindung hergestellt wird. 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. Bei Verwendung von POINT_IN_TIME wird der Parameter version ignoriert. BRANCH—Die Verbindung wird zur Standard-Verzweigungsversion hergestellt. 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.	String
version (optional)	Die transaktionale Version oder der historische Marker der Geodatabase, zu der bzw. dem eine Verbindung hergestellt werden soll. Die Standardoption verwendet die standardmäßige transaktionale Version. 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, zu einer Microsoft Azure SQL Database oder zu einer Azure SQL Managed Instance verwendet wird. AZURE_ACTIVE_DIRECTORY_UNIVERSAL_WITH_MFA—Der Microsoft Entra multifactor authentication (MFA)-Benutzername-Authentifizierungstyp 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 die Azure SQL Database und die Azure SQL Managed Instance unterstützt. AZURE_ACTIVE_DIRECTORY_PASSWORD—Der Microsoft Entra Password-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 die Azure SQL Database und die Azure SQL Managed Instance unterstützt. AZURE_ACTIVE_DIRECTORY_INTEGRATEDSERVICE_AUTHENTICATION—Der Microsoft Entra Integrated-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 die Azure SQL Database und die 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 muss, wird für die Verbindung mit Snowflake verwendet. USER_AUTHENTICATION—Der Benutzer-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.	String
project_id (optional)	Die Projekt-ID für die Google BigQuery-Verbindung.	String
default_dataset (optional)	Das Standard-Dataset für die Google BigQuery-Datenbankverbindung.	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=<Wert>" getrennt durch Semikolons an. Beispiel: option1=value1;option2=value2;. Informationen über optionale Verbindungsoptionen finden Sie in der Dokumentation zum Cloud Data Warehouse.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_workspace	Die Ausgabe-Datenbankverbindungsdatei (.sde)	workspace

Codebeispiel

CreateDatabaseConnection: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.CreateDatabaseConnection_management("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.CreateDatabaseConnection_management("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.CreateDatabaseConnection_management("C:\\MyProject",
                                          "history.sde",
                                          "DB2",
                                          "DB2_DS",
                                          "DATABASE_AUTH",
                                          "butch",
                                          "sundance",
                                          "SAVE_USERNAME",
                                          "#",
                                          "#",
                                          "HISTORICAL",
                                          "June 9, 2010",
                                          "#")

CreateDatabaseConnection: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug CreateDatabaseConnection verwenden, um eine Verbindung mit 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.CreateDatabaseConnection_management("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

Lizenzinformationen

• Basic: Nein
• Standard: Ja
• Advanced: Ja