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

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData JDBC Driver for Airtable を使用して、WebLogic 上で動作するWeb アプリケーションからAirtable のデータ に接続します。

CData JDBC Driver for Airtable を使えば、標準的な手順に沿ってAirtable のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for Airtable を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.airtable.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.airtable.jar;%PRE_CLASSPATH%

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

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

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

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

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

    • Driver Class Name: ドライバークラスを入力します(cdata.jdbc.airtable.AirtableDriver)。
    • URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。

      jdbc:airtable:APIKey=keymz3adb53RqsU;BaseId=appxxN2fe34r3rjdG7;TableNames=TableA,...;ViewNames=TableA.ViewA,...;

      Airtable への接続

      それでは、Airtable に接続していきましょう。CData 製品は、Airtable にテーブルとビューを要求します。 Schema プロパティ(オプション)を使用すると、表示されるテーブルおよびビューを特定のベースに制限できます。 特定のベースに制限したい場合は、このプロパティを使用するスキーマの名前に設定してください。(これはAirtable のBase 名に相当します。)

      すべてのAirtable Bases に加えて、DataModelInformation という名前の静的スキーマもご利用いただけます。 このスキーマでは、Bases、Tables、Users のような静的テーブルをクエリできます。 DisplayObjectIdsTrue に設定されている場合、Schema の値は名前ではなくAirtable Base id に設定する必要があります。

      Airtableへの認証

      続いて、認証方法を設定しましょう。個人用アクセストークンまたはOAuth PKCE のいずれかを使用してAirtable に認証できます。

      個人用アクセストークン

      個人用アクセストークンをまだ生成していない場合は、以下のステップで生成してみましょう。

      1. ユーザーアカウントにログインします
      2. "https://airtable.com/create/tokens" に移動します
      3. Create new token をクリックします
      4. Scopes で、Add a scope をクリックして以下の各スコープを追加します
        • data.records:read
        • data.records:write
        • schema.bases:read
      5. Access で、トークンにアクセス権を付与するすべてのワークスペースとベースを追加します
      6. Create token をクリックしてトークンを生成します。生成されたトークンは一度しか表示されませんので、必ずコピーして保存してください

      次に、以下の設定を行います。

      • AuthSchemePersonalAccessToken
      • Token:先ほど生成した個人用アクセストークンの値

      OAuth PKCE については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご確認ください。

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

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

      java -jar cdata.jdbc.airtable.jar
      

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

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

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

その他のWebLogic 連携

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

はじめる準備はできましたか?

Airtable Driver の無料トライアルをダウンロードしてお試しください:

 ダウンロード

詳細:

Airtable Icon Airtable JDBC Driver お問い合わせ

Airtable に連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。