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 で単一のディレクトリを取り込むには、 Identity and Access Management S3 コンソールの Platform 用 (IAM) ユーザーと、次のアクションの権限を割り当てます。
s3:GetObject
s3:GetObjectVersion
接続の調査とテストには、次の権限も必要です。
s3:ListAllMyBuckets
s3:ListBucket
s3:GetBucketLocation
次のようなファイルパス myBucket/folder/subfolder/subsubfolder/abc.csv
次にのみアクセスするように設定します: subsubfolder/abc.csv
. サブフォルダーにアクセスする場合は、 bucket
パラメーターを次のように S3 コンソールに設定します。 myBucket
そして folderPath
as folder/subfolder
を使用して、ファイルの調査が subfolder
~とは対照的に subsubfolder/abc.csv
.
一時的なセキュリティ認証情報を使用して接続 Amazon S3
接続可能 Amazon S3 を使用して一時的なセキュリティ認証情報を持つ s3SessionToken
. これにより、 Amazon S3 を使用して永続的な IAM 認証情報を作成する必要がない場合 Amazon Web Servicesまたは Amazon S3 信頼できない環境のユーザーにバケットを作成します。
一時的なセキュリティ資格情報は、通常の長期アクセスキー資格情報と同様に機能しますが、一時的な資格情報の有効期限を短く設定できる点が異なります。 有効期限は、アクティブ化の数分後または数時間後に設定できます。 また、一時的な資格情報はユーザーには含まれません。 つまり、有効期限が切れたときに、一時的な資格情報の新しいセットをリクエストする必要があります。
一時セッショントークンを生成する手順については、次を参照してください AWS 一時セッショントークンのドキュメント
.
S3 をに接続 Platform
以下のドキュメントでは、API またはユーザーインターフェイスを使用して S3 をAdobe Experience Platformに接続する方法に関する情報を提供します。