各製品の資料を入手。
詳細はこちら →Jetty コネクションプールからSnowflake のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします:本記事では、Jetty のWeb アプリからSnowflake のデータに連携する手順を説明します。
最終更新日:2023-06-18
この記事で実現できるSnowflake 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for Snowflake は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にSnowflake のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for Snowflake を設定します。
DBC Driver for Snowflake を JNDI Data Source として設定
次の手順で、Jetty とSnowflake の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル(インストールディレクトリのlib フォルダ下)をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Snowflake のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='snowflakedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="snowflakedemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="snowflakedemo"/></Arg> <Arg>jdbc/snowflakedb</Arg> <Arg> <New class="cdata.jdbc.snowflake.SnowflakeDriver"> <Set name="url">jdbc:snowflake:</Set> <Set name="User">Admin</Set> <Set name="Password">test123</Set> <Set name="Server">localhost</Set> <Set name="Database">Northwind</Set> <Set name="Warehouse">TestWarehouse</Set> <Set name="Account">Tester1</Set> </New> </Arg> </New> </Configure>
Snowflake データベースに接続するには、認証に加えて次のプロパティを設定します。
- Url:自身のSnowflake URL、例えばhttps://orgname-myaccount.snowflakecomputing.com。
- Legacy URL を使用する場合:https://myaccount.region.snowflakecomputing.com
- 自身のURL を見つけるには:
- Snowflake UI の左下にある自身の名前をクリックします。
- Account ID にカーソルを合わせます。
- Copy Account URL アイコンをクリックして、アカウントURL をコピーします。
- Database(オプション):によって公開されるテーブルとビューを、特定のSnowflake データベースのものに制限します。
- Schema(オプション):本製品によって公開されるテーブルとビューを、特定のSnowflake データベーススキーマのものに制限します。
Snowflake への認証
本製品は、Snowflake ユーザー認証、フェデレーション認証、およびSSL クライアント認証をサポートしています。認証するには、User とPassword を設定し、AuthScheme プロパティで認証メソッドを選択します。
キーペア
ユーザーアカウントに定義されたプライベートキーを使用してセキュアなトークンを作成することにより、キーペア認証を使用して認証できます。この方法で接続するには、AuthScheme をPRIVATEKEY に設定し、次の値を設定します。
- User:認証に使用するユーザーアカウント。
- PrivateKey:プライベートキーを含む.pem ファイルへのパスなど、ユーザーに使用されるプライベートキー。
- PrivateKeyType:プライベートキーを含むキーストアの種類(PEMKEY_FILE、PFXFILE など)。
- PrivateKeyPassword:指定されたプライベートキーのパスワード。
その他の認証方法は、ヘルプドキュメントの「Snowflake への認証」セクションを参照してください。
- Url:自身のSnowflake URL、例えばhttps://orgname-myaccount.snowflakecomputing.com。
-
Web xml でリソースを設定します:
jdbc/snowflakedb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/snowflakedb へのルックアップでSnowflake のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource mysnowflake = (DataSource)ctx.lookup("java:comp/env/jdbc/snowflakedb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。