--- title: "バッチファイルをアップロードする" slug: "upload-a-batch-file" abstract: "バッチファイルをSitecore CDPにアップロードする方法。" --- # バッチファイルをアップロードする このウォークスルーでは、バッチファイルをSitecore CDPにアップロードします。 このウォークスルーでは、以下の方法を説明します: :::攻略 1. [JSONファイルをGzipで処理してください](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-a-batch-file.html#gzip-your-json-file) 2. [必要な情報を集める](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-a-batch-file.html#collect-required-details) 3. [gzip化されたファイルをアップロードしてください](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-a-batch-file.html#upload-the-gzipped-file) 4. [Sitecore CDPがアップロードされたデータを取り込んでいるか確認してください](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-a-batch-file.html#verify-that-sitecore-cdp-ingested-the-uploaded-data)::: > !注**始める前に** > > - 有効なJSON記録を含む[JSONファイル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_section-idm4522526261340833518772650713 "JSON records in the JSON file") (import.json)を用意してください。ご自身の記録JSONがない場合は、[サンプルJSON記録](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_section-idm4522526261340833518772650713 "JSON records in the JSON file")をご利用ください。 > > - [ファイルアーカイブを](https://www.7-zip.org/download.html)使えるようにしましょう。 > ## JSONファイルをGzipで処理してください バッチファイルをアップロードする前に、JSONファイルをgzip化し、アップロードプロセスでgzip化されたファイルを使います。 JSONファイルをgzip化するには: - ファイルアーカイブまたはプログラム方式のいずれかを使いましょう。 例えば、アップロードしたいデータがimport.jsonにある場合、gzip化されたファイルはimport.json.gzです。 > !ヒントバッチファイルのアップロードには50MBのサイズ制限があります。 > > もしgzipファイルのサイズが50MBの制限を超えた場合は、元のJSONファイルを2つ以上のgzipファイルに再圧縮し、そのファイルは50MBサイズを超えません。その後、gzip化されたファイルを1つずつアップロードします。 ## 必要な情報を集める gzipファイルを作成した後、アップロードプロセスを開始するために必要な詳細情報を集めます。 詳細 種類 概要 例 バイト単位のファイルサイズ 整数 gzip化されたファイルのバイト単位でのサイズ(import.json.gz)。ファイルのプロパティで確認できます。 3456 MD5チェックサム ストリング gzip化されたファイルの16進エンコード [MD5チェックサム](https://emn178.github.io/online-tools/md5_checksum.html) です。これは、gzip化されたファイルの整合性が保たれていることを保証するためのものです。 "40d9a12f0a3c93c8ed66a3b6f3735790" Base64弦 ストリング 同じ16進符号化されたMD5チェックサムを [Base64](https://base64.guru/converter/encode/hex)に変換しました。 "hmhSUwGGLymfT1gmfmkCSA==" バッチ参照用のUUID ストリング バッチアップロードのUUID。 これはあなたが生成するUUIDです。すべてのバッチで一意でなければなりません。 [オンラインツールを使って](https://guidgenerator.com/online-guid-generator.aspx) UUIDを生成できます。 3ee694e5-0b77-2d1e-af19-1aa78f500785 ## gzip化されたファイルをアップロードしてください 必要な情報を集めたら、アップロードプロセスを開始できます。このプロセスでは、まずバッチアップロードの場所を割り当て、その後gzip化されたファイルのアップロードを開始し、アップロードのステータスを取得します。 バッチアップロード場所を割り当てた後は、**開発者センター** Sitecore CDP >バッチ [**アップロード**](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/work-with-batch-uploads.html)\>バッチファイルのアップロード状況を監視し始めることができます。 gzip化されたファイルをアップロードするには: 1. バッチアップロード場所を割り当てるためにPUTリクエストを出します。 curl -X PUT '/v2/batches/' \\ -u ':' \\ --data-raw ' { "checksum": "", "size": }' 以下に注意してください: - [基本的な認証を](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/authentication-999478.html "Authentication")使いましょう。 - を[基本URL](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/base-url.html "Base URL")に置き換えます。、、を前の手順で収集した値に置き換えます。 レスポンス内のlocationオブジェクトのhrefキーにはバッチアップロードパスが含まれています。次のステップでバッチアップロードパスを使用します。バッチアップロードパスは1時間有効です。 バッチアップロードパスの例: https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/... > !警告処理のために大量のバッチファイルをアップロードしようとすると、バッチアップロードの上限を超えたというエラーが表示されます。一度に1つのバッチファイルをアップロードする必要があります。 2. バッチアップロードパスにPUTリクエストを送ります。このリクエストがアップロードを開始します。 curl -X PUT 'https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...' \\ -H 'x-amz-server-side-encryption: AES256' \\ -H 'Content-Md5: ' \\ --data-binary '' 以下に注意してください: - 前のステップとは逆に基本的な認証は使わないことです。 - 上記のコードサンプルで示されたようにヘッダーを指定します。 を前の手続きで収集した値に置き換えます。 - \--data-binaryで、gzip化されたファイルのパスを指定します。ファイルを本文にバイナリデータとしてアップロードしなければなりません。 例: @/C:/Users/user/Desktop/import.json.gz > !ヒントPostmanを使っている場合は、バイ**ナリ**\>**ボディ**をクリックし>**ファイル選択**。 このリクエストは空の200 OK応答を返します。 3. バッチファイルのアップロード状況は、**開発者センター** >バッチ [**アップロード**](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/work-with-batch-uploads.html)Sitecore CDP >を開くか、以下のGETリクエストを行って確認してください: curl -X GET '/v2/batches/' \\ -u ':' \\ -H 'Accept: application/json' 以下に注意してください: - [基本的な認証を](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/authentication-999478.html "Authentication")使いましょう。 - を[基本URL](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/base-url.html "Base URL")に置き換えてください。を、PUTのバッチアップロード場所割り当てリクエストをしたときに使ったのと同じバッチ参照に置き換えてください。 応答では、statusオブジェクトに [アップロード状況](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/retrieve-batch-file-upload-status.html#UUID-34d4e5d5-6978-8b2c-4d6e-06bf48f4a5d7_para-idm1903352047606408)に関する情報が含まれています。まず、ステータスはprocessingです。アップロードが成功すると、ステータスはsuccessとなります。 > !ヒント次のファイルをアップロードする前に、各ファイルのアップロード状況が成功しているか確認することをお勧めします。これにより、フォーマットの問題やその他のエラーで失敗した際に、ステータスを確認しなかったファイルの再アップロードを省くことができます。 ## Sitecore CDPがアップロードされたデータを取り込んだか確認してください アップロードが成功したら、アップロードされたデータを確認するためにSitecore CDPにログインします。この例では、[サンプルJSONレコード](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_section-idm4522526261340833518772650713 "JSON records in the JSON file")に記載されているゲストを検索します。 Sitecore CDPがアップロードされたデータを取り込んだことを確認するために: 1. Sitecore CDPで「 **ゲスト**」をクリックし、検索ドロップダウンで **「メール** 」を選択し、アップロードしたゲストレコードのメールアドレス(例えば[jane.doe@myretailsite.com](mailto:jane.doe@myretailsite.com))を入力してください。 ゲストの展示。 2. ゲストをクリックしてください。ゲストプロフィールが表示されます。 3. ゲストプロフィールページで「**プロパティ**」をクリックします。アップロードされたゲストの詳細が表示されます。サンプルJSONレコードに記載されているゲストの詳細には、Ext属性にFirst Seen、Last Seen、データ拡張(例えばLoyaltyNumber)が含まれています。 > !ヒントアップロードが成功し、Sitecore CDPがデータを取り込んだら、残りのバッチファイルを一つずつアップロードし始められます。 これでバッチファイルをSitecore CDPに正常にアップロードしました。JSONファイルをgzip化し、アップロードを開始し、Sitecore CDPがアップロードしたデータを取り込んだことを確認しました。