Datenbankverbindung erstellen (Data Management)

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

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:

  • DamengHerstellen einer Verbindung mit Dameng
  • Db2Herstellen einer Verbindung mit IBM Db2 für Linux, UNIX oder Windows
  • OracleHerstellen einer Verbindung mit Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing
  • PostgreSQLHerstellen 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
  • TeradataHerstellen einer Verbindung mit Teradata Vantage
  • SAP HANAHerstellen einer Verbindung mit SAP HANA oder SAP HANA Cloud
  • SQL ServerHerstellen 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.

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

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

  • TransaktionalMit 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.
  • HistorischMit 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.
  • ZeitpunktMit einem bestimmten Zeitpunkt verbinden. Wenn Zeitpunkt ausgewählt ist, wird der Parameter Folgende Version wird verwendet deaktiviert und der Parameter Datum und Uhrzeit aktiviert.
  • VerzweigungMit 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

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

  • DAMENGHerstellen einer Verbindung mit Dameng
  • DB2Herstellen einer Verbindung mit IBM Db2 für Linux, UNIX oder Windows
  • ORACLEHerstellen einer Verbindung mit Oracle, Amazon Relational Database Service (RDS) for Oracle oder Autonomous Transaction Processing
  • POSTGRESQLHerstellen 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 HANAHerstellen einer Verbindung mit SAP HANA oder SAP HANA Cloud
  • SQL_SERVERHerstellen 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
  • TERADATAHerstellen 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_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 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_AUTHDie 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_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 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_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.
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.

  • TRANSACTIONALMit einer traditionellen transaktionalen Version verbinden.
    Hinweis:

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

  • HISTORICALMit einem historischen Marker verbinden.
  • POINT_IN_TIMEMit einem bestimmten Zeitpunkt verbinden. Bei Verwendung von POINT_IN_TIME wird der Parameter version ignoriert.
  • BRANCHMit 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

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

Lizenzinformationen

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

Verwandte Themen