

# SSRS または PBIRS をオンにする
<a name="SSRS.Enabling"></a>

DB インスタンスの SSRS または PBIRS をオンにするには、次のプロセスを使用します。

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

1. `SSRS` オプション (SQL Server 2016～2022 の場合) または `PBIRS` オプション (SQL Server 2025 以降の場合) をオプショングループに追加します。

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

1. SSRS または PBIRS リスナーポートの仮想プライベートクラウド (VPC) セキュリティグループへのインバウンドアクセスを許可します。

## SSRS または PBIRS のオプショングループの作成
<a name="SSRS.OptionGroup"></a>

SSRS または PBIRS を使用するには、使用する DB インスタンスの SQL Server エンジンおよびバージョンに対応するオプショングループを作成します。そのためには、AWS マネジメントコンソール または AWS CLI を使用します。

**注記**  
既存のオプショングループが正しい SQL Server エンジンおよびバージョンに対応している場合は、それを使用することもできます。

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

次の手順では、SQL Server Standard Edition 2017 のオプショングループを作成します。SQL Server 2025 の場合、同じ手順に従いますが、適切なエンジンバージョンを選択し、`PBIRS` オプションを使用します。

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

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

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

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

1. [**オプショングループの作成**] ウィンドウで、次の操作を行います。

   1. **[名前]** に、AWS アカウント内の一意のオプショングループ名、**ssrs-se-2017** (SSRS の場合) または**pbirs-se-2025** (PBIRS の場合) などを入力します。名前には、英字、数字、ハイフンのみ使用できます。

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

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

   1. **[メジャーエンジンバージョン]** で SSRS オプションを追加する場合は **14.00**、PBIRS オプションを追加する場合は **17.00** を選択します。

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

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

次の手順では、SQL Server Standard Edition 2017 (SSRS) と SQL Server Standard Edition 2025 (PBIRS) のオプショングループを作成します。

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

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-option-group \
    --option-group-name {{ssrs-se-2017}} \
    --engine-name {{sqlserver-se}} \
    --major-engine-version {{14.00}} \
    --option-group-description "{{SSRS option group for SQL Server SE 2017}}"
```
Windows の場合:  

```
aws rds create-option-group ^
    --option-group-name {{ssrs-se-2017}} ^
    --engine-name {{sqlserver-se}} ^
    --major-engine-version {{14.00}} ^
    --option-group-description "{{SSRS option group for SQL Server SE 2017}}"
```

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

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds create-option-group \
    --option-group-name {{pbirs-se-2025}} \
    --engine-name {{sqlserver-se}} \
    --major-engine-version {{17.00}} \
    --option-group-description "{{PBIRS option group for SQL Server SE 2025}}"
```
Windows の場合:  

```
aws rds create-option-group ^
    --option-group-name {{pbirs-se-2025}} ^
    --engine-name {{sqlserver-se}} ^
    --major-engine-version {{17.00}} ^
    --option-group-description "{{PBIRS option group for SQL Server SE 2025}}"
```

## オプショングループへの SSRS または PBIRS オプションの追加
<a name="SSRS.Add"></a>

次に、AWS マネジメントコンソールまたは AWS CLI を使用して、`SSRS` オプション (SQL Server 2016～2022 の場合) または `PBIRS` オプション (SQL Server 2025 以降の場合) をオプショングループに追加します。

### コンソール
<a name="SSRS.Add.CON"></a>

**SSRS オプションを追加するには**

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

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

1. 先ほど作成したオプショングループを選択し、**[Add option]** (オプションの追加) を選択します。

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

1. [**オプション設定**] で、次の操作を行います。

   1. SSRS サービスがリッスンするポートを入力します。デフォルトは 8443 です。許可される値のリストについては、「[制限と推奨事項](SSRS.Limitations.md)」を参照してください。

   1. [**最大メモリ**] に値を入力します。

      [**最大メモリ**] は、レポートサーバーアプリケーションに対して新しいメモリ割り当て要求を許可しない上限しきい値を指定します。この値は、DB インスタンスの合計メモリに対する割合 (%) です。指定できる値は 10～80 です。

   1. [**セキュリティグループ**] で、オプションに関連付ける VPC セキュリティグループを選択します。DB インスタンスに関連付けられているものと同じセキュリティグループを使用します。

