Cette page décrit les conditions préalables, la procédure de configuration et les limites relatives à l'utilisation de SSRS dans Cloud SQL.
Avant de commencer
Avant d'utiliser SSRS sur Cloud SQL, vous devez disposer des éléments suivants :
Une instance Cloud SQL pour héberger la base de données du serveur de rapports
Un hôte sur lequel vous installez et exécutez SSRS.
Il peut s'agir d'une VM Compute Engine ou d'un hôte qui n'utilise pas Compute Engine.
Pour obtenir des instructions d'installation, consultez la page Installer SQL Server Reporting Services.
Un enregistrement Cloud DNS pour attribuer un nom d'hôte à votre instance Cloud SQL.
Vous pouvez créer un nom d'hôte à l'aide de l'une des options suivantes :
Cloud DNS : utilisez Cloud DNS pour créer un nom d'hôte qui pointe vers votre instance.
Zone DNS personnalisée : si vous gérez votre propre zone DNS, créez un enregistrement A qui mappe le nom d'hôte de votre choix à l'adresse IP de votre instance.
Mappage de nom d'hôte local : modifiez le fichier hosts de votre système pour créer un alias personnalisé pour votre instance.
Deux connexions Cloud SQL existantes, une connexion de configuration et une connexion de service.
Pour créer une connexion, consultez la page gcloud sql users create.
Si vous souhaitez utiliser l'authentification Windows, vous devez utiliser le service Active Directory géré pour joindre l'instance SQL Server et l'hôte exécutant SSRS. Pour en savoir plus, consultez la page Utiliser le service Microsoft AD géré avec Cloud SQL.
Procédure
Pour configurer SSRS dans Cloud SQL, suivez les étapes décrites ci-dessous :
Le tableau suivant décrit les paramètres gcloud de cette opération :
Paramètre
Description
Valeurs autorisées
Valeur par défaut
--setup-login
Obligatoire. Connexion utilisée pour se connecter à l'instance lors de la configuration de SSRS. Il s'agit de la première connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
Il doit s'agir d'une connexion SQL Server existante, telle que sqlserver.
Aucun
--service-login
Obligatoire. Connexion SQL Server utilisée par le serveur de rapports pour se connecter à la base de données du serveur de rapports lors de la configuration de SSRS. Il s'agit de la deuxième connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
Il doit s'agir d'une connexion SQL Server existante et différente de la connexion de configuration.
Aucune.
--report-database
Obligatoire. Nom d'une base de données de rapports existante ou nouvelle sur l'instance.
Certains caractères spéciaux ne sont pas autorisés dans le nom de la base de données de rapports, tels que les espaces, les crochets et les caractères non utilisés en anglais.
Aucun
--duration
Facultatif. Nombre d'heures où le bail SSRS est actif et pendant lesquelles vous pouvez effectuer la configuration SSRS.
Entre 1 et 12 heures. Par exemple : 4h
5 heures
REST v1
À l'aide de l'API REST, vous pouvez acquérir un bail SSRS sur une instance. Pour acquérir un bail SSRS, spécifiez les éléments suivants :
Deux connexions SQL Server différentes, la connexion de configuration et la connexion de service
Le nom de la base de données de rapports
La durée pendant laquelle le bail est actif
Seul le champ DURATION est facultatif. Pour en savoir plus, consultez la section AquireSsrsLeaseContext :
PROJECT_ID : ID du projet.
INSTANCE_NAME : nom de l'instance.
SETUP_LOGIN : connexion SQL Server utilisée pour se connecter à l'instance SQL Server lors de la configuration de SSRS. Il s'agit de la première connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
SERVICE_LOGIN : connexion SQL Server utilisée par le serveur de rapports pour se connecter à la base de données du serveur de rapports lors de la configuration de SSRS. Il s'agit de la deuxième connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
REPORT_DATABASE : nom d'une base de données de rapports existante ou nouvelle sur l'instance.
Microsoft n'autorise pas certains caractères spéciaux dans le nom de la base de données de rapports, tels que les espaces, les crochets et les caractères non utilisés en anglais.
DURATION : facultatif. Nombre d'heures où le bail SSRS est actif et pendant lesquelles vous pouvez effectuer la configuration SSRS.
Entre 1 et 12 heures. Par exemple : 4h
À l'aide de l'API REST, vous pouvez acquérir un bail SSRS sur une instance. Pour acquérir un bail SSRS, spécifiez les éléments suivants :
Deux connexions SQL Server différentes, la connexion de configuration et la connexion de service
Le nom de la base de données de rapports
La durée pendant laquelle le bail est actif
Seul le champ DURATION est facultatif. Pour en savoir plus, consultez la section AquireSsrsLeaseContext :
PROJECT_ID : ID du projet.
INSTANCE_NAME : nom de l'instance.
SETUP_LOGIN : connexion SQL Server utilisée pour se connecter à l'instance SQL Server lors de la configuration de SSRS. Il s'agit de la première connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
SERVICE_LOGIN : connexion SQL Server utilisée par le serveur de rapports pour se connecter à la base de données du serveur de rapports lors de la configuration de SSRS. Il s'agit de la deuxième connexion demandée dans le gestionnaire de configuration du serveur de rapports lorsque vous définissez une base de données de serveur de rapports.
REPORT_DATABASE : nom d'une base de données de rapports existante ou nouvelle sur l'instance.
Microsoft n'autorise pas certains caractères spéciaux dans le nom de la base de données de rapports, tels que les espaces, les crochets et les caractères non utilisés en anglais.
DURATION : facultatif. Nombre d'heures où le bail SSRS est actif et pendant lesquelles vous pouvez effectuer la configuration SSRS.
Entre 1 et 12 heures. Par exemple : 4h
Pour effectuer la configuration de SSRS, procédez comme suit :
Ouvrez le gestionnaire de configuration de Reporting Services sur l'hôte où SSRS est installé.
Connectez-vous à votre instance de serveur de rapports locale.
Cliquez sur Changer de base de données.
Saisissez le nom d'hôte SQL Server créé dans Cloud DNS et les identifiants de connexion SQL Server pour la connexion de configuration utilisée pour le bail SSRS.
Saisissez le nom d'une nouvelle base de données de serveur de rapports ou d'une base de données de rapports existante utilisée pour le bail SSRS.
Saisissez les identifiants de connexion SQL Server pour la connexion de service utilisée pour le bail SSRS.
Cliquez sur Suivant et passez à la dernière étape.
Si ce n'est pas déjà fait, configurez l'URL du service Web et l'URL du portail Web. Le portail Web devrait se charger en quelques secondes.
Libérer un bail SSRS
Vous pouvez libérer un bail manuellement ou attendre qu'il expire automatiquement. La libération du bail est nécessaire pour rétablir toutes les autorisations avec privilèges élevés nécessaires à la configuration et pour permettre à la connexion de service de se connecter à la base de données de rapports.
La connexion de service ne peut pas accéder à la base de données de rapports tant que le bail n'a pas expiré ou n'est pas libéré manuellement.
La commande suivante libère un bail SSRS.
gcloud
Utilisez la commande suivante pour libérer un bail :
À l'aide de l'API REST, vous pouvez libérer un bail SSRS pour une instance. Comme illustré dans l'exemple de requête suivant, il vous suffit de fournir le nom de l'instance et l'ID du projet.
À l'aide de l'API REST, vous pouvez libérer un bail SSRS pour une instance. Comme illustré dans l'exemple de requête suivant, il vous suffit de fournir le nom de l'instance et l'ID du projet.
Les connexions Active Directory ne sont pas acceptées pour la configuration de la base de données de rapports.
Le nom de la base de données de rapports ne peut contenir que des caractères alphanumériques et des tirets.
Vous devez acquérir un bail afin de modifier la connexion utilisée pour vous connecter à la base de données de rapports via le gestionnaire de configuration du serveur de rapports.
Pour une base de données traitée par une connexion de service, les opérations d'importation de fichiers SQL et de suppression de bases de données répliquées peuvent échouer entre le moment où la configuration de SSRS est terminée et le moment où le bail est libéré.
Vous devez supprimer et recréer l'utilisateur de base de données pour la connexion de service sur une base de données de rapports importée. Cela est dû au fait que l'utilisateur existant dans la base de données importée n'appartient pas à la nouvelle instance.
Lorsque vous ajoutez de nouveaux serveurs de rapports pour un déploiement à scaling horizontal dans SSRS, vous devez acquérir et libérer le bail SSRS pour chaque nouvelle VM Windows hébergeant un serveur de rapports. Chaque instance Cloud SQL nécessite de configurer la nouvelle base de données de rapports à l'aide de la base de données de rapports existante.
Vous devez créer un nouveau bail chaque fois que vous souhaitez modifier les identifiants de connexion pour la base de données de serveur de rapports dans le gestionnaire de configuration du serveur de rapports.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
