Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

db.collection.analyzeShardKey()

項目一覧

  • 定義
  • 構文
  • フィールド
  • 動作
  • アクセス制御
  • 出力
  • 詳細
db.collection.analyzeShardKey(key, opts)

シャーディングされていないコレクションまたはシャーディングされたコレクションの シャードキー を評価するためのメトリクスを計算します。 メトリクスは、サンプリングされたクエリに基づいています。 configureQueryAnalyzerを使用して、コレクションのクエリ サンプリングを構成できます。

db.collection.analyzeShardKey() の構文は次のとおりです。

db.collection.analyzeShardKey(
<shardKey>,
{
keyCharacteristics: <bool>,
readWriteDistribution: <bool>,
sampleRate: <double>,
sampleSize: <int>
}
)
フィールド
タイプ
必要性
説明
key
ドキュメント
必須

分析するシャードキー。 これは、シャーディングされていないコレクションまたはシャーディングされたコレクションの候補シャードキー、またはシャーディングされたコレクションの現在のシャードキーです。

デフォルト値はありません。

opts.keyCharacteristics
ブール値
任意

シャードキーの特性に関するメトリクスを計算するかどうか。 詳細については、「 キーの特性 」を参照してください

デフォルトは true です。

opts.readWriteDistribution
ブール値
任意

読み取りと書込みの分布に関するメトリクスを計算するかどうか。 詳しくは、「 readWriteDistribution 」を参照してください。

デフォルトは true です。

opts.sampleRate
double
任意

シャードキーの特性に関するメトリクスを計算するときにサンプリングするコレクション内のドキュメントの割合。 sampleRateを設定した場合、 sampleSizeは設定できません。

01より大きく、 以下である必要があります。

デフォルト値はありません。

opts.sampleSize
integer
任意

シャードキーの特性に関するメトリクスを計算するときにサンプリングするドキュメントの数。 sampleSizeを設定した場合、 sampleRateは設定できません。

指定されておらず、かつsampleRateが指定されていない場合、サンプル サイズはデフォルトでanalyzeShardKeyCharacteristicsDefaultSampleSizeで設定されたサンプル サイズになります。

動作については、 analyzeShardKey の動作 を参照してください。

詳細については、「 analyzeShardKey アクセス制御 」を参照してください。

出力の例については、「 analyzeShardKey 出力 」を参照してください。

例については、「 analyzeShardKey の例 」を参照してください。

戻る

db.collection.aggregate