リソースグループのプロパティ

リソースグループ'JSONファイルは、コンソールからダウンロードできるサンプルリソースグループファイルと一致するようにフォーマットすることができます。以下のセクションでは、設定可能なリソースグループプロパティについて説明します。

表 1. メイン・プロパティー
プロパティー名	タイプ	必須 / 任意指定	説明
`rootGroups`	アレイ	必須	リソースグループの仕様を定義する。
`selectors`	アレイ	必須	リソースグループのセレクタ構成を指定します。
`cpuQuotaPeriod`	ストリング	オプション	CPUクォータ期間を指定する。パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。

表 2. `rootGroups` プロパティー
プロパティー名	タイプ	必須 / 任意指定	説明
`name`	ストリング	必須	リソース・グループの名前。以下は命名条件である：名前に'`{`、'`}`、'`$`が含まれる場合、名前はパターン'`\$\{([a-zA-Z][a-zA-Z0-9]*)\}`でなければならない。名前には空白を入れることができる。名前にピリオド（.） 2つの兄弟グループに同じ名前をつけることはできない。ルートグループとサブグループに同じ名前を付けることができます。
`softMemoryLimit`	ストリング	必須	ソフトメモリーの上限を指定する。最低値：0 最大値：999
`maxQueued`	整数	オプション	キューに入れられたリクエストの最大数を指定します。最小値: 0 最大値：2147483647 注：値は'`0`で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。
`softConcurrencyLimit`	整数またはNULL	オプション	ソフトの同時実行数制限を指定する。最小値: 0 最大値：2147483647 注：値は'`0`で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。
`maxRunning`	整数またはNULL	オプション	最大実行回数を指定する。最小値: 0 最大値：2147483647 注：値は'`0`で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。
`hardConcurrencyLimit`	整数	必須注：「`maxRunning`値が利用可能な場合、「`hardConcurrencyLimit`その値を引き継ぐ。 `maxRunning`が設定されていない場合は、'`hardConcurrencyLimit` に値を設定する必要がある。	ハード同時実行数制限を指定する。最小値: 0 最大値：2147483647 注：値は'`softConcurrencyLimit`以上でなければならない。 `0` で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。
`schedulingPolicy`	ストリング以下は利用可能な値である： `fair` `weighted` `weighted_fair` `query_priority` これらの値は大文字小文字が区別されません。	オプション	スケジューリングポリシーを指定します。
`schedulingWeight`	整数またはNULL	オプション	スケジューリングの重みを指定する。許容値（最小値から最大値まで）：1～2147483647。注：値は'`0`で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。あるサブグループが'`schedulingWeight`持つ場合、そのサブグループ内の対応する兄弟はすべて'`schedulingWeight`持たなければならない。
`subGroups`	配列またはヌル	オプション	リソースグループ内のサブグループを指定します。サブグループには、リソースグループと同じように、異なるプロパティに対するルールがあります。
`jmxExport`	ブールまたはヌル	オプション	JMX エクスポートが有効かどうかを示します。
`softCpuLimit`	ストリング	オプション	ソフトCPU制限を指定する。パターン「`^\\d+(\\.\\d+)?[smhd]$`」にマッチしなければならない。 `hardCpuLimit`が定義されている場合、'`softCpuLimit`の値は '`hardCpuLimit` 以下でなければならない。
`hardCpuLimit`	ストリング	オプション	ハードCPU制限を指定する。パターン「`^\d+(\.\d+)?[smhd]$`」にマッチしなければならない。
`perQueryLimits`	オブジェクト	オプション	クエリごとの制限を指定する。例: `"perQueryLimits": { "executionTimeLimit": "30m", "totalMemoryLimit": "2GB", "cpuTimeLimit": "1h" }` このオブジェクトは、以下の1つ、2つ、または3つの制限を持つことができます：注：以下の制限値には負の値は許されない。 executionTimeLimit タイプ文字列パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。 totalMemoryLimit タイプ文字列パターン：このプロパティは、パターン '`^\s(\d+(?:\.\d+)?)\s([a-zA-Z]+)\s$` と一致しなければならない。 cpuTimeLimit タイプ文字列パターン*：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。
`workersPerQueryLimit`	整数またはNULL	オプション	クエリあたりのワーカー数を指定します。許容値（最小値から最大値まで）： -2147483648から2147483647。注：値は'`softConcurrencyLimit`以上でなければならない。 `0` で始まってはならない。例えば、'`01` 、'`05` 。`1`, '`5`ように指定する。 `0`だけでも有効な値である。

