Подключение к SAP HANA из ArcGIS

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

Примечание:

Клиенты SAP HANA доступны для существующих пользователей SAP на SAP Support Portal в разделе Software Downloads.

После настройки клиента ODBC на всех клиентских компьютерах ArcGIS, создайте файл подключения к базе данных. Для публикации веб-сервисов ArcGIS Server, ссылающихся на данные в вашей базе данных SAP HANA, зарегистрируйте файл подключения к базе данных с сайтами ArcGIS Server.

Установка и настройка клиента SAP HANA

Загрузите поддерживаемый 64-разрядный клиент SAP HANA с SAP Support Portal из раздела Software Downloads и установите его на все компьютеры с ArcGIS Pro и компьютеры в сайтах ArcGIS Server, с которых вы будете регистрировать подключение к базе данных SAP HANA.

Для установки и настройки клиента ODBC следуйте инструкциям, предоставленным SAP HANA.

Подключение из ArcGIS Pro

Для подключения из проекта ArcGIS Pro к SAP HANA установите драйвер SAP HANA клиента ODBC для на компьютер с ArcGIS Pro и создайте подключение к базе данных.

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

Можно использовать имя сервера SAP HANA и номер порта SQL для подключения к базе данных, если для вашего сайта справедливо следующее:

  • Вы подключаетесь к локальной установке SAP HANA.
  • Вы подключаетесь с помощью общей версии ArcGIS Pro.
  • Число символов имени сервера SAP HANA и номера порта SQL вашего сервера SAP HANA менее 31.

Если какое-либо из вышеперечисленных условий не выполняется, вы должны настроить имя системного источника данных (DSN) для драйвера клиента ODBC SAP HANA, прежде чем выполнять следующие шаги для подключения к базе данных. Инструкции по настройке имени источника данных см. в документации SAP HANA.

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

Диалоговое окно Подключение базы данных

  1. Откройте панель Каталог в ArcGIS Pro.
  2. Щелкните правой кнопкой мыши Базы данных или папку в разделе Папки и выберите Новое подключение к базе данных.
  3. Из ниспадающего списка Платформа базы данных выберите SAP HANA2.
  4. В текстовом окне Источник данных выполните одно из следующих действий:
    • Имя сервера SAP HANA и номер порта SQL, используемые для коммуникации с базой данных, разделенные двоеточием (:). Например, если полное имя вашего сервера SAP HANA - myserver.network.com, и SAP HANA работает по порту 98765, введите myserver.network.com:98765. Или, задайте номер порта в разделе Дополнительные параметры. (См. шаг 9 ниже.)
    • Имя источника данных, настроенное для драйвера ODBC.
  5. Используйте аутентификацию базы данных в качестве типа проверки подлинности.

    Аутентификация средствами ОС не поддерживается.

  6. Укажите действующее имя пользователя и пароль в текстовых полях Имя пользователя и Пароль.
  7. Снимите отметку с опции Сохранять имя пользователя и пароль, если вы предпочитаете не сохранять свои данные для входа в части соединения.

    Такие действия помогут обеспечить безопасность базы данных. Однако в этом случае при каждом подключении к ArcGIS Pro вы должны будете вводить имя пользователя и пароль.

    Примечание:

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

  8. Введите имя для файла подключения в поле Имя файла подключения.

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

    Это имя, которое будет отображаться на панели и в виде Каталог, а также имя файла .sde, хранящегося на диске.

  9. При необходимости разверните раздел Дополнительные параметры, чтобы ввести параметр и значение для подключения.

    См. документацию SAP HANA для получения информации о дополнительных параметрах подключения.

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

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

  11. Нажмите ОК, чтобы создать файл подключения.

Подключение к базе данных появляется в разделе Базы данных на панели Каталог, а файл подключения (.sde) создается в директории проекта ArcGIS Pro.

Подключение из ArcGIS Server

