ArcMap

Herstellen einer Verbindung mit SAP HANA von ArcGIS

Um über ArcGIS-Clients eine Verbindung zu einer SAP HANA-Datenbank herzustellen, installieren und konfigurieren Sie den ODBC-Treiber des SAP HANA-Clients auf dem ArcGIS-Client-Computer.

Sobald der ODBC-Client auf allen ArcGIS-Clientcomputern konfiguriert ist, erstellen Sie eine Datenbankverbindungsdatei. Um ArcGIS Server-Web-Services zu veröffentlichen, die auf die Daten in Ihrer SAP HANA-Datenbank verweisen, registrieren Sie die Datenbankverbindungsdatei bei den ArcGIS Server-Sites.

Herstellen einer Verbindung von ArcMap

Um eine Verbindung mit SAP HANA über ArcMap herzustellen, installieren und konfigurieren Sie den ODBC-Treiber des SAP HANA-Clients auf allen ArcMap-Computern, und erstellen Sie eine Verbindung von ArcMap zur Datenbank.

Installieren des ODBC-Treibers des SAP HANA-Clients

Führen Sie die folgenden Schritte aus, um den ODBC-Treiber des SAP HANA-Clients herunterzuladen und die Variable "PATH" auf Ihrem Client-Computer zu konfigurieren:

  1. Laden Sie einen unterstützten 32-Bit-Client von SAP HANAvom SAP Support Portal herunter, und installieren Sie ihn auf jedem ArcMap-Computer.
  2. Fügen Sie der Umgebungsvariablen PATH des SAP HANA-Systems das Installationsverzeichnis des Microsoft Windows-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.

Verbinden mit der Datenbank

Sie können den SAP HANA-Servernamen und die SQL-Portnummer für die Verbindung mit der Datenbank verwenden, wenn alle der folgenden Bedingungen für Ihre Site zutreffen:

  • Ihre SAP HANA-Datenbank weist eine unterstützte Version auf (2.0 SPS2 oder höher).
  • Sie stellen eine Verbindung zu einer lokalen SAP HANA-Installation her.
  • Sie stellen die Verbindung über ArcGIS Desktop 10.6.1 oder eine höhere Version her.
  • Die Zeichenanzahl im SAP HANA-Servernamen und in der SQL-Portnummer des SAP HANA-Servers beträgt weniger als 31.

Wenn eine der obigen Bedingungen nicht erfüllt ist, müssen Sie einen Systemdatenquellennamen (DSN) für den ODBC-Treiber des SAP HANA-Clients konfigurieren, bevor Sie mit den folgenden Schritten fortfahren können, um über ArcMap die Verbindung herzustellen.

Fügen Sie über das Dialogfeld Datenbankverbindung oder das Geoverarbeitungswerkzeug Datenbankverbindung erstellen eine Datenbankverbindung hinzu. In den folgenden Schritten wird die Verwendung des Dialogfeldes Datenbankverbindung beschrieben.

  1. Erweitern Sie im Kataloginhaltsverzeichnis in ArcMap oder ArcCatalog den Knoten Datenbankverbindungen, und doppelklicken Sie auf Hinzufügen: Datenbankverbindung.
  2. Wählen Sie aus der Dropdown-Liste Datenbankplattform den Eintrag SAP HANA aus.
  3. Geben Sie im Textfeld Datenquelle Folgendes ein:
    • Den SAP HANA-Servernamen und die SQL-Portnummer für die Kommunikation mit der Datenbank, getrennt durch einen Doppelpunkt (:). Beispiel: Wenn der vollständig qualifizierte Name des SAP HANA-Servers "myserver.network.com" lautet und SAP HANA über Port 98765 kommuniziert, geben Sie myserver.network.com:98765 ein.
    • Den Datenquellennamen, den Sie für den ODBC-Treiber konfiguriert haben.
  4. Wählen Sie unter Authentifizierungstyp den Eintrag Datenbankauthentifizierung aus.
  5. Geben Sie in den Textfeldern Benutzername und Kennwort einen gültigen Benutzernamen und ein gültiges Kennwort ein.
  6. Deaktivieren Sie die Option Benutzername und Kennwort speichern, wenn Sie die Anmeldeinformationen nicht als Teil der Verbindung speichern möchten. Dies erhöht die Sicherheit der Datenbank. Allerdings werden Sie in diesem Fall bei jedem Verbindungsaufbau über Desktop-Clients zur Eingabe eines Benutzernamens und eines Kennwortes aufgefordert.

  7. Klicken Sie auf OK, um die Verbindung herzustellen.

Es wird eine Datei im Verzeichnis \\<computer_name>\Users\<user_name>\AppData\Roaming\ESRI\Desktop<release#>\ArcCatalog erstellt.

Sie können die Verbindung an einen anderen Speicherort verschieben. Stellen Sie jedoch sicher, dass die Anwendungen und Benutzer, die eine Verbindung benötigen, problemlos auf das Verzeichnis zugreifen können, in dem Sie die Verbindungsdatei ablegen.

Wenn Sie die Daten aus dieser Verbindung als Quelle für einen Service verwenden, z. B. für einen Geoverarbeitungs- oder Geokodierungsservice, müssen Sie die Verbindungsdatei ggf. in einem freigegebenen Verzeichnis im Netzwerk platzieren. Weitere Informationen zur Freigabe einer Verbindungsdatei finden Sie unter Bereitstellen der Daten für ArcGIS Server.

Konfigurieren eines Datenquellennamens (falls erforderlich)

Wenn eine der folgenden Bedingungen erfüllt ist, müssen Sie einen Systemdatenquellennamen (DSN) für den ODBC-Treiber des SAP HANA-Clients konfigurieren, um eine Verbindung mit der Datenbank herzustellen:

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

