Сводка
Создает файл, который 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})| Параметр | Объяснение | Тип данных |
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-схему базы геоданных. | String |
version_type (Дополнительный) | Определяет тип версии, к которой будет выполнено подключение.
| String |
version (Дополнительный) | Рабочая версия базы геоданных или историческая метка, к которой будет выполняться подключение. Опция по умолчанию использует транзакционную версию по умолчанию. | String |
date (Дополнительный) | Значение, соответствующее дате и времени, которое будет использоваться для подключении к базе данных при работе с данными со включенным архивированием. Указывать дату можно в следующих форматах:
| Date |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_workspace | Выходной файл подключения базы данных (.sde). | workspace |
Пример кода
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: Да