ArcMap

Se connecter à SAP HANA depuis ArcGIS

Pour vous connecter à une base de données SAP HANA à partir de clients ArcGIS, installez et configurez le pilote ODBC du client SAP HANA sur les machines clientes ArcGIS.

Une fois le Pilote ODBC configuré sur tous vos ordinateurs clients ArcGIS, créez un fichier de connexion à une base de données. Pour publier les services Web de ArcGIS Server qui référencent les données de votre base de données SAP HANA, enregistrez le fichier de connexion à la base de données avec vos sites ArcGIS Server.

Connexion à partir d'ArcMap

Pour vous connecter depuis ArcMap à SAP HANA, installez et configurez le pilote ODBC du client SAP HANA sur toutes les machines ArcMap et créez une connexion depuis ArcMap vers la base de données.

Installer le pilote ODBC du client SAP HANA

Procédez comme suit pour télécharger le pilote ODBC du client SAP HANA et configurez la variable du chemin sur votre machine client.

  1. Téléchargez un client SAP HANA 32 bits pris en charge depuis le portail de support SAP, et installez-le sur chaque machine ArcMap.
  2. Ajoutez le répertoire d’installation du client SAP HANA dans la variable d’environnement PATH du système Microsoft Windows.

    Par exemple, si vous avez installé le pilote ODBC du client SAP HANA dans C:\Program Files\sap\hdbclient, ajoutez ce chemin à la variable d’environnement PATH.

Connexion à la base de données

Vous pouvez utiliser le nom de serveur SAP HANA et le numéro de port SQL pour vous connecter à la base de données si toutes les conditions suivantes sont exactes pour votre site :

  • Votre base de données SAP HANA est une version compatible, 2.0 SPS2 ou version ultérieure.
  • Vous vous connectez à une installation sur site de SAP HANA.
  • Vous vous connectez depuis ArcGIS Desktop 10.6.1 ou une version ultérieure.
  • Le nombre de caractères dans le nom de serveur SAP HANA et le numéro du port SQL de votre serveur SAP HANA est inférieur à 31.

Si une des conditions ci-dessus n’est pas satisfaite, vous devez configurer un nom de source de données du système pour le pilote ODBC du client SAP HANA avant de procéder comme suit pour vous connecter depuis ArcMap.

Ajoutez une connexion à la base de données à l’aide de la boîte de dialogue Database Connection (Connexion à la base de données) ou de l’outil de géotraitement Créer une connexion à la base de données. La procédure suivante présente l’utilisation de la boîte de dialogue Database Connection (Connexion à la base de données) :

  1. Développez le nœud Connexions aux bases de données dans l'arborescence du Catalogue d'ArcMap ou d'ArcCatalog et double-cliquez sur Ajouter une connexion à une base de données.
  2. Sélectionnez SAP HANA dans la liste déroulante Plateforme de la base de données.
  3. Dans la zone de texte Data source (Source de données), saisissez un des éléments suivants :
    • Le nom de serveur SAP HANA et le numéro de port SQL utilisé pour communiquer avec la base de données séparés par deux points (:). Par exemple, si le nom entier de votre serveur SAP HANA est myserver.network.com et si SAP HANA communique via le port 98765, saisissez myserver.network.com:98765.
    • Le nom de la source des données que vous avez configurée pour le pilote ODBC.
  4. Sélectionnez Authentification de la base de données comme Type d'authentification.
  5. Saisissez un nom d'utilisateur et un mot de passe valides dans les zones de texte Nom d'utilisateur et Mot de passe.
  6. Si vous préférez ne pas enregistrer vos informations de connexion dans le cadre de votre connexion, décochez la case Enregistrer le nom et le mot de passe de l'utilisateur ; ce faisant, vous préservez la sécurité de la base de données. Toutefois, si vous procédez ainsi, vous êtes invité à fournir un nom d’utilisateur et un mot de passe à chaque fois que vous vous connectez à partir d’un client de bureau.

  7. Cliquez sur OK pour vous connecter.

Un fichier est créé dans \\<computer_name>\Users\<user_name>\AppData\Roaming\ESRI\Desktop<release#>\ArcCatalog.

Vous pouvez transférer la connexion vers un autre emplacement, mais veillez à ce que les utilisateurs et les applications qui doivent établir une connexion disposent d'un accès en lecture sur le répertoire dans lequel se trouve le fichier de connexion.

Si vous utilisez les données de cette connexion comme source pour un service, tel qu'un service de géotraitement ou de géocodage, il vous faudra peut-être placer le fichier de connexion dans un emplacement partagé sur votre réseau. Reportez-vous à la rubrique Rendre vos données accessibles dans ArcGIS Server pour en savoir plus sur le partage d'un fichier de connexion.

Configurez un nom de source de données (le cas échéant)

Si aucune des conditions suivantes n’est vérifiée, vous devez configurer un nom de source de données pour le pilote ODBC du client SAP HANA avant de vous connecter à la base de données :

  • Vous utilisez SAP HANA 1.0 (toute version de pack de services prise en charge).
  • Vous vous connectez à SAP HANA Cloud.
  • Vous vous connectez depuis ArcGIS Desktop 10.6 ou une version antérieure.
  • Le nombre de caractères dans le nom de serveur SAP HANA et le numéro du port SQL de votre serveur SAP HANA est supérieur à 31.

