Краткая информация
Создает файл подключения к базе данных для подключения к базам геоданных enterprise, workgroup или desktop.
Использование
Если в диалоговом окне инструмента введены допустимые данные подключения, инструмент установит соединение с базой данных, чтобы определить, содержит ли база данных схему базы геоданных. При обнаружении схемы сервер автоматически внесет в параметр Схема (Schema) схему SDE (только для баз геоданных пользовательской схемы Oracle), параметр Тип версии Version Type) с ключевым словом TRANSACTIONAL и параметр имени версии с именем версии Default.
Если вы хотите предотвратить сохранение информации о подключении в окне Результаты или сохранение файлов журнала истории геообработки, отключите запись истории и сохраните файл подключения без сохранения информации о подключении.
Все параметры в разделе Свойства подключения базы геоданных диалогового окна инструмента будут игнорироваться при подключении к базе данных, которая не является базой геоданных.
Синтаксис
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. | String |
database_platform | Платформа системы управления базами данных, к которой подключаетесь. Существует несколько возможных опций:
| String |
instance | Сервер базы данных или экземпляр, к которому вы подключаетесь. Значение, указанное для параметра database_platform, определяет тип базы данных, к которой выполняется подключение. Значение параметра instance может варьироваться в зависимости от указанной платформы БД. Более подробная информация о настройке подключения к каждой из платформ БД находится ниже.
| String |
account_authentication (дополнительно) |
| Boolean |
username (дополнительно) | Имя пользователя базы данных для подключения с использованием аутентификации в базе данных. | String |
password (дополнительно) | Пароль пользователя базы данных для подключения с использованием аутентификации базы данных. | Encrypted String |
save_user_pass (дополнительно) |
| Boolean |
database (дополнительно) | Имя базы данных, к которой вы будете подключаться. Этот параметр действителен только для платформ PostgreSQL и SQL Server. | String |
schema (дополнительно) | Пользовательская схема базы геоданных, к которой вы хотите подключиться. Этот параметр действителен только для баз данных Oracle, которые содержат хотя бы одну базу геоданных пользовательской схемы. По умолчанию этот параметр использует схему SDE (master) базы геоданных. | String |
version_type (дополнительно) | Тип версии, к которой выполняется подключение.
Если используется значение TRANSACTIONAL или HISTORICAL, параметр date будет игнорироваться. Если используется значение HISTORICAL, и в параметре version_name не указано имя, будет использована рабочая версия по умолчанию Default. Если выбрано значение POINT_IN_TIME, и в параметре date не указана дата, будет использована рабочая версия по умолчанию Default. | String |
version (дополнительно) | Рабочая версия базы геоданных или метка времени для подключения. Опция по умолчанию использует версию по умолчанию Default. | String |
date (дополнительно) | Значение, представляющее дату и время, используемое для подключения к базе данных. Работа с данными с поддержкой архивирования. Указывать дату можно в следующих форматах:
| Date |
Пример кода
CreateDatabaseConnection, пример 1 (окно 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")
CreateDatabaseConnection, пример 2 (автономный скрипт)
Следующий автономный скрипт демонстрирует использование инструмента 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")
CreateDatabaseConnection, пример 3 (окно 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",
"#")
CreateDatabaseConnection, пример 4 (окно 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")