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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Платформа базы данных

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

  • SQL ServerПодключиться к Microsoft SQL Server или Microsoft Azure SQL Database.
  • OracleПодключиться к Oracle.
  • DB2Подключиться к IBM DB2 для Linux, UNIX или Windows.
  • PostgreSQLПодключиться к PostgreSQL.
  • TeradataПодключиться к Teradata Data Warehouse Appliance.
  • SAP HANAПодключиться к SAP HANA.
  • DamengПодключиться к Dameng.
String
Экземпляр

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

Это значение параметра зависит от выбранного значения параметра Платформа базы данных.

String
Аутентификация в базе данных.
(Дополнительный)

Указывает тип используемой аутентификации.

  • Аутентификация в базе данныхБудет использоваться аутентификация в базе данных. Использует внутреннее имя пользователя и пароль для подключения к базе данных. Вводить имя пользователя или пароль для создания подключения необязательно; но если этого не сделать, вам будет предложено ввести их при установлении подключения. Это значение по умолчанию
    Примечание:

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

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

Имя пользователя базы данных для подключения с использованием аутентификации в базе данных.

String
Пароль
(Дополнительный)

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

Encrypted String
База данных
(Дополнительный)

Имя базы данных, к которой вы будете подключаться. Этот параметр действителен только для платформ PostgreSQL и SQL Server.

String
Имя объекта набора данных
(Дополнительный)

Имя набора данных или объекта в базе данных, на который будет указывать строка подключения. Эта строка подключения может использоваться в качестве пути к указанному набору данных.

String
Тип данных
(Дополнительный)

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

String
Целевой набор классов объектов
(Дополнительный)

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

String
Схема (только базы геоданных пользовательской схемы Oracle)
(Дополнительный)

Пользовательская схема базы геоданных, к которой вы хотите подключиться. Инструмент определит наличие подключения к базе данных Oracle, которая содержит базу геоданных пользовательской схемы. Если база данных Oracle содержит пользовательскую схему, активируется этот параметр. В противном случае остается неактивным. По умолчанию этот параметр использует схему sde (master) базы геоданных.

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

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

ПодписьОписаниеТип данных
Строка CIMDATA-подключения

Строка CIMDATA-подключения

String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
ИмяОписаниеТип данных
database_platform

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

  • SQL_SERVERПодключиться к Microsoft SQL Server или Microsoft Azure SQL Database.
  • ORACLEПодключиться к Oracle.
  • DB2Подключиться к IBM DB2 для Linux, UNIX или Windows.
  • POSTGRESQLПодключиться к PostgreSQL.
  • TERADATAПодключиться к Teradata Data Warehouse Appliance.
  • SAP HANAПодключиться к SAP HANA.
  • DAMENGПодключиться к Dameng.
String
instance

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

Это значение параметра зависит от выбранного значения параметра Платформа базы данных.

String
account_authentication
(Дополнительный)

Указывает тип используемой аутентификации.

  • DATABASE_AUTHБудет использоваться аутентификация в базе данных. Использует внутреннее имя пользователя и пароль для подключения к базе данных. Вводить имя пользователя или пароль для создания подключения необязательно; но если этого не сделать, вам будет предложено ввести их при установлении подключения. Это значение по умолчанию
    Примечание:

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

  • OPERATING_SYSTEM_AUTHБудет использоваться аутентификация в операционной системе. Имя пользователя и пароль вводить не нужно. Подключение выполняется с именем пользователя и паролем, которые используются для входа в операционную систему. Если учетная запись, используемая для операционной системы, не является некорректной учетной записью базы геоданных, подключение не будет выполнено.
Boolean
username
(Дополнительный)

Имя пользователя базы данных для подключения с использованием аутентификации в базе данных.

String
password
(Дополнительный)

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

Encrypted String
database
(Дополнительный)

Имя базы данных, к которой вы будете подключаться. Этот параметр действителен только для платформ PostgreSQL и SQL Server.

String
object_name
(Дополнительный)

Имя набора данных или объекта в базе данных, на который будет указывать строка подключения. Эта строка подключения может использоваться в качестве пути к указанному набору данных.

String
data_type
(Дополнительный)

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

String
feature_dataset
(Дополнительный)

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

String
schema
(Дополнительный)

Пользовательская схема базы геоданных, к которой вы хотите подключиться. Этот параметр действителен только для баз данных Oracle, которые содержат хотя бы одну базу геоданных пользовательской схемы. По умолчанию этот параметр использует схему sde (master) базы геоданных.

String
version_type
(Дополнительный)

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

  • TRANSACTIONALПодключение к транзакционной версии. Если выбрано значение Транзакционная, параметр Будет использоваться следующая версия будет заполнен списком транзакционных версий. Параметр Дата и время будет неактивным. Это значение используется по умолчанию.
  • HISTORICALПодключить, используя исторический маркер. Если выбрано значение Историческая, параметр Будет использоваться следующая версия будет заполнен списком исторических маркеров даты и времени. Параметр Дата и время будет неактивным.
  • POINT_IN_TIMEПодключение к конкретной точке во времени. Если выбрано значение Точка во времени, параметр Будет использоваться следующая версия будет неактивным. Параметр Дата и время станет активным.
  • BRANCHПодключение к версии ветви по умолчанию.

Примечание:

Если выбрано значение Историческая, и в параметре имени версии не указано имя, будет использована транзакционная версия по умолчанию. Если выбрано значение Точка во времени, и в параметре Дата и время не указана дата, будет использована транзакционная версия по умолчанию Default.

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

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

ИмяОписаниеТип данных
out_connection_string

Строка CIMDATA-подключения

String

Пример кода

CreateDatabaseConnectionString, пример (окно Python)

В следующем скрипте окна Python показано, как используется функция CreateDatabaseConnectionString в режиме прямого запуска.

import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb", 
                                          "",
                                          "gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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