Si ces conditions ne sont pas réunies sur votre site, vous pouvez encore configurer un nom de source de données pour vous connecter à SAP HANA, mais cela n’est pas requis.

Procédez comme suit pour configurer un nom de source de données pour votre base de données SAP HANA :

  1. Ouvrez l’administrateur de source de données ODBC (32 bits) sur votre machine client.

  2. Cliquez sur l'onglet DSN système dans l'administrateur de la source des données ODBC (64 bits) et cliquez sur Ajouter.
  3. Sélectionnez le client ODBC SAP HANA et cliquez sur Finish (Terminer).
  4. Renseignez un nom, une description et un numéro de port SQL pour la source de données.
  5. Dans la section TLS/SSL, cochez Connect to the database using TLS/SSL (Connexion à la base de données à l’aide de TLS/SSL) et Validate the TLS/SSL certificate (Valider le certificat TLS/SSL).
  6. Cliquez sur OK sur la configuration du client ODBC et l'administrateur de la source des données ODBC pour les fermer.

Connexion à partir d'ArcGIS Server

Si vous souhaitez publier des données SAP HANA sur un site ArcGIS Server fédéré ou autonome et souhaitez que les services obtenus utilisent les données dans SAP HANA, installez un pilote ODBC du client SAP HANA 64 bits sur chaque machine du site ArcGIS Server. Suivez les instructions correspondant au système d’exploitation sur lequel ArcGIS Server est installé.

Une fois que vous avez configuré les machines sur le site ArcGIS Server, créez une connexion à votre base de données et enregistrez le fichier de connexion avec votre site ArcGIS Server.

Installer le SAP HANA sur les machines ArcGIS Server (Microsoft Windows)

Téléchargez le pilote ODBC du client SAP HANA et installez-le sur chaque machine du site ArcGIS Server.

Installez le pilote ODBC du client SAP HANA sur chaque machine ArcGIS Server Windows :

  1. Téléchargez un client SAP HANA 64 bits pris en charge à partir du portail de support SAP et installez-le sur chaque machine du site ArcGIS Server.
  2. Ajoutez le répertoire d’installation du client SAP HANA dans la variable d’environnement PATH du système Windows.

    Par exemple, si vous avez installé le pilote ODBC du client SAP HANA dans C:\Program Files\sap\hdbclient, ajoutez ce chemin à la variable d’environnement PATH.

Une fois que le pilote ODBC du client SAP HANA est installé, vous pouvez poursuivre avec l’enregistrement d’une connexion à une base de données avec votre site ArcGIS Server. Si les conditions suivantes existent, cependant, vous devez configurer un nom de source de données pour le pilote ODBC avant d’enregistrer une connexion de base de données.

  • Vous utilisez SAP HANA 1.0 (toute version de pack de services prise en charge).
  • Vous vous connectez à SAP HANA Cloud.
  • Vous vous connectez à la base de données depuis ArcGIS Server 10.6 ou une version antérieure.
  • Le nombre de caractères dans le nom de serveur SAP HANA et le numéro du port SQL de votre serveur SAP HANA est supérieur à 31.

Configurez un nom de source de données ODBC sur Windows (le cas échéant)

Si vous avez besoin d’un nom de source de données, procédez comme suit pour configurer un nom de source de données de système pour le pilote ODBC du client SAP HANA sur chaque machine ArcGIS Server Windows :

  1. Ouvrez l’administrateur de source de données ODBC (64 bits).
  2. Cliquez sur l'onglet DSN système dans l'administrateur de la source des données ODBC (64 bits) et cliquez sur Ajouter.

    La boîte de dialogue Create New Data Source (Créer une source de données) s’affiche.

  3. Sélectionnez le client ODBC SAP HANA et cliquez sur Finish (Terminer).
  4. Complétez les informations des champs Nom de la source de données, Description, et Server:Port pour votre base de données.
  5. Dans la section TLS/SSL, cochez Connect to the database using TLS/SSL (Connexion à la base de données à l’aide de TLS/SSL) et Validate the TLS/SSL certificate (Valider le certificat TLS/SSL).
  6. Ouvrez la boîte de dialogue de configuration avancée ODBC et ajoutez la valeur de clé suivante dans la section Special property settings (Paramètres de propriété spécifiques) : SPATIALTYPES=1. Cliquez sur OK pour appliquer les modifications et fermez la boîte de dialogue ODBC Advanced Setup (Configuration avancée ODBC).

  7. Cliquez sur OK sur la configuration du client ODBC et l'administrateur de la source des données ODBC pour les fermer.

Installer le SAP HANA sur les machines ArcGIS Server (Linux)

