メインコンテンツまでスキップ

Twilio Segmentからイベントを保存する方法

概要​

このソリューションは、Twilio Segment からのイベントをリッスンし、データを Teradata Vantage インスタンスに書き込みます。この例では Google Cloud を使用していますが、任意のクラウド プラットフォームに翻訳できます。

アーキテクチャ​

このソリューションでは、Twilio Segment が生のイベント データを Google Cloud Pub/Sub に書き込みます。Pub/Sub はイベントを Cloud Run アプリケーションに転送します。Cloud Run アプリはデータを Teradata Vantage データベースに書き込みます。これは、VM の割り当てや管理を必要としないサーバーレス ソリューションです。

Segment Google Cloud フローダイアグラム

デプロイメント​

前提条件​

  1. Google Cloud アカウント。アカウントをお持ちでない場合は、https://console.cloud.google.com/ で作成できます。
  2. gcloud インストール済み。https://cloud.google.com/sdk/docs/install をご覧ください。
  3. Google Cloud Run が通信できる Teradata Vantage インスタンス。
注記

Vantage のテストインスタンスが必要な場合は、 https://clearscape.teradata.com で無料でプロビジョニングできます

構築とデプロイ​

  1. サンプル リポジトリのクローンを作成します。

  1. リポジトリには、データベースを設定する segment.sql ファイルが含まれています。お気に入りの SQL IDE、 Teradata Studio 、または bteq と呼ばれるコマンド ライン ツールを使用して、Vantage db にスクリプトを実行します ( Windows、[]、 Linux、 macOSのダウンロード)。 SQL スクリプトは、Segment と呼ばれる新しいデータベースと、セグメント イベントを保存するためのテーブルのセットを作成します。

  2. デフォルトのプロジェクトとリージョンを設定します。

  1. プロジェクト ID と番号を取得します。これは後続の手順で必要になります。
  1. 必要な Google Cloud サービスを有効にします。
  1. アプリケーションを構築します。
  1. Segment と共有する API キーを定義します。API キーを Google Cloud Secret Manager に保存します。
  1. Vantage にセグメント データを書き込むアプリケーションは Cloud Run を使用します。まず、Cloud Run がシークレットにアクセスできるようにする必要があります。
  1. アプリを Cloud Run にデプロイします ( <VANTAGE_HOST> を Teradata Vantage データベースのホスト名または IP に置き換えます)。2 番目のエクスポート ステートメントは、後続のコマンドに必要なサービス URL を保存します。
  1. Segmentからイベントを受信する Pub/Sub トピックを作成します。
  1. Pub/Sub が Cloud Run アプリを呼び出すために使用するサービス アカウントを作成します。
  1. サービス アカウントに Cloud Run を呼び出すアクセス権を付与します。
  1. Pub/Sub がプロジェクト内に認証トークンを作成できるようにします。
  1. サービス アカウントを使用してPub/Subサブスクリプションを作成します。

  1. Segment がトピックに公開できるようにします。これを行うには、https://console.cloud.google.com/cloudpubsub/topic/list でプロジェクトに pubsub@segment-integrations.iam.gserviceaccount.com ロール Pub/Sub Publisher を割り当てます。詳細については セグメントマニュアル を参照してください。

  2. Segment で Google Cloud Pub/Sub の宛先を設定します。完全なトピック projects/<PROJECT_ID>/topics/segment-events を使用し、すべての Segment イベント タイプ ( * 文字を使用) をトピックにマッピングします。

試してみる​

  1. Segment のイベント テスター機能を使用して、サンプル ペイロードをトピックに送信します。サンプル データが Vantage に保存されていることを確認します。

制約​

  • この例では、アプリを単一のリージョンにデプロイする方法を示します。多くの場合、この設定では十分な稼働時間が保証されません。Cloud Run アプリは、グローバル ロードバランサの背後にある複数のリージョンにデプロイする必要があります。

まとめ​

このハウツーでは、Segment イベントを Teradata Vantage に送信する方法を説明します。この構成では、イベントを Segment から Google Cloud Pub/Sub に転送し、その後 Cloud Run アプリケーションに転送します。アプリケーションはデータを Teradata Vantage に書き込みます。

さらに詳しく​

注記

ご質問がある場合やさらにサポートが必要な場合は、 コミュニティフォーラム にアクセスしてサポートを受けたり、他のコミュニティ メンバーと交流したりしてください。

興味深い記事