Создать подключение базы данных (Управление данными)

Краткая информация

Создает файл, который ArcGIS использует для подключения к базе данных или к многопользовательской базе геоданных.

Использование

• После ввода корректной информации о подключении для установки подключения в диалоговом окне инструмента, инструмент обратится к базе данных, чтобы определить, содержит ли база данных схему.

  • Для баз данных все параметры в категории Свойства подключения к базе геоданных в панели Геообработка игнорируются.
  • Для баз геоданных инструмент автоматически заполняет категорию параметров Свойства подключения к базе геоданных. Параметр Схема устанавливается со схемой sde (только для пользовательской схемы базы геоданных Oracle), Тип версии по умолчанию для базы данных и версия По умолчанию.

• Если вы хотите предотвратить сохранение информации о подключении в окне Результаты или ее сохранение в файлах журнала истории геообработки, отключите запись истории и сохраните файл подключения без сохранения информации о подключении.

• Подключения из ArcGIS к Altibase и Netezza больше не поддерживаются.

Параметры

Диалог

Подпись	Описание	Тип данных
Местоположение файла подключения	Путь к папке, где будет храниться файл подключения к базе данных (.sde).	Folder
Имя файла подключения	Имя файла подключения к базе данных. Выходной файл будет иметь расширение .sde.	String
Платформа базы данных	Определяет платформу системы управления базы данных, к которой будет выполнено подключение. Существует несколько возможных опций: BigQuery—Будет выполнено подключение к Google BigQuery. Dameng—Будет выполнено подключение к Dameng. Db2—Будет выполнено подключение к IBM Db2 для Linux, UNIX или Windows. Oracle—Будет выполнено подключение к Oracle, Amazon Relational Database Service (RDS) for Oracle или Autonomous Transaction Processing. PostgreSQL—Будет выполнено подключение к PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL или Microsoft Azure Cosmos DB for PostgreSQL. Redshift—Будет выполнено подключение к Amazon Redshift. Teradata—Будет выполнено подключение к Teradata Vantage. SAP HANA—Будет выполнено подключение к SAP HANA или SAP HANA Cloud. Snowflake—Будет выполнено подключение к Snowflake. SQL Server—Будет выполнено подключение к Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance или Amazon Relational Database Service (RDS) for SQL Server, или Google Cloud SQL for SQL Server.	String
Экземпляр/Сервер (Дополнительный)	Сервер базы данных или экземпляр, к которому вы подключаетесь. Значение, выбранное из ниспадающего меню Платформа базы данных, определяет тип базы данных или облачного хранилища данных, к которой вы будете подключиться. Указываемая информация для параметра Экземпляр/Сервер может варьироваться в зависимости от выбранного типа подключения. Ниже смотрите информацию о том, что необходимо предоставить для каждой платформы. Dameng – имя сервера, на котором установлена база данных Dameng Db2 – имя каталогизированной базы данных Db2 Oracle – имя TNS или строка Oracle Easy Connection для подключения к базе данных или сервису базы данных Oracle PostgreSQL – имя сервера, на котором установлен PostgreSQL, или имя экземпляра сервиса базы данных PostgreSQL Redshift — URL-адрес для сервера Redshift SAP HANA – имя источника данных ODBC для базы данных или сервиса базы данных SAP HANA Snowflake — URL-адрес сервера Snowflake SQL Server – имя экземпляра базы данных SQL Server или имя экземпляра сервиса базы данных. Teradata – имя источника данных ODBC для базы данных Teradata	String
Аутентификация в базе данных. (Дополнительный)	Указывает тип используемой аутентификации. Аутентификация в базе данных—Будет использоваться аутентификация в базе данных. Для подключения к базе данных будет использоваться внутреннее имя пользователя базы данных и пароль. Вводить имя пользователя или пароль для создания подключения необязательно; но если этого не сделать, вам будет предложено ввести их при установлении подключения. Примечание: Если создаваемый файл подключения обеспечивает сервисам ArcGIS доступ к базе данных или базе геоданных, или, если вы хотите использовать Каталог для поиска данных, доступных через этот файл подключения, необходимо включить имя пользователя и пароль. Аутентификация средствами операционной системы—Будет использоваться аутентификация в операционной системе. Имя пользователя и пароль вводить не нужно. Подключение выполняется с именем пользователя и паролем, которые используются для входа в операционную систему. Если учетная запись, используемая для операционной системы, не является корректной учетной записью базы данных, подключение не будет выполнено.	Boolean
Имя пользователя (Дополнительный)	Имя пользователя базы данных, которые будет использоваться для аутентификации в базе данных.	String
Пароль (Дополнительный)	Пароль пользователя базы данных , который будет использоваться для аутентификации базы данных.	Encrypted String
Сохранить имя пользователя и пароль (Дополнительный)	Указывает, будут ли сохранены имя пользователя и пароль. Отмечено – имя пользователя и пароль будут сохранены в файле подключения. Это значение по умолчанию Если создаваемый файл подключения обеспечивает сервисам ArcGIS с доступом к базе данных, базе геоданных или облачному хранилищу данных, если вы хотите использовать Каталог для поиска данных, доступных через этот файл подключения, необходимо сохранить имя пользователя и пароль. Не отмечено – имя пользователя и пароль не будут сохранены в файле подключения. При каждой попытке подключиться с помощью файла будет отображаться запрос на ввод имени пользователя и пароля.	Boolean
База данных (Дополнительный)	Имя базы данных, к которой будет выполнено подключение. Этот параметр применяется только для платформ PostgreSQL, Redshift, Snowflake и SQL Server.	String
Схема (только базы геоданных пользовательской схемы Oracle) (Дополнительный)	База геоданных пользовательской схемы, к которой будет выполнено подключение. Инструмент определит наличие подключения к базе данных Oracle, которая содержит базу геоданных пользовательской схемы. Если база данных Oracle содержит пользовательскую схему, эта опция активна, а в противном случае - не активна. По умолчанию этот параметр использует sde- схему базы геоданных.	String
Тип версии (Дополнительный)	Определяет тип версии, к которой будет выполнено подключение. Этот параметр применяется столько при подключении к базе геоданных. Примечание: Если выбрано значение Историческая, и в параметре имени версии не указано имя, будет использована рабочая версия по умолчанию. Если выбрано значение Точка во времени, и в параметре Дата и время не указана дата, будет использована рабочая версия по умолчанию Default. Рабочая—Подключение будет выполнено к рабочей версии. Если выбрано значение Рабочая, параметр Будет использоваться следующая версия будет заполнен списком рабочих версий. Параметр времени и даты будет неактивным. Это значение по умолчанию Историческая—Подключение будет выполнено к историческому маркеру. Если выбрано значение Историческая, параметр Будет использоваться следующая версия будет заполнен списком исторических маркеров. Параметр времени и даты будет неактивным. Точка во времени—Подключение будет выполнено к конкретной точке во времени. Если выбрано значение Точка во времени, параметр Будет использоваться следующая версия будет неактивным. Параметр Дата и время станет активным. Сервис-ориентированная—Подключение будет выполнено к сервис-ориентированной версии по умолчанию.	String
Будет использоваться следующая версия (Дополнительный)	Рабочая версия базы геоданных или исторический маркер, к которому будет выполняться подключение. Опция по умолчанию использует рабочую версию по умолчанию. Если вы выбрали тип версии Ветвь, вы всегда подключаетесь к версии ветви по умолчанию.	String
Дата и время (Дополнительный)	Значение, представляющее собой дату и время, используемое для подключения к базе данных. Эта опция используется с данными, для которых включено архивирование. Используйте средство выбора времени для выбора нужного значения времени. При вводе даты вручную можно использовать следующие форматы: 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Примечание: Если время указывается без даты, будет использована дата по умолчанию (30 декабря 1899 г.). Если дата указывается без указания времени, будет использовано время по умолчанию (12:00).	Date
Расширенный тип аутентификации (Дополнительный)	Указывает на использование расширенного типа аутентификации, который будет использован при подключении к облачному хранилищу данных, Microsoft Azure SQL Database или Azure SQL Managed Instance. Azure Active Directory Universal с MFA—Будет использована аутентификация по имени пользователя Azure Active Directory, но не по паролю. При подключении вам приходит текстовое сообщение, email или на устройство MFA с кодом, либо вы можете использовать для аутентификации скан отпечатка пальца. Эта вторая часть процесса аутентификации зависит от ваших настроенных сетевых и авторизационных протоколов.Опция поддерживается только для Azure SQL Database и Azure SQL Managed Instance. Пароль Azure Active Directory—Используется тип аутентификации по имени пользователя Azure Active Directory и паролю, заданных в параметрах Имя пользователя и Пароль. Имена пользователей могут иметь длину не более 30 символов.Опция поддерживается только для Azure SQL Database и Azure SQL Managed Instance. Аутентификацию сервиса—При подключении к Google BigQuery будет использован тип аутентификации сервиса. См. Документацию Google BigQuery, посвященную аутентификации для дополнительной информации. Стандартные—При подключении к Amazon Redshift будет использован стандарный тип аутентификации. Изучите Руководство по установке и настройке ODBC Data Connector Amazon Redshift для получения информации о стандартной аутентификации. Пользователь—Будет использован метод аутентификации, требующий указания имени пользователя и пароля при подключении к Snowflake. Аутентификацию пользователя—При подключении к Google BigQuery будет использован тип аутентификации пользователя. См. Документацию Google BigQuery, посвященную аутентификации для дополнительной информации.	String
Идентификатор (ID) проекта (Дополнительный)	ID проекта для подключения к Google BigQuery.	String
Набор данных по умолчанию (Дополнительный)	Набор данных по умолчанию для подключения к Google BigQuery.	String
Обновить токен (Дополнительный)	Значение для обновления тоекна. Этот параметр применяется только для подключения к Google BigQuery, если тип расширенной аутентификации - аутентификация пользователя.	String
Ключевой файл (Дополнительный)	Значение для ключевого файла. Этот параметр применяется только для подключения к Google BigQuery, если тип расширенной аутентификации - аутентификация на сервере.	String
Роль (Дополнительный)	Значение роли для подключения к облачному хранилищу данных. Этот параметр применяется, только при подключении к Snowflake.	String
Хранилище (Дополнительный)	Значение хранилища для подключения. Этот параметр применяется, только при подключении к Snowflake.	String
Дополнительные опции (Дополнительный)	Дополнительные опции для подключения. Дополнительная информация о подключении, специфичная для платформы облачного хранилища данных (Google BigQuery, Amazon Redshift или Snowflake) к которому вы подключаетесь. Указжите дополнительные опции, используя формат Option=<value>, разделенные точками с запятой. Например, option1=value1;option2=value2;. См. документацию по облачному хранилищу данных для информации о дополнительных опциях.	String

