Datenbankverbindung erstellen (Data Management)—ArcGIS Pro

Zusammenfassung

Erstellt eine Datei, die ArcGIS verwendet, um eine Verbindung mit einer Datenbank oder einer Enterprise-Geodatabase herzustellen.

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 im Abschnitt Geodatabase-Verbindungseigenschaften des Werkzeugdialogfeldes ignoriert.
- Bei Geodatabases wird der Abschnitt Geodatabase-Verbindungseigenschaften automatisch durch das Werkzeug eingetragen. 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.
Verbindungen von ArcGIS mit Altibase und Netezza werden nicht mehr unterstützt.

Parameter

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: Dameng—Herstellen einer Verbindung mit Dameng Db2—Herstellen einer Verbindung mit IBM Db2 für Linux, UNIX oder Windows Oracle—Herstellen einer Verbindung mit Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing PostgreSQL—Herstellen einer Verbindung mit PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Microsoft Azure Database for PostgreSQL oder Google Cloud SQL for PostgreSQL Teradata—Herstellen einer Verbindung mit Teradata Vantage SAP HANA—Herstellen einer Verbindung mit SAP HANA oder SAP HANA Cloud SQL Server—Herstellen einer Verbindung mit 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	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 an, mit der eine Verbindung hergestellt wird. Abhängig vom ausgewählten Verbindungstyp müssen Sie für den Parameter Instanz unterschiedliche Informationen angeben. Informationen zu den Angaben, die für jede Datenbankplattform 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 SAP HANA: Der Datenquellenname der ODBC-Verbindung (Open Database Connectivity) für die SAP HANA-Datenbank bzw. den Datenbank-Service 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 eingeben. 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 eingeben. 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 Geodatabase-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 oder Geodatabase 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.	Boolean
Datenbank (optional)	Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter gilt nur für die Plattformen PostgreSQL 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—Mit einer transaktionalen Version verbinden. 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—Mit einem historischen Marker verbinden. 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—Mit einem bestimmten Zeitpunkt verbinden. Wenn Zeitpunkt ausgewählt ist, wird der Parameter Folgende Version wird verwendet deaktiviert und der Parameter Datum und Uhrzeit aktiviert. Verzweigung—Mit der Default-Verzweigungsversion verbinden.	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: Wenn lediglich eine Uhrzeit ohne Datum angegeben wird, 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

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
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})

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: DAMENG—Herstellen einer Verbindung mit Dameng DB2—Herstellen einer Verbindung mit IBM Db2 für Linux, UNIX oder Windows ORACLE—Herstellen einer Verbindung mit Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing POSTGRESQL—Herstellen einer Verbindung mit PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Microsoft Azure Database for PostgreSQL oder Google Cloud SQL for PostgreSQL SAP HANA—Herstellen einer Verbindung mit SAP HANA oder SAP HANA Cloud SQL_SERVER—Herstellen einer Verbindung mit 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—Herstellen einer Verbindung mit Teradata Vantage	String
instance	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 an, mit der die Verbindung hergestellt werden soll. Abhängig von der angegebenen Datenbankplattform müssen Sie für den Parameter instance unterschiedliche Informationen angeben. Informationen zu den Angaben, die für jede Datenbankplattform 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 SAP HANA: Der Datenquellenname der ODBC-Verbindung (Open Database Connectivity) für die SAP HANA-Datenbank bzw. den Datenbank-Service 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 eingeben. 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 eingeben. 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 Geodatabase-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 oder Geodatabase 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.	Boolean
database (optional)	Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter gilt nur für die Plattformen PostgreSQL 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—Mit einer traditionellen transaktionalen Version verbinden. Hinweis: Diese Option gilt nicht für Geodatabases in SAP HANA. HISTORICAL—Mit einem historischen Marker verbinden. POINT_IN_TIME—Mit einem bestimmten Zeitpunkt verbinden. Bei Verwendung von POINT_IN_TIME wird der Parameter version ignoriert. BRANCH—Mit der Default-Verzweigungsversion verbinden. 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

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 4 (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

Zusammenfassung

Verwendung

Parameter

Hinweis:

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Hinweis:

Hinweis:

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema