--- title: "データへのアクセス" slug: "access-your-data" abstract: "Amazon Web Servicesのコマンドラインインターフェース(Sitecore CDP)を使って、組織のデータにアクセスしましょう。" --- # データへのアクセス このウォークスルーでは、Amazon Web Servicesコマンドラインインターフェース(AWS CLI)を使って、Sitecore Amazon S3バケット内の組織のデータにアクセスする方法を説明します。 このウォークスルーは以下の条件を満たしていることを前提としています: - [AWS管理コンソール](https://aws.amazon.com/console/)へのアクセス権とIAMロール作成の権限を持つAmazon Web Services(AWS)アカウント。 - [AWSコマンドラインインターフェース](https://aws.amazon.com/cli/)(AWS CLI)は、IAMロールを使ってAWSインスタンスにアクセスするよう設定されています。 データにアクセスする準備をするには、まずIAMロールを作成し、そのポリシーを更新します。次に、IAMロールを承認してデータへのアクセスを要求する [サポートケースを作成します](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/create-a-support-case.html) 。IAMロールが承認された後、AWS CLIのIAMロールを使って安全にデータにアクセスできます。 このウォークスルーでは、以下の方法を説明します: :::攻略 1. [IAMロールを作成する](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#create-an-iam-role) 2. [IAM役割ポリシーを設定する](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#configure-the-iam-role-policy) 3. [アクセス要求](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#request-access) 4. [エクスポートされたデータを理解する](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#understand-the-exported-data) 5. [データへのアクセス](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#access-your-data)::: ## IAMロールを作成する AWS管理コンソールを使ってIAMロールを作成し、作成者として組織のデータに対する独占的な読み取りアクセス権を付与できます。 IAMロールを作成するには: 1. AWS管理コンソールで、Sitecore Amazon S3バケット内の組織のデータにアクセスする権限を持つIAMロールを作成します。 2. IAMロールの[Amazon Resource Name(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)をメモしてください。を[AWSアカウントID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)に置き換え、[有効なパス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)でしてください。 arn:aws:iam:::role/ 例: arn:aws:iam::012345678901:role/sitecore-access-s3-role > !重要作成したIAMロールは、作成した元のユーザーであるあなたにのみ独占的な読み取りアクセス権を与えます。組織のデータ [へのアクセスを要求](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_section-idm4537295798572833698538040681 "Request access") する際は、この役割に関連する特定のARNを必ず提供してください。 ## IAM役割ポリシーを設定する IAMロールを作成した後は、その役割に権限ポリシーを付与しなければなりません。このポリシーの権限によって、組織のデータへのアクセスリクエストが許可されるか拒否されるかを決定します。 IAM役割ポリシーを設定するには: - AWS管理コンソールの前回の手順で作成したIAMロールのアクセス管理エリアで、以下のインラインポリシーを作成します。 { "Version": "2012-10-17", "Statement": { "Sid": "AllowS3Access", "Effect": "Allow", "Action": "s3:GetObject", "s3:ListBucket" , "Resource": "arn:aws:s3:::bx--production-/\*", "arn:aws:s3:::bx--production-" } } [プレースホルダーの値は](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727950799439 "Reference for placeholder values")Sitecore CDPインスタンスの詳細に置き換えてください。 ## アクセス要求 IAM役割ポリシーを設定した後は、データレイクエクスポートを有効にするサポートケースを作成し、組織のデータへのアクセスを要求する必要があります。 アクセスを申請するには: 1. [サポートケースを作成し](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/create-a-support-case.html) 、 [IAMの役割ARN](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_para-idm1903370188424334)を提供してください。 2. Sitecoreがあなたと共にIAMロール、ARN、AWSアカウントID、その他のアカウント情報を確認するための通話に参加してください。 3. 確認を待ってください。Sitecoreがデータレイクエクスポートを有効にし、作成したIAMロールへのアクセスが許可されると通知されます。組織のデータへのアクセスは、あなたが提供した特定のIAMロールARNのみが許可されます。 > !重要データレイクのエクスポートが有効化された後は、IAMロールを変更しないでください。変更が起きるとアクセスが妨げられます。SitecoreのAmazon S3バケットは、あなたが提供した元のIAMロールARNのみを認識するように厳格に設定されています。IAMロールの権限や詳細を変更すると競合が発生し、組織のデータにアクセスできなくなります。 ## エクスポートされたデータを理解する 組織のデータにアクセスする前に、どこに保存されているか、エクスポートに含まれるデータが何かを理解することが重要です。 ### データストレージの位置 アクセスが許可されると、Sitecore CDPのデータレイクエクスポートサービスが毎日実行され、[組織のデータの完全なエクスポートが作成され](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/data-lake-export-service.html "Data lake export service")ます。このエクスポートされたデータはSitecore Amazon S3バケット内の指定されたフォルダに保存されます。エクスポートフォルダは以下の形式に従います( [プレースホルダーの値は](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727950799439 "Reference for placeholder values")Sitecore CDPインスタンスの詳細に置き換えています): s3://bx---/analytics/bdl/exports/data/ ### データ冗長性 Sitecoreはエクスポートプロセスでの失敗やエラーに備え、エクスポートフォルダーに設計された冗長性を提供します。データの信頼性を確保するため、Sitecoreは指定フォルダ内に過去3日間の完全なデータレイクエクスポートを保存します。 例えば、2024年5月5日のエクスポートフォルダには3つのサブフォルダがあり、それぞれYYYY-MM-DD ISO 8601形式の日付ラベルが付いており、以下のデータが含まれています。 - 2024-05-04 - 5月3日からの新規および更新されたデータを含むデータレイクの全コンテンツ。 - 2024-05-03 - 5月2日以降の新規および更新データを含むデータレイクの全コンテンツ。 - 2024-05-02 - データレイクの全コンテンツ。 5月6日に障害が発生した場合、過去3日間分のデータは利用可能ですが、5月5日のデータは存在しません。5月7日にサービスが再開されると、フォルダ構造は以下のようになります。 - 2024-05-06 - 5月4日および5月5日の新規および更新データを含むデータレイクの全コンテンツ。 - 2024-05-04 - 5月3日からの新規および更新されたデータを含むデータレイクの全コンテンツ。 - 2024-05-03 - データレイクの全コンテンツ。 ### データ分割 エクスポートフォルダはさらに異なる[Sitecore CDPエンティティ用のサブフォルダに分割](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/data-lake-export-service.html "Data lake export service")されています。 events、guests、sessionsそれぞれ別のフォルダがあります。 eventsサブフォルダにはデータレイク内で最大のデータセットが含まれており、毎日このデータをダウンロードするのは非効率的です。このプロセスを最適化するために、Sitecoreイベントデータには日付ベースのパーティション分けが用いられています。各日のイベントはmeta\_created\_at\_date=YYYY-MM-DDという別個のフォルダに保存されます。例えば、meta\_created\_at\_date=2024-05-04、meta\_created\_at\_date=2024-05-03、などです。 イベントデータは加算的であり、過去のイベントは削除されません。その結果、各デイリーエクスポートのeventsサブフォルダには、データレイクエクスポートが有効だった日ごとにパーティション分けされたサブフォルダが存在します。この構造により、毎日すべてのeventsサブフォルダをダウンロードする必要がなくなります。代わりに、最新の日付のパーティションイベントデータを取り出し、既存のデータセットに追加して最新の状態を保つだけで済みます。 sessionsサブフォルダはeventsサブフォルダと同様に日付ごとにパーティション分けされており、同じ方法を踏むことが推奨されます。 guestsサブフォルダはゲストタイプごとにパーティション分けされています:CUSTOMER、VISITOR、RETIRED。このデータセットは常に変化しているため、毎日このフォルダをフルプルすることが推奨されます。 ## データへのアクセス IAMロールが承認された後、IAMロールの作成者であるあなただけがSitecore Amazon S3バケット内の組織のデータにアクセスできるようになります。 > !重要あなたが提供した特定のIAMロールARNのみが組織のデータにアクセスする権限を持っています。このIAMロールを使って他のユーザーはあなたのデータにアクセスできません。もし当初指定されたものと異なるユーザーに役割を付与し、そのユーザーがエクスポート処理を実行しようとした場合、セキュリティ上の理由で拒否されます。 > > データレイクエクスポートが設定された後に割り当てられたユーザーを変更する必要がある場合は、この更新を要求するために [サポートケースを作成する](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/create-a-support-case.html) 必要があります。これによりプロセスがリセットされるため、アクセスを要求する前に正しいユーザー、ロール、ARNを必ず確認してください。 このセクションでは、AWSコマンドラインインターフェース(AWS CLI)でaws s3 cp(またはコピー)コマンドを使ってデータをダウンロードしたり、選択した別のAmazon S3バケットにコピーする方法を説明します。あるいは、*Get*や*List*で始まる[Amazon S3のアクション](https://docs.aws.amazon.com/AmazonS3/latest/userguide/list_amazons3.html#amazons3-actions-as-permissions)を実行してデータにアクセスすることもできます。 データにアクセスするには: 1. 必ずAWS CLIをインストールし、IAMロールを使ってAWSインスタンスにアクセスできるように設定してください。 2. エクスポートフォルダからコピーしたい [フォルダやサブフォルダ](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_section-idm234557301648021 "Understand the exported data") を決めてください。特定の要件に応じて異なるデータセットを選択できます。 3. ターミナルやコマンドプロンプトを開き、以下のaws s3 cpコマンドを実行して組織のデータをコピーしてください。 [プレースホルダーの値は](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727950799439 "Reference for placeholder values")Sitecore CDPインスタンスの詳細に置き換えてください。 例61。ターミナルで入力できるよく使われるAWS S3のCPコマンド 組織のデータをローカルマシンにダウンロードしてください。これには [過去3日間の完全なデータレイクのエクスポート](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727941636429 "Data redundancy")も含まれます。 aws s3 cp s3://bx---/analytics/bdl/exports/data . --recursive [特定の日付で完全なデータレイクのエクスポート](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727941636429 "Data redundancy")をローカルマシンにダウンロードしてください。 aws s3 cp s3://bx---/analytics/bdl/exports/data/ . --recursive 組織のすべてのデータを別のAmazon S3バケットにコピーしてください。これには [過去3日間の完全なデータレイクのエクスポート](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727941636429 "Data redundancy")も含まれます。 aws s3 cp s3://bx---/analytics/bdl/exports/data --recursive [特定の日付の完全なデータレイクエクスポート](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/access-your-data.html#UUID-fd039a77-1b6e-695b-906d-bef37295e4c6_N1727941636429 "Data redundancy")を、別のAmazon S3バケットにコピーしてください: aws s3 cp s3://bx---/analytics/bdl/exports/data/ --recursive これらのコマンドを実行すると、組織のデータがローカルにダウンロードされるか、選んだ別のAmazon S3バケットにコピーされます。 > !警告BDLエクスポートプロセスで生成される .parquetファイルのファイル名やサイズは、Sitecoreによって制御または一意であることを保証するものではありません。すべてのエクスポートファイルが単一のディレクトリに配置されると、名前の衝突により一部のファイルが意図せず上書きされることがあります。 > > データの損失や破損を防ぐために: > > - BDLエクスポートで作成されたフォルダ構造を移動したりフラット化したりしないでください。 > > - エクスポートしたファイルの保存、転送、読み込みの際には、必ず元のディレクトリ階層を保持してください。 > ### プレースホルダー値の参照 例のコマンドでは、プレースホルダーの値をSitecore CDPインスタンスの必要な詳細に、必要に応じてエクスポートの詳細に置き換えてください。 属性 種類 概要 例 ストリング あなたのSitecore CDPクライアントキーは、あなたのSitecore CDPインスタンスからのものです。これはあなたの組織の一意かつ公開の識別子です。 クライアントキーを探すには、Sitecore CDPのナビゲーションペインで「![cdp\_gear\_icon.png](https://doc.sitecore.com/api/markdown-image/cdp/ja/developers/api/images/cdp_gear_icon.png) >」をクリックしAPI「クライアント**キー** **\>アクセス**」をクリックしてください。 ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe ストリング デプロイメント環境について。通常は、特に注意がなければ production に設定されています。 production ストリング あなたのSitecore CDPインスタンスの環境に対応する地域コードです。 地域コードを見つけるには、Sitecore CDPのナビゲーションペインで「 **![cdp\_gear\_icon.png](https://doc.sitecore.com/api/markdown-image/cdp/ja/developers/api/images/cdp_gear_icon.png) > 会社情報**\>**環境**」をクリックしてください。 以下のいずれかでなければなりません: - ap-southeast-2 - eu-west-1 - ap-northeast-1 - us-east-1 ストリング 過去または今日の特定の日付で、その日付の完全なデータレイクエクスポートをコピーします。 フォーマット: YYYY-MM-DD 2026-01-27 ストリング ローカルマシンはピリオド(.)で表されるか、データをコピーしたい別のAmazon S3バケットで表されます。 s3://my-bucket/myData