1. SSRS Email を使用してレポートを送信するには、**[Email delivery in reporting services]** (レポートサービスでのメール配信) の **[Configure email delivery options]** (E メール配信オプションの設定) チェックボックスを選択し、以下の操作を実行します。

   1. **[Sender email address]** (送信者メールアドレス) で、SSRS Email で送信されるメッセージの **[From]** フィールドに使用するメールアドレスを入力します。

      SMTP サーバーからメールを送信するアクセス許可を持つユーザーアカウントを指定します。

   1. **SMTP server]** (SMTP サーバー) で、使用する SMTP サーバーまたはゲートウェイを指定します。

      IP アドレス、社内イントラネット上のコンピュータの NetBIOS 名、または完全修飾ドメイン名を使用できます。

   1. **[SMTP port]** (SMTP ポート) で、メールサーバーに接続するために使用するポートを入力します。デフォルトは 25 です。

   1. 認証を使用するには:

      1. **[Use authentication]** (認証の使用) チェックボックスを選択します。

      1. **[Secret Amazon Resource Name (ARN)]** (シークレットの Amazon リソースネーム (ARN)) で、ユーザー認証情報の AWS Secrets Manager ARN を入力します。

         次の形式を使用します。

         **arn:aws:secretsmanager:{{Region}}:{{AccountId}}:secret:{{SecretName}}-{{6RandomCharacters}}**

         例: 

         **arn:aws:secretsmanager:{{us-west-2}}:{{123456789012}}:secret:{{MySecret-a1b2c3}}**

         シークレットを作成するための詳細については、「[レポートサービスの E メールを使用したレポートの送信](SSRS.Email.md)」を参照してください。

   1. **[Use Secure Sockets Layer (SSL)]** (Secure Sockets Layer (SSL) を使用する)) チェックボックスを選択して、SSL を使用して電子メールメッセージを暗号化します。

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

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

**PBIRS オプションを追加するには (SQL Server 2025 以降)**

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

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

1. 先ほど作成した PBIRS のオプショングループを選択し、**[オプションの追加]** を選択します。

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

1. [**オプション設定**] で、次の操作を行います。

   1. PBIRS サービスがリッスンするポートを入力します。デフォルトは 8443 です。許可される値のリストについては、「[制限と推奨事項](SSRS.Limitations.md)」を参照してください。

   1. [**最大メモリ**] に値を入力します。

      [**最大メモリ**] は、レポートサーバーアプリケーションに対して新しいメモリ割り当て要求を許可しない上限しきい値を指定します。この値は、DB インスタンスの合計メモリに対する割合 (%) です。指定できる値は 10～80 です。

   1. [**セキュリティグループ**] で、オプションに関連付ける VPC セキュリティグループを選択します。DB インスタンスに関連付けられているものと同じセキュリティグループを使用します。

1. レポートサービスの E メールを使用してレポートを送信するには、**[E メール配信オプションの設定]** の **[レポートサービスでの E メール配信]** チェックボックスを選択し、以下の操作を実行します。

   1. **[送信者の E メールアドレス]** で、レポートサービスの E メールで送信されるメッセージの **[From]** フィールドに使用する E メールアドレスを入力します。

      SMTP サーバーからメールを送信するアクセス許可を持つユーザーアカウントを指定します。

   1. **SMTP server]** (SMTP サーバー) で、使用する SMTP サーバーまたはゲートウェイを指定します。

      IP アドレス、社内イントラネット上のコンピュータの NetBIOS 名、または完全修飾ドメイン名を使用できます。

   1. **[SMTP port]** (SMTP ポート) で、メールサーバーに接続するために使用するポートを入力します。デフォルトは 25 です。

   1. 認証を使用するには:

      1. **[Use authentication]** (認証の使用) チェックボックスを選択します。

      1. **[Secret Amazon Resource Name (ARN)]** (シークレットの Amazon リソースネーム (ARN)) で、ユーザー認証情報の AWS Secrets Manager ARN を入力します。

         次の形式を使用します。

         **arn:aws:secretsmanager:{{Region}}:{{AccountId}}:secret:{{SecretName}}-{{6RandomCharacters}}**

         例: 

         **arn:aws:secretsmanager:{{us-west-2}}:{{123456789012}}:secret:{{MySecret-a1b2c3}}**

         シークレットを作成するための詳細については、「[レポートサービスの E メールを使用したレポートの送信](SSRS.Email.md)」を参照してください。

   1. **[Use Secure Sockets Layer (SSL)]** (Secure Sockets Layer (SSL) を使用する)) チェックボックスを選択して、SSL を使用して電子メールメッセージを暗号化します。

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

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

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