Téléchargez le pilote ODBC du client SAP HANA. Placez le client sur chaque machine sur le site ArcGIS Server, installez-le et modifiez le script ArcGIS Server init_user_param.sh sur chaque machine ArcGIS Server Linux.

  1. Téléchargez un client SAP HANA 64 bits pris en charge à partir du portail de support SAP et installez-le sur chaque machine du site ArcGIS Server.
  2. Si ce n’est pas déjà fait, installez un gestionnaire de pilotes ODBC Linux sur chaque machine ArcGIS Server.

    3. Une fois les fichiers de clients de bases de données installés, modifiez le script init_user_param.sh installé avec ArcGIS Server pour référencer les fichiers de clients. Ce script est disponible dans le répertoire <ArcGIS Server installation directory>/arcgis/server/usr.

  3. Vérifiez que le propriétaire de l'installation ArcGIS Server sur chaque machine dispose au moins des autorisations de lecture et d'exécution sur les bibliothèques du client de la base de données.
  4. Ouvrez le script init_user_param.sh dans un éditeur de texte.
  5. Supprimez la marque de commentaire (#) de ces lignes et remplacez les informations <SAPHANA_InstallDir> par le chemin du répertoire dans lequel vous avez installé le client SAP HANA :

    export SAPHANADIR=<SAPHANA_InstallDir>/sap/hdbclient
export LD_LIBRARY_PATH==$SAPHANADIR:$LD_LIBRARY_PATH

  6. Enregistrez et fermez le script.
  7. Après avoir configuré init_user_param.sh sur chaque machine de votre site ArcGIS Server, exécutez le script startserver.sh pour redémarrer ArcGIS Server.

    ./startserver.sh

Une fois que le pilote ODBC du client SAP HANA est installé, vous pouvez poursuivre avec l’enregistrement d’une connexion à une base de données avec votre site ArcGIS Server. Si les conditions suivantes existent, cependant, vous devez configurer un nom de source de données pour le pilote ODBC avant d’enregistrer une connexion de base de données.

  • Vous utilisez SAP HANA 1.0 (toute version de pack de services prise en charge).
  • Vous vous connectez à SAP HANA Cloud.
  • Vous vous connectez à la base de données depuis ArcGIS Server 10.6 ou une version antérieure.
  • Le nombre de caractères dans le nom de serveur SAP HANA et le numéro du port SQL de votre serveur SAP HANA est supérieur à 31.

Configurez un nom de source de données ODBC sous Linux (le cas échéant)

Si vous avez besoin d’un nom de source de données, procédez comme suit pour configurer un nom de source de données de système pour le pilote ODBC du client SAP HANA sur chaque machine ArcGIS Server Linux :

  1. Pour configurer un nom de source de données ODBC, modifiez les fichiers de connexion ODBC SAP HANA, .odbc.ini et .odbcinst.ini.

    Les fichiers doivent s'intituler .odbc.ini et .odbcinst.ini.

  2. Ouvrez le fichier .odbc.ini dans un éditeur de texte et donnez les informations nécessaires à la connexion à votre base de données.

    Vérifiez l’absence d’espaces autour des signes égal (=) dans le fichier .odbc.ini.

    Par exemple, cette entrée n’a pas d’espace autour des signes égal : L’entrée SPATIALTYPES=1 n’est pas incluse. Cette entrée n’est pas requise pour vous connecter à des versions prises en charge de SAP HANA 2.0 ou à une version ultérieure. 

    [<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. Pour vous connecter à SAP HANA Cloud, vous devez utiliser une connexion chiffrée. Pour ce faire, chaque machine du site ArcGIS Server doit être en mesure de faire référence au fichier DigiCertGlobalRootCA.crt.pem pour vérifier l’autorité de certification (AC) qui signe le certificat SAP HANA Cloud. Téléchargez ce fichier depuis le portail SAP Help et placez-le dans un répertoire sur chacune des machines du site. Définissez Encrypt=Yes et attribuez l’une des valeurs suivantes au paramètre sslTrustStore :
    • Indiquez l’emplacement du fichier DigiCertGlobalRootCA.crt.pem sur la machine locale comme indiqué dans l’entrée suivante :
      [<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
    • Fournissez la chaîne de certificats provenant du fichier DigiCertGlobalRootCA.crt.pem. Ouvrez le fichier DigiCertGlobalRootCA.crt.pem, copiez son contenu et collez-le entre les notations BEGIN CERTIFCATE et END CERTIFCATE dans le fichier .odbc.ini (voir ci-dessous) :
      [<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. Enregistrez et fermez le fichier .odbc.ini.
  5. Ouvrez le fichier .odbcinst.ini et modifiez-le pour inclure le chemin du pilote ODBC.

    Dans le fichier .odbcinst.ini, un tel espacement n’est pas obligatoire, comme l’indique l’exemple :

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

  6. Enregistrez et fermez le fichier .odbcinst.ini.

Inscrire la base de données

Si vous voulez publier des services web utilisant des données de SAP HANA, créez une connexion à la base de données et enregistrez-la avec vos sites ArcGIS Server. Vous pouvez vous connecter à un SAP HANA depuis ArcMap ou ArcGIS Server Manager. Vous ne pouvez pas vous connecter à une géodatabase dans SAP HANA depuis ArcMap.