詳細情報:
Amazon S3 出力接続
データプレップを使用するときに、Amazon S3 出力コネクタを使用してリモート接続を作成し、CRM Analytics から Amazon S3 バケットに.csvデータを書き込みます。
メモ Amazon S3 バケットから CRM Analytics にデータを同期する場合は、代わりに Amazon S3 接続を使用します。
出力ノードを使用する CRM Analytics 出力コネクタのしくみ
CRM Analytics コネクタを使用すると、レシピの結果を外部システムに書き込んで、詳細な分析を行ったり、ビジネスの自動化で使用したり、保存したりできます。このガイドの手順を使用してデータソースへの出力コネクタとフォルダーパスを設定したら、データプレップを使用してレシピを作成します。出力ノードをレシピに追加して、出力接続への書き込みを選択します。設定した S3 接続を選択し、出力データを含める S3 オブジェクトを選択します。レシピを実行すると、CRM Analytics はディレクトリ内のフォルダーパスにある指定されたオブジェクトにデータを書き込みます。たとえば、フォルダ パス ...support/servicedata を指定し、オブジェクト APAC を選択した場合、パス ...support/servicedata/APAC のフォルダ APAC に書き込まれます。このフォルダーには次のファイルが含まれます。
- 出力データセットの .csv ファイル。命名規則は
folderpath_0.csv です。この例では、出力はAPAC_0.csvです。大きなデータセットの場合、CRM Analytics は自動的にデータを複数の .csv ファイルに分割し、増加する数字を名前に追加します。この例では、すべてのデータが書き込まれるまで、APAC_1.csv、APAC_2.csv、その他があります。このファイルにヘッダー行はありません。 - メタデータファイル schema.json。名前、データ型、精度など、各列に関する情報が含まれます。
- _SUCCESS ファイル。.csv が完全に書き込まれた場合に生成されます。
レシピを再度実行すると、以前に生成されたファイルが削除され、新しいバージョンのファイルが書き込まれます。
Amazon S3 出力コネクタの有効化と追加
- [設定] から、[クイック検索] ボックスに「Analytics」と入力し、[Analytics] を選択して [設定] を選択します。
- [Amazon S3 出力接続を有効化] を選択して、変更内容を保存します。
- データマネージャーで、[接続] タブをクリックします。
- [新しい接続] をクリックします。
- [出力] をクリックします。
- コネクタのアイコンをクリックし、「接続設定」セクションの説明に従ってその設定を入力します。
- [保存 & テスト] をクリックします。[保存 & テスト] をクリックすると、ソースへの接続が試行されて設定が検証されます。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。
特に明記されていない限り、すべての設定で値が必要です。
| 接続設定 | 説明 |
|---|---|
| 接続名 | 接続を識別します。異なる接続を区別しやすい規則を使用します。 |
| API 参照名 | 接続の API 参照名。API 参照名にスペースを含むことはできません。また、接続の作成後に API 参照名を変更することはできません。 |
| 説明 | 説明 |
| 認証種別 | 標準認証の場合、「Root」と入力します。AWS IAM(Identity Access Management)認証の場合、「IAM」と入力します。AWS データに詳細にアクセスするには、IAM 認証を使用して、AWS で IAM ユーザーとロールを設定します。AWS IAM についての詳細は、「AWS での IAM の使用開始」を参照してください。 |
| Secret Key (秘密鍵) | Amazon の秘密のアクセスキー。 |
| Region Name (リージョン名) | S3 サービスの範囲。デフォルトのリージョンは [US East(N. Virginia) (米国東部 (バージニア北部))] です。リージョン名のリストについては、『AWS サービスエンドポイント』ドキュメントを参照してください。 |
| Folder Path (フォルダーパス) | 接続先のフォルダーへのパス。パスはバケット名で始まる必要があり、データを同期するサブフォルダーの名前を含むことはできません。 |
| Access Key (アクセスキー) | Amazon S3 バケットのアクセスキー ID。 |
| AWS ロール ARN | IAM 認証の場合のみ、IAM ロールの ARN。これは、AWS の [IAM ロールの設定] にあります。 |
Amazon S3 出力コネクタを使用するときは、次の点に留意してください。
- 出力接続はレシピごとに複数回使用できますが、各出力ノードでは異なるオブジェクトを使用する必要があります。各出力ノードでは、コネクタの実行あたりの制限まで個別に使用できますが、24 時間周期の制限の対象にはなります。
- 出力接続は、データプレップで作成されたレシピでのみ使用できます。
- 各出力接続では、フォルダーパスが 1 つのみサポートされます。別のフォルダーパスに出力するには、別の出力接続を作成します。
- 現在の実行に備えて以前の実行のファイルが削除された場合、出力データセットの以前のバージョンにはアクセスできません。各実行の後で出力をコピーまたは使用するようにプロセスを設定するには、書き込みの完了を示すものとして _SUCCESS ファイルを使用します。
- null値は
null-[token]としてAWSに出力されます。ここで、tokenは文字列です。たとえば、null-OrJLA4JEfCjToa4DDNやnull-PaKIW3MEfCaQou9WXMです。null 値を解釈するには、AWS CLI を使用するか、データが使用される対象で、後処理を実装することが必要な場合があります。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
