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 Standard-Versionstyp für die Geodatabase und die Standard-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.
Die Verwendung von Altibase mit ArcGIS ist nun veraltet. Die Option ist in dieser Version noch vorhanden, sie wird aber in einer künftigen ArcGIS-Version entfernt.
Syntax
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-Datei) 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 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) | Gibt den zu verwendenden Authentifizierungstyp an.
| 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 |
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 wird nur für PostgreSQL- und SQL Server-Plattformen verwendet. | 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.
| 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, 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-Datei). | Workspace |
Codebeispiel
CreateDatabaseConnection – Beispiel 1 (Python-Fenster)
Das folgende Skript für das Python-Fenster veranschaulicht, wie das Werkzeug 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)
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("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