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

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

Примечание:

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

Установите 32- и 64-разрядные приложения и клиенты на различные компьютеры, чтобы избежать проблем, связанных с различными версиями одних и тех же драйверов на одном компьютере.

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

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

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

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

Выполните следующие действия для загрузки драйвера ODBC клиента SAP HANA и настройте переменную path на клиентском компьютере:

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

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

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

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

  • Версия вашей базы данных SAP HANA является поддерживаемой - 2.0 SPS2 и позднее.
  • Вы подключаетесь к локальной установке SAP HANA.
  • Вы подключаетесь из ArcGIS Pro версии 2.2 или позднее.
  • Число символов имени сервера SAP HANA и номера порта SQL вашего сервера SAP HANA менее 31.

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

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

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

    Примечание:

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

  7. Нажмите OK для подключения.

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

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

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

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

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

  1. Откройте на своем клиентском компьютере ODBC Data Source Administrator (64 bit).

    Примечание:

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

  2. Щелкните вкладку System DSN в ODBC Data Source Administrator (64 bit) и выберите Добавить.
  3. Выберите клиент ODBC SAP HANA и щелкните Завершить.
  4. Введите имя, описание и номер порта SQL для источника данных.
  5. В разделе TLS/SSL отметьте Подключение к базе данных с помощью TLS/SSL и Проверка сертификата TLS/SSL.
  6. Откройте расширенные настройки клиента ODBC, добавьте свойство SPATIALTYPES и задайте для него значение 1.

    Примечание:

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

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

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

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

После настройки компьютеров сайта ArcGIS Server, создайте подключение к базе данных и зарегистрируйте файл подключения на сайте 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.

  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

Поле установки драйвера ODBC клиента SAP HANA можно выполнить регистрацию подключения к базе данных на вашем сайте 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.

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

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