SAP HANA® JDBC コネクターを使用すると、SAP high-performance analytic appliance (HANA) で構造化クエリ言語 (SQL) 操作を実行するためにコマンド をチェーンで使用できます。例えば、このコネクターを使えば、次のことができる:
-
CREATEまたはUPDATEステートメントまたはSELECTクエリを含む SQL コマンドを実行する。 - SAP HANAでテーブルの詳細を取得する
- SAP HANAデータベースへのレコード挿入
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
SAP HANAへの接続を可能にするために、コネクターはJavaデータベース接続(JDBC)を使用し、基本的なユーザー名とパスワード認証で保護されます。コネクターの設定には、以下のものが必要だ:
- コネクター用にSAP HANAで作成された指定統合ユーザー
- 統合ユーザーのユーザー名とパスワード
- JDBC接続のURL,例:
jdbc:sap://<server>:<port>[/?<options>] - SAP HANAのオンプレミスインスタンスに接続するには、接続用のGroundRunner
メモ: SAP HANA のクラウドインスタンスに接続するには、デフォルトの CloudRunner を使用します。
SAP HANA JDBCコネクターの設定
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から、接続 をクリックし、右上の作成 をクリックします。
-
Connector Connection で、SAP HANA JDBC と接続で使用するランナーを選択します。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、コネクターの詳細を入力します:
プロパティ 詳細 ユーザー名 コネクターの SAP HANA 統合ユーザーのユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 接続URL jdbc:sap://localhost:<server>:<port>/?<options> のように、JDBC 接続の URL に
任意のオプション・プロパティをクエリ文字列として付加して入力します。例えば、接続の待ち時間とタイムアウトを無効にするには、jdbc:sap://localhost:30015/?latency=0&communicationtimeout=0.注: デフォルトでは、ポートは
30015です。しかし、これは環境により異なる可能性があります。注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。セキュリティのため、Connection URL 入力内にオプションプロパティとしてユーザー認証情報を含むことは避けてください。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
SAP HANAへの接続に失敗した場合:
- 統合ユーザーの認証情報の確認
- サーバーとポートを含むJDBC接続のURLを確認する。
接続がコマンドの実行に失敗した場合は、その入力(SQL構文やテーブルなど)が有効であることを確認する。