Herstellen einer Verbindung mit SAP HANA von ArcGIS

Um ArcGIS Server-Web-Services zu veröffentlichen, die die Daten in einer SAP HANA-Datenbank referenzieren, installieren und konfigurieren Sie den ODBC-Treiber des SAP HANA-Clients auf allen Computern der ArcGIS Server-Site.

Hinweis:

SAP HANA-Clients sind für SAP-Benutzer über das SAP Support Portal unter "Software Downloads" verfügbar.

Nachdem der ODBC-Treiber auf allen ArcGIS-Client-Computern konfiguriert wurde, erstellen Sie eine Datenbankverbindungsdatei, und registrieren Sie diese Datenbankverbindungsdatei bei Ihren ArcGIS Server-Sites.

Installieren und Konfigurieren des SAP HANA-Clients

Laden Sie einen unterstützten 64-Bit-Client von SAP HANA vom SAP Support Portal unter Software Downloads herunter, und installieren Sie ihn auf allen ArcGIS Pro-Computern und allen Computern in ArcGIS Server-Sites, bei denen eine Verbindung zu einer SAP HANA-Datenbank registriert werden soll.

Befolgen Sie die von SAP HANA bereitgestellten Anweisungen zum Installieren und Konfigurieren des ODBC-Clients.

Installieren von SAP HANA auf den ArcGIS Server-Computern

Laden Sie den ODBC-Treiber des SAP HANA-Clients herunter. Platzieren Sie den Client auf jedem Computer der ArcGIS Server-Site, installieren Sie ihn, und bearbeiten Sie das ArcGIS Server-Skript init_user_param.sh auf jedem ArcGIS Server-Linux-Computer.

Laden Sie einen unterstützten 64-Bit-Client von SAP HANA vom SAP Support Portal herunter, und installieren Sie ihn auf jedem Computer in der ArcGIS Server-Site.
Installieren Sie einen Linux ODBC-Treiber-Manager auf jedem ArcGIS Server-Computer, sofern noch keiner installiert ist.

Nach der Installation der Datenbank-Client-Dateien ändern Sie das Skript init_user_param.sh, das mit ArcGIS Server installiert wird, sodass es die Client-Dateien referenziert. Sie können auf dieses Skript zugreifen, indem Sie zum Verzeichnis <ArcGIS Server installation directory>/arcgis/server/usr navigieren.

Sie müssen das Skript init_user_param.sh auf allen Computern der ArcGIS Server-Site aktualisieren.
Stellen Sie sicher, dass der Besitzer der ArcGIS Server-Installation auf jedem Computer zumindest über Lese- und Ausführungsberechtigungen für die Datenbank-Client-Bibliotheken verfügt.
Öffnen Sie das Skript init_user_param.sh in einem Texteditor.

