WebLogic のコネクションプールからSnowflakeに接続

CData JDBC Driver for Snowflake を使えば、標準的な手順に沿ってSnowflake のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for Snowflake をWebLogic Server にデプロイする方法を説明します。

はじめに

---

WebLogic Server へのJDBC ドライバーのデプロイ

ドライバーをデプロイするには、ドライバーJAR をクラスパスに追加します。.lic ファイルは、JAR と同じフォルダに配置する必要があります。 これらのファイルは、インストールディレクトリのlib サブフォルダに格納されています。

すべてのドメインにドライバーを追加する場合は、WL_HOME\common\bin\commEnv.cmd/sh にあるWEBLOGIC_CLASSPATH 環境変数の先頭にJAR のパスを追加します。このスクリプトは WL_HOME\common\bin\ にあります。以下に例を示します。

set WEBLOGIC_CLASSPATH=your-installation-directory\lib\cdata.jdbc.snowflake.jar;%WEBLOGIC_CLASSPATH%

WebLogic 12.2.1 では、特定のドメインにドライバーを追加する場合、ドライバーJAR と.lic ファイルをDOMAIN_HOME\lib（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）に配置するだけで済みます。これらのファイルは、起動時にサーバーのクラスパスに追加されます。

以前のバージョンでは、手動でドライバーをクラスパスに追加する必要があります。setDomainEnv.cmd/sh のPRE_CLASSPATH 環境変数の先頭に、以下の内容を追加します。このスクリプトは、対象ドメインのフォルダのbin サブフォルダにあります。

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.snowflake.jar;%PRE_CLASSPATH%

これらの変更を行った後、サーバーを再起動します。

Snowflake 用JDBC データソースの作成

ドライバーをデプロイしたら、WebLogic 管理コンソールにログインして接続を作成します。

1. ドメイン構造ツリーで、Services -> Data Sources -> New -> Generic Data Source をクリックします。
2. JDBC Data Source Properties ページで、以下の情報を入力します。
   • Name: ユーザーフレンドリーな名前を入力します（例：snowflakejdbc）。
   • JNDI Name: JDBC データソースのバインド先のパスを入力します（例：jdbc/Snowflake）。

   • Database Type: Other を選択します。

   

3. Next をクリックしてデフォルトオプションを使用します。最後のページで、以下の情報を入力してTest Configuration をクリックします。

   • Driver Class Name: ドライバークラスを入力します（cdata.jdbc.snowflake.SnowflakeDriver）。

   • URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。

     jdbc:snowflake:User=Admin;Password=test123;Server=localhost;Database=Northwind;Warehouse=TestWarehouse;Account=Tester1;

     それでは、Snowflake データベースに接続していきましょう。認証に加えて、以下の接続プロパティを設定します。

     • Url：お使いのSnowflake URL を指定します。例：https://orgname-myaccount.snowflakecomputing.com
       • Legacy URL を使用する場合：https://myaccount.region.snowflakecomputing.com
       • ご自身のURL は以下のステップで確認できます。
         1. Snowflake UI の左下にあるユーザー名をクリックします
         2. Account ID にカーソルを合わせます
         3. Copy Account URL アイコンをクリックして、アカウントURL をコピーします
     • Database（オプション）：CData 製品によって公開されるテーブルとビューを、特定のSnowflake データベースのものに制限したい場合に設定します
     • Schema（オプション）：CData 製品によって公開されるテーブルとビューを、特定のSnowflake データベーススキーマのものに制限したい場合に設定します

     Snowflakeへの認証

     CData 製品では、Snowflake ユーザー認証、フェデレーション認証、およびSSL クライアント認証をサポートしています。認証するには、User とPassword を設定し、AuthScheme プロパティで認証方法を選択してください。

     キーペア認証

     ユーザーアカウントに定義されたプライベートキーを使用してセキュアなトークンを作成し、キーペア認証で接続することも可能です。この方法で接続するには、AuthScheme をPRIVATEKEY に設定し、以下の値を設定してください。

     • User：認証に使用するユーザーアカウント
     • PrivateKey：プライベートキーを含む.pem ファイルへのパスなど、ユーザーに使用されるプライベートキー
     • PrivateKeyType：プライベートキーを含むキーストアの種類（PEMKEY_FILE、PFXFILE など）
     • PrivateKeyPassword：指定されたプライベートキーのパスワード

     その他の認証方法については、ヘルプドキュメントの「Snowflakeへの認証」セクションをご確認ください。

     組み込みの接続文字列デザイナー

     JDBC URL の作成には、Snowflake JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

     java -jar cdata.jdbc.snowflake.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     
   • Database User Name: JDBC URL で指定していない場合は、ユーザー名を入力します。
   • Password: JDBC URL で指定していない場合は、パスワードを入力します。
   

JDBC データソースをデプロイするサーバーを選択すると、Snowflake のデータ に接続できるようになります。

その他のWebLogic 連携

上記の手順では、シンプルなコネクションプーリングシナリオでのドライバー設定方法を説明しました。その他のユースケースや詳細については、Oracle Fusion Middleware ドキュメントのWebLogic Data Sources 章のJDBC セクションを参照してください。