Краткая информация
Инструмент Создать подключение базы данных создает файл, который ArcGIS использует для подключения к базе данных или к базам геоданных enterprise, workgroup или desktop.
Использование
Если в диалоговом окне инструмента введены допустимые данные подключения, инструмент установит соединение с базой данных, чтобы определить, содержит ли база данных схему базы геоданных. При обнаружении схемы инструмент автоматически внесет в параметр Схема схему sde (только для баз геоданных пользовательской схемы Oracle), параметр Тип версии) с ключевым словом 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")
Пример 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")
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")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Нет
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да