表 3. `selectors` プロパティー
プロパティー名	タイプ	必須 / 任意指定	説明
`user`	ストリングまたは null 文字列には有効な正規表現（`.*`）を指定できます。	オプション	ユーザー正規表現パターンを指定します。
`source`	ストリングまたは null 文字列には有効な正規表現（`.*`）を指定できます。	オプション	ソース正規表現パターンを指定します。
`queryType`	ストリングまたは null 考えられる値： `data_definition` `delete` `describe` `explain` `analyze` `insert` `select` `control` `update` これらの値は大文字小文字が区別されません。	オプション	クエリータイプを指定する。
`clientTags`	文字列のリストまたはNULL 例：`"clientTags": ["resourceGroup1",”resourceGroup2”]` 文字列には有効な正規表現（`.*`）を指定できます。	オプション	クライアントタグを指定します。
`selectorResourceEstimate`	オブジェクトまたはヌル	オプション	セレクタリソースの推定値を指定する。例: `"selectorResourceEstimate": {"executionTime": {"min": "5m", "max": "10m"}, "cpuTime": {"min": "30m", "max": "1h"}, "peakMemory": {"min": "512MB", "max": "2GB"}}` このオブジェクトは、以下の1つ、2つ、または3つの制限を持つことができます。また、「`min`、「`max`、またはその両方のパラメータを、3つのリミットすべてに使用することもできる。例えば、`"selectorResourceEstimate": {"executionTime": {"min": "5m"} }` などです。注：以下の制限値には負の値は許されない。 executionTime 分タイプ文字列パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。最大タイプ文字列パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。 peakMemory 分タイプ文字列パターン：このプロパティは、パターン '`^\s(\d+(?:\.\d+)?)\s([a-zA-Z]+)\s$` と一致しなければならない。最大タイプ文字列パターン：このプロパティは、パターン '`^\s(\d+(?:\.\d+)?)\s([a-zA-Z]+)\s$` と一致しなければならない。 cpuTime 分タイプ文字列パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。最大タイプ文字列パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。
`clientInfo`	ストリングまたは null 文字列には有効な正規表現（`.*`）を指定できます。	オプション	クライアント情報の正規表現パターンを指定します。
`schema`	ストリングまたは null 文字列には有効な正規表現（`.*`）を指定できます。	オプション	スキーマを指定する。
`principal`	ストリングまたは null 文字列には有効な正規表現（`.*`）を指定できます。	オプション	主要な正規表現パターンを指定する。
`group`	ストリング	必須	グループ名は、リソースグループで使用可能な名前でなければなりません。サブグループへのリダイレクトには '`"group": "groupname.subgroupname"` を使用する。 `${SOURCE}`、'`${USER}`、'`${SCHEMA}`ような動的な値をルートグループ名に使用することもできます。 `null`を '`group` に含めることはできない。

注意：'sourceと'user正規表現では、'(?<sampleName>.*)形式で指定された名前をダイナミックグループ名として使用することができる。例:

{
            "source": "(?<sampleName>.*)",
            "clientTags": [
                "hipri"
            ],
            "group": "bi-${sampleName}"
}and there is a group as ,{
            "name": "bi-${sampleName}",
            "softMemoryLimit": "80%",
            "hardConcurrencyLimit": 100,
            "maxQueued": 1000,
            "schedulingPolicy": "weighted",
            "jmxExport": true
}

この例では、「sampleName」は動的な値である。名前に特殊文字は使用できません。 ${SOURCE}、'${USER}、'${SCHEMA}などの値を追加することができる。 group」は大文字と小文字を区別する。動的変数の前後に値を持つことができる。例えば、'abc-${SOURCE}または '${toolname}-xyz 。

表 4。 `cpuQuotaPeriod` プロパティー
プロパティー名	タイプ	必須 / 任意指定	説明
`cpuQuotaPeriod`	ストリング	オプション	CPUクォータ期間を指定する。パターン：このプロパティは、パターン '`^\\d+(\\.\\d+)?[smhd]$` と一致しなければならない。