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.

Remarque :

Les clients SAP HANA sont disponibles pour les utilisateurs SAP existants sur le portail du support SAP sous Téléchargements de logiciels.

Installez les applications 32 bits et 64 bits, et les clients sur des machines distinctes afin d’éviter des problèmes éventuels lorsque différentes versions des mêmes pilotes sont installées sur la même machine.

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 ArcGIS Server qui référencent les données de votre base de données SAP HANA, inscrivez le fichier de connexion à une base de données auprès de vos sites ArcGIS Server.

Connexion à partir de ArcGIS Pro

Pour vous connecter depuis un projet ArcGIS Pro à SAP HANA, installez le pilote ODBC du client SAP HANA sur la machine ArcGIS Pro et créez une connexion à une base de données.

Installer le 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 64 bits pris en charge à partir du portail de support SAP sous Software Downloads, puis installez-le sur chaque machine ArcGIS Pro.
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.

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 réunies pour votre site :

• Votre base de données SAP HANA est une version prise en charge, 2.0 SPS2 ou version ultérieure.
• Vous vous connectez à une installation sur site de SAP HANA.
• Vous vous connectez depuis ArcGIS Pro 2.2 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 pour le pilote ODBC du client SAP HANA avant de procéder comme suit pour vous connecter depuis ArcGIS Pro.

Établissez 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) pour se connecter à SAP HANA :

1. Ouvrez la fenêtre Catalog (Catalogue) dans ArcGIS Pro.
2. Cliquez avec le bouton droit sur Databases (Bases de données) et sélectionnez New Database Connection (Nouvelle connexion à une base de données).
3. Sélectionnez SAP HANA dans la liste déroulante Plateforme de la base de données.
4. 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.
5. Sélectionnez Authentification de la base de données comme Type d’authentification.

   L’authentification du système d’exploitation n’est pas prise en charge.

6. Saisissez un nom d’utilisateur et un mot de passe de base de données valides dans les zones de texte User name (Nom d’utilisateur) et Password (Mot de passe).
7. 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 serez invité à fournir un nom d’utilisateur et un mot de passe à chaque connexion depuis ArcGIS Pro.

   Remarque :

   L’option Save user name and password (Enregistrer le nom d’utilisateur et le mot de passe) doit être cochée pour les fichiers de connexion que vous inscrivez auprès d’un site ArcGIS Server ou si vous souhaitez localiser les données accessibles via ce fichier de connexion.

8. Cliquez sur OK pour créer le fichier de connexion.

Une connexion à une base de données s’affiche sous Databases (Bases de données) dans la fenêtre Catalog (Catalogue) et un fichier de connexion (.sde) est créé dans le répertoire de projet ArcGIS Pro.

Vous pouvez renommer le fichier en saisissant un nouveau nom dans la fenêtre Catalog (Catalogue) et en appuyant sur Entrée.

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

Si aucune des conditions suivante 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 utilisez ArcGIS Pro 2.1 ou 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 afin de configurer un nom de source de données pour une base de données SAP HANA :

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

   Remarque :

   Utilisez le même nom pour configurer tous les clients ODBC SAP HANA sur cette même base de données. Par exemple, utilisez le même nom de source de données lorsque vous configurez le pilote ODBC du client SAP HANA sur vos machines ArcGIS Pro que celui utilisé pour configurer le nom de source de données du pilote ODBC sur vos machines ArcGIS Server. Si vous n’utilisez pas le même nom, vous rencontrerez des problèmes lors de la publication, car ArcGIS compare les chaînes de connexion des données en cours de publication et la base de données qui est inscrite.

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. Ouvrez les paramètres avancés pour le client ODBC et ajoutez la propriété SPATIALTYPES et définissez sa valeur sur 1.

   Remarque :

   Vous pouvez ignorer cette étape si vous utilisez ArcGIS Pro 2.2 ou une version plus récente avec une version prise en charge de SAP HANA 2.0.

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

Connexion à partir de ArcGIS Server

Pour publier des données SAP HANA sur un site ArcGIS Server fédéré ou autonome et conserver les données dans SAP HANA, installez un pilote ODBC de client SAP HANA 64 bits sur chaque machine sur le site ArcGIS Server et inscrivez un fichier de connexion à une base de données auprès du site.

Une fois que vous avez configuré les machines sur le site ArcGIS Server, créez une connexion à la base de données SAP HANA et inscrivez le fichier de connexion auprès de votre site ArcGIS Server.

Installer SAP HANA sur les machines ArcGIS Server (Linux)

Téléchargez le pilote ODBC du client SAP HANA. Placez le client sur chaque machine du 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 depuis le portail de support SAP, puis 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.

Après avoir installé les fichiers de clients de bases de données, modifiez le script init_user_param.sh installé avec ArcGIS Server pour référencer les fichiers de clients. Vous pouvez accéder à ce script dans le répertoire <ArcGIS Server installation directory>/arcgis/server/usr.

Vous devez mettre à jour le init_user_param.sh sur chaque machine du site ArcGIS Server.

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 (#) des lignes commencant par export et remplacez les informations <SAPHANA_InstallDir> par le chemin du répertoire dans lequel vous avez installé le client 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

6. Enregistrez et fermez le script.
7. Pour que les modifications apportées dans le fichier init_user_param.sh prennent effet, vous devez redémarrer ArcGIS Server.

   Pour ce faire, exécutez le script stopserver.sh, puis le script startserver.sh sur chaque machine du site ArcGIS Server.

   ./stopserver.sh

   ./startserver.sh

Une fois que le pilote ODBC du client SAP HANA est installé, vous pouvez établir une connexion à une base de données et l’inscrire auprès de 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 de créer et d’enregistrer une connexion à une 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.

Configurer un nom de source de données ODBC sur 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 fonctionnant sous Linux :

Remarque :

Utilisez le même nom de source des données ODBC pour configurer tous les clients ODBC SAP HANA sur cette même base de données. Par exemple, si vous configurez un nom de source de données pour le pilote ODBC sur vos machines ArcGIS Pro, définissez le même nom de source de données pour le pilote ODBC SAP HANA sur toutes vos machines ArcGIS Server. Si vous n’utilisez pas le même nom, vous rencontrerez des problèmes lors de la publication, car ArcGIS compare les chaînes de connexion des données en cours de publication et la base de données qui est inscrite.

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 qu’il n’y a pas 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 est incluse. Cette entrée n’est pas requise pour se connecter à des versions prises en charge de SAP HANA 2.0 ou 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.

Connexion à la base de données

Vous pouvez utiliser la boîte de dialogue Database Connection (Connexion à une base de données) d’ArcGIS Pro pour vous connecter à la base de données, comme décrit ci-dessous.

Une autre possibilité consiste à exécuter l’outil Créer une connexion à une base de données dans ArcGIS Pro ou à utiliser Python pour exécuter la commande Créer une connexion à une base de données à partir d’une machine ArcGIS Server pour créer un fichier de connexion à une base de données (.sde) qui se connecte à une base de données.

Vous devez enregistrer les informations d’utilisateur dans le fichier de connexion pour utiliser le fichier de connexion à une base de données avec ArcGIS Server.

Inscrire la base de données

Pour publier des services Web utilisant des données de SAP HANA, établissez une connexion à une base de données et inscrivez-la auprès de vos sites ArcGIS Server.

Pour autoriser le site ArcGIS Server à accéder aux données, utilisez le fichier de connexion à une base de données que vous avez créé afin d’ajouter un data store inscrit dans ArcGIS Pro ou d’ajouter un élément de data store dans le portail.