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:
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:
- Abra o Reporting Services Configuration Manager no host onde o SSRS está instalado.
- Conecte-se à sua instância do servidor de relatórios local.
- Clique em Alterar banco de dados .
- 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.
- 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.
- Insira as credenciais de login do SQL Server para o login de serviço usado para o arrendamento do SSRS.
- Clique em Avançar e conclua com o último passo.
- 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.