# データベースメールの有効化
<a name="SQLServer.DBMail.Enable"></a>

DB インスタンスでデータベースメールを有効にするには、次の手順に従います。

1. 新しいパラメータグループを作成します。

1. パラメータグループを変更して、`database mail xps` パラメータを 1 に設定します。

1. パラメータグループを DB インスタンスに関連付けます。

## データベースメールパラメータグループの作成
<a name="DBMail.CreateParamGroup"></a>

DB インスタンスの SQL Server のエディションとバージョンに対応する `database mail xps` パラメータのパラメータグループを作成します。

**注記**  
既存のパラメータグループを変更することもできます。「[データベースメールを有効にするパラメータの変更](#DBMail.ModifyParamGroup)」 の手順に従います。

### コンソール
<a name="DBMail.CreateParamGroup.Console"></a>

次の例では、SQL Server Standard Edition 2016 のパラメータグループを作成します。

**パラメータグループを作成するには**

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

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

1. [**Create parameter group**] を選択します。

1. [**パラメータグループの作成**] ペインで、次の操作を行います。

   1. [**パラメータグループファミリー**] で、[**sqlserver-se-13.0**] を選択します。

   1. [**グループ名**] に、パラメータグループの識別子 (**dbmail-sqlserver-se-13** など) を入力します。

   1. [**説明**] に「**Database Mail XPs**」と入力します。

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

### CLI
<a name="DBMail.CreateParamGroup.CLI"></a>

次の例では、SQL Server Standard Edition 2016 のパラメータグループを作成します。

**パラメータグループを作成するには**
+ 以下のいずれかのコマンドを使用します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds create-db-parameter-group \
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} \
      --db-parameter-group-family "{{sqlserver-se-13.0}}" \
      --description "{{Database Mail XPs}}"
  ```

  Windows の場合:

  ```
  aws rds create-db-parameter-group ^
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} ^
      --db-parameter-group-family "{{sqlserver-se-13.0}}" ^
      --description "{{Database Mail XPs}}"
  ```

## データベースメールを有効にするパラメータの変更
<a name="DBMail.ModifyParamGroup"></a>

DB インスタンスの SQL Server のエディションとバージョンに対応するパラメータグループの `database mail xps` パラメータを変更します。

データベースメールを有効にするには、`database mail xps` パラメータを 1 に設定します。

### コンソール
<a name="DBMail.ModifyParamGroup.Console"></a>

次の例では、SQL Server Standard Edition 2016 用に作成したパラメータグループを変更します。

**パラメータグループを変更するには**

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

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

1. [**dbmail-sqlserver-se-13**] などのパラメータグループを選択します。

1. [**パラメータ**] で、パラメータのリストを **mail** でフィルタ処理します。

1. [**データベースメール xps**] を選択します。

1. [**Edit parameters**] を選択します。

1. **1** と入力します。

1. **[Save changes]** (変更の保存) をクリックします。

### CLI
<a name="DBMail.ModifyParamGroup.CLI"></a>

次の例では、SQL Server Standard Edition 2016 用に作成したパラメータグループを変更します。

**パラメータグループを変更するには**
+ 以下のいずれかのコマンドを使用します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds modify-db-parameter-group \
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} \
      --parameters "ParameterName='database mail xps',ParameterValue={{1}},ApplyMethod=immediate"
  ```

  Windows の場合:

  ```
  aws rds modify-db-parameter-group ^
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} ^
      --parameters "ParameterName='database mail xps',ParameterValue={{1}},ApplyMethod=immediate"
  ```

## パラメータグループと DB インスタンスの関連付け
<a name="DBMail.AssocParamGroup"></a>

AWS マネジメントコンソール または AWS CLI を使用して、データベースメールパラメータグループを DB インスタンスに関連付けることができます。

### コンソール
<a name="DBMail.AssocParamGroup.Console"></a>

データベースメールパラメータグループを新規または既存の DB インスタンスに関連付けることができます。
+ 新しい DB インスタンスの場合は、インスタンスを起動するときにそれを関連付けます。詳細については、「[Amazon RDS DB インスタンスの作成](USER_CreateDBInstance.md)」を参照してください。
+ 既存の DB インスタンスの場合は、インスタンスを変更することでそれを関連付けます。詳しくは、「[Amazon RDS DB インスタンスを変更する](Overview.DBInstance.Modifying.md)」を参照してください。

### CLI
<a name="DBMail.AssocParamGroup.CLI"></a>

データベースメールパラメータグループを新規または既存の DB インスタンスに関連付けることができます。

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

  Linux、macOS、Unix の場合:

  ```
  aws rds create-db-instance \
      --db-instance-identifier {{mydbinstance}} \
      --db-instance-class {{db.m5.2xlarge}} \
      --engine {{sqlserver-se}} \
      --engine-version {{13.00.5426.0.v1}} \
      --allocated-storage {{100}} \
      --manage-master-user-password \
      --master-username {{admin}} \
      --storage-type {{gp2}} \
      --license-model {{li}}
      --db-parameter-group-name {{dbmail-sqlserver-se-13}}
  ```

  Windows の場合:

  ```
  aws rds create-db-instance ^
      --db-instance-identifier {{mydbinstance}} ^
      --db-instance-class {{db.m5.2xlarge}} ^
      --engine {{sqlserver-se}} ^
      --engine-version {{13.00.5426.0.v1}} ^
      --allocated-storage {{100}} ^
      --manage-master-user-password ^
      --master-username {{admin}} ^
      --storage-type {{gp2}} ^
      --license-model {{li}} ^
      --db-parameter-group-name {{dbmail-sqlserver-se-13}}
  ```

**DB インスタンスを変更し、データベースメールパラメータグループを関連付けるには**
+ 以下のいずれかのコマンドを使用します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds modify-db-instance \
      --db-instance-identifier {{mydbinstance}} \
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} \
      --apply-immediately
  ```

  Windows の場合:

  ```
  aws rds modify-db-instance ^
      --db-instance-identifier {{mydbinstance}} ^
      --db-parameter-group-name {{dbmail-sqlserver-se-13}} ^
      --apply-immediately
  ```