Snowflake® JDBC コネクターを使用すると、チェーンでコマンド を使用して、Snowflake データベースで構造化クエリ言語(SQL)操作を実行できます。例えば、このコネクターを使えば、次のことができる:
-
CREATEまたはUPDATEステートメントまたはSELECTクエリを含む SQL コマンドを実行する。 - Snowflakeでテーブルの詳細を取得する
- Snowflakeデータベースにレコードを挿入する
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
Snowflakeへの接続を有効にするには、まず組織のセキュリティ管理者が 構成からを有効にする必要があります。
コネクター自体はJavaデータベース接続(JDBC)を使用し、ベーシック認証またはキーペア認証で保護される。コネクターの設定には、以下のものが必要だ:
- コネクター用に Snowflake で作成した指定統合ユーザー名と、統合ユーザーのユーザー名とパスワード。
メモ: ベーシック認証は2025年11月をもってサポートされなくなります。代わりにキーペア認証の使用を推奨する。詳細はこちら。
- (オプション)キーペア認証を有効にするための秘密鍵ファイル 。
- JDBC接続のURL,例:
jdbc:snowflake://[accountName].snowflakecomputing.com/?[options] - オンプレミスのSnowflakeデータベースに接続するには、コネクター向けGroundRunner for the connection (Snowflakeのクラウドインスタンスに接続するには、デフォルトのCloudRunnerを使用します)。
スノーフレーク・コネクターの設定
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター接続 で、Snowflake JDBC と接続で使用するランナーを選択します。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
- (オプション)リソース で、秘密鍵ファイルをアップロードする。次へのステップで、このファイル名称を"Private key file "フィールドに正確に入力する必要があります。
-
プロパティ で、コネクターの詳細を入力します:
プロパティ 詳細 ユーザー名 認証するユーザー名を入力します。秘密鍵ファイルが以下に提供されている場合、このユーザー名で自動的に認証されます。 パスワード ユーザー名 プロパティのパスワードを入力します。以下に秘密鍵ファイルが提供されている場合は、ここにパスワードを入力する。
メモ: 暗号化されていないキーファイルの場合は空白のままにする。
接続URL jdbc:snowflake://[accountName].snowflakecomputing.com/のように、JDBC 接続の URL を入力します。接続のオプションプロパティ を含むには、それらをクエリ文字列として追加します。 例えば、1分以内に接続に失敗した場合、自動的にログインをタイムアウトさせるには、
?loginTimeout=60を追加する。秘密鍵ファイル (オプション)サーバーの公開キーによる認証に使用する。ユーザー名とパスワードは上記の欄に入力してください。
詳細はこちら:キー・ペア認証とキー・ペア回転
メモ: ファイル名は、接続リソースとしてアップロードされたファイルと一致しなければならない。
注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。セキュリティ上、Connection URL プロパティ内にオプションプロパティとしてユーザー認証情報を含むことは避けてください。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
- Snowflakeへの接続に失敗した場合:
- 認証情報を確認する。
- キー・ペア認証を使用する場合は、リソース を通じてアップロードされたファイル名が、秘密鍵ファイル フィールドに入力されたファイル名と一致していることを確認する。
- アカウント名称を含むJDBC接続のURLを確認する。
- オンプレミスのデータベースに接続する場合は、コネクターに選択されている GroundRunner を確認してください。
- 接続がコマンドの実行に失敗した場合、SQL構文やテーブルなどの入力が有効であることを確認します。
- エラーメッセージIncoming request with IP/Token XX.XX.XX is not allowed to access Snowflake が表示されて Snowflake コマンドが失敗した場合は、このSnowflake の記事 を参照して、必要な IP アドレス(CloudRunner または GroundRunner のいずれか)を Snowflake インスタンスの許可 IP リストに追加してください。