ArcGIS クライアントから SAP HANA データベースに接続するには、SAP HANA クライアント ODBC ドライバーを ArcGIS クライアント コンピューターにインストールして構成します。
注意:
既存の SAP ユーザーは、SAP HANA クライアントを SAP Support Portal の Software Downloads から入手できます。
すべての ArcGIS クライアント コンピューター上で ODBC ドライバーが構成されたら、データベース接続ファイルを作成します。 SAP HANA データベース内のデータを参照する ArcGIS Server Web サービスを公開するには、データベース接続ファイルを ArcGIS Server サイトに登録します。
SAP HANA クライアントのインストールと構成
SAP Support Portal の [ソフトウェア ダウンロード] から、サポートされている 64 ビット SAP HANA クライアントをダウンロードして、すべての ArcGIS Pro コンピューター、および SAP HANA データベースへの接続を登録する ArcGIS Server サイトのコンピューターにインストールします。
SAP HANA の指示に従って ODBC クライアントをインストールおよび構成します。
ArcGIS Pro からの接続
ArcGIS Pro プロジェクトから SAP HANA に接続するには、SAP HANA クライアント ODBC ドライバーを ArcGIS Pro コンピューターにインストールし、データベース接続を作成します。
データベース接続を作成するには、[データベース接続] ダイアログ ボックスまたは [データベース接続の作成 (Create Database Connection)] ジオプロセシング ツールを使用します。
サイトに関する下記のすべての条件が満たされている場合は、SAP HANA サーバー名と SQL ポート番号を使用してデータベースに接続できます。
- SAP HANA のオンプレミスのインストールに接続している。
- ArcGIS Pro の一般リリース バージョンから接続している。
- SAP HANA サーバーの SAP HANA サーバー名と SQL ポート番号の文字数が 31 文字未満である。
上記の条件のいずれかが満たされていない場合は、次の手順を実行してデータベースに接続する前に、SAP HANA クライアント ODBC ドライバー用にシステムのデータ ソース名 (DSN) を構成しておく必要があります。 データ ソース名の構成手順については、SAP HANA のドキュメントをご参照ください。
[データベース接続] ダイアログ ボックスを使用して SAP HANA に接続するには、次の手順に従います。
- ArcGIS Pro で [カタログ] ウィンドウを開きます。
- [データベース] を右クリックして [新しいデータベース コネクション] をクリックします。
- [データベース プラットフォーム] ドロップダウン リストで [SAP HANA] を選択します。
- [データ ソース] テキスト ボックスに、次のいずれかを入力します。
- データベースとの通信に使用される SAP HANA サーバー名と SQL ポート番号 (それぞれをコロン (:) で区切る)。 たとえば、SAP HANA サーバーの完全修飾名が myserver.network.com で、SAP HANA が通信に使用するポートが 98765 である場合は、「myserver.network.com:98765」と入力します。 または、[その他のプロパティ] でポート番号を設定することもできます (下記のステップ 9 を参照)。
- ODBC ドライバー用に構成されたデータ ソース名。
- 認証タイプにデータベース認証を使用します。
オペレーティング システム認証はサポートされません。
- 有効なデータベース ユーザー名とパスワードを [ユーザー名] テキスト ボックスと [パスワード] テキスト ボックスにそれぞれ入力します。
- 接続の一部としてログイン情報を保存しない場合は、[ユーザー名とパスワードを保存する] チェックボックスをオフにします。
これは、データベースのセキュリティの維持に役立ちます。 ただし、オフにした場合、ArcGIS Pro からの接続時にユーザー名とパスワードを入力するよう求められます。
注意:
ArcGIS Server サイトに登録する接続ファイルの場合またはこの接続ファイルを経由してアクセスするデータを検索する場合は、[ユーザー名とパスワードを保存する] チェックボックスをオンにする必要があります。
- [接続ファイル名] フィールドに接続ファイルの名前を入力します。
接続情報を指定すると、デフォルト名が作成されます。 デフォルトを使用するか、より説明的なファイル名を入力できます。
これは、[カタログ] ウィンドウとビューに表示される名前であり、ディスクに保存される .sde ファイルの名前です。
- 必要に応じて、[その他のプロパティ] セクションを展開し、接続パラメーターと値を入力します。
追加およびオプションの接続パラメーターについては、SAP HANA のドキュメントをご参照ください。
- [整合チェック] をクリックし、接続情報が有効で、データベースにアクセスできることを確認します。
データベースにジオデータベースが含まれ、接続が有効である場合は、[ジオデータベース プロパティ] タブがアクティブになります。
- [OK] をクリックして、接続ファイルを作成します。
データベース接続が [カタログ] ウィンドウの [データベース] に表示され、接続ファイル (.sde) が ArcGIS Pro のプロジェクト ディレクトリに作成されます。
ArcGIS Server からの接続
SAP HANA データをフェデレートされているかスタンドアロンの ArcGIS Server サイトに公開し、データを SAP HANA に維持するには、ArcGIS Server サイトの各コンピューターに 64 ビット SAP HANA クライアント ODBC ドライバーをインストールし、データベース接続ファイルをサイトに登録します。
ArcGIS Server サイトのコンピューターを構成したら、SAP HANA データベースへのデータベース接続を作成し、接続ファイルを ArcGIS Server サイトに登録します。
ArcGIS Server コンピューター (Linux) への SAP HANA のインストール
SAP HANA クライアント ODBC ドライバーをダウンロードします。 ArcGIS Server サイトの各コンピューター上にクライアントを配置してインストールし、各 ArcGIS Server Linux コンピューター上で ArcGIS Server init_user_param.sh スクリプトを編集します。
- SAP Support Portal からサポートされている 64 ビット SAP HANA クライアントをダウンロードして、ArcGIS Server サイトの各コンピューターにインストールします。
- 各 ArcGIS Server コンピューターに Linux ODBC ドライバー マネージャーがインストールされていない場合は、インストールします。
- 各コンピューターの ArcGIS Server のインストール所有者がデータベース クライアント ライブラリに対する読み取りおよび実行以上の権限を持っていることを確認します。
- テキスト エディターで init_user_param.sh スクリプトを開きます。
- export で始まる行からコメント記号 (#) を削除して、<SAPHANA_InstallDir> の情報を 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
- スクリプトを保存して閉じます。
- init_user_param.sh ファイルの変更を有効にするには、ArcGIS Server を再起動する必要があります。
そのためには、stopserver.sh スクリプトを実行し、startserver.sh サイトの各コンピューターで ArcGIS Server スクリプトを実行します。
./stopserver.sh
./startserver.sh
データベース クライアント ファイルをインストールしたら、クライアント ファイルを参照するように、init_user_param.sh とともにインストールされた ArcGIS Server スクリプトを変更します。 このスクリプトにアクセスするには、<ArcGIS Server installation directory>/arcgis/server/usr ディレクトリを参照します。
init_user_param.sh サイト内のすべてのコンピューターで ArcGIS Server を更新する必要があります。
SAP HANA クライアント ODBC ドライバーをインストールしたら、データベース接続を作成して ArcGIS Server サイトに登録できます。 ただし、下記の条件が該当する場合は、データベース接続を作成および登録する前に、ODBC ドライバー用にデータ ソース名を構成する必要があります。
- SAP HANA 1.0 (サポートされている任意のサービス パック リリース) を使用している。
- SAP HANA クラウドに接続している。
- ArcGIS Server 10.6 以前からデータベースに接続している。
- SAP HANA サーバーの SAP HANA サーバー名と SQL ポート番号の文字数が 31 文字を超えている。
Linux での ODBC データ ソース名の構成 (必要な場合)
データ ソース名が必要な場合は、次の手順に従って、各 ArcGIS Server Linux コンピューター上で SAP HANA クライアント ODBC ドライバー用にシステムのデータ ソース名を構成します。
注意:
この同じデータベースに接続する SAP HANA ODBC クライアントを構成するときには、すべて同じ ODBC データ ソース名を使用します。 たとえば、ArcGIS Pro コンピューター上のデータ ソース名を ArcGIS Server サイトのコンピューター上の SAP HANA クライアント ODBC ドライバーのデータ ソース名と同じになるように設定します。 同じ名前を使用しない場合、公開時に問題が発生します。これは、ArcGIS が、公開対象のデータの接続文字列と、登録されるデータベースとを比較するためです。
- ODBC データ ソース名を構成するには、SAP HANA ODBC 接続ファイルである .odbc.ini と .odbcinst.ini を編集します。
これらのファイルの名前は「.odbc.ini」と「.odbcinst.ini」にする必要があります。
- .odbc.ini ファイルをテキスト エディターで開き、データベースに接続するために必要な情報を入力します。
.odbc.ini ファイルで等号 (=) の前後にスペースがないことを確認します。
たとえば、次のエントリでは等号の前後にスペースがありません。 SPATIALTYPES=1 エントリが含まれています。 このエントリは、SAP HANA 2.0 以降のサポートされているバージョンに接続する場合には不要です。
[<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
- SAP HANA クラウドに接続するには、暗号化された接続を使用しますが、このためには、ArcGIS Server サイト内のすべてのコンピューターが、SAP HANA クラウドの証明書に署名する証明機関 (CA) を確認するために、DigiCertGlobalRootCA.crt.pem ファイルを参照できる必要があります。 SAP ヘルプ ポータルからこのファイルをダウンロードし、サイト内の各コンピューター上のディレクトリに配置します。 Encrypt=Yes を設定し、sslTrustStore パラメーターを次のいずれかに設定します。
- 次のエントリに示されているように、ローカル コンピューター上の DigiCertGlobalRootCA.crt.pem ファイルの場所を指定します。
[<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
- DigiCertGlobalRootCA.crt.pem ファイルからの証明書の文字列を指定します。 DigiCertGlobalRootCA.crt.pem ファイルを開いて内容をコピーし、以下に示されているように、.odbc.ini ファイル内の BEGIN CERTIFCATE と END CERTIFCATE 表記の間に貼り付けます。
[<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
- 次のエントリに示されているように、ローカル コンピューター上の DigiCertGlobalRootCA.crt.pem ファイルの場所を指定します。
- .odbc.ini ファイルを保存して閉じます。
- .odbcinst.ini ファイルを開き、ODBC ドライバー パスが含まれるように編集します。
.odbcinst.ini ファイルでは、以下の例に示すようなスペースは不要です。
Description =SAP HANA ODBC Driver64 = /<usr>/sap/hdbclient/libodbcHDB.so
- .odbcinst.ini ファイルを保存して閉じます。
データベースへの接続
上記のとおり、ArcGIS Pro の [データベース接続] ダイアログ ボックスを使用して、データベースに接続できます。
または、ArcGIS Pro で [データベース接続の作成 (Create Database Connection)] ツールを実行するか、Python を使用して ArcGIS Server コンピューターから [データベース接続の作成 (Create Database Connection)] コマンドを実行して、データベースに接続するデータベース接続ファイル (.sde) を作成することができます。
ArcGIS Server でデータベース接続ファイルを使用するには、ユーザー情報を接続ファイルに保存する必要があります。
データベースの登録
SAP HANA のデータを使用して Web サービスを公開する場合は、データベース接続を作成して、ArcGIS Server サイトに登録します。
ArcGIS Server サイトでデータにアクセスできるようにするには、作成したデータベース接続ファイルを使用して、ArcGIS Pro に登録済みデータ ストアを追加するか、ポータルにデータ ストア アイテムを追加します。