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

BeschriftungErläuterungDatentyp
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:

  • BigQueryDie Verbindung wird hergestellt zu: Google BigQuery.
  • DamengDie Verbindung wird hergestellt zu: Dameng.
  • Db2Die Verbindung wird zu IBM Db2 hergestellt (für Linux, UNIX oder Windows).
  • OracleDie Verbindung wird hergestellt zu: Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing.
  • PostgreSQLDie 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.
  • RedshiftDie Verbindung wird hergestellt zu: Amazon Redshift.
  • TeradataDie Verbindung wird hergestellt zu: Teradata Vantage.
  • SAP HANADie Verbindung wird hergestellt zu: SAP HANA oder SAP HANA Cloud.
  • SnowflakeDie Verbindung wird hergestellt zu: Snowflake.
  • SQL ServerDie 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.

  • DatenbankauthentifizierungDie 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.

  • BetriebssystemauthentifizierungDie 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.

  • TransaktionalDie 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.
  • HistorischDie 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.
  • ZeitpunktDie 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.
  • VerzweigungDie 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 MFADer 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 PasswordDer 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 IntegratedDer 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.
  • ServiceauthentifizierungDer 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.
  • StandardDer 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.
  • BenutzerEine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden muss, wird für die Verbindung mit Snowflake verwendet.
  • BenutzerauthentifizierungDer 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

BeschriftungErläuterungDatentyp
Ausgabe-Workspace

Die Ausgabe-Datenbankverbindungsdatei (.sde)

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})
NameErläuterungDatentyp
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:

  • BIGQUERYDie Verbindung wird hergestellt zu: Google BigQuery.
  • DAMENGDie Verbindung wird hergestellt zu: Dameng.
  • DB2Die Verbindung wird zu IBM Db2 hergestellt (für Linux, UNIX oder Windows).
  • ORACLEDie Verbindung wird hergestellt zu: Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing.
  • POSTGRESQLDie 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.
  • REDSHIFTDie Verbindung wird hergestellt zu: Amazon Redshift.
  • SAP HANADie Verbindung wird hergestellt zu: SAP HANA oder SAP HANA Cloud.
  • SNOWFLAKEDie Verbindung wird hergestellt zu: Snowflake.
  • SQL_SERVERDie 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.
  • TERADATADie 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_AUTHDie 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_AUTHDie 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_USERNAMEDer 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_USERNAMEDer 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.

  • TRANSACTIONALDie Verbindung wird zu einer herkömmlichen transaktionalen Version hergestellt.
    Hinweis:

    Diese Option gilt nicht für Geodatabases in SAP HANA.

  • HISTORICALDie Verbindung wird zu einem historischen Marker hergestellt.
  • POINT_IN_TIMEDie Verbindung wird zu einem bestimmten Zeitpunkt hergestellt. Bei Verwendung von POINT_IN_TIME wird der Parameter version ignoriert.
  • BRANCHDie 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_MFADer 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_PASSWORDDer 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_AUTHENTICATIONDer 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_AUTHENTICATIONDer 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.
  • STANDARDDer 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.
  • USEREine Authentifizierungsmethode, bei der ein Benutzername und ein Kennwort eingegeben werden muss, wird für die Verbindung mit Snowflake verwendet.
  • USER_AUTHENTICATIONDer 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

NameErläuterungDatentyp
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")

Lizenzinformationen

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

Verwandte Themen