Se connecter à SAP HANA depuis ArcGIS

Pour publier des services Web ArcGIS Server qui référencent les données dans une base de données SAP HANA, installez et configurez le pilote ODBC du client SAP HANA sur toutes les machines du site ArcGIS Server.

Remarque :

Les clients SAP HANA sont disponibles pour les utilisateurs SAP existants sur le portail du support SAP sous Software Downloads.

Une fois le pilote ODBC configuré sur toutes les machines clientes ArcGIS, créez un fichier de connexion à une base de données et inscrivez-le auprès de vos sites ArcGIS Server.

Installer et configurer le client SAP HANA

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 toutes les machines ArcGIS Pro et les machines des sites ArcGIS Server auprès desquels vous allez inscrire une connexion à une base de données SAP HANA.

Suivez les instructions fournies par SAP HANA pour installer et configurer le client ODBC.

Installer SAP HANA sur les machines ArcGIS Server

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

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.
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 script init_user_param.sh sur chaque machine du site ArcGIS Server.
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 base de données.
Ouvrez le script init_user_param.sh dans un éditeur de texte.

Supprimez la marque de commentaire (#) des lignes commençant 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

Enregistrez et fermez le script.
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 de 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 du client 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.

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

Les fichiers doivent s’intituler .odbc.ini et .odbcinst.ini.
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
```
Pour vous connecter à SAP HANA Cloud, utilisez une connexion chiffrée. Pour ce faire, chaque machine du site ArcGIS Server doit être en mesure de référencer le fichier DigiCertGlobalRootCA.crt.pem pour vérifier l’autorité de certification 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
```
Enregistrez et fermez le fichier .odbc.ini.
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
```
Enregistrez et fermez le fichier .odbcinst.ini.

Installer SAP HANA sur les machines ArcGIS Server

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 fonctionnant sous Windows :

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.
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 commencer l’inscription d’une connexion à une base de données 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 d’inscrire 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 sous 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 (DSN) pour le pilote ODBC du client SAP HANA sur chaque machine ArcGIS Server fonctionnant sous Windows :

Remarque :

Utilisez le nom de la source de données pour vous connecter à la base de données depuis ArcGIS. 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.

Ouvrez l’administrateur de source de données ODBC (64 bits).
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.
Sélectionnez le client ODBC SAP HANA et cliquez sur Finish (Terminer).
Complétez les informations des champs Nom de la source de données, Description, et Server:Port pour votre base de données.
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).
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).

Remarque :

Vous pouvez ignorer cette étape si vous utilisez ArcGIS Server avec une version prise en charge de SAP HANA 2.0 ou ultérieure.
Cliquez sur OK sur la configuration du client ODBC et l’administrateur de la source des données ODBC pour les fermer.

Créer une connexion à une base de données

Vous devez disposer d’une connexion à la base de données (fichier .sde) qui authentifie la connexion à la base de données.

Vous pouvez appeler la fonction ArcPy CreateDatabaseConnection depuis l’une des machines du site ArcGIS Server qui doit se connecter à la base de données. Consultez la rubrique Créer une connexion à une base de données dans l’aide d’ArcGIS Pro pour obtenir des informations sur l’exécution de cette fonction.

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 le fichier de connexion

Pour autoriser les sites 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 afin d’ajouter un élément de data store dans le portail.