**SSRS オプションを追加するには**

1. `ssrs-option.json` などの JSON ファイル を作成します。

   1. 以下の必須パラメータを設定します。
      + `OptionGroupName` - 以前に作成または選択したオプショングループの名前 (次の例では `ssrs-se-2017`)。
      + `Port` - SSRS サービスがリッスンするポート。デフォルトは 8443 です。許可される値のリストについては、「[制限と推奨事項](SSRS.Limitations.md)」を参照してください。
      + `VpcSecurityGroupMemberships` - RDS DB インスタンスの VPC セキュリティグループのメンバーシップ。
      + `MAX_MEMORY` - レポートサーバーアプリケーションに対して新しいメモリ割り当て要求を許可しない上限しきい値。この値は、DB インスタンスの合計メモリに対する割合 (%) です。指定できる値は 10～80 です。

   1. (オプション) SSRS Email を使用するには、次のパラメータを設定します。
      + `SMTP_ENABLE_EMAIL` — SSRS E メールを使用するには `true` に設定します。デフォルトは `false` です。
      + `SMTP_SENDER_EMAIL_ADDRESS` — SSRS E メールで送信されるメッセージの**[From]** フィールドに使用するメールアドレスです。SMTP サーバーからメールを送信するアクセス許可を持つユーザーアカウントを指定します。
      + `SMTP_SERVER` — 使用する SMTP サーバーまたはゲートウェイ。IP アドレス、社内イントラネット上のコンピュータの NetBIOS 名、または完全修飾ドメイン名を使用できます。
      + `SMTP_PORT` — メールサーバーに接続するために使用するポート。デフォルトは 25 です。
      + `SMTP_USE_SSL` — SSL を使用して E メールメッセージを暗号化するには、`true` に設定します。デフォルトは `true` です。
      + `SMTP_EMAIL_CREDENTIALS_SECRET_ARN` — ユーザー認証情報を保持する Secrets Manager ARN。次の形式を使用します。

        **arn:aws:secretsmanager:{{Region}}:{{AccountId}}:secret:{{SecretName}}-{{6RandomCharacters}}**

        シークレットを作成するための詳細については、「[レポートサービスの E メールを使用したレポートの送信](SSRS.Email.md)」を参照してください。
      + `SMTP_USE_ANONYMOUS_AUTHENTICATION` — 認証を使用しない場合は、`true` に設定し、`SMTP_EMAIL_CREDENTIALS_SECRET_ARN` を含めないでください。

        `SMTP_ENABLE_EMAIL` が `true` の場合、デフォルトは `false` です。

   次の例には、シークレット ARN を使用した SSRS E メールパラメータが含まれています。

   ```
   {
   "OptionGroupName": "{{ssrs-se-2017}}",
   "OptionsToInclude": [
   	{
   	"OptionName": "SSRS",
   	"Port": {{8443}},
   	"VpcSecurityGroupMemberships": ["{{sg-0abcdef123}}"],
   	"OptionSettings": [
               {"Name": "MAX_MEMORY","Value": "{{60}}"},
               {"Name": "SMTP_ENABLE_EMAIL","Value": "{{true}}"}
               {"Name": "SMTP_SENDER_EMAIL_ADDRESS","Value": "{{nobody@example.com}}"},
               {"Name": "SMTP_SERVER","Value": "email-smtp.{{us-west-2}}.amazonaws.com"},
               {"Name": "SMTP_PORT","Value": "{{25}}"},
               {"Name": "SMTP_USE_SSL","Value": "{{true}}"},
               {"Name": "SMTP_EMAIL_CREDENTIALS_SECRET_ARN","Value": "arn:aws:secretsmanager:{{us-west-2}}:{{123456789012}}:secret:{{MySecret-a1b2c3}}"}
               ]
   	}],
   "ApplyImmediately": true
   }
   ```

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

   Linux、macOS、Unix の場合:

   ```
   aws rds add-option-to-option-group \
       --cli-input-json file://{{ssrs-option.json}} \
       --apply-immediately
   ```

   Windows の場合:

   ```
   aws rds add-option-to-option-group ^
       --cli-input-json file://{{ssrs-option.json}} ^
       --apply-immediately
   ```

