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

Сводка

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

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

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

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

Синтаксис

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
ParameterОбъяснениеТип данных
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.
  • INFORMIXПодключиться к IBM Informix.
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

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

NameОбъяснениеТип данных
out_connection_string

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

Строковое

Пример кода

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

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