SQL Server Reporting Services (SSRS)

Cloud SQL est compatible avec SQL Server Reporting Services (SSRS), qui vous aide à créer, déployer et gérer des rapports paginés.

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 :

  1. Acquérir un bail SSRS.
  2. Configurer SSRS.
  3. Libérer un bail SSRS.

Acquérir un bail SSRS

SSRS nécessite des autorisations élevées lors de la configuration. Pour acquérir un bail SSRS pour votre instance, utilisez la commande suivante :

gcloud

Utilisez la commande suivante pour acquérir un bail :

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 \

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

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

REST v1beta4

À 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

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Configurer SSRS

Pour effectuer la configuration de SSRS, procédez comme suit :

  1. Ouvrez le gestionnaire de configuration de Reporting Services sur l'hôte où SSRS est installé.
  2. Connectez-vous à votre instance de serveur de rapports locale.
  3. Cliquez sur Changer de base de données.
    1. 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.
    2. 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.
    3. Saisissez les identifiants de connexion SQL Server pour la connexion de service utilisée pour le bail SSRS.
    4. Cliquez sur Suivant et passez à la dernière étape.
  4. 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 :

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

REST v1

À 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.

  • PROJECT_ID : ID du projet.
  • INSTANCE_NAME : nom de l'instance.

Méthode HTTP et URL : 

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

REST v1beta4

À 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.

  • PROJECT_ID : ID du projet.
  • INSTANCE_NAME : nom de l'instance.

Méthode HTTP et URL : 

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

Limites

  • 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.

Questions fréquentes

Les sections suivantes vous aident à répondre aux questions fréquentes concernant SSRS.

Configuration et mécanisme de location

Les sections suivantes vous aident à répondre aux questions sur la configuration et les baux SSRS.

Comment configurer SSRS avec Cloud SQL ?

Vous devez installer SSRS sur un hôte Windows distinct, comme une VM Compute Engine. Ensuite, configurez SSRS pour qu'il utilise votre instance Cloud SQL pour les bases de données ReportServer et ReportServerTempDB. La "location SSRS" est une partie importante de ce processus si vous gérez la configuration à l'aide de Cloud SQL.

Qu'est-ce que le bail SSRS et pourquoi est-il nécessaire ?

La configuration de SSRS nécessite normalement des autorisations sysadmin, qui ne sont pas accordées aux utilisateurs dans Cloud SQL. Le mécanisme de bail accorde temporairement les autorisations élevées nécessaires à une connexion SQL Server spécifiée, par exemple --setup-login, pour finaliser la configuration de la base de données.

Vous acquérez un bail à l'aide de gcloud sql instances acquire-ssrs-lease avant la configuration et le libérez ensuite avec gcloud sql instances release-ssrs-lease. La durée du bail est configurable.

Authentification

La section suivante vous aidera à répondre aux questions sur l'authentification.

Non, vous devez utiliser les connexions SQL Server pour les paramètres --setup-login et --service-login lorsque vous acquérez le bail et configurez la base de données du serveur de rapports. Les identifiants Windows ne sont pas acceptés pour cette configuration initiale.

Bien que la configuration nécessite des identifiants SQL, vous pouvez potentiellement utiliser l'authentification Windows pour accéder aux rapports si votre instance Cloud SQL et l'hôte SSRS sont tous deux associés à l'un des types de domaines suivants :

Restrictions

La section suivante vous aide à répondre aux questions liées aux restrictions ou aux limites.

Quelles sont les limites de l'utilisation de SSRS avec Cloud SQL ?

  • Il n'existe aucune connexion Microsoft Active Directory pour la phase de configuration de la base de données.
  • 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 nouveau bail si vous souhaitez modifier les identifiants du compte de service ultérieurement.
  • Les déploiements à scaling horizontal nécessitent le processus de bail pour chaque nouvel hôte SSRS.
  • L'importation de bases de données de serveur de rapports existantes nécessite des étapes manuelles pour remapper l'utilisateur de connexion au service.

Remarques sur les tarifs

La section suivante vous aide à prendre en compte les aspects liés à la tarification.

Quels sont les coûts associés aux licences ?

  • Une licence SQL Server est requise pour votre instance Cloud SQL.
  • Étant donné que SSRS s'exécute sur une machine Windows distincte, assurez-vous que l'OS Windows et tous les composants SQL Server de cette machine sont correctement concédés sous licence. Selon les règles de Microsoft, l'exécution de SSRS sur un serveur distinct peut nécessiter une licence SQL Server supplémentaire.

Automatisation

La section suivante vous aide à répondre aux questions liées à l'automatisation.

Pouvez-vous automatiser le processus d'installation et de configuration de l'hôte SSRS ?

Vous pouvez exécuter des opérations pour acquérir et libérer le bail SSRS dans Cloud SQL à l'aide de la gcloud CLI ou des API REST.

L'installation et la configuration de SSRS dans l'environnement Windows lui-même impliquent généralement des étapes manuelles dans l'interface du gestionnaire de configuration Reporting Services, ce qui rend l'automatisation complète de bout en bout plus difficile.

Pour en savoir plus, consultez Installer et configurer SSRS.

Maintenance

La section suivante vous aidera à répondre aux questions liées à la maintenance.

Quelles sont les activités de gestion et de maintenance potentielles associées à l'utilisation de SSRS ?

Avant de commencer, tenez compte de la charge de gestion continue associée au serveur SSRS distinct. Vous êtes responsable de la gestion, de l'application de correctifs et de la sécurisation de la VM Windows exécutant le service SSRS. Cloud SQL ne gère que l'instance de base de données.