CData Mule コネクタをオンプレミスまたはクラウドにデプロイ

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

CData Mule Connector for SnapchatAds は、Snapchat Ads データをMule アプリケーションに接続し、身近なSQL クエリで読み、書き、更新、削除機能を有効にします。Connector を使用することで、ユーザーはリアルタイムSnapchat Ads データにアクセスできるMule アプリケーションを簡単に作成できます。また、内部アクセスのためのオンプレミスサーバーへのデプロイや、ダイレクトクラウドアクセスのためのMuleSoft CloudHub へのデプロイが可能になります。

Mule アプリへのSnapchat Ads 接続を追加する

この記事では、CData Mule Connector for SnapchatAds をアプリケーションに組み込み、そのアプリケーションをMuleSoft CloudHub およびオンプレミスサーバーにデプロイする手順を説明します。CData Snapchat Ads Connector に加えて、Mule およびAnypoint Studio をインストールする必要があります。

• CData MuleSoft Connector にSnapchat Ads 接続を埋め込みます。
• Anypoint Platform を介してMuleSoft CloudHub にデプロイ します。
• Anypoint Platform を介してオンプレミスサーバーにデプロイします。

Snapchat Ads 接続を埋め込む

以下のステップは、Snapchat Ads Connector をプロジェクトに追加し、接続とコネクタを構成する方法の概要です。

1. Anypoint Studio で新しいMule プロジェクトを作成します。
2. CData Snapchat Ads Connector をアプリケーションに追加します。
3. 新しいConnection を作成（または既存のものを編集）し、Snapchat Ads に接続するプロパティを設定します。（以下を参照）接続を設定したら、「Test Connection」をクリックしてSnapchat Ads への接続を確認します。

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

   Snapchat Ads はOAuth 認証のみサポートします。この認証を有効にするには、すべてのOAuth フローでAuthScheme をOAuth に設定し、カスタムOAuth アプリケーションを作成する必要があります。

   定型のクエリを簡略化するために、AccountId にデフォルトのAccountId を指定するように設定することもできます。 これにより、WHERE 句の一部として手動で指定する必要がなくなります。（AccountId が指定されず、WHERE 句にアカウントID が明示的に与えられない場合、CData 製品はAccounts ビューに返されるリストから最初のアカウントを取得しようとします。）

   ヘルプドキュメントでは、以下の3つの一般的な認証フローでのSnapchat Ads への認証について詳しく説明しています。

   • デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。
   • Web：共有ウェブサイト経由でデータにアクセスします。
   • ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。

   カスタムOAuth アプリケーションの作成については、ヘルプドキュメント の「カスタムOAuth アプリケーションの作成」セクションを参照してください。

4. Operation、Query タイプ、SQL クエリを使用してCData Snapchat Ads Connector を構成します。
5. アプリケーションを終了して保存します。

アプリケーションが完成したら、Anypoint Studio をAnypoint Platform と組み合わせて使用し、MuleSoft CloudHub インスタンスまたはオンプレミスサーバーにアプリケーションをデプロイできます。

MuleSoft CloudHub にデプロイする

1. 「Project」を右クリックし、「Anypoint Platform」->「Deploy to Cloud」を選択します。
2. デプロイメントを設定し、「Deploy Application」をクリックします。
3. デプロイが完了したら、Anypoint Platform Runtime Manager に移動してデプロイされたアプリケーションを管理します。

アプリケーションがデプロイされると、必要なパラメータを追加してApp URL に移動することで、Web 上のどこからでもアクセスできるようになります。

オンプレミスサーバーにデプロイする

Anypoint Platform を介してMule アプリケーションをオンプレミスサーバーにデプロイするには、Mule Server インスタンスをマシンにインストールする必要があります。以下のステップでは、Anypoint Platform にオンプレミスサーバーを追加し、Mule アプリケーションをデプロイする方法を説明します。

オンプレミスMule Server をAnypoint Platform に追加する

1. 実行中の場合、オンプレミスのMule Server を停止します。
2. Anypoint Platform に移動して「Add Server」をクリックし、サーバーを追加するセキュリティトークンを含むコマンドを表示します。

3. MuleSoft Runtime Manager Agent をセットアップします（Windows の場合、amc_setup.bat ... を実行）。

   %MULE_HOME%\bin> amc_setup -H 12ab3cd4-567e-8fa9-0123-4b56c7de8901---234567 MYSERVER

4. オンプレミスMule Server を開始します（Windows の場合、mule.bat を実行）。

   %MULE_HOME%\bin> mule

Mule アプリケーションをデプロイする

1. Anypoint Studio で、「project」を右クリックし、「Export」を選択します。
   • Mule フォルダにて、「Anypoint Studio Project to Mule Deployable Archive」を選択し、「Next」をクリックしてデプロイ可能なファイルを作成します。
2. Anypoint Platform Runtime Manager で「Applications」に移動し、「Deploy Application」をクリックします。
   • アプリケーションに名前を付けます。
   • Deployment Target としてオンプレミスサーバーを選択します。
   • 「Application File」の下で「Choose file」->「Upload file」とクリックし、エクスポートしたプロジェクトを選択します。
   • 「Deploy Application」をクリックします。

アプリケーションをオンプレミスサーバーにデプロイすると、サ－バーにアクセス可能な任意のブラウザからアクセスできるようになります。サーバーのアドレスとポートに移動し、アプリケーションに必要なURL パラメータを追加します。

これで、Snapchat Ads データを使用するMule アプリケーションがデプロイできました。Mule Connector for SnapchatAds の30日間の無償トライアルをダウンロードして、Mule アプリケーションでCData の強力なデータ連携をご体感ください。