AWS Firehose コネクタ構成ガイド

必要条件

• AWSアカウント。
• 必須: firehose:PutRecord 権限。
• 任意: firehose:ListDeliveryStreams 権限。
• データを送信するためのデリバリーストリーム。

サポートされているアクション

アクション名	オーディエンスにトリガー	ストリームにトリガー
デリバリーストリームへのイベントデータの送信	✗	✓
デリバリーストリームへの訪問データの送信	✓	✗
デリバリーストリームへのカスタマイズデータの送信 (高度)	✓	✓
デリバリーストリームへのコネクタ失敗データの送信	✗	✓
デリバリーストリームへのカスタマイズデータの送信 (バッチ処理)	✓	✓
デリバリーストリームへのイベントデータの送信 (バッチ処理)	✗	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいAWS Firehoseコネクタを追加します。コネクタの追加方法については、コネクタ概要の記事を参照してください。

ベンダーを構成するには、次の手順に従ってください：

1. 構成タブで、コネクタインスタンスにタイトルを付けます。

2. IAMユーザーのアクセスキーとシークレットキーを提供します。

   IAMユーザーインスタンスに添付されたポリシーステートメントには、firehose:PutRecord 権限が含まれている必要があります。Firehoseのポリシーについての詳細は、AWS: Amazon Data Firehoseへのアクセス制御 を参照してください。

3. API呼び出しを行いたいリージョンを選択します。

4. Assume Role Parameters: 必要なすべての権限でIAMユーザーが構成されていない場合にのみ必要です。詳細については、IAMロールへの切り替えを参照してください。

   • ARN: 必須。ロールを引き受けるために割り当てられたAmazonリソース名。
   • Session NameRequired: 必須。引き受けたロールセッションの一意の識別子。
   • External ID: 任意。第三者が顧客のアカウント内でロールを引き受ける際に使用する一意の識別子。詳細については、AWS: 第三者所有のAWSアカウントへのアクセスを参照してください。

5. 提供された資格情報でAPI接続を確認するためにTest Connectionをクリックします。

アクション構成：パラメータとオプション

Nextをクリックするか、Actionsタブに移動します。ここでアクションをトリガーする構成を行います。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション: デリバリーストリームへのイベントデータの送信

パラメータ

• Delivery Stream: 必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを表示するには、firehose:ListDeliveryStreams 権限が必要です。
• Record Suffix: 個々のレコードを識別するための訪問データに追加する値を選択します。
• Print Attribute Names: このボックスをチェックすると、メッセージペイロード内の各イベントデータ属性の名前が表示されます。

オプション: Record Suffix

オプション	説明
改行 (\\n)	訪問データオブジェクトの末尾に改行文字を追加します。
デリミタなし	選択した場合、訪問データオブジェクトに何も追加されません。

アクション: デリバリーストリームへの訪問データの送信

パラメータ

• Delivery Stream: 必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを表示するには、firehose:ListDeliveryStreams 権限が必要です。
• Record Suffix: 個々のレコードを識別するための訪問データに追加する値を選択します。
• Include Current Visit Data: このボックスをチェックすると、現在の訪問データがメッセージペイロードに含まれます。
• Print Attribute Names: このボックスをチェックすると、メッセージペイロード内の各訪問データ属性の名前が表示されます。

オプション: Record Suffix

オプション	説明
改行 (\\n)	訪問データオブジェクトの末尾に改行文字を追加します。
デリミタなし	選択した場合、訪問データオブジェクトに何も追加されません。

アクション: デリバリーストリームへのカスタマイズデータの送信 (高度)

パラメータ

• Delivery Stream: 必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを表示するには、firehose:ListDeliveryStreams 権限が必要です。
• Record Suffix: 個々のレコードを識別するための訪問データに追加する値を選択します。
• Message Data: 必須。カスタムメッセージボディを構築します。属性を名前にマッピングして単一レベルのJSON形式を作成するか、テンプレート名を参照して（二重中括弧で囲む）Custom Message Definition オプションを選択します。
• Message Template Variables: 属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換とレンダリングに利用可能です。詳細については、テンプレート変数ガイドを参照してください。
• Message Templates: レンダリングするための1つ以上のテンプレートを提供します。通常、単一のテンプレートがメッセージデータの構築に使用されます。一般的な構文と拡張については、テンプレートガイドを参照してください。

オプション: Record Suffix

オプション	説明
改行 (\\n)	訪問データオブジェクトの末尾に改行文字を追加します。
デリミタなし	選択した場合、訪問データオブジェクトに何も追加されません。

アクション: デリバリーストリームへのカスタマイズデータの送信 (バッチ処理)

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

• リクエストの最大数：500
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：4MB

パラメータ

パラメータ	説明
Delivery Stream	データを送信するデリバリーストリームを選択します。利用可能なストリームを表示するには、firehose:ListDeliveryStreams 権限が必要です。Amazon Kinesis Data Firehoseデリバリーストリームには制限があります。詳細については、AWS: Amazon Data Firehoseクォータを参照してください。
Record Suffix	各レコードの末尾に追加されるデリミタとして使用される接尾辞。デフォルト: 改行 (\n)

カスタムメッセージ定義

• Message Template Variables: 属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換とレンダリングに利用可能です。詳細については、テンプレート変数ガイドを参照してください。
• Message Templates: レンダリングするための1つ以上のテンプレートを提供します。通常、単一のテンプレートがメッセージデータの構築に使用されます。構文と拡張についての詳細は、テンプレートガイドを参照してください。

アクション: デリバリーストリームへのイベントデータの送信 (バッチ処理)

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

• リクエストの最大数：500
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：4MB

パラメータ

パラメータ	説明
配信ストリーム	データを送信する配信ストリームを選択します。利用可能なストリームを表示するには、firehose:ListDeliveryStreamsの権限が必要です。Amazon Kinesis Data Firehoseの配信ストリームには制限があります。詳細はAWS: Amazon Data Firehoseのクォータをご覧ください。
レコードの接尾辞	各レコードの末尾に追加される接尾辞で、デリミタとして使用されます。デフォルト: 改行 (\n)
属性名の印刷	属性名が更新されると、ペイロード内の名前も更新されます。

ベンダーのドキュメンテーション

• AWS: Amazon Data Firehoseとは何ですか？
• AWS: Amazon Data Firehoseのクォータ
• AWS: Amazon Data Firehoseでのアクセス制御
• AWS: IAMロールへの切り替え (AWS API)
• AWS: 第三者が所有するAWSアカウントへのアクセス