Amazon S3 ソース

最終更新日： 2025年5月5日
  • トピック：

作成対象：

  • 開発者
IMPORTANT
Amazon Web Services（AWS）でAdobe Experience Platformを実行するときに、Amazon S3 ソースを使用できるようになりました。 AWS上で動作するExperience Platformは、現在、限られた数のお客様が利用できます。 サポートされるExperience Platform インフラストラクチャについて詳しくは、Experience Platform multi-cloud overview を参照してください。

Adobe Experience Platformは、AWS、Google Cloud Platform、Azure などのクラウドプロバイダーとのネイティブ接続を提供します。 これらのシステムからExperience Platformにデータを取り込むことができます。

クラウドストレージソースを使用すると、ダウンロード、フォーマット、アップロードを行う必要なく、独自のデータをExperience Platformに取り込むことができます。 取り込んだデータは、XDM JSON、XDM Parquet 形式または区切り形式で書式設定できます。 プロセスのすべての手順がソースワークフローに統合されます。Experience Platformでは、S3 からバッチでデータを取り込むことができます。

Azure 上のExperience Platformの Amazon S3 ソースを設定する

Azure でExperience Platform用に Amazon S3 アカウントを設定する方法については、次の手順に従います。

Azure への接続用 IP アドレス許可リスト

ソースを Azure 上のExperience Platformに接続する前に、地域固有の IP アドレスを許可リストに追加する必要があります。 詳しくは、Azure 上のExperience Platformへの接続に対する IP アドレスの許可リストに加える に関するガイドを参照してください。

ファイルとディレクトリの命名制約

クラウドストレージファイルまたはディレクトリに名前を付ける際に考慮する必要がある制約のリストを次に示します。

  • ディレクトリ名とファイルコンポーネント名は 255 文字を超えてはなりません。
  • ディレクトリ名とファイル名の末尾にスラッシュ（/）は使用できません。使用した場合、自動的に削除されます。
  • 次の予約 URL 文字は、適切にエスケープする必要があります。! ' ( ) ; @ & = + $ , % # [ ]
  • 次の文字は使用できません。" \ / : | < > * ?
  • 無効な URL パス文字は使用できません。\uE000 のようなコードポイントは、NTFS ファイル名では有効ですが、有効な Unicode 文字ではありません。また、一部の ASCII 文字や Unicode 文字、例えば制御文字（0x00 ～ 0x1F、\u0081 など）も使用できません。HTTP/1.1 で Unicode 文字列を規定するルールについては、RFC 2616、セクション 2.2：基本ルールおよび RFC 3987 を参照してください。
  • 次のファイル名は使用できません：LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、PRN、AUX、NUL、CON、CLOCK$、ドット文字（.）、2 つのドット文字（…）。

Amazon S3 に対する権限の設定

S3 で 1 つのディレクトリを取り込むには、S3 コンソールでExperience Platformの Identity and Access Management （IAM）ユーザーを作成し、次のアクションに対する権限を割り当てる必要があります。

  • s3:GetObject
  • s3:GetObjectVersion

接続の調査とテストには、次の権限も必要です。

  • s3:ListAllMyBuckets
  • s3:ListBucket
  • s3:GetBucketLocation

myBucket/folder/subfolder/subsubfolder/abc.csv のようなファイルパスを使用すると、subsubfolder/abc.csv にのみアクセスする場合があります。 サブフォルダーにアクセスする場合は、S3 コンソールで bucket パラメーターを myBucket、folderPath を folder/subfolder に指定して、ファイルの探索が subsubfolder/abc.csv ではなく subfolder から開始されるようにすることができます。

一時的なセキュリティ資格情報を使用して Amazon S3 に接続

s3SessionToken を使用して、一時的なセキュリティ資格情報で Amazon S3 に接続できます。 これにより、Amazon Web Services で永続的な IAM 認証情報を作成したり、信頼できない環境のユーザーに Amazon S3 バケットへのアクセスを提供したりすることなく、Amazon S3 をExperience Platformに接続できます。

一時的なセキュリティ資格情報は、一時的な資格情報の有効期限を短く設定できる点を除き、通常の長期アクセスキー資格情報と同様に機能します。 有効期限は、アクティベーション後の数分、または最大で数時間に設定できます。 また、一時資格情報はユーザーには含まれません。 つまり、有効期限が切れたら、新しい一時的な資格情報セットをリクエストする必要があります。

一時セッショントークンの生成手順については、この AWS 一時セッショントークンのドキュメントを参照してください。

Amazon Web Services上のExperience Platform用の Amazon S3 ソースの設定

AVAILABILITY
この節の内容は、Amazon Web Services（AWS）上で動作するExperience Platformの実装に適用されます。 AWS上で動作するExperience Platformは、現在、限られた数のお客様が利用できます。 サポートされるExperience Platform インフラストラクチャについて詳しくは、Experience Platform multi-cloud overview を参照してください。

Amazon Web Services（AWS）上のExperience Platform用に Amazon S3 アカウントを設定する方法については、次の手順に従います。