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

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

Создает файл, который 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

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: Да

Связанные разделы