---
title: "データ抽出"
slug: "data-extraction"
abstract: "xConnectクライアントAPIのデータ抽出機能の使い方について。これにより、すべての連絡先ややり取り、または一部をサードパーティアプリケーションでエクスポートできます。"
---
# データ抽出

データ抽出はxConnect Client APIの機能であり、連絡先やインタラクションのすべてまたは一部をサードパーティアプリケーションで使用するためにエクスポートすることを可能にします。報告データベースの再構築プロセス(履歴集約とも呼ばれる)はデータ抽出機能を利用します。

## マルチシャード環境におけるデータ抽出

データ抽出は、シャードを呼び出す際にラウンドロビン方式を用います。

-   シャードは1つずつリクエストされます。シャードに500レコードがあり、要求されたバッチサイズが1000の場合、500レコードのみが返されます。
-   シャードに関連データがなければスキップされます。
-   Sitecore 9.2からは、読み取り操作の結果が0レコードで他のシャードにレコードがある場合、次のシャードからデータを読み取るために読み取り操作が実行されます。

以下の例は、3つのシャードと要求されたバッチサイズが1000の環境におけるデータ抽出のプロセスを示しています。

-   データ抽出が始まる前に、データはシャード全体に次のように分散されます。
    
    ![Three shards with data distributed across them.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/data-extraction-1.png)
    
-   ファーストリードカーソル操作(シャード1から開始):シャード1(1000)=1000レコードの返送:
    
    ![First read cursor operation across the three shards.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/data-extraction-2.png)
    
-   2回目の読み取りカーソル操作(シャード2から開始):シャード2(500)= 500レコードの返送:
    
    ![Second read cursor operation with 500 records returned.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/data-extraction-3.png)
    
    > !注バッチを埋めるためにシャード3は要求されず、500件のレコードのみが返されます。
    
-   3回目の読み取りカーソル操作(シャード3から開始):シャード3(1000)=1000レコードの返送:
    
    ![Third read cursor operation with 1000 records returned.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/data-extraction-4.png)
    
-   4回目の読み取りカーソル操作(シャード3から開始):シャード3(200)=200レコードを返しました:
    
    ![Fourth read cursor operation with 200 records returned.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/data-extraction-5.png)
    

この時点でデータ抽出は完了します。