Производные выходные данные

Подпись	Описание	Тип данных
Выходная рабочая область	Выходной файл подключения базы данных (.sde).	workspace

Python

arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, {instance}, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date}, {auth_type}, {project_id}, {default_dataset}, {refresh_token}, {key_file}, {role}, {warehouse}, {advanced_options})

Имя	Описание	Тип данных
out_folder_path	Путь к папке, где будет храниться файл подключения к базе данных (.sde).	Folder
out_name	Имя файла подключения к базе данных. Выходной файл будет иметь расширение .sde.	String
database_platform	Определяет платформу системы управления базы данных, к которой будет выполнено подключение. Существует несколько возможных опций: BIGQUERY—Будет выполнено подключение к Google BigQuery. DAMENG—Будет выполнено подключение к Dameng. DB2—Будет выполнено подключение к IBM Db2 для Linux, UNIX или Windows. ORACLE—Будет выполнено подключение к Oracle, Amazon Relational Database Service (RDS) for Oracle или Autonomous Transaction Processing. POSTGRESQL—Будет выполнено подключение к PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Google Cloud SQL for PostgreSQL, Microsoft Azure Database for PostgreSQL или Microsoft Azure Cosmos DB for PostgreSQL. REDSHIFT—Будет выполнено подключение к Amazon Redshift. SAP HANA—Будет выполнено подключение к SAP HANA или SAP HANA Cloud. SNOWFLAKE—Будет выполнено подключение к Snowflake. SQL_SERVER—Будет выполнено подключение к Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance или Amazon Relational Database Service (RDS) for SQL Server, или Google Cloud SQL for SQL Server. TERADATA—Будет выполнено подключение к Teradata Vantage.	String
instance (Дополнительный)	Сервер базы данных или экземпляр, к которому вы подключаетесь. Значение, указанное для параметра database_platform, определяет тип базы данных или облачного хранилища данных, к которой выполняется подключение. Информация, указываемая в параметре instance может варьироваться в зависимости от указанной платформы. Ниже смотрите информацию о том, что необходимо предоставить для каждой платформы. Dameng – имя сервера, на котором установлена база данных Dameng Db2 – имя каталогизированной базы данных Db2 Oracle – имя TNS или строка Oracle Easy Connection для подключения к базе данных или сервису базы данных Oracle PostgreSQL – имя сервера, на котором установлен PostgreSQL, или имя экземпляра сервиса базы данных PostgreSQL Redshift — URL-адрес для сервера Redshift SAP HANA – имя источника данных ODBC для базы данных или сервиса базы данных SAP HANA Snowflake — URL-адрес сервера Snowflake SQL Server – имя экземпляра базы данных SQL Server или имя экземпляра сервиса базы данных. Teradata – имя источника данных ODBC для базы данных Teradata	String
account_authentication (Дополнительный)	Указывает тип используемой аутентификации. DATABASE_AUTH—Будет использоваться аутентификация в базе данных. Для подключения к базе данных будет использоваться внутреннее имя пользователя базы данных и пароль. Вводить имя пользователя или пароль для создания подключения необязательно; но если этого не сделать, вам будет предложено ввести их при установлении подключения. Примечание: Если создаваемый файл подключения обеспечивает сервисам ArcGIS доступ к базе данных или базе геоданных, или, если вы хотите использовать Каталог для поиска данных, доступных через этот файл подключения, необходимо включить имя пользователя и пароль. OPERATING_SYSTEM_AUTH—Будет использоваться аутентификация в операционной системе. Имя пользователя и пароль вводить не нужно. Подключение выполняется с именем пользователя и паролем, которые используются для входа в операционную систему. Если учетная запись, используемая для операционной системы, не является корректной учетной записью базы данных, подключение не будет выполнено.	Boolean
username (Дополнительный)	Имя пользователя базы данных, которые будет использоваться для аутентификации в базе данных.	String
password (Дополнительный)	Пароль пользователя базы данных , который будет использоваться для аутентификации базы данных.	Encrypted String
save_user_pass (Дополнительный)	Указывает, будут ли сохранены имя пользователя и пароль. SAVE_USERNAME—Имя пользователя и пароль будут сохранены в файле подключения. Это значение по умолчанию Если создаваемый файл подключения обеспечивает сервисам ArcGIS с доступом к базе данных, базе геоданных или облачному хранилищу данных, если вы хотите использовать Каталог для поиска данных, доступных через этот файл подключения, необходимо сохранить имя пользователя и пароль. DO_NOT_SAVE_USERNAME—Имя пользователя и пароль не будут сохранены в файле подключения. При каждой попытке подключиться с помощью файла будет отображаться запрос на ввод имени пользователя и пароля.	Boolean
database (Дополнительный)	Имя базы данных, к которой будет выполнено подключение. Этот параметр применяется только для платформ PostgreSQL, Redshift, Snowflake и SQL Server.	String
schema (Дополнительный)	База геоданных пользовательской схемы, к которой будет выполнено подключение. Эта опция применяется только для баз данных Oracle, которые содержат хотя бы одну базу геоданных пользовательской схемы. По умолчанию этот параметр использует sde-схему базы геоданных.	String
version_type (Дополнительный)	Определяет тип версии, к которой будет выполнено подключение. TRANSACTIONAL—Подключение будет выполнено к традиционной рабочей версии. Примечание: Эта опция не поддерживается для баз геоданных в SAP HANA. HISTORICAL—Подключение будет выполнено к историческому маркеру. POINT_IN_TIME—Подключение будет выполнено к конкретной точке во времени. Если используется POINT_IN_TIME, параметр version будет игнорироваться. BRANCH—Подключение будет выполнено к сервис-ориентированной версии по умолчанию. Примечание: Если используется TRANSACTIONAL или HISTORICAL, параметр date будет игнорироваться. Если используется HISTORICAL, и в параметре version не указано имя, будет использована рабочая версия по умолчанию. Если выбрано значение POINT_IN_TIME, и в параметре date не указана дата, будет использована рабочая версия по умолчанию.	String
version (Дополнительный)	Рабочая версия базы геоданных или исторический маркер, к которому будет выполняться подключение. Опция по умолчанию использует рабочую версию по умолчанию. Если вы выбрали тип версии Ветвь, вы всегда подключаетесь к версии ветви по умолчанию.	String
date (Дополнительный)	Значение, соответствующее дате и времени, которое будет использоваться для подключении к базе данных при работе с данными со включенным архивированием. Указывать дату можно в следующих форматах: 6/9/2011 4:20:15 PM 6/9/2011 16:20:15 6/9/2011 4:20:15 PM 16:20:15 Примечание: Если время указывается без даты, будет использована дата по умолчанию (30 декабря 1899 г.). Если дата указывается без указания времени, будет использовано время по умолчанию (12:00).	Date
auth_type (Дополнительный)	Указывает на использование расширенного типа аутентификации, который будет использован при подключении к облачному хранилищу данных, Microsoft Azure SQL Database или Azure SQL Managed Instance. AZURE_ACTIVE_DIRECTORY_UNIVERSAL_WITH_MFA—Будет использована аутентификация по имени пользователя Azure Active Directory, но не по паролю. При подключении вам приходит текстовое сообщение, email или на устройство MFA с кодом, либо вы можете использовать для аутентификации скан отпечатка пальца. Эта вторая часть процесса аутентификации зависит от ваших настроенных сетевых и авторизационных протоколов.Опция поддерживается только для Azure SQL Database и Azure SQL Managed Instance. AZURE_ACTIVE_DIRECTORY_PASSWORD—Используется тип аутентификации по имени пользователя Azure Active Directory и паролю, заданных в параметрах Имя пользователя и Пароль. Имена пользователей могут иметь длину не более 30 символов.Опция поддерживается только для Azure SQL Database и Azure SQL Managed Instance. SERVICE_AUTHENTICATION—При подключении к Google BigQuery будет использован тип аутентификации сервиса. См. Документацию Google BigQuery, посвященную аутентификации для дополнительной информации. STANDARD—При подключении к Amazon Redshift будет использован стандарный тип аутентификации. Изучите Руководство по установке и настройке ODBC Data Connector Amazon Redshift для получения информации о стандартной аутентификации. USER—Будет использован метод аутентификации, требующий указания имени пользователя и пароля при подключении к Snowflake. USER_AUTHENTICATION—При подключении к Google BigQuery будет использован тип аутентификации пользователя. См. Документацию Google BigQuery, посвященную аутентификации для дополнительной информации.	String
project_id (Дополнительный)	ID проекта для подключения к Google BigQuery.	String
default_dataset (Дополнительный)	Набор данных по умолчанию для подключения к Google BigQuery.	String
refresh_token (Дополнительный)	Значение для обновления тоекна. Этот параметр применяется только для подключения к Google BigQuery, если тип расширенной аутентификации - аутентификация пользователя.	String
key_file (Дополнительный)	Значение для ключевого файла. Этот параметр применяется только для подключения к Google BigQuery, если тип расширенной аутентификации - аутентификация на сервере.	String
role (Дополнительный)	Значение роли для подключения к облачному хранилищу данных. Этот параметр применяется, только при подключении к Snowflake.	String
warehouse (Дополнительный)	Значение хранилища для подключения. Этот параметр применяется, только при подключении к Snowflake.	String
advanced_options (Дополнительный)	Дополнительные опции для подключения. Дополнительная информация о подключении, специфичная для платформы облачного хранилища данных (Google BigQuery, Amazon Redshift или Snowflake) к которому вы подключаетесь. Указжите дополнительные опции, используя формат Option=<value>, разделенные точками с запятой. Например, option1=value1;option2=value2;. См. документацию по облачному хранилищу данных для информации о дополнительных опциях.	String

Производные выходные данные

Имя	Описание	Тип данных
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: Да