---
title: "xConnectクライアントAPI読み取り設定"
slug: "xconnect-client-api-read-preferences"
abstract: "Get操作におけるxConnect APIの読み取り設定の概要。"
---
# xConnectクライアントAPI読み取り設定

xConnect Client APIは、任意のGetやデータ抽出操作に対して明示的な読み取り優先オプションを指定する機能をサポートしています:

オプション

概要

Default

デフォルトの読み取り優先設定です。つまり、 EnableScalableReads 設定が有効になると、 Default オプションの読み取り操作が一つずつ分析され、サービスプラグインの事前設定された構成器に基づいて自動的にプライマリまたはセカンダリーノードにルーティングされる ConfigureScalableReadsPlugin。  
  
(例えば、 Default オプションを持つすべてのデータ抽出操作を自動的にセカンダリパリプトにルーティングします。)

AllowStaleData

古いデータを読み取る優先順位を定義します。 AllowStaleData が指定されている場合、データレプリケーションにある程度の遅延を許容します。通常、オンプレミSQLレプリケーション遅延はなく、SQL Azureのプライマリとセカンダリ間のレプリケーションレイテンシは低く、この状況は稀です。

AlwaysLatestData

プライマリレプリカから最も多くの実際のデータを読み取る優先順位を定義します。

以下はGetContactsAsync演算のReadPreference.AllowStaleDataを指定する例です。

Contact contact = await \_client.GetContactAsync(contactId, new ContactExecutionOptions
{
 ReadPreference = ReadPreference.AllowStaleData
});