Создать подключение базы данных (Управление данными)
Краткая информация
Создает файл подключения, который можно использовать для подключения к базе данных или к корпоративной и настольной базе геоданных, а также к базе геоданных рабочей группы.
Использование
Если в диалоговом окне инструмента введены допустимые данные подключения, инструмент установит соединение с базой данных, чтобы определить, содержит ли база данных схему базы геоданных. При обнаружении схемы сервер автоматически внесет в параметр Схема (Schema) схему SDE (только для баз геоданных пользовательской схемы Oracle), параметр Тип версии (Version Type) с ключевым словом TRANSACTIONAL и параметр имени версии с именем версии Default.
Если вы хотите предотвратить сохранение информации о подключении в окне Результаты или сохранение файлов журнала истории геообработки, вам необходимо будет отключить регистрацию истории (history logging) и сохранить файл подключения без сохранения информации о подключении, которую вы хотите скрыть.
Все параметры в разделе Свойства подключения базы геоданных (Geodatabase Connection Properties) диалогового окна инструмента будут игнорироваться при подключении к базе данных, которая не является базой геоданных.
Синтаксис
| Параметр | Объяснение | Тип данных |
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, которые содержат хотя бы одну базу геоданных пользовательской схемы. По умолчанию этот параметр использует версию по умолчанию. | String |
version_type (дополнительно) | Тип версии, к которой планируется выполнить подключение.
Если используется значение TRANSACTIONAL или HISTORICAL, параметр date будет игнорироваться. Если используется значение HISTORICAL, и в параметре version_name не указано имя, будет использована рабочая версия по умолчанию. Если выбрано значение POINT IN TIME, и в параметре date не указана дата, будет использована рабочая версия по умолчанию. | String |
version (дополнительно) |
Рабочая версия базы геоданных или метка времени для подключения. Параметр по умолчанию использует версию по умолчанию. | String |
date (дополнительно) | Значение, представляющее дату и время, используемое для подключения к базе данных. Работа с данными с поддержкой архивирования. Указывать дату можно в следующих форматах:
 Примечание:
| Date |
Пример кода
Приведенный ниже скрипт окна 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.
# 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")
Приведенный ниже скрипт окна 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",
"#")
Приведенный ниже скрипт окна 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")