CData Connect AI を使用して Google Cloud Data Fusion でリアルタイムの JSON Services パイプラインを構築

Google Cloud Data Fusion は、ビジュアルインターフェースを使用してさまざまなソースと同期先間でデータを接続、変換、移動できるため、データパイプラインの構築と管理を簡素化します。CData Connect AI と組み合わせることで、ELT/ETL データパイプラインの構築と管理にJSON servicesへのアクセスが可能になります。この記事では、CData Connect AI を使用して JSON へのライブ接続を作成する方法と、Cloud Data Fusion プラットフォームからリアルタイムのJSON servicesに接続・アクセスする方法を説明します。

Cloud Data Fusion 用の JSON 接続を設定

Cloud Data Fusion から JSON への接続は、CData Connect AI によって実現されます。Cloud Data Fusion からJSON servicesを扱うには、まず JSON 接続を作成・設定します。

1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック

2. Add Connection パネルから「JSON」を選択

3. JSON に接続するために必要な認証プロパティを入力します。

   データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。CData 製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

   URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

   DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

   • Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。CData 製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
   • FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
   • Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

   リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

   Amazon S3 内のJSON への接続

   URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。

   • AWSAccessKey：AWS アクセスキー（username）に設定。
   • AWSSecretKey：AWS シークレットキーに設定。

   Box 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。

   Dropbox 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

   SharePoint Online SOAP 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。

   SharePoint Online REST 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。

   FTP 内のJSON への接続

   URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。

   Google Drive 内のJSON への接続

   デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。

   
4. Save & Test をクリック
5. Add JSON Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。

Personal Access Token を追加

REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。

1. Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
3. PAT に名前を付けて Create をクリック。
4. Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。

接続の設定と PAT の生成が完了したら、Cloud Data Fusion からJSON servicesに接続する準備が整いました。

Cloud Data Fusion から JSON に接続

以下の手順に従って、CData Connect AI JDBC ドライバーを介して Cloud Data Fusion から JSON への接続を確立します：

1. CData Connect AI JDBC ドライバーをダウンロード・インストール：
   1. CData Connect AI の Integrations ページを開きます。
   2. JDBC を検索・選択します。
   3. セットアップファイルをダウンロードして実行します。
   4. インストールが完了したら、インストールディレクトリ（例：C:\Program Files\CData\JDBC Driver for CData Connect\lib）から JAR ファイル（cdata.jdbc.connect.jar）をコピーします。
2. Cloud Data Fusion にログイン。
3. 右上の緑色の「+」ボタンをクリックしてエンティティを追加。
4. Driver の下で Upload をクリック。
5. CData Connect AI JDBC ドライバー（JAR ファイル）をアップロード。
6. ドライバー設定を入力：
   • Name：ドライバー名を入力
   • Class name：「cdata.jdbc.connect.ConnectDriver」 と入力
   • Version：ドライバーのバージョンを入力
   • Description（オプション）：ドライバーの説明を入力
7. Finish をクリック。
8. ソース設定を入力：
   • Label：接続を識別するための名前
   • JDBC driver name：ステップ 6 で設定したドライバーを識別する JDBC ドライバー名を入力
   • Connection string：JDBC 接続文字列を入力（例：

     jdbc:connect:AuthScheme=Basic;user=username;password=PAT;

   • User：CData Connect AI のユーザー名（CData Connect AI インターフェースの右上に表示）を入力（例：「[email protected]」）
   • Password：Settings ページで生成した PAT を入力
9. 右上の Validate をクリック。
10. 接続が成功したら、UI を通じてパイプラインを編集・管理できます。
11. 作成したパイプラインを実行。

トラブルシューティング

Cloud Data Fusion では、ソースデータの 「int」 型が自動的に 「long」 にキャストされる既知の問題があることにご注意ください。

クラウドアプリケーションから JSON Services へのリアルタイムアクセス

これで、Google Cloud Data Fusion からリアルタイムのJSON servicesへの直接接続が確立されました。JSON services をレプリケーションすることなく、さまざまなソースと同期先間でデータをスムーズに移動できる接続を追加作成し、データ統合プロセスを効率化できます。

クラウドアプリケーションから JSON を含む 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスについては、CData Connect AI をご覧ください。