データへのアクセス

IAMロールを作成する

AWS管理コンソールを使ってIAMロールを作成し、作成者として組織のデータに対する独占的な読み取りアクセス権を付与できます。

IAMロールを作成するには:

1. AWS管理コンソールで、Sitecore Amazon S3バケット内の組織のデータにアクセスする権限を持つIAMロールを作成します。

2. IAMロールのAmazon Resource Name(ARN)をメモしてください。<aws_account_id>をAWSアカウントIDに置き換え、有効なパスで<role_name_with_path>してください。

   arn:aws:iam::<aws_account_id>

   /<role_name_with_path>

   例:

   arn:aws:iam::012345678901

   /sitecore-access-s3-role

!重要作成したIAMロールは、作成した元のユーザーであるあなたにのみ独占的な読み取りアクセス権を与えます。組織のデータ へのアクセスを要求 する際は、この役割に関連する特定のARNを必ず提供してください。

IAM役割ポリシーを設定する

IAMロールを作成した後は、その役割に権限ポリシーを付与しなければなりません。このポリシーの権限によって、組織のデータへのアクセスリクエストが許可されるか拒否されるかを決定します。

IAM役割ポリシーを設定するには:

• AWS管理コンソールの前回の手順で作成したIAMロールのアクセス管理エリアで、以下のインラインポリシーを作成します。

  { "Version": "2012-10-17", "Statement": { "Sid": "AllowS3Access", "Effect": "Allow", "Action": "s3

  ", "s3
  " , "Resource": "arn:aws:s3:::bx-<client_key>-production-<region_code>/*", "arn:aws:s3:::bx-<client_key>-production-<region_code>"

  }

  }

  プレースホルダーの値はSitecore CDPインスタンスの詳細に置き換えてください。

アクセス要求

IAM役割ポリシーを設定した後は、データレイクエクスポートを有効にするサポートケースを作成し、組織のデータへのアクセスを要求する必要があります。

アクセスを申請するには:

1. サポートケースを作成し 、 IAMの役割ARNを提供してください。
2. Sitecoreがあなたと共にIAMロール、ARN、AWSアカウントID、その他のアカウント情報を確認するための通話に参加してください。
3. 確認を待ってください。Sitecoreがデータレイクエクスポートを有効にし、作成したIAMロールへのアクセスが許可されると通知されます。組織のデータへのアクセスは、あなたが提供した特定のIAMロールARNのみが許可されます。

!重要データレイクのエクスポートが有効化された後は、IAMロールを変更しないでください。変更が起きるとアクセスが妨げられます。SitecoreのAmazon S3バケットは、あなたが提供した元のIAMロールARNのみを認識するように厳格に設定されています。IAMロールの権限や詳細を変更すると競合が発生し、組織のデータにアクセスできなくなります。

エクスポートされたデータを理解する

組織のデータにアクセスする前に、どこに保存されているか、エクスポートに含まれるデータが何かを理解することが重要です。

データへのアクセス

IAMロールが承認された後、IAMロールの作成者であるあなただけがSitecore Amazon S3バケット内の組織のデータにアクセスできるようになります。

!重要あなたが提供した特定のIAMロールARNのみが組織のデータにアクセスする権限を持っています。このIAMロールを使って他のユーザーはあなたのデータにアクセスできません。もし当初指定されたものと異なるユーザーに役割を付与し、そのユーザーがエクスポート処理を実行しようとした場合、セキュリティ上の理由で拒否されます。

データレイクエクスポートが設定された後に割り当てられたユーザーを変更する必要がある場合は、この更新を要求するために サポートケースを作成する 必要があります。これによりプロセスがリセットされるため、アクセスを要求する前に正しいユーザー、ロール、ARNを必ず確認してください。

このセクションでは、AWSコマンドラインインターフェース(AWS CLI)でaws s3 cp(またはコピー)コマンドを使ってデータをダウンロードしたり、選択した別のAmazon S3バケットにコピーする方法を説明します。あるいは、GetやListで始まるAmazon S3のアクションを実行してデータにアクセスすることもできます。

データにアクセスするには:

1. 必ずAWS CLIをインストールし、IAMロールを使ってAWSインスタンスにアクセスできるように設定してください。

2. エクスポートフォルダからコピーしたい フォルダやサブフォルダ を決めてください。特定の要件に応じて異なるデータセットを選択できます。

3. ターミナルやコマンドプロンプトを開き、以下のaws s3 cpコマンドを実行して組織のデータをコピーしてください。 プレースホルダーの値はSitecore CDPインスタンスの詳細に置き換えてください。

   例61。ターミナルで入力できるよく使われるAWS S3のCPコマンド

   組織のデータをローカルマシンにダウンロードしてください。これには 過去3日間の完全なデータレイクのエクスポートも含まれます。

   aws s3 cp s3://bx-<client_key>--<region_code>/analytics/bdl/exports/data . --recursive

   特定の日付で完全なデータレイクのエクスポートをローカルマシンにダウンロードしてください。

   aws s3 cp s3://bx-<client_key>--<region_code>/analytics/bdl/exports/data/ . --recursive

   組織のすべてのデータを別のAmazon S3バケットにコピーしてください。これには 過去3日間の完全なデータレイクのエクスポートも含まれます。

   aws s3 cp s3://bx-<client_key>--<region_code>/analytics/bdl/exports/data --recursive

   特定の日付の完全なデータレイクエクスポートを、別のAmazon S3バケットにコピーしてください:

   aws s3 cp s3://bx-<client_key>--<region_code>/analytics/bdl/exports/data/ --recursive

これらのコマンドを実行すると、組織のデータがローカルにダウンロードされるか、選んだ別のAmazon S3バケットにコピーされます。

!警告BDLエクスポートプロセスで生成される .parquetファイルのファイル名やサイズは、Sitecoreによって制御または一意であることを保証するものではありません。すべてのエクスポートファイルが単一のディレクトリに配置されると、名前の衝突により一部のファイルが意図せず上書きされることがあります。

データの損失や破損を防ぐために:

• BDLエクスポートで作成されたフォルダ構造を移動したりフラット化したりしないでください。

• エクスポートしたファイルの保存、転送、読み込みの際には、必ず元のディレクトリ階層を保持してください。