この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。
Azure Event Gridは、多数の異なるAzureサービスやアプリケーション間でイベントを簡単に管理できる、完全マネージド型のイベントサービスです。イベント駆動型アプリケーション向けのパフォーマンスとスケールを実現します。 この連携を設定することで、Azure Event Gridトピックに公開されたあらゆるイベントをほぼリアルタイムでストリーミングし、さらなる意思決定のためにTD CDPで利用できます。
- Treasure Dataの基本的な知識。
- Azure Event Gridの基本的な知識。
- TD API Write-only Key
- カスタムイベントを正しく処理するには、*"data": {}*を含める必要があります。
- SIDは、ASCII文字、数字、特殊記号の組み合わせで、最小10文字以上である必要があります。
- コネクタタイプごとにアカウントあたり2つのソース作成に制限があります。
- 重複イベントは許可されています。
- データベースとテーブルは事前に作成する必要があります（ユーザーがマスターアカウントを持っている場合を除く）。
- Azure Event Grid delivery and retry - Azure Event Gridにあるすべての制限と制約が適用されます。
- Plazmaでデータが利用可能になるまでの予想ターゲットレイテンシは5～10分です。
- TDユーザーは、Azure Event Grid Streaming接続を作成するためにWrite-only API keyを使用する必要があります。
- 新しく作成されたソースがデータのストリーミングを開始するまで数秒の遅延があります。
Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。
TD Consoleを開きます。
Integrations Hub > Catalogに移動します。
Azure Event Grid Data Streamingを検索して選択します。
Create Authenticationを選択します。
次のダイアログが開きます。
以下のパラメータを編集します：
| Parameters | Description | |
|---|---|---|
| Security Identifiers (SIDs) | Required | SIDは、ユーザーがAzure Event Grid webhookの設定と認証モデルの作成の両方で設定する、ローテーション可能なアクセストークンです。ASCII文字、数字、特殊記号の組み合わせで、最小10文字以上である必要があります。カンマ区切りのトークンリストを入力してください。 |
| TD API Key | Required | データベースにアクセスするためのTD write-only API Key。 Getting Your API Keysを参照してください。 |
Security Identifiers(SIDs)はマスクされます。今後のローテーションのために、SIDをパスワードマネージャーに安全に保管することをお勧めします。
Continueを選択します。
接続の名前を入力します。
Doneを選択します。
認証接続のステップ後、自動的に認証リストページに移動します。
作成した接続を検索します**。**
New Sourceを選択します。
Create SourceモデルでConnectionダイアログが開きます。
Data Transfer NameフィールドにSourceの名前を入力します**。**
Nextをクリックします。Data Settingsダイアログが開きます。
以下のパラメータを編集します：
| Parameters | Required | Description |
|---|---|---|
| Datastore | Required | Plazmaが利用可能なオプションです。 |
| Tags | Optional | このソースを見つけるためにタグを使用できます。 |
| Database | Required | データをインポートするTreasure Data内のデータベースを指定します。 |
| Table | Required | データを配置するデータベース内のテーブルを指定します。 |
- Createを選択します。
Source ID（UUID v4）は、ソース作成時に発行されます。
悪用を防ぐため、Source Idは権限のない者に開示しないでください。
- ソースを作成すると、自動的にソースリストページに移動します。
作成したソースを検索します。
同じ行の「...」をクリックし、Copy Unique IDをクリックします。このUnique IDは、Azure Event Gridにエンドポイントを登録する際に必要なSource IDです。
Azure Event Gridストリーミングコネクタでイベントを処理するには、有効なSource IDでAzure Event Gridにエンドポイントを登録する必要があります。Azure Event Gridで、Event Grid TopicのCreate Event Subscriptionを行います。
ENDPOINT DETAILSにAzure Event Gridエンドポイントを入力します。米国のAzure Event Grid取り込みエンドポイントは次のとおりです：https://aeg-in-streaming.treasuredata.com/v1/task/{source id} 他の地域のホスト名は異なりますが、同じパターンに従います。たとえば、日本の場合は次を使用します：https://aeg-in-streaming.treasuredata.co.jp/v1/task/{source id}
Security Identifiers (SIDs)を静的なAuthorizationヘッダーとして指定します。認証作成時に指定したSecurity Identifiers (SIDs)のリストからSIDを登録して、ローテーションを有効にします。Delivery PropertiesタブのPROPERTIES SENT ON EVENT DELIVERYセクションで、SIDをAuthorization: BEARER $SIDヘッダーとして指定します。完全な手順については、Azure Event Gridのクイックスタートガイドを参照してください Quickstart Portal。
お客様は、オプションでEvent Grid Subscriptionのイベントフィルタリングを指定できます。フィルタリングには3つのオプションがあります：
- Event types
- Subject begins with or ends with
- Advanced fields and operators
完全な手順については、Azure Event Gridドキュメントを参照してください Event Filtering。
コネクタは、ストリーミングデータソースの作成が成功した後、最初のイベントがトリガーされるとすぐに、TDでのイベントデータ取り込みを開始できます。