Serviços de Relatórios do SQL Server (SSRS)

O Cloud SQL oferece suporte ao SQL Server Reporting Services (SSRS) , que ajuda você a criar, implantar e gerenciar relatórios paginados.

Esta página fornece os pré-requisitos, o procedimento de configuração e as limitações para usar o SSRS no Cloud SQL.

Antes de começar

Antes de usar o SSRS no Cloud SQL, você deve ter o seguinte:

  • Uma instância do Cloud SQL para hospedar o banco de dados do servidor de relatórios
  • Um host onde você instala e executa o SSRS. Pode ser uma VM do Compute Engine ou um host que não usa o Compute Engine. Para obter instruções de instalação, consulte Instalar o SQL Server Reporting Services .
  • Um registro DNS do Cloud para atribuir um nome de host à sua instância do Cloud SQL. Você pode criar um nome de host usando uma das seguintes opções:

    • Cloud DNS: use o Cloud DNS para criar um nome de host que aponte para sua instância.
    • Zona DNS personalizada: se você gerencia sua própria zona DNS, crie um registro A que mapeie seu nome de host preferido para o endereço IP da sua instância.
    • Mapeamento de nome de host local: modifique o arquivo de hosts do seu sistema para criar um alias personalizado para sua instância.
  • Dois logins existentes do Cloud SQL: um login de configuração e um login de serviço. Para criar um login, consulte gcloud sql users create .

    Se quiser usar a autenticação do Windows, você precisará usar o Active Directory gerenciado para unir a instância do SQL Server e o host que executa o SSRS. Para obter mais informações, consulte Usar o Microsoft AD gerenciado com o Cloud SQL .

Procedimento

Para configurar o SSRS no Cloud SQL, execute as seguintes etapas:

  1. Adquira um contrato de locação SSRS .
  2. Configurar o SSRS .
  3. Libere um contrato de locação do SSRS .

Adquira um contrato de locação SSRS

O SSRS requer permissões elevadas durante a configuração. Para adquirir uma concessão do SSRS para sua instância, use o seguinte comando:

gcloud

Use o seguinte comando para adquirir um arrendamento:

gcloud sql instances acquire-ssrs-lease INSTANCE_NAME \
--project=PROJECT_NAME \
--setup-login=SETUP_LOGIN \
--service-login=SERVICE_LOGIN \
--report-database=REPORT_DATABASE \
--duration=DURATION \

A tabela a seguir descreve os parâmetros gcloud desta operação:

Parâmetro Descrição Valores permitidos Valor padrão
--setup-login Obrigatório. O login usado para se conectar à instância durante a configuração do SSRS. Este é o primeiro login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um banco de dados do servidor de relatórios. Este deve ser um login existente do SQL Server, como sqlserver Nenhum
--service-login Obrigatório. O login do SQL Server usado pelo servidor de relatórios para se conectar ao banco de dados do servidor de relatórios durante a configuração do SSRS. Este é o segundo login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um banco de dados do servidor de relatórios. Este deve ser um login existente do SQL Server e deve ser diferente do login de configuração. Nenhum.
--report-database Obrigatório. Um nome de banco de dados de relatório existente ou novo na instância. Certos caracteres especiais não são permitidos no nome do banco de dados do relatório, como espaços, colchetes e caracteres não ingleses. Nenhum
--duration Opcional. O número de horas em que o contrato de locação do SSRS está ativo e durante as quais você pode executar a configuração do SSRS. Entre 1 e 12 horas. Por exemplo, 4h 5 horas

REST v1

Usando a API REST, você pode adquirir um lease de SSRS para uma instância. Para adquirir um lease de SSRS, especifique o seguinte:
  • Dois logins diferentes do SQL Server, o login de configuração e o login de serviço
  • Nome do banco de dados do relatório
  • A duração em que o arrendamento está ativo

Somente o campo DURATION é opcional. Para mais informações, consulte AcquireSsrsLeaseContext :

  • PROJECT_ID : o ID do projeto.
  • INSTANCE_NAME : o nome da instância.
  • SETUP_LOGIN : o login do SQL Server usado para conectar-se à instância do SQL Server durante a configuração do SSRS. Este é o primeiro login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um banco de dados do servidor de relatórios.
  • SERVICE_LOGIN : o login do SQL Server usado pelo servidor de relatórios para se conectar ao banco de dados do servidor de relatórios durante a configuração do SSRS. Este é o segundo login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um Banco de Dados do Servidor de Relatórios.
  • REPORT_DATABASE : um nome de banco de dados de relatório existente ou novo na instância. A Microsoft não permite certos caracteres especiais no nome do banco de dados de relatório, como espaços, colchetes e caracteres não ingleses.
  • DURATION : Opcional. O número de horas em que o contrato de locação do SSRS está ativo e durante as quais você pode realizar a configuração do SSRS. Entre 1 e 12 horas, por exemplo, 4h .

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease

Corpo JSON da solicitação:

{
  "acquireSsrsLeaseContext": {
    "setupLogin": SETUP_LOGIN,
    "serviceLogin": SERVICE_LOGIN,
    "reportDatabase": REPORT_DATABASE,
    "duration": DURATION,
  }
}