Entfernen Sie das Kommentarzeichen (#) aus den Zeilen, die mit export beginnen, und ersetzen Sie die <SAPHANA_InstallDir>-Information durch den Pfad zu dem Verzeichnis, in dem Sie den SAP HANA-Client installiert haben:

# -----------------------------------------------------------------------
# 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

Speichern und schließen Sie das Skript.
Damit Ihre Änderungen an der Datei init_user_param.sh wirksam werden, müssen Sie ArcGIS Server neu starten.

Führen Sie dazu das Skript stopserver.sh und dann das Skript startserver.sh auf jedem Computer der ArcGIS Server-Site aus.

./stopserver.sh

./startserver.sh

Sobald Sie den ODBC-Treiber des SAP HANA-Clients installiert haben, können Sie eine Datenbankverbindung erstellen und diese bei Ihrer ArcGIS Server-Site registrieren. Wenn allerdings die folgenden Bedingungen vorliegen, müssen Sie den Datenquellennamen für den ODBC-Treiber konfigurieren, bevor Sie eine Datenbankverbindung erstellen und registrieren.

Sie verwenden SAP HANA 1.0 (alle unterstützten Service-Pack-Versionen).
Sie stellen eine Verbindung mit SAP HANA Cloud her.
Sie stellen die Verbindung mit der Datenbank über ArcGIS Server 10.6 oder früher her.
Die Zeichenanzahl im SAP HANA-Servernamen und in der SQL-Portnummer des SAP HANA-Servers beträgt mehr als 31.

Konfigurieren eines ODBC-Datenquellennamens unter Linux (falls erforderlich)

Wenn Sie einen Datenquellennamen benötigen, führen Sie die folgenden Schritte aus, um einen Systemdatenquellennamen für den ODBC-Treiber des SAP HANA-Clients auf jedem ArcGIS Server-Linux-Computer zu konfigurieren:

Hinweis:

Verwenden Sie beim Konfigurieren sämtlicher SAP HANA-ODBC-Clients für diese Datenbank denselben ODBC-Datenquellennamen. Konfigurieren Sie beispielsweise als Datenquellennamen auf Ihren ArcGIS Pro-Computern denselben Namen wie den Datenquellennamen für den ODBC-Treiber des SAP HANA-Clients auf den Computern in den ArcGIS Server-Sites. Wenn Sie nicht denselben Namen verwenden, treten beim Veröffentlichen Probleme auf, da ArcGIS die Verbindungszeichenfolgen der veröffentlichten Daten und die Datenbank vergleicht, bei denen sie registriert sind.

Bearbeiten Sie zum Konfigurieren eines ODBC-Datenquellennamens die SAP HANA-ODBC-Verbindungsdateien .odbc.ini und .odbcinst.ini.

Den Dateien müssen die Namen .odbc.ini und .odbcinst.ini zugewiesen werden.
Öffnen Sie die Datei .odbc.ini in einem Texteditor, und geben Sie die notwendigen Informationen für die Verbindung mit der Datenbank ein.

Stellen Sie sicher, dass vor und hinter den Gleichheitszeichen (=) in der Datei .odbc.ini keine Leerzeichen stehen.

Dieser Eintrag weist beispielsweise vor und hinter den Gleichheitszeichen keine Leerstellen auf. Der Eintrag SPATIALTYPES=1 ist vorhanden. Der Eintrag ist nicht erforderlich, wenn Sie eine Verbindung mit einer unterstützten Version von SAP HANA (2.0 oder höher) herstellen.
```
[<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
```
Zum Herstellen der Verbindung mit SAP HANA Cloud müssen Sie eine verschlüsselte Verbindung verwenden. Dazu muss jeder Computer in der ArcGIS Server-Site in der Lage sein, die Datei DigiCertGlobalRootCA.crt.pem zu referenzieren, um die Zertifizierungsstelle (CA) zu überprüfen, die das SAP HANA Cloud-Zertifikat signiert. Dazu müssen Sie diese Datei aus dem SAP-Hilfeportal herunterladen und auf jedem der Computer in der Site in einem Verzeichnis ablegen. Legen Sie Encrypt=Yes fest, und wählen Sie für den Parameter sslTrustStore eine der folgenden Einstellungen aus:
- Geben Sie den Speicherort der Datei DigiCertGlobalRootCA.crt.pem auf dem lokalen Computer wie im folgenden Eintrag gezeigt an:
```
[<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
```
- Geben Sie die Zertifikatzeichenfolge aus der Datei DigiCertGlobalRootCA.crt.pem an. Öffnen Sie die Datei DigiCertGlobalRootCA.crt.pem, kopieren Sie den Inhalt, und fügen Sie diesen wie nachstehend gezeigt zwischen BEGIN CERTIFCATE und END CERTIFCATE in die Datei .odbc.ini ein:
```
[<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
```
Speichern und schließen Sie die .odbc.ini-Datei.
Öffnen Sie die Datei .odbcinst.ini, und fügen Sie den ODBC-Treiberpfad hinzu.

In der Datei .odbcinst.ini sind solche Leerstellen nicht erforderlich, wie im folgenden Beispiel dargestellt:
```
Description  =SAP HANA ODBC
Driver64         = /<usr>/sap/hdbclient/libodbcHDB.so
```
Speichern und schließen Sie die .odbcinst.ini-Datei.

Installieren von SAP HANA auf den ArcGIS Server-Computern

Laden Sie den ODBC-Treiber des SAP HANA-Clients herunter, und installieren Sie ihn auf jedem Computer in der ArcGIS Server-Site.

Installieren Sie den ODBC-Treiber des SAP HANA-Clients auf allen ArcGIS Server-Windows-Computern:

Laden Sie einen unterstützten 64-Bit-Client von SAP HANA vom SAP Support Portal herunter, und installieren Sie ihn auf jedem Computer in der ArcGIS Server-Site.
Fügen Sie der Umgebungsvariablen "PATH" des Windows-Systems das Installationsverzeichnis des SAP HANA-Clients hinzu.

Wenn Sie den ODBC-Treiber des SAP HANA-Clients beispielsweise unter C:\Program Files\sap\hdbclient installiert haben, fügen Sie der Umgebungsvariablen "PATH" dieses Verzeichnis hinzu.

Sobald Sie den ODBC-Treiber des SAP HANA-Clients installiert haben, können Sie mit dem Registrieren einer Datenbankverbindung bei Ihrer ArcGIS Server-Site fortfahren. Wenn allerdings die folgenden Bedingungen vorliegen, müssen Sie den Datenquellennamen für den ODBC-Treiber konfigurieren, bevor Sie eine Datenbankverbindung registrieren:

Sie verwenden SAP HANA 1.0 (alle unterstützten Service-Pack-Versionen).
Sie stellen eine Verbindung mit SAP HANA Cloud her.
Sie stellen die Verbindung mit der Datenbank über ArcGIS Server 10.6 oder früher her.
Die Zeichenanzahl im SAP HANA-Servernamen und in der SQL-Portnummer des SAP HANA-Servers beträgt mehr als 31.

Konfigurieren eines ODBC-Datenquellennamens unter Windows (falls erforderlich)

Wenn Sie einen Datenquellennamen benötigen, führen Sie die folgenden Schritte aus, um einen Systemdatenquellennamen (DSN) für den ODBC-Treiber des SAP HANA-Clients auf jedem ArcGIS Server-Windows-Computer zu konfigurieren:

Hinweis:

Verwenden Sie den Datenquellenamen, wenn Sie eine Verbindung von ArcGIS mit der Datenbank herstellen. Verwenden Sie beim Konfigurieren sämtlicher SAP HANA-ODBC-Clients für diese Datenbank denselben Namen. Verwenden Sie beim Konfigurieren des ODBC-Treibers des SAP HANA-Clients auf Ihren ArcGIS Pro-Computern den gleichen Datenquellennamen wie beim Konfigurieren des Datenquellennamens für den ODBC-Treiber auf Ihren ArcGIS Server-Computern. Wenn Sie nicht denselben Namen verwenden, treten beim Veröffentlichen Probleme auf, da ArcGIS die Verbindungszeichenfolgen der veröffentlichten Daten und die Datenbank vergleicht, bei denen sie registriert sind.

Öffnen Sie ODBC Data Source Administrator (64 Bit).
Klicken Sie im ODBC-Datenquellen-Administrator (64 Bit) auf die Registerkarte System-DSN, und klicken Sie auf Hinzufügen.

Das Dialogfeld Neue Datenquelle erstellen wird geöffnet.
Wählen Sie den SAP HANA-ODBC-Client aus, und klicken Sie auf Fertig stellen.
Füllen Sie Datenquellenname, Beschreibung und Server:Port mit Informationen für Ihre Datenbank.
Aktivieren Sie im Abschnitt TLS/SSL die Optionen Verbindung zur Datenbank über TLS/SSL herstellen und TLS/SSL-Zertifikat validieren.
Öffnen Sie das Dialogfeld "Erweiterte ODBC-Installation", und fügen Sie den folgenden Schlüsselwert in den Abschnitt Spezielle Eigenschafteneinstellungen ein: SPATIALTYPES=1. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld Erweiterte ODBC-Installation zu schließen.

Hinweis:

Sie können diesen Schritt überspringen, wenn Sie ArcGIS Server mit einer unterstützten Version von SAP HANA (2.0 oder höher) verwenden.
Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.

Erstellen einer Datenbankverbindung

Sie müssen über eine Datenbankverbindung (.sde-Datei) verfügen, die die Verbindung mit der Datenbank authentifiziert.

Sie können die ArcPy-Funktion CreateDatabaseConnection von einem der Computer auf der ArcGIS Server-Site aufrufen, die mit der Datenbank verbunden werden muss. Informationen zur Ausführung dieser Funktion finden Sie unter Datenbankverbindung erstellen in der ArcGIS Pro-Hilfe.

Sie müssen Benutzerinformationen mit der Verbindungsdatei speichern, um die Datenbankverbindungsdatei mit ArcGIS Server verwenden zu können.

Registrieren der Verbindungsdatei

Damit ArcGIS Server-Sites auf die Daten zugreifen können, müssen Sie mithilfe der erstellten Datenbankverbindungsdatei in ArcGIS Pro einen registrierten Data Store hinzufügen oder ein Data-Store-Element im Portal hinzufügen.