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

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Местоположение файла подключения	Путь к папке, где будет храниться файл подключения к базе данных (.sde).	Folder
Имя файла подключения	Имя файла подключения к базе данных. Выходной файл будет иметь расширение .sde.	String
Платформа базы данных	Определяет платформу системы управления базы данных, к которой будет выполнено подключение. Существует несколько возможных опций: Dameng—Подключение к Dameng. Db2—Подключение к IBM Db2 для Linux, UNIX или Windows. Oracle—Подключение к Oracle, Amazon Relational Database Service (RDS) for Oracle или Autonomous Transaction Processing database in Oracle Cloud. PostgreSQL—Подключение к PostgreSQL, Amazon Aurora PostgreSQL, Amazon Relational Database Service (RDS) for PostgreSQL или Microsoft Azure Database for PostgreSQL. Teradata—Подключение к Teradata Data Warehouse Appliance. SAP HANA—Подключение к SAP HANA или SAP HANA Cloud. SQL Server—Подключение к Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance или Amazon Relational Database Service (RDS) for SQL Server.	String
Экземпляр	Сервер базы данных или экземпляр, к которому вы подключаетесь. Значение, выбранное из ниспадающего меню Платформа базы данных, определяет тип базы данных, к которой вы хотите подключиться. Указываемая информация для параметра Экземпляр может варьироваться в зависимости от выбранного типа подключения. Ниже смотрите информацию о том, что необходимо предоставить для каждой из платформ базы данных. Dameng – имя сервера, на котором установлена база данных Dameng Db2 – имя каталогизированной базы данных Db2 Oracle – имя TNS или строка Oracle Easy Connection для подключения к базе данных или сервису базы данных Oracle PostgreSQL – имя сервера, на котором установлен PostgreSQL, или имя экземпляра сервиса базы данных PostgreSQL SAP HANA – имя источника данных ODBC для базы данных или сервиса базы данных SAP HANA SQL Server – имя экземпляра базы данных SQL Server или имя экземпляра сервиса базы данных. Teradata – имя источника данных ODBC для базы данных Teradata	String
Аутентификация в базе данных. (Дополнительный)	Указывает тип используемой аутентификации. Аутентификация в базе данных—Будет использоваться аутентификация в базе данных. Для подключения к базе данных будет использоваться внутреннее имя пользователя базы данных и пароль. Вводить имя пользователя или пароль для создания подключения необязательно; но если этого не сделать, вам будет предложено ввести их при установлении подключения. Примечание: Если создаваемый файл подключения обеспечивает сервисам ArcGIS доступ к базе данных или базе геоданных, или, если вы хотите использовать Каталог для поиска данных, доступных через этот файл подключения, необходимо указать имя пользователя и пароль. Аутентификация средствами операционной системы—Будет использоваться аутентификация в операционной системе. Имя пользователя и пароль вводить не нужно. Подключение выполняется с именем пользователя и паролем, которые используются для входа в операционную систему. Если учетная запись, используемая для операционной системы, не является некорректной учетной записью базы геоданных, подключение не будет выполнено.	Boolean
Имя пользователя (Дополнительный)	Имя пользователя базы данных , которое будет использоваться для аутентификации базы данных.	String
Пароль (Дополнительный)	Пароль пользователя базы данных , который будет использоваться для аутентификации базы данных.	Encrypted String
Сохранить имя пользователя и пароль (Дополнительный)	Указывает, будут ли сохранены имя пользователя и пароль. Отмечено – имя пользователя и пароль будут сохранены в файле подключения. Это значение по умолчанию Если создаваемый файл подключения будет обеспечивать сервисам ArcGIS доступ к базе геоданных, надо сохранить имя пользователя и пароль. Не отмечено – имя пользователя и пароль не будут сохранены в файле подключения. При каждой попытке подключиться с помощью файла будет отображаться запрос на ввод имени пользователя и пароля.	Boolean
База данных (Дополнительный)	Имя базы данных, к которой будет выполнено подключение. Этот параметр применяется только для платформ PostgreSQL и 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

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

Подпись	Описание	Тип данных
Выходная рабочая область	Выходной файл подключения базы данных (.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})

Имя	Описание	Тип данных
out_folder_path	Путь к папке, где будет храниться файл подключения к базе данных (.sde).	Folder
out_name	Имя файла подключения к базе данных. Выходной файл будет иметь расширение .sde.	String
database_platform	Определяет платформу системы управления базы данных, к которой будет выполнено подключение. Существует несколько возможных опций: DAMENG—Подключение к Dameng. DB2—Подключение к IBM Db2 для Linux, UNIX или Windows. ORACLE—Подключение к Oracle, Amazon Relational Database Service (RDS) for Oracle или Autonomous Transaction Processing database in Oracle Cloud. POSTGRESQL—Подключение к PostgreSQL, Amazon Aurora PostgreSQL, Amazon Relational Database Service (RDS) for PostgreSQL или Microsoft Azure Database for PostgreSQL. SAP HANA—Подключение к SAP HANA или SAP HANA Cloud. SQL_SERVER—Подключение к Microsoft SQL Server, Microsoft Azure SQL Database, Microsoft Azure SQL Managed Instance или Amazon Relational Database Service (RDS) for SQL Server. TERADATA—Подключение к Teradata Data Warehouse Appliance.	String
instance	Сервер базы данных или экземпляр, к которому вы подключаетесь. Значение, указанное для параметра database_platform, определяет тип базы данных, к которой выполняется подключение. Информация для параметра instance может варьироваться в зависимости от указанной платформы базы данных. Ниже смотрите информацию о том, что необходимо предоставить для каждой из платформ базы данных. Dameng – имя сервера, на котором установлена база данных Dameng Db2 – имя каталогизированной базы данных Db2 Oracle – имя TNS или строка Oracle Easy Connection для подключения к базе данных или сервису базы данных Oracle PostgreSQL – имя сервера, на котором установлен PostgreSQL, или имя экземпляра сервиса базы данных PostgreSQL SAP HANA – имя источника данных ODBC для базы данных или сервиса базы данных SAP HANA 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 и 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

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

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