Сводка
Инструмент Создать подключение базы данных создает файл, который ArcGIS использует для подключения к базе данных или многопользовательской базе геоданных.
Использование
После ввода корректной информации о подключении для установки подключения в диалоговом окне инструмента, инструмент обратится к базе данных, чтобы определить, содержит ли база данных схему.
- Для баз данных все параметры в разделе Свойства подключения к базе геоданных в диалоговом окне инструмента игнорируются.
- Для баз геоданных инструмент автоматически заполняет Свойства подключения к базе геоданных. Параметр Схемаустанавливается со схемой sde (только для пользовательской схемы базы геоданных Oracle), Тип версии по умолчанию для базы данных и версия по умолчанию.
Подключения из ArcGIS к Altibase и Netezza больше не поддерживаются.
Синтаксис
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| Parameter | Объяснение | Тип данных |
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 не указано имя, будет использована рабочая версия по умолчанию. Если выбрано значение POINT_IN_TIME, и в параметре date не указана дата, будет использована рабочая версия по умолчанию. | String |
version (Дополнительный) | Рабочая версия базы геоданных или метка времени для подключения. Опция по умолчанию использует транзакционную версию по умолчанию. Если вы выбрали тип версии Ветвь, вы всегда подключаетесь к версии ветви по умолчанию. | String |
date (Дополнительный) | Значение, соответствующее дате и времени, которое будет использоваться для подключении к базе данных при работе с данными со включенным архивированием. Указывать дату можно в следующих форматах:
Примечание:
| Date |
Производные выходные данные
| Name | Объяснение | Тип данных |
| out_workspace | Выходной файл подключения базы данных (файл .sde). | рабочая область |
Пример кода
Пример скрипта Python для использования инструмента CreateDatabaseConnection в режиме прямого запуска.
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"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("C:\\MyProject",
"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("C:\\MyProject",
"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("C:\\MyProject",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")Environments
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да