ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Справка
  • Sign Out
ArcGIS Desktop

ArcGIS Online

Картографическая платформа вашей организации

ArcGIS Desktop

Полноценная профессиональная ГИС

ArcGIS Enterprise

ГИС предприятия

ArcGIS Developers

Инструменты для встраивания приложений с местоположениями

ArcGIS Solutions

Бесплатные шаблоны карт и приложений для отрасли

ArcGIS Marketplace

Получение приложения и данных для вашей организации.

  • Документация
  • Поддержка
Esri
  • Войти
user
  • Мой профиль
  • Выход

ArcMap

  • На главную
  • Начало работы
  • Карта
  • Анализ
  • Управление данными
  • Инструменты
  • Дополнительные модули

Создать подключение базы данных

  • Сводка
  • Использование
  • Синтаксис
  • Пример кода
  • Параметры среды
  • Информация о лицензиях

Сводка

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

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

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

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

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

Синтаксис

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.
  • DB2ZOS —Подключение к IBM Db2 для операционной системы z.
  • INFORMIX —Подключение к IBM Informix.
  • ORACLE —Подключение к Oracle или Amazon Relational Database Service (RDS) for Oracle.
  • POSTGRESQL —Подключение к PostgreSQL, Amazon Aurora (PostgreSQL-compatible edition), Amazon Relational Database Service (RDS) for PostgreSQL или Microsoft Azure Database for PostgreSQL.
  • SAP HANA —Подключение к SAP HANA.
  • 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
  • Db2 для Z/OS – имя каталогизированной базы данных Db2
  • Informix – имя источника данных ODBC для базы данных Informix
  • 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 —Подключение к транзакционной версии.
  • HISTORICAL —Подключить, используя исторический маркер.
  • POINT_IN_TIME —Подключение к конкретной точке во времени. Если используется POINT_IN_TIME, параметр version будет игнорироваться.

Примечание:

Если используется 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: Да

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

  • Обзор группы инструментов Рабочая область

ArcGIS Desktop

  • На главную
  • Документация
  • Поддержка

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

Об Esri

  • О нас
  • Карьера
  • Блог Esri
  • Конференция пользователей
  • Саммит разработчиков
Esri
Расскажите нам, что вы думаете.
Copyright © 2021 Esri. | Конфиденциальность | Правовая информация