**PBIRS オプションを追加するには (SQL Server 2025 以降)**

1. `pbirs-option.json` などの JSON ファイル を作成します。

   1. 以下の必須パラメータを設定します。
      + `OptionGroupName` - 以前に作成または選択したオプショングループの名前 (次の例では `pbirs-se-2025`)。
      + `Port` - PBIRS サービスがリッスンするポート。デフォルトは 8443 です。許可される値のリストについては、「[制限と推奨事項](SSRS.Limitations.md)」を参照してください。
      + `VpcSecurityGroupMemberships` - RDS DB インスタンスの VPC セキュリティグループのメンバーシップ。
      + `MAX_MEMORY` - レポートサーバーアプリケーションに対して新しいメモリ割り当て要求を許可しない上限しきい値。この値は、DB インスタンスの合計メモリに対する割合 (%) です。指定できる値は 10～80 です。

   1. (オプション) レポートサービスの E メールを使用するには、次のパラメータを設定します。
      + `SMTP_ENABLE_EMAIL` – レポートサービスの E メールを使用するには、`true` に設定します。デフォルトは `false` です。
      + `SMTP_SENDER_EMAIL_ADDRESS` – レポートサービスの E メールで送信されるメッセージの **[From]** フィールドに使用する E メールアドレスです。SMTP サーバーからメールを送信するアクセス許可を持つユーザーアカウントを指定します。
      + `SMTP_SERVER` — 使用する SMTP サーバーまたはゲートウェイ。IP アドレス、社内イントラネット上のコンピュータの NetBIOS 名、または完全修飾ドメイン名を使用できます。
      + `SMTP_PORT` — メールサーバーに接続するために使用するポート。デフォルトは 25 です。
      + `SMTP_USE_SSL` — SSL を使用して E メールメッセージを暗号化するには、`true` に設定します。デフォルトは `true` です。
      + `SMTP_EMAIL_CREDENTIALS_SECRET_ARN` — ユーザー認証情報を保持する Secrets Manager ARN。次の形式を使用します。

        **arn:aws:secretsmanager:{{Region}}:{{AccountId}}:secret:{{SecretName}}-{{6RandomCharacters}}**

        シークレットを作成するための詳細については、「[レポートサービスの E メールを使用したレポートの送信](SSRS.Email.md)」を参照してください。
      + `SMTP_USE_ANONYMOUS_AUTHENTICATION` — 認証を使用しない場合は、`true` に設定し、`SMTP_EMAIL_CREDENTIALS_SECRET_ARN` を含めないでください。

        `SMTP_ENABLE_EMAIL` が `true` の場合、デフォルトは `false` です。

   次の例には、シークレット ARN を使用したレポートサービスの E メールパラメータが含まれています。

   ```
   {
   "OptionGroupName": "{{pbirs-se-2025}}",
   "OptionsToInclude": [
   	{
   	"OptionName": "PBIRS",
   	"Port": {{8443}},
   	"VpcSecurityGroupMemberships": ["{{sg-0abcdef123}}"],
   	"OptionSettings": [
               {"Name": "MAX_MEMORY","Value": "{{60}}"},
               {"Name": "SMTP_ENABLE_EMAIL","Value": "{{true}}"},
               {"Name": "SMTP_SENDER_EMAIL_ADDRESS","Value": "{{nobody@example.com}}"},
               {"Name": "SMTP_SERVER","Value": "email-smtp.{{us-west-2}}.amazonaws.com"},
               {"Name": "SMTP_PORT","Value": "{{25}}"},
               {"Name": "SMTP_USE_SSL","Value": "{{true}}"},
               {"Name": "SMTP_EMAIL_CREDENTIALS_SECRET_ARN","Value": "arn:aws:secretsmanager:{{us-west-2}}:{{123456789012}}:secret:{{MySecret-a1b2c3}}"}
               ]
   	}],
   "ApplyImmediately": true
   }
   ```

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

   Linux、macOS、Unix の場合:

   ```
   aws rds add-option-to-option-group \
       --cli-input-json file://{{pbirs-option.json}} \
       --apply-immediately
   ```

   Windows の場合:

   ```
   aws rds add-option-to-option-group ^
       --cli-input-json file://{{pbirs-option.json}} ^
       --apply-immediately
   ```

