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

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

Инструмент Создать подключение базы данных создает файл, который 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. PostgreSQL—Подключитесь к PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Microsoft Azure Database for PostgreSQL или Google Cloud SQL for PostgreSQL. Teradata—Подключение к Teradata Vantage. 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 или Google Cloud SQL 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. POSTGRESQL—Подключитесь к PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL, Microsoft Azure Database for PostgreSQL или Google Cloud SQL 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 или 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 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: Да