キャパシティ ポリシー

キャパシティ ポリシーは、クラスターでのデータ管理操作のコンピューティング リソースを制御するために使用されます。

キャパシティ ポリシー オブジェクト

容量ポリシーは、次のコンポーネントで構成されます。

• IngestionCapacity
• ExtentsMergeCapacity
• ExtentsPurgeRebuildCapacity
• ExportCapacity
• ExtentsPartitionCapacity
• MaterializedViewsCapacity
• StoredQueryResultsCapacity

クラスターの容量を表示するには、 .show capacity コマンドを使用します。

インジェスト キャパシティ

式

.show capacity コマンドは、次の式に基づいてクラスターのインジェスト容量を返します。

Minimum(ClusterMaximumConcurrentOperations, クラスター内のノードの数 * Maximum(1, ノードあたりのコア数 * CoreUtilizationCoefficient))

エクステントのマージ キャパシティ

式

.show capacity コマンドは、次の式に基づいてクラスターのエクステントマージ容量を返します。

クラスター内のノード数 * ノードあたりのコンカレント操作数

ノードあたりの 繰り返し操作の有効な値 は、マージ操作の成功率が 90% 以上である限り、システムによって [MinimumConcurrentOperationsPerNode,MaximumConcurrentOperationsPerNode] の範囲で自動的に調整されます。

エクステントの消去再構築キャパシティ

式

.show capacity コマンドは、次の式に基づいてクラスターのエクステントの消去再構築容量を返します。

クラスター内のノードの数 x MaximumConcurrentOperationsPerNode

エクスポート キャパシティ

式

.show capacity コマンドは、次の式に基づいてクラスターのエクスポート容量を返します。

Minimum(ClusterMaximumConcurrentOperations, クラスター内のノードの数 * Maximum(1, ノードあたりのコア数 * CoreUtilizationCoefficient))

エクステントのパーティション キャパシティ

連続操作の有効な値は、パーティション分割操作の成功率が 90% 以上である限り、システムによって [ClusterMinimumConcurrentOperations,ClusterMaximumConcurrentOperations] の範囲で自動的に調整されます。

具体化されたビューのキャパシティ ポリシー

このポリシーを使用して、具体化されたビューの同時実行の設定を変更できます。 具体化されたビューの容量ポリシーを変更すると、クラスターに 1 つ以上の具体化されたビューが定義されている場合に便利です。

Concurrent 操作の有効な値は、クラスター内の具体化されたビューの数とクラスターの CPU に基づいて、[ClusterMinimumConcurrentOperations,ClusterMaximumConcurrentOperations] 範囲内のシステムによって自動的に調整されます。

保存されたクエリ結果のキャパシティ

式

.show capacity コマンドは、次の式に基づいて、クラスターの格納されているクエリ結果の作成容量を返します。

クラスター内のノードの数 * Maximum(1, ノードあたりのコア数 * CoreUtilizationCoefficient)

既定

既定のキャパシティ ポリシーには、次の JSON 表現があります。

{
  "IngestionCapacity": {
    "ClusterMaximumConcurrentOperations": 512,
    "CoreUtilizationCoefficient": 0.75
  },
  "ExtentsMergeCapacity": {
    "MinimumConcurrentOperationsPerNode": 1,
    "MaximumConcurrentOperationsPerNode": 3
  },
  "ExtentsPurgeRebuildCapacity": {
    "MaximumConcurrentOperationsPerNode": 1
  },
  "ExportCapacity": {
    "ClusterMaximumConcurrentOperations": 100,
    "CoreUtilizationCoefficient": 0.25
  },
  "ExtentsPartitionCapacity": {
    "ClusterMinimumConcurrentOperations": 1,
    "ClusterMaximumConcurrentOperations": 32
  },
  "MaterializedViewsCapacity": {
    "ClusterMaximumConcurrentOperations": 1,
    "ExtentsRebuildCapacity": {
      "ClusterMaximumConcurrentOperations": 50,
      "MaximumConcurrentOperationsPerNode": 5
    }
  },
  "StoredQueryResultsCapacity": {
    "MaximumConcurrentOperationsPerDbAdmin": 250,
    "CoreUtilizationCoefficient": 0.75
  }
}

管理コマンド

• .show cluster policy capacity を使用して、クラスターの現在のキャパシティ ポリシーを表示します。
• .alter-merge cluster policy capacity を使用して、クラスターの現在のキャパシティ ポリシーを変更します。

管理コマンドの調整

Kusto では、ユーザーによって開始される次のコマンドの同時要求数が制限されています。

• インジェスト
  • このカテゴリには、ストレージからの取り込み、クエリからの取り込み、インラインでの取り込みを実行するコマンドが含まれています。
  • この制限は、インジェスト キャパシティによって定義されます。
• 消去
  • グローバルな制限は、現在、クラスターごとに 1 つに修正されています。
  • 消去再構築キャパシティは、消去コマンドの実行中の同時再構築操作数を決定するために、内部的に使用されます。 このプロセスが原因で、消去コマンドがブロックまたは調整されることはありませんが、消去再構築キャパシティに応じて完了がより早くまたは遅くなります。
• エクスポート
  • この制限は、エクスポート キャパシティに定義されているとおりです。

操作が同時要求数の制限を超えたことをクラスターが検出すると、次のようになります。

• システム情報のコマンドによって示されるように、コマンドの状態が Throttled になります。
• エラー メッセージには、コマンドの種類、調整の発生元、超過したキャパシティが含まれます。 例:
  • (例: The management command was aborted due to throttling. Retrying after some backoff might succeed. CommandType: 'TableSetOrAppend', Capacity: 18, Origin: 'CapacityPolicy/Ingestion')。
• HTTP 応答コードは 429 になります。 サブコードは TooManyRequests になります。
• 例外の種類は ControlCommandThrottledException になります。

関連するコンテンツ

• .show capacity