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

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

Инструмент Создать подключение базы данных создает файл, который 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-compatible edition), 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

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-compatible edition), 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: Да

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