JDBC ドライバーのダウンロード/統合¶

要件¶

Snowflakeクライアントでサポートされているオペレーティングシステムのリストについては、 オペレーティングシステムのサポート をご参照ください。

ご希望のタイプのドライバーのダウンロード¶

ドライバーをダウンロードするには、希望のドライバータイプの手順に従ってください。

オプション：ドライバーパッケージの署名の確認¶

JDBC ドライバーパッケージの署名を確認するには、

1. 公開キーサーバーから、使用している JDBC ドライバーのバージョンのSnowflake GPG 公開キーをダウンロードしてインポートします。

   • バージョン3.22.0以上の場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 2A3149C82551A34A

   • バージョン3.19.1から3.21.0までの場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 5A125630709DD64B

   • バージョン3.13.23から3.19.0までの場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3

   • バージョン3.12.13から3.13.22までの場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C

   • バージョン3.6.26から3.12.12までの場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1

   • バージョン3.6.25以下の場合:

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 93DB296A69BE019A

   注釈

   このコマンドが次のエラーを発生して失敗した場合、

   gpg: keyserver receive failed: Server indicated a failure
   

   Copy

   次に、キーサーバーにポート80を使用することを指定します。

   gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
   

   Copy

2. gpg --verify コマンドを実行して、パッケージの署名を確認します。

   --verify コマンドラインフラグには、署名ファイルとして 以前にダウンロード した .asc ファイルを指定し、署名済みデータを含むファイルとして JAR ファイルを指定します。

   例:

   $ gpg --verify snowflake-jdbc-3.22.0.jar.asc snowflake-jdbc-3.22.0.jar
   gpg: Signature made Wed 22 Feb 2017 04:31:58 PM UTC using RSA key ID <gpg_key_id>
   gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>"

   確認する JDBC ドライバーパッケージの正しいバージョン番号を指定します。この例では、バージョン 3.22.0 は説明のみを目的として使用されています。ドライバーの最新の利用可能なバージョンはそれ以上の場合があります。

   注釈

   署名を確認すると、次のような警告が生成されます。

   gpg: Signature made Mon 24 Sep 2018 03:03:45 AM UTC using RSA key ID <gpg_key_id>
   gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>" unknown
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg: There is no indication that the signature belongs to the owner.
   

   Copy

   警告を回避するために、Snowflake GPG 公開キーの暗黙的な信頼を付与できます。

3. ローカル環境には複数の GPG キーを含めることができます。ただし、セキュリティ上の理由から、Snowflakeは定期的に公開 GPG キーをローテーションします。ベストプラクティスとして、最新の署名済みパッケージで最新のキーが機能することを確認した後、既存の公開キーを削除することをお勧めします。

   $ gpg --delete-key "Snowflake Computing"
   

   Copy

ドライバーのmavenプロジェクトへの統合¶

ドライバーを Maven プロジェクトに統合するには：

• pom.xml ファイルに依存関係としてドライバーを追加します。

例:

• 標準ドライバー

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

• FIPS-準拠ドライバー

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc-fips</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

• Thin-jarドライバー

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc-thin</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

<version> タグは、統合したいドライバーのバージョンを指定します。バージョン 3.22.0 は、この例で説明のみを目的として使用されています。ドライバーの新しいバージョンが利用できるかもしれません。

開発者ノートは、ソースコードとともに GitHub でホストされています。

JNA クラスをクラスパスに追加します。¶

ブラウザーベースの SSO の接続キャッシュ と 多要素認証（MFA）のトークンキャッシュ には、ファイルシステムにデータを安全に保存するために Java Native Access（JNA）クラス を使用する必要があります。

JDBC ドライバーのバージョン3.12.18以降、 JNA クラスは JDBC ドライバー JAR ファイルにパッケージ化されなくなりました。JDBC ドライバー pom.xml ファイルでは、これらのクラスへの依存関係はオプションとしてマークされています。

接続キャッシュまたはトークンキャッシュを使用する必要がある場合は、次のライブラリをクラスパスに追加する必要があります。

• MacおよびLinuxの場合:

  • JNA

• Windowsの場合:

  • JNA

  • JNA プラットフォーム

JDBC ドライバー用の pom.xml ファイルは、 JDBC ドライバーでテストされた JNA クラスのバージョンを指定します。Snowflakeでは、 JNA クラスのこのバージョン（または同じメジャーバージョン）を使用することをお勧めします。

詳細については、 JDBC Maven Central Repositoryのドライバーページ をご参照ください。