REST v1beta4

Usando a API REST, você pode adquirir um lease de SSRS para uma instância. Para adquirir um lease de SSRS, especifique o seguinte:
  • Dois logins diferentes do SQL Server, o login de configuração e o login de serviço
  • Nome do banco de dados do relatório
  • A duração em que o arrendamento está ativo

Somente o campo DURATION é opcional. Para mais informações, consulte AcquireSsrsLeaseContext :

  • PROJECT_ID : o ID do projeto.
  • INSTANCE_NAME : o nome da instância.
  • SETUP_LOGIN : o login do SQL Server usado para conectar-se à instância do SQL Server durante a configuração do SSRS. Este é o primeiro login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um banco de dados do servidor de relatórios.
  • SERVICE_LOGIN : o login do SQL Server usado pelo servidor de relatórios para se conectar ao banco de dados do servidor de relatórios durante a configuração do SSRS. Este é o segundo login solicitado no Gerenciador de Configuração do Servidor de Relatórios ao definir um Banco de Dados do Servidor de Relatórios.
  • REPORT_DATABASE : um nome de banco de dados de relatório existente ou novo na instância. A Microsoft não permite certos caracteres especiais no nome do banco de dados de relatório, como espaços, colchetes e caracteres não ingleses.
  • DURATION : Opcional. O número de horas em que o contrato de locação do SSRS está ativo e durante as quais você pode realizar a configuração do SSRS. Entre 1 e 12 horas, por exemplo, 4h .

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease

Corpo JSON da solicitação:

{
  "acquireSsrsLeaseContext": {
    "setupLogin": SETUP_LOGIN,
    "serviceLogin": SERVICE_LOGIN,
    "reportDatabase": REPORT_DATABASE,
    "duration": DURATION,
  }
}

Configurar SSRS

Para executar a configuração do SSRS, siga estas etapas:

  1. Abra o Reporting Services Configuration Manager no host onde o SSRS está instalado.
  2. Conecte-se à sua instância do servidor de relatórios local.
  3. Clique em Alterar banco de dados .
    1. Insira o nome do host do SQL Server criado no Cloud DNS e as credenciais de login do SQL Server para o login de configuração usado para o lease do SSRS.
    2. Insira o nome de um novo banco de dados do servidor de relatório ou de um banco de dados de relatório existente usado para o arrendamento do SSRS.
    3. Insira as credenciais de login do SQL Server para o login de serviço usado para o arrendamento do SSRS.
    4. Clique em Avançar e conclua com o último passo.
  4. Caso ainda não tenha definido, configure a URL do Serviço Web e a URL do Portal Web . O Portal Web deverá carregar com sucesso em alguns segundos.

Liberar um contrato de locação do SSRS

Você pode liberar um lease manualmente ou esperar até que ele expire automaticamente. A liberação do lease é necessária para reverter quaisquer permissões elevadas necessárias para a configuração e permitir que o login do serviço se conecte ao banco de dados de relatórios. O login do serviço não pode acessar o banco de dados de relatórios até que o lease expire ou seja liberado manualmente. O comando a seguir libera um lease do SSRS.

gcloud

Use o seguinte comando para liberar um arrendamento:

gcloud sql instances release-ssrs-lease INSTANCE_NAME \
--project=PROJECT_NAME

REST v1

Usando a API REST, você pode liberar um lease do SSRS para uma instância. Conforme mostrado no exemplo de solicitação a seguir, você só precisa fornecer o nome da instância e o ID do projeto.

  • PROJECT_ID : o ID do projeto.
  • INSTANCE_NAME : o nome da instância.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease

REST v1beta4

Usando a API REST, você pode liberar um lease do SSRS para uma instância. Conforme mostrado no exemplo de solicitação a seguir, você só precisa fornecer o nome da instância e o ID do projeto.

  • PROJECT_ID : o ID do projeto.
  • INSTANCE_NAME : o nome da instância.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease

Limitações

  • Os logins do Active Directory não são suportados para configurar o banco de dados de relatórios.
  • O nome do banco de dados do relatório pode conter apenas caracteres alfanuméricos e hifens.
  • Você deve adquirir um contrato de concessão para alterar o login usado para se conectar ao banco de dados de relatórios por meio do Report Server Configuration Manager.
  • Para um banco de dados processado por um login de serviço, as operações de importação de arquivos SQL e exclusão de banco de dados replicado podem falhar entre a conclusão da configuração do SSRS e a liberação do lease.
  • Você deve excluir e recriar o usuário do banco de dados para o login de serviço em um banco de dados de relatórios importado. Isso ocorre porque o usuário existente no banco de dados importado não pertence à nova instância.
  • Ao adicionar novos servidores de relatório para uma implantação escalável no SSRS, você deve adquirir e liberar o lease do SSRS para cada nova VM Windows que hospeda um servidor de relatório. Cada instância do Cloud SQL exige que você configure o novo banco de dados de relatório usando o banco de dados de relatório existente.
  • Você deve criar um novo arrendamento sempre que quiser alterar as credenciais de login do banco de dados do servidor de relatório no Report Server Configuration Manager.