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. Test Connection をクリックして、提供された認証情報で API 接続性を確認します。

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

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

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データに個々のレコードを識別するために追加する値を選択します。
属性名の表示	このオプションを選択すると、メッセージペイロード内の各イベントデータ属性の名前が表示されます。

オプション：レコードサフィックス

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データに個々のレコードを識別するために追加する値を選択します。
現在の訪問データを含む	ペイロードに現在の訪問データを追加します。これには、現在の訪問イベントデータが除外されていない場合のイベント訪問データが含まれます。
現在の訪問イベントデータを除外	現在の訪問データからイベントデータを除外します。
属性名の表示	このオプションを選択すると、メッセージペイロード内の各訪問データ属性の名前が表示されます。

オプション：レコードサフィックス

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

アクション：デリバリーストリームへのカスタマイズデータ送信（高度）

パラメータ

パラメータ	説明
デリバリーストリーム	必須。データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データに個々のレコードを識別するために追加する値を選択します。
メッセージデータ	必須。カスタムメッセージ本体を構築します。属性を名前にマッピングする単純な1レベルのJSON形式を使用するか、二重中括弧で囲まれたテンプレート名を参照し、「カスタムメッセージ定義」オプションを選択します。
メッセージテンプレート変数	属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換およびレンダリングに使用できます。詳細については、コネクターテンプレート変数を参照してください。
メッセージテンプレート	レンダリングに使用する1つ以上のテンプレートを提供します。通常、メッセージデータを構築するために単一のテンプレートが使用されます。構文と拡張についての詳細は、コネクターテンプレートについてを参照してください。

オプション：レコードサフィックス

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

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

バッチ制限

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。Amazon Kinesis Data Firehose デリバリーストリームには制限があります。詳細については、AWS: Amazon Data Firehose の制限を参照してください。
レコードサフィックス	各レコードの最後に追加されるサフィックスで、区切り文字として使用されます。デフォルト: 改行 (\n)

カスタムメッセージ定義

パラメータ	説明
メッセージテンプレート変数	属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換およびレンダリングに使用できます。詳細については、コネクターテンプレート変数を参照してください。
メッセージテンプレート	レンダリングに使用する1つ以上のテンプレートを提供します。通常、メッセージデータを構築するために単一のテンプレートが使用されます。詳細については、コネクターテンプレートについてを参照してください。

アクション：デリバリーストリームへのイベントデータ送信（バッチ処理）

バッチ制限

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	データを送信するデリバリーストリームを選択します。利用可能なストリームを見るには、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アカウントへのアクセス