ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Hilfe
  • Sign Out
ArcGIS Desktop

ArcGIS Online

Die Mapping-Plattform für Ihre Organisation

ArcGIS Desktop

Ein vollständiges professionelles GIS

ArcGIS Enterprise

GIS in Ihrem Unternehmen

ArcGIS Developers

Werkzeuge zum Erstellen standortbezogener Apps

ArcGIS Solutions

Kostenlose Karten- und App-Vorlagen für Ihre Branche

ArcGIS Marketplace

Rufen Sie Apps und Daten für Ihre Organisation ab.

  • Dokumentation
  • Support
Esri
  • Anmelden
user
  • Eigenes Profil
  • Abmelden

ArcMap

  • Startseite
  • Erste Schritte
  • Karte
  • Analysieren
  • Verwalten von Daten
  • Werkzeuge
  • Erweiterungen

Datenbankverbindung erstellen

  • Zusammenfassung
  • Verwendung
  • Syntax
  • Codebeispiel
  • Umgebungen
  • Lizenzinformationen

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})
ParameterErklärungDatentyp
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:

  • DAMENG —Herstellen einer Verbindung mit Dameng
  • DB2 —Herstellen einer Verbindung mit IBM Db2 für Linux, UNIX oder Windows
  • DB2ZOS —Herstellen einer Verbindung mit IBM Db2 für das z-Betriebssystem
  • INFORMIX —Herstellen einer Verbindung mit IBM Informix
  • ORACLE —Herstellen einer Verbindung mit Oracle oder Amazon Relational Database Service (RDS) for Oracle
  • POSTGRESQL —Herstellen einer Verbindung mit PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL oder Microsoft Azure Database for PostgreSQL
  • SAP HANA —Herstellen einer Verbindung mit SAP HANA
  • SQL_SERVER —Herstellen einer Verbindung mit Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance oder Amazon Relational Database Service (RDS) for SQL Server
  • TERADATA —Herstellen einer Verbindung mit Teradata Data Warehouse Appliance
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.

  • Dameng: Der Name des Servers, auf dem die Dameng-Datenbank installiert ist
  • Db2: Der Name der katalogisierten Db2-Datenbank
  • Db2 for z/OS: Der Name der katalogisierten Db2-Datenbank
  • Informix: Der Datenquellenname der ODBC-Verbindung (Open Database Connectivity) für die Informix-Datenbank
  • Oracle: Der TNS-Name oder die Oracle Easy Connection-Zeichenfolge zum Herstellen der Verbindung mit der Oracle-Datenbank
  • PostgreSQL: Der Name des Servers, auf dem PostgreSQL installiert ist, oder der Name der PostgreSQL-Datenbank-Service-Instanz
  • SAP HANA: Der ODBC-Datenquellenname für die SAP HANA-Datenbank
  • SQL Server: Der Name der SQL Server-Datenbankinstanz oder der Name der Datenbank-Service-Instanz
  • Teradata: Der ODBC-Datenquellennamen für die Teradata-Datenbank
String
account_authentication
(optional)

Gibt den zu verwendenden Authentifizierungstyp an.

  • DATABASE_AUTH —Die Datenbankauthentifizierung wird verwendet. Die Verbindung mit der Datenbank wird über einen internen Datenbankbenutzernamen und ein internes Datenbankkennwort hergestellt. Sie müssen zum Erstellen einer Verbindung nicht Ihren Benutzernamen und Ihr Kennwort eingeben. In diesem Fall werden Sie jedoch dazu aufgefordert, wenn eine Verbindung hergestellt wird.
    Hinweis:

    Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank oder Geodatabase gewährt, müssen Sie einen Benutzernamen und ein Kennwort eingeben. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird.

  • OPERATING_SYSTEM_AUTH —Die Betriebssystemauthentifizierung wird verwendet. Sie müssen keinen Benutzernamen und kein Kennwort eingeben. Die Verbindung wird mit dem Benutzernamen und dem Kennwort hergestellt, die für die Anmeldung beim Betriebssystem verwendet wurden. Falls es sich bei den Login-Daten für das Betriebssystem nicht um ein gültiges Geodatabase-Login handelt, kann keine Verbindung hergestellt werden.
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.

  • SAVE_USERNAME —Der Benutzername und das Kennwort werden in der Verbindungsdatei gespeichert. Dies ist die Standardeinstellung. Wenn die Verbindungsdatei, die Sie erstellen, ArcGIS-Services den Zugriff auf die Datenbank oder Geodatabase gewährt, müssen Sie den Benutzernamen und das Kennwort speichern. Dies gilt auch, wenn Sie die Katalogsuche zum Suchen von Daten verwenden, auf die über diese Verbindungsdatei zugegriffen wird.
  • DO_NOT_SAVE_USERNAME —Der Benutzername und das Kennwort werden nicht in der Verbindungsdatei gespeichert. Bei jedem Versuch, mit der Datei eine Verbindung herzustellen, werden Sie aufgefordert, den Benutzernamen und das Kennwort einzugeben.
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.

  • TRANSACTIONAL —Mit einer transaktionalen Version verbinden.
  • HISTORICAL —Mit einem historischen Marker verbinden.
  • POINT_IN_TIME —Mit einem bestimmten Zeitpunkt verbinden. Bei Verwendung von POINT_IN_TIME wird der Parameter version ignoriert.

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 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:

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 16:20:15

Hinweis:

  • Wird lediglich eine Uhrzeit ohne Datum angegeben, wird das folgende Standarddatum verwendet: 30. Dezember 1899.
  • Wird lediglich ein Datum ohne Uhrzeit angegeben, wird die folgende Standarduhrzeit verwendet: 12:00:00 AM.

Date

Abgeleitete Ausgabe

NameErklärungDatentyp
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

  • Aktueller Workspace

Lizenzinformationen

  • Basic: Nein
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen

  • Überblick über das Toolset "Workspace"

ArcGIS Desktop

  • Startseite
  • Dokumentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

Über Esri

  • Über uns
  • Karriere
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Wir sind an Ihrer Meinung interessiert.
Copyright © 2021 Esri. | Datenschutz | Rechtliches