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. SAP HANA -Client-ODBC-Treiber sind für SAP-Benutzer über das SAP Support Portal unter "Software Downloads" verfügbar.
Sobald der ODBC-Client auf allen ArcGIS-Clientcomputern konfiguriert ist, erstellen Sie eine Datenbankverbindungsdatei in ArcGIS Pro oder ArcMap. 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.
Hinweis:
Installieren Sie 32- und 64-Bit-Anwendungen und ODBC-Treiber auf getrennten Computern. So vermeiden Sie Probleme, die auftreten können, wenn verschiedene Versionen eines Treibers auf demselben Computer installiert werden.
Herstellen einer Verbindung von ArcGIS Pro
Um eine Verbindung von einem ArcGIS Pro-Projekt mit SAP HANAherzustellen, installieren Sie den ODBC-Treiber des SAP HANA-Clients auf dem ArcGIS Pro-Computer, konfigurieren ihn und erstellen eine Datenbankverbindung.
Installieren des SAP HANA-Clients und Konfigurieren des ODBC-Treibers
Führen Sie die folgenden Schritte aus, um den ODBC-Treiber des SAP HANA-Clients herunterzuladen und zu konfigurieren:
- 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.
- Richten Sie mithilfe des ODBC-Datenquellen-Administrators (64 Bit) einen Systemdatenquellennamen (DSN) ein.
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.
- 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.
- Klicken Sie auf Einstellungen, um das Dialogfeld Erweiterte ODBC-Installation zu öffnen, und fügen Sie 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 Pro 2.2 oder eine neuere Version mit einer unterstützten Version von SAP HANA 2.0 verwenden.
- Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.
- Klicken Sie im ODBC-Datenquellen-Administrator (64 Bit) auf die Registerkarte System-DSN, und klicken Sie auf Hinzufügen.
- 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.
Verbinden mit der Datenbank
Fügen Sie eine Datenbankverbindung über das Dialogfeld Datenbankverbindung oder mit dem Geoverarbeitungswerkzeug Datenbankverbindung erstellen hinzu. In den folgenden Schritten wird die Verwendung des Dialogfeldes Datenbankverbindung beschrieben.
- Klicken Sie im Bereich Katalog mit der rechten Maustaste auf Datenbanken, und klicken Sie danach auf Neue Datenbankverbindung.
- Wählen Sie aus der Dropdown-Liste Datenbankplattform den Eintrag SAP HANA aus.
- Geben Sie den Datenquellennamen, den Sie für den ODBC-Treiber konfiguriert haben, in das Textfeld Datenquelle ein.
- Wählen Sie unter Authentifizierungstyp den Eintrag Datenbankauthentifizierung aus.
- Geben Sie in den Textfeldern Benutzername und Kennwort einen gültigen Datenbankbenutzernamen und ein gültiges Kennwort ein.
- 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.
Hinweis:
Die Option Benutzername und Kennwort speichern muss für Verbindungsdateien, die bei einer ArcGIS Server-Site registriert werden, aktiviert sein. Dies gilt auch, wenn Sie nach Daten suchen möchten, auf die über diese Verbindungsdatei zugegriffen wird.
- Klicken Sie auf OK, um die Verbindung herzustellen.
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 und Konfigurieren des ODBC-Treibers des SAP HANA-Clients
Führen Sie die folgenden Schritte aus, um den ODBC-Treiber des SAP HANA-Clients zu konfigurieren, der von ArcMap verwendet wird:
- Laden Sie einen unterstützten 32-Bit-Client von SAP HANAvom SAP Support Portal herunter, und installieren Sie ihn auf jedem ArcMap-Computer.
- Richten Sie mithilfe des ODBC-Datenquellen-Administrators (32 Bit) einen Systemdatenquellennamen (DSN) ein.
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 von SAP HANA auf Ihren ArcMap-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.
- Klicken Sie im ODBC-Datenquellen-Administrator (32 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.
- Klicken Sie auf Einstellungen, um das Dialogfeld Erweiterte ODBC-Installation zu öffnen, und fügen Sie 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 ArcMap mit einer unterstützten Version von SAP HANA 2.0 verwenden.
- Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.
- Klicken Sie im ODBC-Datenquellen-Administrator (32 Bit) auf die Registerkarte System-DSN, und klicken Sie auf Hinzufügen.
- 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
Fügen Sie eine Datenbankverbindung über das Dialogfeld Datenbankverbindung oder mit dem Geoverarbeitungswerkzeug Datenbankverbindung erstellen hinzu. In den folgenden Schritten wird die Verwendung des Dialogfeldes Datenbankverbindung beschrieben.
- Erweitern Sie im Kataloginhaltsverzeichnis in ArcMap oder ArcCatalog den Knoten Datenbankverbindungen, und doppelklicken Sie auf Hinzufügen: Datenbankverbindung.
- Wählen Sie aus der Dropdown-Liste Datenbankplattform den Eintrag SAP HANA aus.
- Geben Sie den Datenquellennamen, den Sie für den ODBC-Treiber konfiguriert haben, in das Textfeld Datenquelle ein.
- Wählen Sie unter Authentifizierungstyp den Eintrag Datenbankauthentifizierung aus.
- Geben Sie in den Textfeldern Benutzername und Kennwort einen gültigen Benutzernamen und ein gültiges Kennwort ein.
- 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.
Hinweis:
Die Option Benutzername und Kennwort speichern muss für Verbindungsdateien, die bei einer ArcGIS Server-Site registriert werden, aktiviert sein. Dies gilt auch, wenn Sie mit der Katalogsuche nach Daten suchen möchten, auf die über diese Verbindungsdatei zugegriffen wird.
- 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.
Herstellen einer Verbindung von ArcGIS Server
Wenn Sie SAP HANA-Daten auf einer ArcGIS Server-Site veröffentlichen und die resultierenden Services die Daten in SAP HANA verwenden sollen, installieren und konfigurieren Sie den 64-Bit-ODBC-Treiber eines SAP HANA-Clients auf der ArcGIS Server-Site und registrieren die Datenbank bei der Site.
Installieren des SAP HANA-Clients und Konfigurieren des ODBC-Treibers
Laden Sie den ODBC-Treiber des SAP HANA-Clients herunter, installieren Sie ihn, und konfigurieren Sie den Namen der Datenquelle. Führen Sie die Schritte entsprechend dem ArcGIS Server-Betriebssystem, Windows oder Linux, aus
ArcGIS Server unter Windows
Führen Sie die folgenden Schritte aus, um den ODBC-Treiber des SAP HANA-Clients auf dem jeweiligen Windows-Computer von ArcGIS Server zu konfigurieren:
- 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.
- Richten Sie mithilfe des ODBC-Datenquellen-Administrators (64 Bit) einen Systemdatenquellennamen (DSN) ein.
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 ArcMap-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.
- 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.
- Klicken Sie auf Einstellungen, um das Dialogfeld Erweiterte ODBC-Installation zu öffnen, und fügen Sie 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 verwenden.
- Klicken Sie im ODBC-Client-Setup und im ODBC Data Source Administrator auf OK, um sie zu schließen.
- Klicken Sie im ODBC-Datenquellen-Administrator (64 Bit) auf die Registerkarte System-DSN, und klicken Sie auf Hinzufügen.
- 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.
ArcGIS Server unter Linux
Führen Sie die folgenden Schritte aus, um den ODBC-Treiber des SAP HANA-Clients auf dem jeweiligen ArcGIS Server-Computer von Linux zu konfigurieren:
- 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.
- Bearbeiten Sie die SAP HANA-ODBC-Verbindungsdateien. Den Dateien müssen die Namen .odbc.ini und .odbcinst.ini zugewiesen werden.
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:
[<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
Hinweis:
Der Eintrag SPATIALTYPES=1 ist nicht erforderlich, wenn Sie ArcGIS Server mit einer unterstützten Version von SAP HANA 2.0 verwenden.
In der .odbcinst.ini-Datei sind solche Leerstellen nicht erforderlich, wie im folgenden Beispiel:
Description =SAP HANA ODBC Driver64 = /<usr>/sap/hdbclient/libodbcHDB.so
- Richten Sie einen ODBC-Datenquellennamen ein. Verwenden Sie diesen Namen, wenn Sie von ArcGIS eine Verbindung mit der Datenbank herstellen.
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 Desktop-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.
Ändern des Skripts "init_user_param.sh" (nur Linux)
Hinweis:
Eine Korrektur ist erforderlich, um ArcGIS Server 10.5.x unter Linux mit SAP HANA zu verwenden. Wenden Sie sich an den technischen Support von Esri (in den USA) oder an Ihren Distributor (außerhalb der USA), falls Sie diese Konfiguration benötigen.
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.
- 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.
- Öffnen Sie das Skript init_user_param.sh in einem Texteditor.
- 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
- Speichern und schließen Sie das Skript.
- 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
Registrieren der Datenbank
Wenn Sie Web-Services mit Daten in SAP HANA veröffentlichen möchten, registrieren Sie die Datenbank bei den ArcGIS Server-Sites. Anweisungen finden Sie unter Verwalten von registrierten Data Stores in der ArcGIS Pro-Hilfe oder unter Registrieren von Daten bei ArcGIS Server mit Manager.