Чтобы опубликовать данные SAP HANA на интегрированный или автономный сайт ArcGIS Server и сохранить данные в SAP HANA, установите 64-битный клиент SAP HANA драйвера ODBC на каждом компьютере сайта ArcGIS Server и зарегистрируйте файл подключения на этом сайте. Следуйте инструкциям к вашей ОС, на которой установлен ArcGIS Server.

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

Установите SAP HANA на компьютерах с ArcGIS Server (Microsoft Windows)

Загрузите драйвер ODBC клиента SAP HANA и установите его на всех компьютерах сайта ArcGIS Server.

Установите драйвер ODBC клиента SAP HANA на каждом компьютере с ArcGIS Server Windows.

  1. Загрузите поддерживаемый 64-разрядный клиент SAP HANA из SAP Support Portal и установите его на каждом компьютере сайта ArcGIS Server.
  2. Добавьте директорию установки клиента SAP HANA в системную переменную среды Windows PATH.

    Например, если вы установили драйвер ODBC клиента SAP HANA в папку C:\Program Files\sap\hdbclient, добавьте этот путь к переменной PATH.

Поле установки драйвера ODBC клиента SAP HANA можно выполнить регистрацию подключения к базе данных на вашем сайте ArcGIS Server. Если выполнены следующие условия, вам тем не менее нужно настроить имя источника данных для драйвера ODBC перед регистрацией подключения.

  • Вы используете SAP HANA 1.0 (любой поддерживаемый пакет обновлений).
  • Вы подключаетесь к SAP HANA Cloud.
  • Вы подключаетесь к базе данных из ArcGIS Server версии 10.6 или ранее.
  • Число символов имени сервера SAP HANA и номера порта SQL вашего сервера SAP HANA менее 31.

Настройка имени источника данных ODBC на Windows (если необходимо)

Если вам требуется имя источника данных, выполните следующие действия для задания системного имени источника данных (DSN) для драйвера ODBC клиента SAP HANA на каждом из компьютеров ArcGIS Server Windows:

Примечание:

Используйте это имя источника данных при подключении к базе данных из ArcGIS. Используйте то же имя при настройке всех клиентов ODBC SAP HANA, подключающихся к этой же базе данных. Например, используйте то же имя источника данных, когда настраиваете драйвер клиента ODBC SAP HANA на компьютерах с ArcGIS Pro, которое использовали при настройке имени источника данных для драйвера ODBC на компьютерах с ArcGIS Server. Если вы не будете использовать то же имя, при публикации возникнут проблемы, поскольку ArcGIS сравнивает строки подключения данных, которые публикуются, и регистрируемой базы данных.

  1. Откройте ODBC Data Source Administrator (64-разрядный).
  2. Щелкните вкладку System DSN в ODBC Data Source Administrator (64 bit) и выберите Добавить.

    Откроется диалоговое окно Создать новый источник данных.

  3. Выберите клиент ODBC SAP HANA и щелкните Завершить.
  4. Введите Имя источника данных, Описание и Server:Port вашей базы данных.
  5. В разделе TLS/SSL отметьте Подключение к базе данных с помощью TLS/SSL и Проверка сертификата TLS/SSL.
  6. Откройте диалоговое окно ODBC Setup и добавьте в раздел Special property ключ SPATIALTYPES=1. Щелкните OK, чтобы применить изменения и закрыть диалоговое окно Расширенные настройки ODBC.

    Примечание:

    Этот шаг можно пропустить при использовании ArcGIS Server с поддерживаемой версией SAP HANA 2.0 или позднее.

  7. Щелкните OK в окне настройки клиента ODBC и ODBC Data Source Administrator, чтобы закрыть их.

Установите SAP HANA на компьютерах с ArcGIS Server (Linux)

