Zusammenfassung
Erstellt eine Verbindungszeichenfolge, die durch Geoverarbeitungswerkzeuge verwendet werden kann, um eine Verbindung mit einer Datenbank oder einer Enterprise-Geodatabase herzustellen.
Verwendung
Dieses Werkzeug sollten Sie anstelle von Verbindungsdateien verwenden, wenn Sie mit einem automatisierten Geoverarbeitungs-Workflow (Skript oder Modell) arbeiten, der Datasets in Datenbanken oder Enterprise-Geodatabases verwendet. Statt einen Pfad zur Datenbank über den Verbindungsdatei-Workspace zu verwenden, können Sie eine Verbindungszeichenfolge erstellen, die als Eingabe für ein Geoverarbeitungswerkzeug, das den angegebenen Dataset-Typ unterstützt, verwendet werden kann.
Verbindungen von ArcGIS mit Altibase und Netezza werden nicht mehr unterstützt.
Syntax
arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})| Parameter | Erklärung | Datentyp |
database_platform | Gibt die Datenbankplattform an, zu der die Verbindung hergestellt werden soll.
| String |
instance | Der Datenbankserver bzw. die Datenbankinstanz, zu dem bzw. der die Verbindung hergestellt werden soll. Der Wert dieses Parameters hängt von dem für den Parameter Datenbankplattform ausgewählten Wert ab. | 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 |
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 |
object_name (optional) | Der Name des Datasets oder Objektes in der Datenbank, auf das die Verbindungszeichenfolge zeigen soll. Diese Verbindungszeichenfolge kann als Pfad zum angegebenen Dataset verwendet werden. | String |
data_type (optional) | Der Typ des Datasets oder Objektes, das im Dataset-Objektnamen referenziert wird. Wenn mehrere Objekte mit demselben Namen in der Datenbank vorhanden sind, müssen Sie möglicherweise den Datentyp des Objektes, für das eine Verbindungszeichenfolge erstellt werden soll, angeben. | String |
feature_dataset (optional) | Der Name des Feature-Datasets, in dem das Dataset oder Objekt, für das eine Verbindungszeichenfolge erstellt werden soll, enthalten ist. Wenn das Dataset nicht in einem Feature-Dataset enthalten ist (zum Beispiel, wenn es sich im Stammverzeichnis der Datenbank befindet), darf kein Ziel-Feature-Dataset angegeben werden. | 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. Dieser Parameter gilt nur beim Verbinden mit einer Geodatabase.
Hinweis:Wenn Historisch ausgewählt ist und kein Name angegeben ist, wird die standardmäßige transaktionale Version verwendet. Wenn Zeitpunkt ausgewählt ist und für den Parameter Datum und Uhrzeit 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. 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_connection_string | Die CIMDATA-Verbindungszeichenfolge. | Zeichenfolge |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CreateDatabaseConnectionString im unmittelbaren Modus verwendet wird.
import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"",
"gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja