Jitterbit でライブ JSON Servicesと連携
Jitterbit は、データワークフローを効率化できるエンタープライズ iPaaS(Integration Platform as a Service)です。CData Connect AI と組み合わせることで、Jitterbit からライブ JSON services にアクセスできます。この記事では、Connect AI を使用して JSON に接続し、Jitterbit でライブ JSON services と連携する方法を説明します。
CData Connect AI は JSON 用の純粋な OData インターフェースを提供し、ネイティブにサポートされているデータベースにデータをレプリケーションすることなく、JSON からデータをクエリできます。CData Connect AI は最適化されたデータ処理機能を標準で備えており、サポートされているすべての SQL 操作(フィルタ、JOIN など)を JSON に直接プッシュし、サーバーサイド処理を活用して、リクエストされた JSON services を迅速に返します。
Jitterbit 向けに JSON 接続を構成
Jitterbit から JSON services を操作するには、Connect AI から JSON に接続し、ユーザーにアクセス権を付与し、JSON services 用のワークスペースを作成する必要があります。
Connect AI から JSON に接続
CData Connect AI は、シンプルなポイント&クリック インターフェースを使用してデータソースに接続します。
- Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします。
- Add Connection パネルから「JSON」を選択します。
-
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 への接続」を参照してください。
- Save & Test をクリックします。
-
Add JSON Connection ページの Permissions タブに移動し、User-based permissions を更新します。
パーソナルアクセストークンの追加
REST API、OData API、または仮想 SQL Server を介して Connect AI に接続する場合、パーソナルアクセストークン(PAT)を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに別々の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、設定ページを開きます。
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付け、Create をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
Jitterbit 向けに JSON エンドポイントを構成
JSON に接続した後、目的のテーブル用のワークスペースを作成します。
-
Workspaces ページに移動し、 Add をクリックして新しいワークスペースを作成します(または既存のワークスペースを選択します)。
- Add をクリックして、ワークスペースに新しいアセットを追加します。
-
JSON 接続(例:JSON1)を選択し、Next をクリックします。
-
操作するテーブルを選択し、Confirm をクリックします。
- ワークスペースの OData Service URL(例:https://cloud.cdata.com/api/odata/{workspace_name})をメモしておきます。
接続、PAT、およびワークスペースの構成が完了すると、Jitterbit から JSON services に接続する準備が整います。
Connect AI を使用して Jitterbit から JSON に接続
OData プロトコルを使用して Jitterbit から CData Connect AI への接続を確立するには、以下の手順に従います。
- Jitterbit にログインします。
- Cloud Studio でプロジェクトを作成し、ワークスペース環境を設定します。
- Sources をクリックし、検索バーに OData と入力します。
- OData コネクタを選択します。
- OData 接続プロパティを入力します。
- Connection Name:接続名を入力します。
- OData Metadata URL:https://cloud.cdata.com/api/odata/{workspace_name} と入力します。
- Authentication:Basic Auth を選択します。
- User Name:CData Connect AI のユーザー名を入力します。これは CData Connect AI インターフェースの右上に表示されます(例:[email protected])。
- Password:Settings ページで生成した PAT を入力します。
- Test をクリックして接続をテストし、Save Changes をクリックします。
- 実行する操作を選択し、プロジェクトのワークフローにドラッグします。
- クエリ操作をダブルクリックすると、OData エンドポイントで使用可能なすべてのテーブルと派生ビューが表示されます。
- テーブルを選択し、クエリを構成します。
これで、Jitterbit でライブ JSON services を変換・連携できます。
CData Connect AI の入手
Jitterbit から 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、 CData Connect AI をぜひお試しください!