SnapLogic でIBM Cloud Object Storage を外部サービスに連携

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

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

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

SnapLogic からIBM Cloud Object Storage に接続する

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

IBM Cloud Object Storage JDBC Driver をアップロードする

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

接続を設定する

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

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

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

     jdbc:ibmcloudobjectstorage:ApiKey=myApiKey;CloudObjectStorageCRN=MyInstanceCRN;Region=myRegion;OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;RTK=XXXXXX;

     です。

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

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

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

     java -jar cdata.jdbc.ibmcloudobjectstorage.jar

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

     Cloud Object Storage 接続プロパティの取得・設定方法

     Cloud Object Storage に接続する前に、Cloud Object Storage インスタンスを登録してCloud Object Storage API キーとCRN を取得していきます。

     Cloud Object Storage の新規インスタンスの登録

     IBM Cloud アカウントにCloud Object Storage がまだない場合は、以下の手順に従ってアカウントにSQL Query のインスタンスをインストールできます。

     1. IBM Cloud アカウントにログインします。
     2. Cloud Object Storage ページに移動して、インスタンス名を指定して「作成」をクリックします。Cloud Object Storage の新規インスタンスにリダイレクトされます。

     API キー

     API キーは以下の手順で取得できます。

     1. まずは、IBM Cloud アカウントにログインします。
     2. API キーページに移動します。
     3. 中央右隅のIBM Cloud APIキーの作成 をクリックして、新しいAPI キーを作成します。
     4. ポップアップウィンドウが表示されたら、API キーの名前を指定して作成をクリックします。ダッシュボードからはアクセスできなくなるため、API Key を控えておきましょう。

     Cloud Object Storage CRN

     デフォルトでは、CData 製品はCloud Object Storage CRN を自動で取得します。ただし、複数のアカウントがある場合は、CloudObjectStorageCRN を明示的に指定する必要があります。この値は、次の2つの方法で取得できます。

     • Services ビューをクエリする。これにより、IBM Cloud Object Storage インスタンスとそれぞれのCRN がリストされます。
     • IBM Cloud で直接CRN を見つける。これを行うには、IBM Cloud のダッシュボードに移動します。リソースリストで、ストレージからCloud Object Storage リソースを選択してCRN を取得します。

     IBM Cloud Object Storage への接続

     これで準備は完了です。以下の接続プロパティを設定してください。

     • InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 認証を繰り返す必要がなく、さらに自動でアクセストークンを設定できます。
     • ApiKey：セットアップ中に控えたAPI キーを指定。
     • CloudObjectStorageCRN（オプション）：控えておいたCloud Object Storage のCRN に設定。Cloud Object Storage アカウントが複数ある場合のみ設定する必要があります。

     プロパティを設定したら、これで接続設定は完了です。

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

IBM Cloud Object Storage データを読み込む

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

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

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

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

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

IBM Cloud Object Storage データを外部サービスにパイプ

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

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

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

詳細情報と無償評価版

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