Создать подключение базы данных (Create Database Connection) (Управление данными)

Уровень лицензии:BasicStandardAdvanced

Резюме

Создает файл подключения, который можно использовать для подключения к базе данных предприятия или базе геоданных ArcSDE.

Использование

Синтаксис

CreateDatabaseConnection_management (out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})
ПараметрОбъяснениеТип данных
out_folder_path

Путь к папке, где будет храниться файл .sde.

Folder
out_name

Имя файла .sde.

Разрешение выходного файла должно заканчиваться на .sde.

String
database_platform

Платформа СУБД, к которой выполняется подключение. Допустимые параметры:

  • SQL_SERVERПодключение к Microsoft SQL Server
  • ORACLEПодключение к Oracle.
  • DB2Подключение IBM DB2 на базе Linux, UNIX или Windows
  • DB2ZOSПодключение к IBM DB2 на базе z/OS
  • INFORMIXПодключение к IBM Informix
  • NETEZZAПодключение к Netezza
  • POSTGRESQLПодключение к PostgreSQL
String
instance

Сервер или экземпляр, к которому выполняется подключение.

Значение, выбранное из раскрывающегося списка "Тип подключения" (Connection type), определяет тип базы данных, к которой требуется подключиться. Указываемая информация для этого параметра может варьироваться в зависимости от выбранного типа подключения.

Дополнительные сведения о каждой из платформ СУБД см. далее.

  • db2 — имя каталогизированной базы данных DB2.
  • db2zos — имя каталогизированной базы данных DB2.
  • informix — имя источника данных Связность с открытой базой данных (ODBC) для базы данных Informix.
  • oracle — имя TNS или строка подключения Oracle Easy.
  • netezza — имя источника данных ODBC для базы данных Netezza.
  • postgresql — имя сервера, на котором установлен PostgreSQL.
  • sqlserver — имя экземпляра SQL Server.
String
account_authentication
(дополнительно)
  • DB_AUTHENTICATIONПроверка подлинности в базе данных. Использует имя пользователя и пароль внутренней базы данных для подключения к СУБД. Вводить имя пользователя или пароль для создания подключения необязательно; однако, если этого не сделать, вам будет предложено ввести их при установлении подключения.
  • OS_AUTHENTICATIONПроверка подлинности средствами операционной системы. Вам не нужно вводить имя пользователя и пароль. Подключение выполняется с именем пользователя и паролем, которые используются для входа в операционную систему. Если логин, используемый для операционной системы, является некорректным логином базы геоданных, подключение не будет выполнено. Обратите внимание: при создании подключения к базе геоданных, хранящейся в Oracle, DB2 или Informix, необходимо использовать прямое подключение к базе данных.
Boolean
username
(дополнительно)

Имя пользователя базы данных для подключения с использованием аутентификации в базе данных.

String
password
(дополнительно)

Пароль пользователя базы данных для подключения с использованием Аутентификации в базе данных.

Encrypted String
save_user_pass
(дополнительно)
  • SAVE_USERNAMEСохранить имя пользователя и пароль в файле подключения. Это значение используется по умолчанию.
  • DO_NOT_SAVE_USERNAMEНе сохранять имя пользователя и пароль в файле. При каждой попытке подключиться с помощью файла будет отображаться запрос на ввод имени пользователя и пароля.
Boolean
database
(дополнительно)

Имя базы данных, к которой будет выполнено подключение. Этот параметр действителен только для платформ PostgreSQL и SQL Server.

String
schema
(дополнительно)

База геоданных с пользовательской схемой, к которой будет выполнено подключение. Этот параметр действителен только для баз данных Oracle, которые содержат хотя бы одну базу геоданных пользовательской схемы. По умолчанию этот параметр использует версию по умолчанию.

String
version_type
(дополнительно)

Тип версии, к которой планируется выполнить подключение.

  • транзакционныйИспользуется для подключения к рабочей версии.
  • ИсторическийИспользуется для подключения к метке времени.
  • POINT_IN_TIMEИспользуется для подключения к конкретной точки во времени. Если используется значение POINT_IN_TIME, параметр имени версии будет игнорироваться.

Если используется значение TRANSACTIONAL или HISTORICAL, параметр date будет игнорироваться. Если используется значение HISTORICAL, и в параметре version_name не указано имя, будет использована рабочая версия по умолчанию. Если выбрано значение POINT IN TIME, и в параметре date не указана дата, будет использована рабочая версия по умолчанию.

String
version
(дополнительно)

Рабочая версия базы геоданных или метка времени для подключения. Параметр по умолчанию использует версию по умолчанию.

String
date
(дополнительно)

Значение, представляющие используемую дату и время для подключения к базе данных. Работа с данными с поддержкой архивирования.

Указывать дату можно в следующих форматах:

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

ПримечаниеПримечание:

  • Если время указывается без даты, будет использована дата по умолчанию (30 декабря 1899 г.).
  • Если дата указывается без указания времени, будет использовано время по умолчанию (12:00 AM).

Date

Пример кода

Пример 1. CreateDatabaseConnection (окно Python)

Приведенный ниже скрипт окна Python демонстрирует прямое использование инструмента CreateDatabaseConnection.

import arcpy
arcpy.CreateDatabaseConnection_management("Database Connections",
                                          "utah.sde",
                                          "SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb",
                                          "SAVE_USERNAME",
                                          "garfield",
                                          "#",
                                          "TRANSACTIONAL",
                                          "sde.DEFAULT")
Пример 2. CreateDatabaseConnection (автономный скрипт)

Следующий автономный скрипт демонстрирует использование инструмента CreateDatabaseConnection.

# 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("Database Connections",
                                          "zion.sde",
                                          "ORACLE",
                                          "zionserver/ORCL",
                                          "OPERATING_SYSTEM_AUTH")
Пример 3. CreateDatabaseConnection (окно Python)

Приведенный ниже скрипт окна Python демонстрирует прямое использование инструмента CreateDatabaseConnection для подключения к метке времени.

# 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("Database Connections",
                                          "history.sde",
                                          "DB2",
                                          "DB2_DS",
                                          "DATABASE_AUTH",
                                          "butch",
                                          "sundance",
                                          "SAVE_USERNAME",
                                          "#",
                                          "#",
                                          "HISTORICAL",
                                          "June 9, 2010",
                                          "#")
Пример 4. CreateDatabaseConnection (окно Python)

Приведенный ниже скрипт окна Python демонстрирует прямое использование инструмента CreateDatabaseConnection для подключения к точке во времени.

# 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("Database Connections",
                                          "history.sde",
                                          "POSTGRESQL",
                                          "dbserver",
                                          "DATABASE_AUTH",
                                          "stevie",
                                          "smith",
                                          "SAVE_USERNAME",
                                          "archivedb",
                                          "#",
                                          "POINT_IN_TIME",
                                          "#",
                                          "5/19/2011 8:43:41 AM")

Параметры среды

Информация о лицензировании

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
9/10/2013