Oracle® RDBMS | ADW コネクターを使用すると、コマンド をチェーンで使用して、Oracle Relational Database Management System (RDBMS) または Autonomous Data Warehouse® (ADW) で構造化クエリ言語 (SQL) 操作を実行できます。例えば、このコネクターを使えば、次のことができる:
-
CREATEまたはUPDATEステートメントまたはSELECTクエリを含む SQL コマンドを実行する。 - Oracle RDBMSまたはADWのテーブルの詳細を取得する。
- Oracle RDBMSまたはADWへのレコード挿入
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
要件
Oracle データベースへの接続を有効にするために、コネクターは基本ユーザー名とパスワード認証で保護された Java データベース接続(JDBC)を使用します。コネクターの設定には、以下のものが必要だ:
- コネクター用にOracle RDBMSまたはADWで作成された指定統合ユーザー
- 統合ユーザーのユーザー名とパスワード
- JDBC 接続の URL(例:
jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./)。 - Oracle ADWに接続するには、データベースのクライアント認証情報またはウォレットファイル
- オンプレミスのデータベースに接続するには、接続用の GroundRunner。
対応バージョン
Oracle® RDBMS | ADW コネクターは、次のデータベース・バージョンと互換性があります :
- 21.x
- 19.x
- 18.3
- 12.2
- 12.1
- 11.2.0.4
ADWウォレットファイル
Oracle ADWへの接続を有効にするには、まず、データベースのクライアント認証情報またはウォレットファイル をダウンロードする。コネクターを設定する際、これらのウォレットファイルをリソース にアップロードします:
cwallet.sso.lck\n* ewallet.p12.lckcwallet.ssoewallet.p12キーストア.jkssqlnet.oratnsnames.oratruststore.jksojdbc.properties
コネクターの接続 URL プロパティでこれらのリソースの場所を示すには、GroundRunner のオペレーティング・システムに基づいてTNS_ADMIN パスを入力します:
- UNIXの場合、
TNS_ADMIN=./ - Microsoft® Windows® の場合、
TNS_ADMIN=.
メモ: コネクターが CloudRunner を使用する場合は、パスTNS_ADMIN=./ を使用します。
Oracle RDBMS | ADWコネクターの設定
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、Oracle RDBMS | ADW と、コネクターで使用するランナーを選択します。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
- Oracle ADW に接続するには、リソース で、データベースのウォレットファイルをアップロードします。
-
プロパティ で、コネクターの詳細を入力します:
プロパティ 詳細 ユーザー名 コネクターの統合ユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 接続URL jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./のように、JDBC接続のURLを入力する。- Oracle RDBMSの場合、接続のオプションプロパティ を追加する。
- Oracle ADWの場合は、選択されたランナーとそのオペレーティング・システムに基づいて、データベースのウォレットファイル用の
TNS_ADMINパスを追加します。
注: デフォルトでは、オラクルRDBMSのポートは
1521です。注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。セキュリティ上、Connection URL プロパティ内にオプションプロパティとしてユーザー認証情報を含むことは避けてください。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
Oracle RDBMSまたはADWへの接続に失敗した場合:
- 統合ユーザーの認証情報を確認します。
- JDBC接続のURLを確認する。
- オンプレミスのデータベースに接続する場合は、コネクターに選択されている GroundRunner を確認してください。
- Oracle ADW に接続する場合は、データベースのウォレットファイルがリソース の下にアップロードされていることを確認し、
TNS_ADMINのパスを接続 URL プロパティで確認します。必要であれば、Oracle ADWからウォレットファイルをダウンロードし、リソース の下に再度アップロードします。
接続がコマンドの実行に失敗した場合は、その入力(SQL構文やテーブルなど)が有効であることを確認する。