Zusammenfassung
Erstellt eine Datei, die ArcGIS verwendet, um eine Verbindung mit einer Datenbank oder einer Enterprise-, Workgroup- oder Desktop-Geodatabase herzustellen.
Verwendung
Nachdem gültige Verbindungsinformationen zum Herstellen einer Verbindung im Dialogfeld des Werkzeugs 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 Versionstyp für die Geodatabase und die Default-Version festgelegt.
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.
Verbindungen von ArcGIS mit Altibase und Netezza werden nicht mehr unterstützt.
Syntax
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| Parameter | Erklärung | 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:
| String |
instance | Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll. 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. Informationen zu den Angaben, die für jede Datenbankplattform bereitgestellt werden müssen, finden Sie nachstehend.
| String |
account_authentication (optional) | Gibt den zu verwendenden Authentifizierungstyp an.
| 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.
| 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.
| 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. | 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:
| Date |
Abgeleitete Ausgabe
| Name | Erklärung | 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
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja