Ativar o SSRS ou PBIRS

Como criar o grupo de opções

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

2. No painel de navegação, escolha Option groups (Grupos de opções).

3. Escolha Create group (Criar grupo).

4. No painel Create option group (Criar grupo de opções), faça o seguinte:

   1. Em Nome, insira um nome para o grupo de opções que seja exclusivo na sua Conta da AWS, como ssrs-se-2017 para o SSRS ou pbirs-se-2025 para o PBIRS. O nome pode conter somente letras, números e hifens.

   2. Em Descrição, insira uma breve descrição do grupo de opções, como SSRS option group for SQL Server SE 2017 ou PBIRS option group for SQL Server SE 2025. A descrição é usada para fins de exibição.

   3. Em Engine (Mecanismo), selecione sqlserver-se.

   4. Em Versão principal do mecanismo, escolha 14.00 se estiver adicionando a opção SSRS, ou 17.00 se estiver adicionando a opção PBIRS.

5. Escolha Criar.

Como criar o grupo de opções para o SSRS

• Execute um dos seguintes comandos:

Como criar o grupo de opções para o PBIRS

• Execute um dos seguintes comandos:

Como adicionar a opção SSRS

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

2. No painel de navegação, escolha Option groups (Grupos de opções).

3. Selecione o grupo de opções que você acabou de criar, depois escolha Add Option (Adicionar opção).

4. Em Detalhes da opção, selecione SSRS em Nome da opção.

5. Em Configurações de opção, faça o seguinte:

   1. Insira a porta de escuta do serviço SSRS. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

   2. Insira um valor em Máximo de memória.

      O Máximo de memória especifica o limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   3. Em Security groups (Grupos de segurança), selecione o grupo de segurança da VPC a ser associado à opção. Use o mesmo grupo de segurança associado à instância de banco de dados.

6. Para usar o SSRS Email para enviar relatórios, marque a caixa de seleção Configure email delivery options (Configurar opções de entrega por e-mail) em Email delivery in reporting services (Entrega por e-mail em serviços de relatórios), depois faça o seguinte:

   1. Para Sender email address (Endereço de e-mail do remetente), insira o endereço de e-mail a ser usado no campo From (De) das mensagens enviadas pelo SSRS Email.

      Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

   2. Para SMTP server (Servidor SMTP), especifique o gateway ou servidor SMTP a ser usado.

      Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

   3. Para SMTP port (Porta SMTP), insira a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

   4. Para usar a autenticação:

      1. Marque a caixa de seleção Use authentication (Usar autenticação).

      2. Para Secret Amazon Resource Name (ARN) (Nome do recurso da Amazon (ARN) do segredo), insira o ARN do AWS Secrets Manager para as credenciais do usuário.

         Use o formato a seguir:

         arn:aws:secretsmanager:Region:AccountId:secret:SecretName-6RandomCharacters

         Por exemplo:

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

         Para obter mais informações sobre como criar o segredo, consulte Usar o e-mail dos serviços de relatórios para enviar relatórios.

   5. Marque a caixa de seleção Use Secure Sockets Layer (SSL) [Usar Secure Sockets Layer (SSL)] para criptografar as mensagens de e-mail usando SSL.

7. Em Scheduling (Programação), escolha se deseja adicionar a opção imediatamente ou na próxima janela de manutenção.

8. Escolha Add option (Adicionar opção).

Como adicionar a opção PBIRS (SQL Server 2025 e posteriores)

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

2. No painel de navegação, escolha Option groups (Grupos de opções).

3. Escolha o grupo de opções que você acabou de criar para o PBIRS e selecione Adicionar opção.

4. Em Detalhes da opção, escolha PBIRS em Nome da opção.

5. Em Configurações de opção, faça o seguinte:

   1. Insira a porta na qual o serviço PBIRS deverá escutar. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

   2. Insira um valor em Máximo de memória.

      O Máximo de memória especifica o limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   3. Em Security groups (Grupos de segurança), selecione o grupo de segurança da VPC a ser associado à opção. Use o mesmo grupo de segurança associado à instância de banco de dados.

6. Para usar o e-mail dos serviços de relatórios para enviar relatórios, marque a caixa de seleção Configurar opções de entrega por e-mail em Serviço de entrega de relatórios por e-mail e faça o seguinte:

   1. Em Endereço de e-mail do remetente, insira o endereço de e-mail que será usado no campo De das mensagens enviadas pelo e-mail dos serviços de relatórios.

      Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

   2. Para SMTP server (Servidor SMTP), especifique o gateway ou servidor SMTP a ser usado.

      Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

   3. Para SMTP port (Porta SMTP), insira a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

   4. Para usar a autenticação:

      1. Marque a caixa de seleção Use authentication (Usar autenticação).

      2. Para Secret Amazon Resource Name (ARN) (Nome do recurso da Amazon (ARN) do segredo), insira o ARN do AWS Secrets Manager para as credenciais do usuário.

         Use o formato a seguir:

         arn:aws:secretsmanager:Region:AccountId:secret:SecretName-6RandomCharacters

         Por exemplo:

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

         Para obter mais informações sobre como criar o segredo, consulte Usar o e-mail dos serviços de relatórios para enviar relatórios.

   5. Marque a caixa de seleção Use Secure Sockets Layer (SSL) [Usar Secure Sockets Layer (SSL)] para criptografar as mensagens de e-mail usando SSL.

