ArcGIS から SAP HANA への接続—ArcGIS Pro

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 がインストールされているオペレーティングシステムに固有の手順に従ってください。

ArcGIS Server サイトのコンピューターを構成したら、SAP HANA データベースへのデータベース接続を作成し、接続ファイルを ArcGIS Server サイトに登録します。

ArcGIS Server コンピューター (Microsoft Windows) への SAP HANA のインストール

SAP HANA クライアント ODBC ドライバーをダウンロードし、ArcGIS Server サイトの各コンピューターにインストールします。

SAP HANA クライアント ODBC ドライバーを各 ArcGIS Server Windows コンピューターにインストールします。

SAP Support Portal からサポートされている 64 ビット SAP HANA クライアントをダウンロードして、ArcGIS Server サイトの各コンピューターにインストールします。
Windows システムの PATH 環境変数に SAP HANA クライアントのインストールディレクトリを追加します。
たとえば、SAP HANA クライアント ODBC ドライバーを C:\Program Files\sap\hdbclient にインストールした場合は、それを PATH 環境変数に追加します。

SAP HANA クライアント ODBC ドライバーをインストールしたら、ArcGIS Server サイトへのデータベース接続の登録を開始できます。ただし、下記の条件が該当する場合は、データベース接続を登録する前に、ODBC ドライバー用にデータソース名を構成する必要があります。

SAP HANA 1.0 (サポートされている任意のサービスパックリリース) を使用している。
SAP HANA クラウドに接続している。
ArcGIS Server 10.6 以前からデータベースに接続している。
SAP HANA サーバーの SAP HANA サーバー名と SQL ポート番号の文字数が 31 文字を超えている。

Windows での ODBC データソース名の構成 (必要な場合)

データソース名が必要な場合は、次の手順に従って、各 ArcGIS Server Windows コンピューター上で SAP HANA クライアント ODBC ドライバー用にシステムのデータソース名 (DSN) を構成します。

注意:

ArcGIS からデータベースに接続するときに、データソース名を使用します。この同じデータベースに接続する SAP HANA ODBC クライアントを構成するときには、すべて同じ名前を使用します。たとえば、ArcGIS Pro コンピューター上で SAP HANA クライアント ODBC ドライバーを構成するときには、ArcGIS Server コンピューター上で ODBC ドライバーに対するデータソース名を構成するときに使用する名前と同じ名前を使用します。同じ名前を使用しない場合、公開時に問題が発生します。これは、ArcGIS が、公開対象のデータの接続文字列と、登録されるデータベースとを比較するためです。

ODBC Data Source Administrator (64 ビット) を開きます。
ODBC Data データソースアドミニストレーター (64 ビット) の [システム DSN] タブをクリックし、[追加] をクリックします。
[データソースの新規作成] ダイアログボックスが表示されます。
SAP HANA ODBC クライアントを選択して [完了] をクリックします。
データベースの [Data Source Name]、[Description]、[Server:Port] 情報を入力します。
TLS/SSL セクションで、[Connect to the database using TLS/SSL] および [Validate the TLS/SSL certificate] をオンにします。
[ODBC Advanced Setup] ダイアログボックスを開き、[Special property settings] セクションに SPATIALTYPES=1 というキー値を追加します。 [OK] をクリックして変更内容を適用し、[ODBC Advanced Setup] ダイアログボックスを閉じます。
注意:
ArcGIS Server とサポートされているバージョンである SAP HANA 2.0 以降を使用している場合、この手順は省略できます。
ODBC クライアント設定および ODBC Data Source Administrator で [OK] をクリックして閉じます。

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 ドライバーマネージャーがインストールされていない場合は、インストールします。

データベースクライアントファイルをインストールしたら、クライアントファイルを参照するように、init_user_param.sh とともにインストールされた ArcGIS Server スクリプトを変更します。このスクリプトにアクセスするには、<ArcGIS Server installation directory>/arcgis/server/usr ディレクトリを参照します。

init_user_param.sh サイト内のすべてのコンピューターで ArcGIS Server を更新する必要があります。

各コンピューターの 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

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
```
.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 に登録済みデータストアを追加するか、ポータルにデータストアアイテムを追加します。

このトピックへのフィードバック

注意: