# RDS for SQL Server インスタンスの Microsoft SQL Server リソースガバナーを有効にする
<a name="ResourceGovernor.Enabling"></a>

RDS for SQL Server DB インスタンスに `RESOURCE_GOVERNOR` オプションを追加して、リソースガバナーを有効にします。以下のプロセスを使用します。

1. 新しいオプショングループを作成するか、既存のオプショングループを選択します。

1. オプショングループに [`RESOURCE_GOVERNOR`] オプションを追加します。

1. オプショングループを DB インスタンスに関連付けます。

**注記**  
オプショングループを使用してリソースガバナーを有効にする場合、再起動は必要ありません。

## `RESOURCE_GOVERNOR` のオプショングループの作成
<a name="ResourceGovernor.OptionGroup"></a>

リソースガバナーを有効にするには、使用する DB インスタンスの SQL Server のエディションとバージョンに対応するオプショングループを作成または変更します。この手順を完了するには、AWS マネジメントコンソール または AWS CLI を使用してください。

### コンソール
<a name="ResourceGovernor.OptionGroup.Console"></a>

次の手順を使用して、SQL Server Enterprise Edition 2022 のオプショングループを作成します。

**オプショングループを作成するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、[**オプショングループ**] を選択します。

1. **[Create group]** (グループの作成) を選択します。

1. [**Create subnet group**(オプショングループの作成)] ウィンドウで以下を行います。

   1. [**名前**] に、AWS アカウント内で一意のオプショングループ名 (**resource-governor-ee-2022** など) を入力します。名前には、英字、数字、ハイフンのみを使用できます。

   1. [**説明**] に、オプショングループの簡単な説明 (**RESOURCE\_GOVERNOR option group for SQL Server EE 2022** など) を入力します。この説明は表示用に使用されます。

   1. **[エンジン]** で **[sqlserver-ee]** を選択します。

   1. [**メジャーエンジンのバージョン**] で、[**16.00**] を選択します。

1. **[作成]** を選択します。

### CLI
<a name="ResourceGovernor.OptionGroup.CLI"></a>

次の手順では、SQL Server Enterprise Edition 2022 のオプショングループを作成します。

**オプショングループを作成するには**
+ 以下のいずれかのコマンドを実行します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds create-option-group \
      --option-group-name {{resource-governor-ee-2022}} \
      --engine-name {{sqlserver-ee}} \
      --major-engine-version {{16.00}} \
      --option-group-description "{{RESOURCE_GOVERNOR option group for SQL Server EE 2022}}"
  ```

  Windows の場合:

  ```
  aws rds create-option-group ^
      --option-group-name {{resource-governor-ee-2022}} ^
      --engine-name {{sqlserver-ee}} ^
      --major-engine-version {{16.00}} ^
      --option-group-description "{{RESOURCE_GOVERNOR option group for SQL Server EE 2022}}"
  ```

## `RESOURCE_GOVERNOR` オプションのオプショングループへの追加
<a name="ResourceGovernor.Add"></a>

次に、AWS マネジメントコンソール または AWS CLI を使用して `RESOURCE_GOVERNOR` オプションをオプショングループに追加します。

### コンソール
<a name="ResourceGovernor.Add.Console"></a>

**RESOURCE\_GOVERNOR オプションを追加するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、[**オプショングループ**] を選択します。

1. 作成したオプショングループ (この例では **resource-governor-ee-2022**) を選択します。

1. **[オプションを追加]** を選択します。

1. **[オプションの詳細]** で、**[オプション名]** として **[RESOURCE\_GOVERNOR]** を選択します。

1. **[スケジュール]** で、オプションをすぐに追加するか、次のメンテナンスウィンドウで追加するかを選択します。

1. **[オプションを追加]** を選択します。

### CLI
<a name="ResourceGovernor.Add.CLI"></a>

**`RESOURCE_GOVERNOR` オプションを追加するには**
+ オプショングループに [`RESOURCE_GOVERNOR`] オプションを追加します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds add-option-to-option-group \
      --option-group-name {{resource-governor-ee-2022}} \
      --options "OptionName=RESOURCE_GOVERNOR" \
      --apply-immediately
  ```

  Windows の場合:

  ```
  aws rds add-option-to-option-group ^
      --option-group-name {{resource-governor-ee-2022}} ^
      --options "OptionName=RESOURCE_GOVERNOR" ^
      --apply-immediately
  ```

## オプショングループを DB インスタンスに関連付ける
<a name="ResourceGovernor.Apply"></a>

`RESOURCE_GOVERNOR` オプショングループを DB インスタンスに関連付けるには、AWS マネジメントコンソール または AWS CLI を使用します。

### コンソール
<a name="ResourceGovernor.Apply.Console"></a>

リソースガバナーの有効化を完了するには、`RESOURCE_GOVERNOR` オプショングループを新規または既存の DB インスタンスに関連付けます。
+ 新しい DB インスタンスの場合は、インスタンスを起動するときにそれらを関連付けます。詳細については、「[Amazon RDS DB インスタンスの作成](USER_CreateDBInstance.md)」を参照してください。
+ 既存の DB インスタンスの場合は、インスタンスを変更することでそれらを関連付けます。詳細については、「[Amazon RDS DB インスタンスを変更する](Overview.DBInstance.Modifying.md)」を参照してください。

### CLI
<a name="ResourceGovernor.Apply.CLI"></a>

`RESOURCE_GOVERNOR` オプショングループを新規または既存の DB インスタンスに関連付けることができます。

**`RESOURCE_GOVERNOR` オプショングループを使用してインスタンスを作成するには**
+ オプショングループの作成時に使用したのと同じ DB エンジンのタイプとメジャーバージョンを指定します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds create-db-instance \
      --db-instance-identifier {{mytestsqlserverresourcegovernorinstance}} \
      --db-instance-class {{db.m5.2xlarge}} \
      --engine {{sqlserver-ee}} \
      --engine-version {{16.00}} \
      --license-model {{license-included}} \
      --allocated-storage {{100}} \
      --master-username {{admin}} \
      --master-user-password {{password}} \
      --storage-type {{gp2}} \
      --option-group-name {{resource-governor-ee-2022}}
  ```

  Windows の場合:

  ```
  aws rds create-db-instance ^
      --db-instance-identifier {{mytestsqlserverresourcegovernorinstance}} ^
      --db-instance-class {{db.m5.2xlarge}} ^
      --engine {{sqlserver-ee}} ^
      --engine-version {{16.00}} ^
      --license-model {{license-included}} ^
      --allocated-storage {{100}} ^
      --master-username {{admin}} ^
      --master-user-password {{password}} ^
      --storage-type {{gp2}} ^
      --option-group-name {{resource-governor-ee-2022}}
  ```

**インスタンスを変更して `RESOURCE_GOVERNOR` オプショングループを関連付けるには**
+ 以下のいずれかのコマンドを実行します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds modify-db-instance \
      --db-instance-identifier {{mytestinstance}} \
      --option-group-name {{resource-governor-ee-2022}} \
      --apply-immediately
  ```

  Windows の場合:

  ```
  aws rds modify-db-instance ^
      --db-instance-identifier {{mytestinstance}} ^
      --option-group-name {{resource-governor-ee-2022}} ^
      --apply-immediately
  ```