Краткая информация
Создает файл, который ArcGIS использует для подключения к базе данных или к настольной, многопользовательской базе геоданных или базе геоданных рабочих групп.
Использование
После ввода корректной информации о подключении для установки подключения в диалоговом окне инструмента, инструмент обратится к базе данных, чтобы определить, содержит ли база данных схему.
- Для баз данных все параметры в разделе Свойства подключения к базе геоданных в диалоговом окне инструмента игнорируются.
- Для баз геоданных инструмент автоматически заполняет Свойства подключения к базе геоданных. Параметр Схемаустанавливается со схемой sde (только для пользовательской схемы базы геоданных Oracle), Тип версии по умолчанию для базы данных и версия по умолчанию.
Если вы не хотите сохранять информации о подключении в окне Результаты или ее сохранение в файлах журнала истории геообработки, отключите запись истории и сохраните файл подключения без сохранения информации о подключении.
Использование Altibase с ArcGIS прекращено. Эта опция еще присутствует в текущей версии, но будет удалена в следующем выпуске ArcGIS.
Синтаксис
CreateDatabaseConnection(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 (Дополнительный) | Указывает тип версии, к которой выполняется подключение.
| String |
version (Дополнительный) | Рабочая версия базы геоданных или метка времени для подключения. Опция по умолчанию использует рабочую версию по умолчанию. | String |
date (Дополнительный) | Значение, представляющее дату и время, используемое для подключения к базе данных при работе с данными, для которых включено архивирование. Указывать дату можно в следующих форматах:
| Date |
Производные выходные данные
Имя | Объяснение | Тип данных |
out_workspace | Выходной файл подключения базы данных (файл .sde). | рабочая область |
Пример кода
CreateDatabaseConnection, пример 1 (окно Python)
Пример скрипта 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, пример 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("C:\\MyProject",
"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("C:\\MyProject",
"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("C:\\MyProject",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
Параметры среды
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да