Установка драйвера ODBC клиента SAP HANA. Разместите клиент на каждом компьютере сайта ArcGIS Server, и установите его и отредактируйте скрипт ArcGIS Server init_user_param.sh на каждом компьютере ArcGIS Server Linux.

  1. Загрузите поддерживаемый 64-разрядный клиент SAP HANA из SAP Support Portal и установите его на каждом компьютере сайта ArcGIS Server.
  2. Установите менеджер ODBC Linux на каждом компьютере ArcGIS Server, если это еще не сделано.
  3. После установки файлов клиента базы данных измените скрипт init_user_param.sh, установленный с ArcGIS Server, чтобы он содержал ссылки на файлы клиента. Этот скрипт находится в директории <ArcGIS Server installation directory>/arcgis/server/usr.

    Вы должны обновить init_user_param.sh на каждом компьютере сайта ArcGIS Server.

  4. Убедитесь, что у владельца установки ArcGIS Server на каждом компьютере есть права доступа к библиотекам клиента базы данных как минимум для чтения и выполнения.
  5. В текстовом редакторе откройте скрипт init_user_param.sh.
  6. Удалите символы комментариев (#) из этих строк, которые начинаются с export и замените информацию <SAPHANA_InstallDir> на путь к папке, где вы установили клиент SAP HANA:

    # -----------------------------------------------------------------------
    # Modify this section to configure a connection to SAP HANA.
    #
    # To make a connection, name the SAP HANA ODBC configuration files as .odbcinst.ini
    # and .odbc.ini and store them in the ArcGIS Server user $HOME directory.
    #
    # -----------------------------------------------------------------------
    export SAPHANADIR=<SAPHANA_InstallDir>/sap/hdbclient
    export LD_LIBRARY_PATH=$SAPHANADIR:$LD_LIBRARY_PATH

  7. Сохраните и закройте скрипт.
  8. Чтобы внесенные вами в файл init_user_param.sh изменения сохранились, нужно перезапустить ArcGIS Server.

    Вы можете сделать это, запустив скрипт stopserver.sh, а затем скрипт startserver.sh на каждом компьютере вашего сайта ArcGIS Server.

    ./stopserver.sh

    ./startserver.sh

После того, как клиент SAP HANA драйвера ODBC будет установлен, вы можете создать подключение базы данных и зарегистрировать его на сайте ArcGIS Server. Если выполнены следующие условия, вам тем не менее нужно настроить имя источника данных для драйвера ODBC перед созданием и регистрацией подключения.

  • Вы используете SAP HANA 1.0 (любой поддерживаемый пакет обновлений).
  • Вы подключаетесь к SAP HANA Cloud.
  • Вы подключаетесь к базе данных из ArcGIS Server версии 10.6 или ранее.
  • Число символов имени сервера SAP HANA и номера порта SQL вашего сервера SAP HANA менее 31.

Настройка имени источника данных ODBC на Linux (если необходимо)

Если вам требуется имя источника данных, выполните следующие действия для задания системного имени источника данных для драйвера ODBC клиента SAP HANA на каждом из компьютеров ArcGIS Server Linux:

Примечание:

Используйте то же имя источника данных ODBC при настройке всех клиентов ODBC SAP HANA, подключающихся к этой же базе данных. Например, при настройке имени источника данных для драйвера ODBC на компьютерах с ArcGIS Pro, задайте то же имя источника данных для драйвера ODBC клиента SAP HANA на всех компьютерах с ArcGIS Server. Если вы не будете использовать то же имя, при публикации возникнут проблемы, поскольку ArcGIS сравнивает строки подключения данных, которые публикуются, и регистрируемой базы данных.

  1. Чтобы задать имя источника данных ODBC, отредактируйте файлы подключения ODBC SAP HANA, .odbc.ini и .odbcinst.ini.

    Файлы должны называться .odbc.ini и .odbcinst.ini.

  2. Откройте файл .odbc.ini в текстовом редакторе и укажите информацию, необходимую для подключения к базе данных.

    Убедитесь, что в файле .odbc.ini вокруг знаков равенства (=) отсутствуют пробелы.

    Например, в этой строке вокруг знаков равенства пробелов нет. Запись SPATIALTYPES=1 включена. Эта запись не требуется для подключения к поддерживаемым версиям SAP HANA 2.0 или более новым выпускам.

    [<HANA_DNS>]
    Driver=/<usr>/sap/hdbclient/libodbcHDB.so
    Description=SAP Hana ODBC
    ServerNode=<HANA_Server_IP>:<SAP_HANA_port>
    UID=<user_name>
    Password=<user_password>
    SPATIALTYPES=1
    
    [ODBC]
    IANAAppCodePage=4
    InstallDir=/<usr>/sap/hdbclient
    Trace=0
    TraceDll=/opt/odbc64v51/lib/odbctrac.so
    TraceFile=/tmp/odbctrace.out
    UseCursorLib=0

  3. Чтобы подключиться к SAP HANA Cloud, используйте шифрованное подключение, для этого необходимо, чтобы каждый компьютер сайта ArcGIS Server имел возможность ссылаться на файл DigiCertGlobalRootCA.crt.pem для проверки Certificate Authority (CA), которым подписан сертификат SAP HANA Cloud. Загрузите этот файл с портала SAP Help и разместите его в папке на каждом компьютере сайта. Задайте Encrypt=Yes и установите для параметра sslTrustStore одно из следующего:
    • Укажите местоположение файла DigiCertGlobalRootCA.crt.pem на локальном компьютере, как показано в следующей строке:
      [<HANA_DNS>]
      Driver=/<usr>/sap/hdbclient/libodbcHDB.so
      Description=SAP Hana ODBC
      ServerNode=<HANA_Server_IP>:<SAP_HANA_port>
      UID=<user_name>
      Password=<user_password>
      ENCRYPT=Yes
      sslTrustStore=<path to DigiCertGlobalRootCA.crt.pem>
      
      [ODBC]
      IANAAppCodePage=4
      InstallDir=/<usr>/sap/hdbclient
      Trace=0
      TraceDll=/opt/odbc64v51/lib/odbctrac.so
      TraceFile=/tmp/odbctrace.out
      UseCursorLib=0
    • Укажите строку сертификата из файла DigiCertGlobalRootCA.crt.pem. Откройте файл DigiCertGlobalRootCA.crt.pem, скопируйте его содержание и вставьте его между нотациями BEGIN CERTIFCATE и END CERTIFCATE в файле .odbc.ini, как показано ниже:
      [<HANA_DNS>]
      Driver=/<usr>/sap/hdbclient/libodbcHDB.so
      Description=SAP Hana ODBC
      ServerNode=<HANA_Server_IP>:<SAP_HANA_port>
      UID=<user_name>
      Password=<user_password>
      ENCRYPT=Yes
      sslTrustStore=-----BEGIN CERTIFICATE-----<contents of the DigiCertGlobalRootCA.crt.pem file>-----END CERTIFICATE-----
      
      [ODBC]
      IANAAppCodePage=4
      InstallDir=/<usr>/sap/hdbclient
      Trace=0
      TraceDll=/opt/odbc64v51/lib/odbctrac.so
      TraceFile=/tmp/odbctrace.out
      UseCursorLib=0
  4. Сохраните и закройте файл .odbc.ini.
  5. Откройте файл .odbcinst.ini и отредактируйте его, указав путь к драйверу ODBC.

    В файле .odbcinst.ini такие пробелы не требуются, как показано в этом примере:

    Description  =SAP HANA ODBC
    Driver64         = /<usr>/sap/hdbclient/libodbcHDB.so

  6. Сохраните и закройте файл .odbcinst.ini.

Подключение к базе данных

Вы можете использовать диалоговое окно Подключение базы данных в ArcGIS Pro для подключения к базе данных, как это описано выше.

Либо вы можете запустить инструмент Создать подключение базы данных в ArcGIS Pro, либо использоватьPython для запуска команды Create Database Connection с компьютера ArcGIS Server для создания файла подключения базы данных (.sde), который подключается к базе данных.

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

Регистрация базы данных

Для публикации веб-сервисов, используя данные SAP HANA, создайте подключение к базе данных и зарегистрируйте его на ваших сайтах ArcGIS Server.

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