SnapLogic でAlloyDB を外部サービスに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

SnapLogic はintegration Platform-as-a-Service（iPaaS）であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC ドライバと組み合わせることで、ユーザーはSnapLogic ワークフローからAlloyDB を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムAlloyDB のデータを高速に扱えます。プラットフォームがAlloyDB に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をAlloyDB に直接プッシュし、サポートされていない操作（主にSQL 関数とJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してAlloyDB のデータを操作することができます。

SnapLogic からAlloyDB に接続する

SnapLogic からAlloyDB のデータに接続するには、CData AlloyDB JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ（デフォルトでは、C:/Program Files/CData/CData JDBC Driver for AlloyDB/lib）にJAR ファイルが作成されます。

AlloyDB JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ（例えば、projects/Jerod Johnson）にManager タブからアップロードします。

接続を設定する

JDBC Driver がアップロードされると、AlloyDB への接続を作成できます。

1. Designer タブに移動します。
2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。
3. Add Account をクリック（または既存のものを選択）して、「Continue」をクリックします。
4. 次のフォームでは、JDBC 接続プロパティを設定します。
   • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
   • JDBC Driver Class をcdata.jdbc.alloydb.AlloyDBDriver に設定します。

   • JDBC URL をAlloyDB JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

     jdbc:alloydb:User=alloydb;Password=admin;Database=alloydb;Server=127.0.0.1;Port=5432RTK=XXXXXX;

     です。

     NOTE： RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください。

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

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

     java -jar cdata.jdbc.alloydb.jar

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

     AlloyDB 接続プロパティの取得・設定方法

     AlloyDB に接続するには、次の接続プロパティが必要です。

     • Server：AlloyDB データベースをホスティングしているサーバーのホスト名またはIP アドレス。
     • Port（オプション）：AlloyDB データベースをホスティングしているサーバーのポート。このプロパティはデフォルトで5432に設定されます。
     • User：AlloyDB サーバーに認証する際に使われるユーザー。
     • Password：AlloyDB サーバーに認証する際に使われるパスワード。
     • Database（オプション）：AlloyDB サーバーに接続する場合のデータベース。設定されていない場合は、ユーザーのデフォルトデータベースが使用されます。

     AlloyDB への認証

     標準認証

     標準認証（事前に提供されたユーザーとパスワードの組み合わせを使用）は、デフォルトの認証形式です。

     標準認証で接続する場合は、これ以上のアクションは必要ありません。

     pg_hba.conf 認証スキーム

     CData 製品がサポートしている他の認証方法では、AlloyDB サーバー上のpg_hba.conf ファイルで有効化する必要があります。

     AlloyDB サーバーでの認証の設定については、こちらを参照してください。

     MD5

     pg_hba.conf ファイルのauth-method をmd5 に設定すると、MD5 パスワード検証を使用して認証できます。

     SASL

     CData 製品は、SASL（特にSCRAM-SHA-256）でパスワードを検証することで認証できます。

     この認証方法を使用するには、pg_hba.conf ファイルのauth-method をscram-sha-256 に設定します。

     Kerberos

     Kerberos 認証は、CData 製品が接続を試行している際にAlloyDB サーバーで開始されます。この認証方法を有効化するには、AlloyDB サーバーでKerberos を設定します。AlloyDB サーバーでのKerberos 認証の設定を完了したら、CData 製品からKerberos 認証を行う方法については、ヘルプドキュメントの「Kerberos の使用」セクションを参照してください。

5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

AlloyDB のデータを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

• Schema name を"AlloyDB" に設定します。
• Table name を、スキーマ名を使用したAlloyDB 用のテーブルに設定します。例えば、"AlloyDB"."Orders" です（ドロップダウンを使用して利用可能なテーブルの全リストを確認できます）。
• テーブルから、使用したい項目ごとにOutput fields を追加します。

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分（以下のハイライト部分）をクリックしてデータをプレビューします。

結果が期待どおりのものであることを確認したら、他のsnap を追加してAlloyDB のデータを別のエンドポイントに渡すこともできます。

AlloyDB のデータを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC ドライバと利用してデータを外部サービスに移すこともできます。

1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
2. Google Sheets に接続するアカウントを追加します。
3. Worksheet Writer snap を、AlloyDB のデータをGoogle Spreadsheet に書き込むよう設定します。

これで、接続済みのパイプラインを実行してAlloyDB からデータを抽出し、Google Spreadsheet にプッシュできます。

外部データをAlloyDB にパイプ

上述のように、JDBC Driver for AlloyDB をSnapLogic から使用してデータをAlloyDB に書き込むことができます。まずは、Generic JDBC - Insert またはGeneric JDBC - Update snap をダッシュボードに追加します。

1. 既存の「Account」（接続）を選択するか、新しく作成します。
2. クエリの設定。
   • Schema name を"AlloyDB" に設定します。
   • Table name をスキーマ名を使用したAlloyDB のテーブルに設定します。例えば、"AlloyDB"."Orders"（ドロップダウンを使用して利用可能な全テーブルの一覧を確認できます）。
   
3. Generic JDBC - Insert/Update snap を保存します。

これで、AlloyDB にデータを書き込んだり、新しいレコードを挿入したり、既存のレコードを更新するsnap が設定できました。

詳細情報と無償評価版

CData JDBC Driver for AlloyDB を使えば、AlloyDB のデータを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。AlloyDB への接続に関する詳細については、CData のAlloyDB 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。