Zusammenfassung
Das Werkzeug Datenbankverbindung erstellen erstellt eine Datei, mit der ArcGIS-Benutzer eine Verbindung mit einer Datenbank oder einer Enterprise-, Workgroup- oder Desktop-Geodatabase herstellen.
Verwendung
Wenn Sie bei Verwendung des Werkzeugdialogfeldes gültige Verbindungsinformationen eingeben, stellt das Werkzeug eine Verbindung mit der Datenbank her, um zu ermitteln, ob die Datenbank das Geodatabase-Schema enthält. Wenn das Schema gefunden wird, übernimmt das Werkzeug 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 Ihre Verbindungsinformationen weder im Fenster Ergebnisse noch in den Protokolldateien des Geoverarbeitungsverlaufs speichern möchten, müssen Sie die Verlaufsprotokollierung deaktivieren und die Verbindungsdatei speichern, ohne dabei die Verbindungsinformationen zu speichern.
Alle Parameter im Abschnitt Geodatabase-Verbindungseigenschaften des Werkzeugdialogfeldes werden ignoriert, wenn eine Verbindung mit einer Datenbank hergestellt wird, die keine Geodatabase enthält.
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 Angaben, 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 bei Verwendung der 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.
| 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 das Werkzeug CreateDatabaseConnection im unmittelbaren Modus verwendet wird.
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)
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug 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("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")
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Nein
- ArcGIS Desktop Standard: Ja
- ArcGIS Desktop Advanced: Ja