Datenbankverbindung erstellen (Zeichenfolge) (Data Management)

Zusammenfassung

Erstellt eine Verbindungszeichenfolge, die durch Geoverarbeitungswerkzeuge verwendet werden kann, um eine Verbindung mit einer Datenbank oder einer Enterprise-Geodatabase herzustellen.

Verwendung

  • Dieses Werkzeug sollten Sie anstelle von Verbindungsdateien verwenden, wenn Sie mit einem automatisierten Geoverarbeitungs-Workflow (Skript oder Modell) arbeiten, der Datasets in Datenbanken oder Enterprise-Geodatabases verwendet. Statt einen Pfad zur Datenbank über den Verbindungsdatei-Workspace zu verwenden, können Sie eine Verbindungszeichenfolge erstellen, die als Eingabe für ein Geoverarbeitungswerkzeug, das den angegebenen Dataset-Typ unterstützt, verwendet werden kann.

  • Verbindungen von ArcGIS mit Altibase und Netezza werden nicht mehr unterstützt.

Parameter

BeschriftungErläuterungDatentyp
Datenbankplattform

Gibt die Datenbankplattform an, zu der die Verbindung hergestellt werden soll.

  • SQL ServerStellen Sie eine Verbindung mit Microsoft SQL Server oder Microsoft Azure SQL Database her.
  • OracleVerbinden mit Oracle
  • Db2Stellen Sie eine Verbindung mit IBM DB2 unter Linux, UNIX oder Windows her.
  • PostgreSQLStellen Sie eine Verbindung mit PostgreSQL her.
  • TeradataStellen Sie eine Verbindung mit Teradata Data Warehouse Appliance her.
  • SAP HANAStellen Sie eine Verbindung mit SAP HANA her.
  • DamengStellen Sie eine Verbindung mit Dameng her.
String
Instanz

Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll.

Der Wert dieses Parameters hängt von dem für den Parameter Datenbankplattform ausgewählten Wert ab.

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 nicht Ihren Benutzernamen und Ihr Kennwort eingeben. In diesem Fall werden Sie jedoch dazu aufgefordert, wenn eine Verbindung hergestellt wird. Dies ist die Standardeinstellung.
    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 eingeben. 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 bei Verwendung der Datenbankauthentifizierung angegeben wird.

String
Kennwort
(optional)

Das Datenbankkennwort, das bei Verwendung der Datenbankauthentifizierung angegeben wird.

Encrypted String
Datenbank
(optional)

Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter wird nur für PostgreSQL- und SQL Server-Plattformen verwendet.

String
Dataset-Objektname
(optional)

Der Name des Datasets oder Objektes in der Datenbank, auf das die Verbindungszeichenfolge zeigen soll. Diese Verbindungszeichenfolge kann als Pfad zum angegebenen Dataset verwendet werden.

String
Datentyp
(optional)

Der Typ des Datasets oder Objektes, das im Dataset-Objektnamen referenziert wird. Wenn mehrere Objekte mit demselben Namen in der Datenbank vorhanden sind, müssen Sie möglicherweise den Datentyp des Objektes, für das eine Verbindungszeichenfolge erstellt werden soll, angeben.

String
Ziel-Feature-Dataset
(optional)

Der Name des Feature-Datasets, in dem das Dataset oder Objekt, für das eine Verbindungszeichenfolge erstellt werden soll, enthalten ist. Wenn das Dataset nicht in einem Feature-Dataset enthalten ist (zum Beispiel, wenn es sich im Stammverzeichnis der Datenbank befindet), darf kein Ziel-Feature-Dataset angegeben werden.

String
Schema (nur Oracle-Benutzerschema-Geodatabases)
(optional)

Die Benutzerschema-Geodatabase, mit der Sie eine Verbindung herstellen möchten. 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 (Master-) Geodatabase mit SDE-Schema.

String
Versionstyp
(optional)

Gibt den Versionstyp an, mit dem eine Verbindung hergestellt werden soll. 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 Standard-Verzweigungsversion verbinden.
String
Folgende Version wird verwendet
(optional)

Die transaktionale Version oder der historische Marker 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. Dieser Parameter wird mit Daten mit aktivierter Archivierung verwendet. Verwenden Sie die Zeitauswahl, um die entsprechende Zeit auszuwählen.

