Zusammenfassung
Erstellt eine Verbindungsdatei, die zum Herstellen einer Verbindung mit einer Datenbank oder einer Enterprise-, Workgroup- oder Desktop-Geodatabase verwendet werden kann.
Verwendung
Bei Verwendung des Dialogfeldes des Werkzeugs stellt das Werkzeug eine Verbindung mit der Datenbank her, wenn gültige Verbindungsinformationen eingegeben werden, um zu ermitteln, ob die Datenbank das Geodatabase-Schema enthält. Wenn das Schema gefunden wird, übernimmt der Server automatisch für den Parameter Schema das SDE-Schema (nur für Geodatabases mit Oracle-Benutzerschema), für den Parameter Versionstyp das Schlüsselwort TRANSACTIONAL und für den Versionsnamenparameter den standardmäßigen Versionsnamen.
Wenn Sie verhindern möchten, dass Ihre Verbindungsinformationen im Fenster Ergebnisse oder in den Protokolldateien des Geoverarbeitungsverlaufs gespeichert werden, müssen Sie die Verlaufsprotokollierung deaktivieren und die Verbindungsdatei speichern, ohne dabei die Verbindungsinformationen zu speichern.
Alle Parameter im Abschnitt Geodatabase-Verbindungseigenschaften des Dialogfeldes des Werkzeugs werden ignoriert, wenn eine Verbindung mit einer Datenbank hergestellt wird, bei der es sich nicht um eine Geodatabase handelt.
Syntax
CreateDatabaseConnection_management (out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| Parameter | Erläuterung | Datentyp |
out_folder_path | Der Ordner, in dem die Datenbankverbindungsdatei (.sde-Datei) gespeichert wird. | Folder |
out_name | Der Name der Datenbankverbindungsdatei. Die Ausgabedatei hat die Erweiterung .sde. | String |
database_platform | Die Datenbankmanagementsystem-Plattform, zu der Sie eine Verbindung herstellen. Die folgenden Optionen sind gültig:
| String |
instance | Der Datenbankserver bzw. die Datenbankinstanz, mit dem/der Sie eine Verbindung herstellen möchten. Der im Parameter database_platform angegebene Wert weist auf den Datenbanktyp hin, mit dem eine Verbindung hergestellt werden soll. Abhängig von der angegebenen Datenbankplattform müssen Sie für den Parameter instance unterschiedliche Informationen angeben. Weitere Informationen zu den Informationen, die für jede Datenbankplattform bereitgestellt werden müssen, finden Sie nachstehend.
| String |
account_authentication (optional) |
| Boolean |
username (optional) | Der Datenbankbenutzername zum Herstellen einer Verbindung mit Datenbankauthentifizierung. | String |
password (optional) | Das Benutzerkennwort für die Datenbank beim Verwenden von Datenbankauthentifizierung. | Encrypted String |
save_user_pass (optional) |
| Boolean |
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 |
schema (optional) | Die Benutzerschema-Geodatabase, zu 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) | Der Versionstyp, mit dem eine Verbindung hergestellt werden soll.
Bei Verwendung von TRANSACTIONAL oder HISTORICAL wird der Parameter date ignoriert. Wenn HISTORICAL verwendet wird und für den Parameter version_name kein Name angegeben ist, wird die standardmäßige transaktionale Version verwendet. Wenn POINT_IN_TIME verwendet wird und für den Parameter date 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. | String |
date (optional) | Der Datums- und Uhrzeitwert, der für die Verbindung mit der Datenbank verwendet wird. Zum Arbeiten mit Daten mit aktivierter Archivierung. Für die Eingabe der Datums- und Zeitangaben stehen die folgenden Formate zur Verfügung:
| Date |
Codebeispiel
CreateDatabaseConnection – Beispiel 1 (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug " CreateDatabaseConnection " im unmittelbaren Modus verwenden.
import arcpy
arcpy.CreateDatabaseConnection_management("Database Connections",
"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 Sie das Werkzeug " CreateDatabaseConnection " verwenden.
# 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("Database Connections",
"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("Database Connections",
"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("Database Connections",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Nein
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja