Amazon S3 コネクタ
Adobe Experience Platformは、AWS、Google Cloud Platform、Azure などのクラウドプロバイダーとのネイティブ接続を提供します。 これらのシステムから Platform にデータを取り込むことができます。
クラウドストレージソースを使用すると、ダウンロード、フォーマット、アップロードを行う必要なく、独自のデータを Platform に取り込むことができます。取り込んだデータは、XDM JSON、XDM Parquet 形式または区切り形式で書式設定できます。 プロセスのすべての手順がソースワークフローに統合されます。Platform では、S3 からデータをバッチで取り込むことができます。
IP アドレス許可リスト
ソースコネクタを操作する前に、IP アドレスのリストを許可リストに追加する必要があります。 地域固有の IP アドレスを許可リストに追加しないと、ソースを使用する際にエラーが発生したり、パフォーマンスが低下する場合があります。 詳しくは、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 つのドット文字（…）。
前提条件 prerequisites
S3 で 1 つのディレクトリを取り込むには、S3 コンソールで Platform の Identity and Access Management （IAM）ユーザーを作成し、次のアクションに対する権限を割り当てる必要があります。
s3:GetObjects3:GetObjectVersion
接続の調査とテストには、次の権限も必要です。
s3:ListAllMyBucketss3:ListBuckets3: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 を Platform に接続できます。
一時的なセキュリティ資格情報は、一時的な資格情報の有効期限を短く設定できる点を除き、通常の長期アクセスキー資格情報と同様に機能します。 有効期限は、アクティベーション後の数分、または最大で数時間に設定できます。 また、一時資格情報はユーザーには含まれません。 つまり、有効期限が切れたら、新しい一時的な資格情報セットをリクエストする必要があります。
一時セッショントークンの生成手順については、この AWS 一時セッショントークンのドキュメントを参照してください。
.
S3 を Platform に接続
以下のドキュメントでは、API やユーザーインターフェイスを使用して S3 をAdobe Experience Platformに接続する方法について説明しています。