Bei einer manuellen Eingabe von Zeit- und Datumsangaben stehen die folgenden Formate zur Verfügung:

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 16:20:15

Hinweis:

  • Wird lediglich eine Uhrzeit ohne Datum angegeben, wird das folgende Standarddatum verwendet: 30. Dezember 1899.
  • Wird lediglich ein Datum ohne Uhrzeit angegeben, wird die folgende Standarduhrzeit verwendet: 12:00:00 AM.

Date

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
CIMDATA-Verbindungszeichenfolge

Die CIMDATA-Verbindungszeichenfolge.

String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
NameErläuterungDatentyp
database_platform

Gibt die Datenbankplattform an, zu der die Verbindung hergestellt werden soll.

  • SQL_SERVERStellen Sie eine Verbindung mit Microsoft SQL Server oder Microsoft Azure SQL Database her.
  • ORACLEVerbinden mit Oracle
  • DB2Stellen Sie eine Verbindung mit IBM DB2 unter Linux, UNIX oder Windows her.
  • POSTGRESQLStellen Sie eine Verbindung mit PostgreSQL her.
  • TERADATAStellen Sie eine Verbindung mit Teradata Data Warehouse Appliance her.
  • SAP HANAStellen Sie eine Verbindung mit SAP HANA her.
  • DAMENGStellen Sie eine Verbindung mit Dameng her.
String
instance

Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll.

Der Wert dieses Parameters hängt von dem für den Parameter Datenbankplattform ausgewählten Wert ab.

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 nicht Ihren Benutzernamen und Ihr Kennwort eingeben. In diesem Fall werden Sie jedoch dazu aufgefordert, wenn eine Verbindung hergestellt wird. Dies ist die Standardeinstellung.
    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 eingeben. 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 bei Verwendung der Datenbankauthentifizierung angegeben wird.

String
password
(optional)

Das Datenbankkennwort, das bei Verwendung der Datenbankauthentifizierung angegeben wird.

Encrypted String
database
(optional)

Der Name der Datenbank, zu der eine Verbindung hergestellt wird. Dieser Parameter wird nur für PostgreSQL- und SQL Server-Plattformen verwendet.

String
object_name
(optional)

Der Name des Datasets oder Objektes in der Datenbank, auf das die Verbindungszeichenfolge zeigen soll. Diese Verbindungszeichenfolge kann als Pfad zum angegebenen Dataset verwendet werden.

String
data_type
(optional)

Der Typ des Datasets oder Objektes, das im Dataset-Objektnamen referenziert wird. Wenn mehrere Objekte mit demselben Namen in der Datenbank vorhanden sind, müssen Sie möglicherweise den Datentyp des Objektes, für das eine Verbindungszeichenfolge erstellt werden soll, angeben.

String
feature_dataset
(optional)

Der Name des Feature-Datasets, in dem das Dataset oder Objekt, für das eine Verbindungszeichenfolge erstellt werden soll, enthalten ist. Wenn das Dataset nicht in einem Feature-Dataset enthalten ist (zum Beispiel, wenn es sich im Stammverzeichnis der Datenbank befindet), darf kein Ziel-Feature-Dataset angegeben werden.

String
schema
(optional)

Die Benutzerschema-Geodatabase, mit der Sie eine Verbindung herstellen möchten. 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 (Master-) Geodatabase mit SDE-Schema.

String
version_type
(optional)

Gibt den Versionstyp an, mit dem eine Verbindung hergestellt werden soll. Dieser Parameter gilt nur beim Verbinden mit einer Geodatabase.

  • TRANSACTIONALMit 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.
  • HISTORICALMit 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.
  • POINT_IN_TIMEMit einem bestimmten Zeitpunkt verbinden. Wenn Zeitpunkt ausgewählt ist, wird der Parameter Folgende Version wird verwendet deaktiviert und der Parameter Datum und Uhrzeit aktiviert.
  • BRANCHMit der Standard-Verzweigungsversion verbinden.

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.

String
version
(optional)

Die transaktionale Version oder der historische Marker 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_connection_string

Die CIMDATA-Verbindungszeichenfolge.

String

Codebeispiel

CreateDatabaseConnectionString – Beispiel (Python-Fenster)

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

import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb", 
                                          "",
                                          "gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

Verwandte Themen