Nesta página, apresentamos 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ê precisa ter o seguinte:
Uma instância do Cloud SQL para hospedar o banco de dados do servidor de relatórios
Um host em que você instala e executa o SSRS.
Ele pode ser uma VM do Compute Engine ou um host que não usa o Compute Engine.
Para instruções de instalação, consulte
Instalar o SQL Server Reporting Services.
Um registro do Cloud DNS para atribuir um nome do host à instância do Cloud SQL.
É possível criar um nome do 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 de DNS personalizada: se você gerencia sua própria zona de DNS, crie um registro A que mapeie o nome de host preferido para o endereço IP da instância.
Mapeamento do nome do host local: modifique o arquivo hosts do sistema para criar um alias personalizado para sua instância.
Dois logins atuais do Cloud SQL, um de configuração e outro de serviço.
Para criar um login, consulte gcloud sql users create.
Se você quiser usar a autenticação do Windows, use o Managed Active Directory para mesclar a instância do SQL Server e o host que executa o SSRS. Para 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:
A tabela a seguir descreve os parâmetros de gcloud
dessa 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. Esse é 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.
Precisa ser um login 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. Esse é 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.
Precisa ser um login do SQL Server e diferente do login de configuração.
Nenhuma.
--report-database
Obrigatório. Um nome de banco de dados de relatórios atual ou novo na instância.
Não é permitido usar determinados caracteres especiais no nome do banco de dados de relatórios, como espaços, colchetes e caracteres que não estejam em inglês.
Nenhum
--duration
Opcional. O número de horas em que o lease de SSRS está ativo durante as quais é possível executar a configuração de SSRS.
Entre 1 e 12 horas. Por exemplo, 4h.
5 horas
REST v1
Usando a API REST, é possível adquirir uma concessão SSRS em uma instância. Para adquirir uma concessão do SSRS, especifique o seguinte:
Dois logins diferentes do SQL Server, o de configuração e o de serviço
SETUP_LOGIN: o login do SQL Server usado para se conectar à instância do SQL Server durante a configuração do SSRS. Esse é 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. Esse é 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órios atual ou novo na instância.
A Microsoft não permite determinados caracteres especiais no nome do banco de dados de relatórios, como espaços, colchetes e caracteres que não estejam em inglês.
DURATION: opcional. O número de horas em que o lease de SSRS está ativo durante as quais é possível executar a configuração de SSRS.
Entre 1 e 12 horas, por exemplo, 4h.
SETUP_LOGIN: o login do SQL Server usado para se conectar à instância do SQL Server durante a configuração do SSRS. Esse é 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. Esse é 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órios atual ou novo na instância.
A Microsoft não permite determinados caracteres especiais no nome do banco de dados de relatórios, como espaços, colchetes e caracteres que não estejam em inglês.
DURATION: opcional. O número de horas em que o lease de SSRS está ativo durante as quais é possível executar a configuração de SSRS.
Entre 1 e 12 horas, por exemplo, 4h.
Abra o Gerenciador de configuração dos serviços de relatórios no host em que o SSRS está instalado.
Conecte-se à sua instância local do servidor de relatórios.
Clique em Alterar banco de dados.
Informe 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 a concessão do SSRS.
Insira o nome de um novo banco de dados de servidor de relatórios ou um banco de dados de relatórios existente usado para a concessão de SSRS.
Digite as credenciais de login do SQL Server para o login de serviço usado para a concessão do SSRS.
Clique em Próxima e conclua a última etapa.
Configure o URL do serviço da Web e o URL do portal da Web, caso ainda não tenham sido definidos. O portal da Web será carregado em alguns segundos.
Liberar uma concessão de SSRS
É possível liberar uma concessão manualmente ou esperar até que ela expire automaticamente. É necessário liberar a concessão para reverter as permissões elevadas necessárias para a configuração e permitir que o login do serviço se conecte ao banco de dados do relatório.
O login do serviço não pode acessar o banco de dados de relatórios até que a concessão expire ou seja liberada manualmente.
O comando a seguir libera uma concessão SSRS.
gcloud
Use o seguinte comando para liberar uma concessão:
Com a API REST, é possível liberar uma concessão SSRS para uma instância. Conforme mostrado no exemplo de solicitação a seguir, você só precisa informar o nome da instância e o ID do projeto.
Com a API REST, é possível liberar uma concessão SSRS para uma instância. Conforme mostrado no exemplo de solicitação a seguir, você só precisa informar o nome da instância e o ID do projeto.
Os logins do Active Directory não são compatíveis 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 hífens.
É necessário adquirir uma concessão para alterar o login usado para se conectar ao banco de dados de relatórios pelo Gerenciador de configuração do servidor de relatórios.
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 replicados podem falhar entre a conclusão da configuração do SSRS e o lançamento da concessão.
Exclua e recrie o usuário do banco de dados para o login de serviço em um banco de dados de relatórios importados. Isso ocorre porque o usuário atual no banco de dados importado não pertence à nova instância.
Ao adicionar novos servidores de relatórios para uma implantação de escalonamento horizontal no SSRS, você precisa adquirir e liberar a concessão do SSRS para cada nova VM do Windows que hospeda um servidor de relatórios. Cada instância do Cloud SQL exige que você configure o novo banco de dados de relatórios usando o banco de dados de relatórios atual.
É preciso criar uma nova concessão sempre que você quiser alterar as credenciais de login do banco de dados do servidor de relatórios no Gerenciador de configuração do servidor de relatórios.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# SQL Server Reporting Services (SSRS)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nCloud SQL supports [SQL Server Reporting Services (SSRS)](https://learn.microsoft.com/en-us/sql/reporting-services/create-deploy-and-manage-mobile-and-paginated-reports?view=sql-server-ver16) which helps you create, deploy, and manage paginated reports.\n\nThis page provides the prerequisites, setup procedure, and limitations for using\nSSRS in Cloud SQL.\n\nBefore you begin\n----------------\n\nBefore using SSRS on Cloud SQL, you must have the following:\n\n- A Cloud SQL instance to host the report server database\n- A host where you install and run SSRS. It can be either a Compute Engine VM or a host that doesn't use Compute Engine. For installation instructions, see [Install SQL Server Reporting Services](https://learn.microsoft.com/en-us/sql/reporting-services/install-windows/install-reporting-services?view=sql-server-ver16).\n- A Cloud DNS record to assign a hostname for your Cloud SQL instance.\n You can create a hostname by using one of the following options:\n\n - Cloud DNS: Use [Cloud DNS](/dns/docs/overview) to create a hostname that points to your instance.\n - Custom DNS zone: If you manage your own DNS zone, then [create an A record](/dns/docs/records) that maps your preferred hostname to the IP address of your instance.\n - Local hostname mapping: Modify your system's `hosts` file to create a custom alias for your instance.\n- Two existing Cloud SQL logins, a setup login and a service login.\n To create a login, see [`gcloud sql users create`](/sdk/gcloud/reference/sql/users/create).\n\n | **Note:** Cloud SQL doesn't support using Windows logins for SSRS.\n\n If you want to use Windows authentication, then you must use Managed Active Directory to join the SQL Server instance and the host running SSRS. For more information, see [Use Managed Microsoft AD with Cloud SQL](/sql/docs/sqlserver/configure-ad).\n\nProcedure\n---------\n\nTo set up SSRS in Cloud SQL, perform the following steps:\n\n1. [Acquire an SSRS lease](/sql/docs/sqlserver/ssrs#acquire).\n2. [Set up SSRS](/sql/docs/sqlserver/ssrs#setup).\n3. [Release an SSRS lease](/sql/docs/sqlserver/ssrs#release).\n\n### Acquire an SSRS lease\n\nSSRS requires elevated permissions during setup. To acquire an SSRS lease for your instance, use the following command: \n\n### gcloud\n\nUse the following command to acquire a lease: \n\n```bash\ngcloud sql instances acquire-ssrs-lease INSTANCE_NAME \\\n--project=PROJECT_NAME \\\n--setup-login=SETUP_LOGIN \\\n--service-login=SERVICE_LOGIN \\\n--report-database=REPORT_DATABASE \\\n--duration=DURATION \\\n```\n\n\nThe following table describes this operation's\n`gcloud` parameters:\n\n### REST v1\n\nUsing the REST API, you can acquire an SSRS lease on an instance. To acquire an SSRS lease, specify the following:\n\n- Two different SQL Server logins, the setup login and service login\n- The report database name\n- The duration for which the lease is active\n\n\nOnly the `DURATION` field is optional. For more information, see\n[AcquireSsrsLeaseContext](/sql/docs/sqlserver/admin-api/rest/v1/instances#AcquireSsrsLeaseContext):\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n- \u003cvar translate=\"no\"\u003eSETUP_LOGIN\u003c/var\u003e: the SQL Server login that's used to connect to the SQL Server instance during SSRS setup. This the first login that is requested in Report Server Configuration Manager when setting a report server database.\n- \u003cvar translate=\"no\"\u003eSERVICE_LOGIN\u003c/var\u003e: the SQL Server login that's used by report server to connect to the report server database during SSRS setup. This is the second login that is requested in Report Server Configuration Manager when setting a Report Server Database.\n- \u003cvar translate=\"no\"\u003eREPORT_DATABASE\u003c/var\u003e: an existing or a new report database name on the instance. Microsoft doesn't allow certain special characters in the report database name, such as spaces, brackets, non-English characters.\n- \u003cvar translate=\"no\"\u003eDURATION\u003c/var\u003e: Optional. The number of hours that the SSRS lease is active during which you can perform the SSRS setup. Between 1 and 12 hours, for example, `4h`.\n\n\nHTTP method and URL: \n\n```bash\nPOST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease\n```\n\n\nRequest JSON body: \n\n```json\n{\n \"acquireSsrsLeaseContext\": {\n \"setupLogin\": SETUP_LOGIN,\n \"serviceLogin\": SERVICE_LOGIN,\n \"reportDatabase\": REPORT_DATABASE,\n \"duration\": DURATION,\n }\n}\n```\n\n### REST v1beta4\n\nUsing the REST API, you can acquire an SSRS lease on an instance. To acquire an SSRS lease, specify the following:\n\n- Two different SQL Server logins, the setup login and service login\n- The report database name\n- The duration for which the lease is active\n\nOnly the `DURATION` field is optional. For more information, see\n[AcquireSsrsLeaseContext](/sql/docs/sqlserver/admin-api/rest/v1beta4/instances#AcquireSsrsLeaseContext):\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n- \u003cvar translate=\"no\"\u003eSETUP_LOGIN\u003c/var\u003e: the SQL Server login that's used to connect to the SQL Server instance during SSRS setup. This the first login that is requested in Report Server Configuration Manager when setting a report server database.\n- \u003cvar translate=\"no\"\u003eSERVICE_LOGIN\u003c/var\u003e: the SQL Server login that's used by report server to connect to the report server database during SSRS setup. This is the second login that is requested in Report Server Configuration Manager when setting a Report Server Database.\n- \u003cvar translate=\"no\"\u003eREPORT_DATABASE\u003c/var\u003e: an existing or a new report database name on the instance. Microsoft doesn't allow certain special characters in the report database name, such as spaces, brackets, non-English characters.\n- \u003cvar translate=\"no\"\u003eDURATION\u003c/var\u003e: Optional. The number of hours that the SSRS lease is active during which you can perform the SSRS setup. Between 1 and 12 hours, for example, `4h`.\n\n\nHTTP method and URL: \n\n```bash\nPOST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/acquireSsrsLease\n```\n\n\nRequest JSON body: \n\n```json\n{\n \"acquireSsrsLeaseContext\": {\n \"setupLogin\": SETUP_LOGIN,\n \"serviceLogin\": SERVICE_LOGIN,\n \"reportDatabase\": REPORT_DATABASE,\n \"duration\": DURATION,\n }\n}\n```\n\n### Set up SSRS\n\n| **Note:** To automate the setup process described in this section, you can use any scripting solution, such as PowerShell.\n\nTo perform the SSRS setup, follow these steps:\n\n1. Open Reporting Services Configuration Manager on the host where SSRS is installed.\n2. Connect to your local report server instance.\n3. Click **Change Database** .\n 1. Enter the SQL Server hostname created in Cloud DNS and the SQL Server login credentials for the setup login used for the SSRS lease.\n 2. Enter the name of a new report server database or existing report database used for the SSRS lease.\n 3. Enter the SQL Server login credentials for the service login used for the SSRS lease.\n 4. Click **Next** and finish through the last step.\n4. If not already set, then configure the **Web Service URL** and **Web Portal URL**. The Web Portal should load successfully within a few seconds.\n\n### Release an SSRS lease\n\nYou can release a lease manually, or you can wait until the lease automatically expires. Releasing the lease is required to revert any elevated permissions needed for setup and to allow the service login to connect to the report database.\nThe service login can't access the report database until the lease expires or is released manually.\nThe following command releases an SSRS lease. \n\n### gcloud\n\nUse the following command to release a lease: \n\n```bash\ngcloud sql instances release-ssrs-lease INSTANCE_NAME \\\n--project=PROJECT_NAME\n```\n\n### REST v1\n\n\nUsing the REST API, you can release an SSRS lease for an instance. As shown in the following request example, you only need to provide the instance name and project ID.\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n\n\nHTTP method and URL: \n\n```bash\nPOST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease\n```\n\n### REST v1beta4\n\n\nUsing the REST API, you can release an SSRS lease for an instance. As shown in the following request example, you only need to provide the instance name and project ID.\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n\n\nHTTP method and URL: \n\n```bash\nPOST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/releaseSsrsLease\n```\n\nLimitations\n-----------\n\n- Active Directory logins are not supported for setting up the report database.\n- The report database name can contain only alphanumeric characters and hyphens.\n- You must acquire a lease for changing the login used to connect to the report database through Report Server Configuration Manager.\n- For a database that is processed by a service login, the import sql files and delete replicated database operations can fail between the completion of the SSRS setup and the release of the lease.\n- You must delete and recreate the database user for the service login on an imported report database. This is because the existing user in the imported database doesn't belong to the new instance.\n- When adding new report servers for a scale-out deployment in SSRS, you must acquire and release the SSRS lease for every new Windows VM hosting a report server. Each Cloud SQL instance requires that you configure the new report database by using the existing report database.\n- You must create a new lease every time you want to change the login credentials for the report server database in Report Server Configuration Manager."]]
