Zusammenfassung
Erstellt eine Datei, die ArcGIS verwendet, um eine Verbindung mit einer Datenbank oder einer Enterprise-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.
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-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.
Hinweis:Bei Verwendung von TRANSACTIONAL oder HISTORICAL wird der Parameter date ignoriert. Wenn HISTORICAL verwendet wird und für den Parameter version kein Name angegeben ist, wird die standardmäßige transaktionale Version verwendet. Wenn POINT_IN_TIME verwendet wird und für den Parameter date kein Datum 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:
Hinweis:
| Date |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_workspace | Die Ausgabe-Datenbankverbindungsdatei (.sde-Datei). | Workspace |
Codebeispiel
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")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")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",
"#")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