Wenn diese Bedingungen in Ihrer Site nicht vorliegen, können Sie trotzdem den Datenquellennamen für die Verbindung mit SAP HANA konfigurieren, er ist allerdings nicht erforderlich.

Führen Sie die folgenden Schritte aus, um einen Datenquellennamen für die SAP HANA-Datenbank zu konfigurieren:

  1. Öffnen Sie auf dem Client-Computer ODBC Data Source Administrator (32 Bit).

  2. Klicken Sie im ODBC-Datenquellen-Administrator (64 Bit) auf die Registerkarte System-DSN, und klicken Sie auf Hinzufügen.
  3. Wählen Sie den SAP HANA-ODBC-Client aus, und klicken Sie auf Fertig stellen.
  4. Geben Sie einen Namen, eine Beschreibung und eine SQL-Portnummer für die Datenquelle an.
  5. Aktivieren Sie im Abschnitt TLS/SSL die Optionen Verbindung zur Datenbank über TLS/SSL herstellen und TLS/SSL-Zertifikat validieren.
  6. Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.

Herstellen einer Verbindung von ArcGIS Server

Wenn Sie SAP HANA-Daten auf einer verbundenen oder eigenständigen ArcGIS Server-Site veröffentlichen möchten und die resultierenden Services die Daten in SAP HANA verwenden sollen, installieren Sie den 64-Bit-ODBC-Treiber eines SAP HANA-Clients auf jedem Computer in der ArcGIS Server-Site. Befolgen Sie die Anweisungen für das Betriebssystem, auf dem ArcGIS Server installiert ist.

Nachdem Sie die Computer in der ArcGIS Server-Site konfiguriert haben, erstellen Sie eine Datenbankverbindung mit Ihrer Datenbank, und registrieren Sie die Verbindungsdatei bei Ihrer ArcGIS Server-Site.

Installieren von SAP HANA auf den ArcGIS Server-Computern (Microsoft Windows)

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

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

  1. 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.
  2. Fügen Sie der Umgebungsvariablen "PATH" des SAP HANA-Systems das Installationsverzeichnis des Windows-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 zu SAP HANA Cloud her.
  • Sie stellen die Verbindung mit der Datenbank über ArcGIS Server 10.6 oder eine frühere Version 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:

  1. Öffnen Sie ODBC Data Source Administrator (64 Bit).
  2. 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.

  3. Wählen Sie den SAP HANA-ODBC-Client aus, und klicken Sie auf Fertig stellen.
  4. Füllen Sie Datenquellenname, Beschreibung und Server:Port mit Informationen für Ihre Datenbank.
  5. Aktivieren Sie im Abschnitt TLS/SSL die Optionen Verbindung zur Datenbank über TLS/SSL herstellen und TLS/SSL-Zertifikat validieren.
  6. Ö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.

  7. Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.

Installieren von SAP HANA auf den ArcGIS Server-Computern (Linux)

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.

  1. 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.
  2. Installieren Sie einen Linux ODBC-Treiber-Manager auf jedem ArcGIS Server-Computer, sofern noch keiner installiert ist.

    3. Nachdem Sie die Datenbank-Clientdateien installiert haben, ändern Sie das Skript init_user_param.sh, das mit ArcGIS Server installiert wird, um auf die Clientdateien zu verweisen. Sie können auf dieses Skript zugreifen, indem Sie zum Verzeichnis <ArcGIS Server installation directory>/arcgis/server/usr navigieren.

  3. Stellen Sie sicher, dass der Besitzer der ArcGIS Server-Installation auf jedem Computer zumindest über Lese- und Ausführungsberechtigungen für die Datenbank-Clientbibliotheken verfügt.
  4. Öffnen Sie das Skript init_user_param.sh in einem Texteditor.
  5. Entfernen Sie das Kommentarzeichen (#) aus diesen Zeilen, und ersetzen Sie die <SAPHANA_InstallDir>-Information durch den Pfad zu dem Verzeichnis, in dem Sie den SAP HANA-Client installiert haben:

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

  6. Speichern und schließen Sie das Skript.
  7. Nachdem Sie init_user_param.sh auf jedem Computer in Ihrer ArcGIS Server-Site konfiguriert haben, führen Sie das Skript startserver.sh auf allen Computern aus, um ArcGIS Server erneut zu starten.

    ./startserver.sh

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 zu SAP HANA Cloud her.
  • Sie stellen die Verbindung mit der Datenbank über ArcGIS Server 10.6 oder eine frühere Version 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:

  1. 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.

  2. Öffnen Sie die Datei .odbc.ini in einem Texteditor, und geben Sie die notwendigen Informationen für die Verbindung mit der Datenbank ein.

    Vergewissern Sie sich, dass vor und hinter den Gleichheitszeichen (=) in der .odbc.ini-Datei 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 unterstützte Versionen von SAP HANA 2.0 oder höher verwenden. 

    [<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. Zum Herstellen der Verbindung zu 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:
    • 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
  4. Speichern und schließen Sie die .odbc.ini-Datei.
  5. Ö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

  6. Speichern und schließen Sie die .odbcinst.ini-Datei.

Registrieren der Datenbank

Wenn Sie Web-Services mit Daten in SAP HANA veröffentlichen möchten, erstellen Sie eine Datenbankverbindung, und registrieren Sie sie bei den ArcGIS Server-Sites. Sie können eine Verbindung mit SAP HANA über ArcMap oder ArcGIS Server Manager herstellen. Sie können über ArcMap keine Verbindung mit einer Geodatabase in SAP HANA herstellen.