Подключение к 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.

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

В следующих шагах описано использование диалогового окна Подключение базы геоданных для подключения к 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.
    • Имя источника данных, настроенное для драйвера ODBC.
  5. Выберите Аутентификация базы данных в разделе Тип аутентификации.

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

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

    Примечание:

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

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

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

Вы можете переименовать файл, указав новое имя на панели Каталог и нажав Enter.

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

Если какое-то из условий соблюдено, необходимо настроить системное имя источника данных (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-битный клиент 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 или добавления элемента хранилища данных на портал.