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 | ブール値 | 任意 | シャードキーの特性に関するメトリクスを計算するかどうか。 詳細については、「 キーの特性 」を参照してください。 デフォルトは |
opts.readWriteDistribution | ブール値 | 任意 | 読み取りと書込みの分布に関するメトリクスを計算するかどうか。 詳しくは、「 readWriteDistribution 」を参照してください。 デフォルトは |
opts.sampleRate | double | 任意 | シャードキーの特性に関するメトリクスを計算するときにサンプリングするコレクション内のドキュメントの割合。
デフォルト値はありません。 |
opts.sampleSize | integer | 任意 | シャードキーの特性に関するメトリクスを計算するときにサンプリングするドキュメントの数。 指定されておらず、かつ |
動作
動作については、 analyzeShardKey の動作 を参照してください。
アクセス制御
詳細については、「 analyzeShardKey アクセス制御 」を参照してください。
出力
出力の例については、「 analyzeShardKey 出力 」を参照してください。
例
例については、「 analyzeShardKey の例 」を参照してください。