7. Em Scheduling (Programação), escolha se deseja adicionar a opção imediatamente ou na próxima janela de manutenção.

8. Escolha Add option (Adicionar opção).

Como adicionar a opção SSRS

1. Crie um arquivo JSON; por exemplo, ssrs-option.json.

   1. Defina os seguintes parâmetros necessários:

      • OptionGroupName – O nome do grupo de opções que você criou ou selecionou anteriormente (ssrs-se-2017 no exemplo a seguir).

      • Port – A porta de escuta do serviço SSRS. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

      • VpcSecurityGroupMemberships – Associações de grupos de segurança da VPC para a instância de banco de dados do RDS.

      • MAX_MEMORY – O limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   2. (Opcional) Defina os seguintes parâmetros para usar o SSRS Email:

      • SMTP_ENABLE_EMAIL: defina como true para usar o SSRS Email. O padrão é false.

      • SMTP_SENDER_EMAIL_ADDRESS: o endereço de e-mail a ser usado no campo From (De) das mensagens enviadas pelo SSRS Email. Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

      • SMTP_SERVER: o gateway ou servidor SMTP a ser usado. Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

      • SMTP_PORT: a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

      • SMTP_USE_SSL: defina como true para criptografar as mensagens de e-mail usando SSL. O padrão é true.

      • SMTP_EMAIL_CREDENTIALS_SECRET_ARN: o ARN do Secrets Manager que contém as credenciais do usuário. Use o formato a seguir:

        arn:aws:secretsmanager:Region:AccountId:secret:SecretName-6RandomCharacters

        Para obter mais informações sobre como criar o segredo, consulte Usar o e-mail dos serviços de relatórios para enviar relatórios.

      • SMTP_USE_ANONYMOUS_AUTHENTICATION: defina como true e não inclua SMTP_EMAIL_CREDENTIALS_SECRET_ARN se não quiser usar a autenticação.

        O padrão é false quando SMTP_ENABLE_EMAIL é true.

   O exemplo a seguir inclui os parâmetros de SSRS Email usando o ARN do segredo.

   {
   "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
   }

2. Adicione a opção SSRS ao grupo de opções.

   exemplo

   Para Linux, macOS ou Unix:

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

   Para Windows:

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

Como adicionar a opção PBIRS (SQL Server 2025 e posteriores)

1. Crie um arquivo JSON; por exemplo, pbirs-option.json.

   1. Defina os seguintes parâmetros necessários:

      • OptionGroupName: o nome do grupo de opções que você criou ou escolheu anteriormente (pbirs-se-2025 no exemplo a seguir).

      • Port: a porta na qual o serviço PBIRS deverá escutar. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

      • VpcSecurityGroupMemberships – Associações de grupos de segurança da VPC para a instância de banco de dados do RDS.

      • MAX_MEMORY – O limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   2. (Opcional) Defina os seguintes parâmetros para usar o e-mail dos serviços de relatórios:

      • SMTP_ENABLE_EMAIL: defina como true para usar o e-mail dos serviços de relatórios. O padrão é false.

      • SMTP_SENDER_EMAIL_ADDRESS: o endereço de e-mail que será usado no campo De das mensagens enviadas pelo e-mail dos serviços de relatórios. Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

      • SMTP_SERVER: o gateway ou servidor SMTP a ser usado. Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

      • SMTP_PORT: a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

      • SMTP_USE_SSL: defina como true para criptografar as mensagens de e-mail usando SSL. O padrão é true.

      • SMTP_EMAIL_CREDENTIALS_SECRET_ARN: o ARN do Secrets Manager que contém as credenciais do usuário. Use o formato a seguir:

        arn:aws:secretsmanager:Region:AccountId:secret:SecretName-6RandomCharacters

        Para obter mais informações sobre como criar o segredo, consulte Usar o e-mail dos serviços de relatórios para enviar relatórios.

      • SMTP_USE_ANONYMOUS_AUTHENTICATION: defina como true e não inclua SMTP_EMAIL_CREDENTIALS_SECRET_ARN se não quiser usar a autenticação.

        O padrão é false quando SMTP_ENABLE_EMAIL é true.

   O exemplo a seguir inclui os parâmetros do e-mail dos serviços de relatórios usando o ARN do segredo.

   {
   "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
   }

2. Adicione a opção PBIRS ao grupo de opções.

   exemplo

   Para Linux, macOS ou Unix:

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

   Para Windows:

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

Como criar uma instância de banco de dados que usa o grupo de opções

• Especifique o mesmo tipo de mecanismo de banco de dados e a versão principal que você usou ao criar o grupo de opções.

  exemplo

  Para Linux, macOS ou 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

  Para 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

Como modificar uma instância de banco de dados para usar o grupo de opções

• Execute um dos seguintes comandos:

  exemplo

  Para Linux, macOS ou Unix:

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

  Para Windows:

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