## オプショングループと DB インスタンスの関連付け
<a name="SSRS.Apply"></a>

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

**注記**  
既存の DB インスタンスを使用する場合は、このインスタンスに Active Directory ドメインと AWS Identity and Access Management (IAM) ロールが既に関連付けられている必要があります。新しいインスタンスを作成する場合は、既存の Active Directory ドメインと IAM ロールを指定します。詳細については、「[RDS for SQL Server による Active Directory の操作](User.SQLServer.ActiveDirectoryWindowsAuth.md)」を参照してください。

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

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

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

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

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

  Linux、macOS、Unix の場合:

  ```
  aws rds create-db-instance \
      --db-instance-identifier {{myssrsinstance}} \
      --db-instance-class {{db.m5.2xlarge}} \
      --engine {{sqlserver-se}} \
      --engine-version {{14.00.3223.3.v1}} \
      --allocated-storage {{100}} \
      --manage-master-user-password  \
      --master-username {{admin}} \
      --storage-type {{gp2}} \
      --license-model {{li}} \
      --domain-iam-role-name {{my-directory-iam-role}} \
      --domain {{my-domain-id}} \
      --option-group-name {{ssrs-se-2017}}
  ```

  Windows の場合:

  ```
  aws rds create-db-instance ^
      --db-instance-identifier {{myssrsinstance}} ^
      --db-instance-class {{db.m5.2xlarge}} ^
      --engine {{sqlserver-se}} ^
      --engine-version {{14.00.3223.3.v1}} ^
      --allocated-storage {{100}} ^
      --manage-master-user-password ^
      --master-username {{admin}} ^
      --storage-type {{gp2}} ^
      --license-model {{li}} ^
      --domain-iam-role-name {{my-directory-iam-role}} ^
      --domain {{my-domain-id}} ^
      --option-group-name {{ssrs-se-2017}}
  ```

**オプショングループを使用するように DB インスタンスを変更するには**
+ 以下のいずれかのコマンドを実行します。  
**Example**  

  Linux、macOS、Unix の場合:

  ```
  aws rds modify-db-instance \
      --db-instance-identifier {{myssrsinstance}} \
      --option-group-name {{ssrs-se-2017}} \
      --apply-immediately
  ```

  Windows の場合:

  ```
  aws rds modify-db-instance ^
      --db-instance-identifier {{myssrsinstance}} ^
      --option-group-name {{ssrs-se-2017}} ^
      --apply-immediately
  ```

## VPC セキュリティグループへのインバウンドアクセスの許可
<a name="SSRS.Inbound"></a>

DB インスタンスに関連付けられた VPC セキュリティグループへのインバウンドアクセスを許可するには、指定された SSRS または PBIRS リスナーポートのインバウンドルールを作成します。セキュリティグループの設定の詳細については、「[セキュリティグループを作成して VPC 内の DB インスタンスへのアクセスを提供する](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup)」を参照してください。