JDBC コネクターを使用すると、Java® データベース接続 (JDBC) をサポートするオンプレミスのソリューションで、構造化クエリ言語 (SQL) 操作を実行するためにチェーンでコマンド を使用できます。例えば、このコネクターを使えば、次のことができる:
-
CREATEまたはUPDATEステートメントまたはSELECTクエリを含む SQL コマンドを実行する。 - データベーステーブルの詳細を取得する
- JDBC経由でデータベースにレコードを挿入する
メモ Amazon® Redshift®,IBM® Db2®,Microsoft® SQL Server®,MySQL®,NetSuite® JDBC に接続する場合、Oracle® Relational Database Management System (RDBMS) または Autonomous Data Warehouse (ADW),Postgres®,SAP HANA® JDBC, またはSnowflake®、代わりにそれぞれのコネクターを使用してください。
前提条件
JDBC 接続を保護するために、コネクターは基本的なユーザー名とパスワード認証を使用します。コネクターの設定には、以下のものが必要だ:
- 接続先のソリューションに設定されている統合ユーザー。
- 統合ユーザーの認証情報。
- JDBC 接続の URL(例:
jdbc:solution://host:port/database - GroundRunner コネクター専用。CloudRunner はサポートされていません。
- 接続用のJDBCドライバ。そのクラス名称とGroundRunnerのファイルシステム上のパスを含む。
- このコネクターを使用するときにカスタム Java オプションを提供するには、GroundRunner の JDK_JAVA_OPTIONS 環境変数を設定します。 例えば、Databricksを使用している場合、次のように使用します:
JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". これは、GroundRunner のインストールと管理 で設定した構成変数と同様です。
インポート: この変数の設定後、GroundRunnerが動作しているコンピュータを再起動する必要があります。
メモ:.jar ファイルはリソースとしてアップロードできないため、ドライバは GroundRunner 上に配置する必要があります。
JDBCコネクターの設定
注: 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から、接続 をクリックし、右上の作成 をクリックします。
-
コネクタ接続 で、JDBC と接続で使用する GroundRunner を選択します。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
[プロパティ]で、接続の詳細を入力します。
プロパティ 詳細 ユーザー名 コネクターの統合ユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 接続URL jdbc:solution://host:port/databaseのように、JDBC接続のURLを入力する。JDBCドライブクラス JDBCドライバの.jarファイルのクラス名称を入力します。例えば、Sybase® の場合は、 com.sybase.jdbc.sybdriverと入力します。JDBCドライバへのパス GroundRunnerのファイルシステムにインストールされているJDBCドライバのパスを入力します。 注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。
- 接続に使用する環境を選択し、保存します。
- GroundRunnerが実行されているコンピュータをシャットダウンして再起動し、JVMを再初期化してください。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
JDBC接続に失敗した場合:
- 統合ユーザーの認証情報を確認します。
- JDBC接続のURL(サーバー、ポート、データベースを含む)を確認する。
- コネクターに入力された JDBC ドライバのクラス名称またはパスを確認します。
接続がコマンドの実行に失敗する場合は、その入力(SQL 構文やテーブルなど)が有効であることを確認してください。