SQL Server Reporting Services (SSRS)

Cloud SQL unterstützt SQL Server Reporting Services (SSRS), mit denen Sie paginierte Berichte erstellen, bereitstellen und verwalten können.

Auf dieser Seite werden die Voraussetzungen, das Einrichtungsverfahren und die Einschränkungen für die Verwendung von SSRS in Cloud SQL beschrieben.

Hinweise

Bevor Sie SSRS in Cloud SQL verwenden können, müssen folgende Voraussetzungen erfüllt sein:

  • Eine Cloud SQL-Instanz zum Hosten der Datenbank des Berichtsservers
  • Ein Host, auf dem Sie SSRS installieren und ausführen. Dies kann entweder eine Compute Engine-VM oder ein Host sein, der Compute Engine nicht verwendet. Eine Installationsanleitung finden Sie unter SQL Server Reporting-Dienste installieren.

  • Einen Cloud DNS-Eintrag, um Ihrer Cloud SQL-Instanz einen Hostnamen zuzuweisen. Sie können einen Hostnamen mit einer der folgenden Optionen erstellen:

    • Cloud DNS: Mit Cloud DNS können Sie einen Hostnamen erstellen, der auf Ihre Instanz verweist.
    • Benutzerdefinierte DNS-Zone: Wenn Sie Ihre eigene DNS-Zone verwalten, erstellen Sie einen A-Eintrag, der Ihren bevorzugten Hostnamen der IP-Adresse Ihrer Instanz zuordnet.
    • Lokale Zuordnung des Hostnamens: Ändern Sie die Datei hosts Ihres Systems, um einen benutzerdefinierten Alias für Ihre Instanz zu erstellen.

  • Zwei vorhandene Cloud SQL-Anmeldungen, eine Einrichtungsanmeldung und eine Dienstanmeldung. Informationen zum Erstellen eines Anmeldedaten finden Sie unter gcloud sql users create.

    Wenn Sie die Windows-Authentifizierung verwenden möchten, müssen Sie Managed Active Directory verwenden, um der SQL Server-Instanz und dem Host, auf dem SSRS ausgeführt wird, beizutreten. Weitere Informationen finden Sie unter Managed Microsoft AD mit Cloud SQL verwenden.

Vorgehensweise

Führen Sie die folgenden Schritte aus, um SSRS in Cloud SQL einzurichten:

  1. SSRS-Drittanbieterlizenz erwerben
  2. SSRS einrichten
  3. SSRS-Freigabe freigeben

SSRS-Freigabe erwerben

Für die Einrichtung von SSRS sind erhöhte Berechtigungen erforderlich. Verwenden Sie den folgenden Befehl, um einen SSRS-Leasingvertrag für Ihre Instanz zu erwerben:

gcloud

Verwenden Sie den folgenden Befehl, um eine Freigabe zu erhalten:

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 \

Die folgende Tabelle beschreibt die gcloud-Parameter dieses Vorgangs:

Parameter Beschreibung Zulässige Werte Standardwert
--setup-login Erforderlich. Die Anmeldung, die während der SSRS-Einrichtung für die Verbindung mit der Instanz verwendet wird. Dies ist die erste Anmeldung, die im Report Server Configuration Manager angefordert wird, wenn eine Report Server-Datenbank eingerichtet wird. Dies muss eine vorhandene SQL Server-Anmeldung sein, z. B. sqlserver. Keine
--service-login Erforderlich. Die SQL Server-Anmeldung, die vom Berichtsserver verwendet wird, um während der SSRS-Einrichtung eine Verbindung zur Berichtsserverdatenbank herzustellen. Dies ist die zweite Anmeldung, die im Report Server Configuration Manager beim Festlegen einer Report Server-Datenbank angefordert wird. Dies muss eine vorhandene SQL Server-Anmeldung sein und sich von der Anmeldedaten für die Einrichtung unterscheiden. –
--report-database Erforderlich. Ein vorhandener oder ein neuer Berichtsdatenbankname für die Instanz. Bestimmte Sonderzeichen sind im Namen der Berichtsdatenbank nicht zulässig, z. B. Leerzeichen, Klammern oder nicht englische Zeichen. Keine
--duration Optional. Gibt an, wie viele Stunden die SSRS-Freigabe aktiv ist und in denen Sie die SSRS-Einrichtung ausführen können. Zwischen 1 und 12 Stunden Beispiel: 4h 5 Stunden

REST Version 1

Mit der REST API können Sie einen SSRS-Leasingvertrag für eine Instanz erwerben. Geben Sie Folgendes an, um eine SSRS-Freigabe zu erhalten:
  • Zwei verschiedene SQL Server-Anmeldungen: die Einrichtungsanmeldung und die Dienstanmeldung
  • Name der Berichtsdatenbank
  • Die Dauer, für die die Freigabe aktiv ist

Nur das Feld DURATION ist optional. Weitere Informationen finden Sie unter AcquireSsrsLeaseContext:

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.
  • SETUP_LOGIN: das SQL Server-Anmeldekonto, mit dem während der SSRS-Einrichtung eine Verbindung zur SQL Server-Instanz hergestellt wird. Dies ist die erste Anmeldung, die im Report Server Configuration Manager angefordert wird, wenn eine Report Server-Datenbank festgelegt wird.
  • SERVICE_LOGIN: die SQL Server-Anmeldung, die vom Berichtsserver verwendet wird, um während der SSRS-Einrichtung eine Verbindung zur Berichtsserver-Datenbank herzustellen. Dies ist die zweite Anmeldung, die im Report Server Configuration Manager angefordert wird, wenn eine Report Server-Datenbank festgelegt wird.
  • REPORT_DATABASE: Name einer vorhandenen oder neuen Berichtsdatenbank in der Instanz. Microsoft lässt bestimmte Sonderzeichen im Namen der Berichtsdatenbank nicht zu, z. B. Leerzeichen, Klammern oder nicht englische Zeichen.
  • DURATION: Optional. Gibt an, wie viele Stunden die SSRS-Freigabe aktiv ist und in denen Sie die SSRS-Einrichtung ausführen können. Zwischen 1 und 12  Stunden, z. B. 4h.

HTTP-Methode und URL: 

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

JSON-Text der Anfrage:

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

REST v1beta4

Mit der REST API können Sie einen SSRS-Leasingvertrag für eine Instanz erwerben. Geben Sie Folgendes an, um eine SSRS-Freigabe zu erhalten:
  • Zwei verschiedene SQL Server-Anmeldungen: die Einrichtungsanmeldung und die Dienstanmeldung
  • Name der Berichtsdatenbank
  • Die Dauer, für die die Freigabe aktiv ist

Nur das Feld DURATION ist optional. Weitere Informationen finden Sie unter AcquireSsrsLeaseContext:

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.
  • SETUP_LOGIN: das SQL Server-Anmeldekonto, mit dem während der SSRS-Einrichtung eine Verbindung zur SQL Server-Instanz hergestellt wird. Dies ist die erste Anmeldung, die im Report Server Configuration Manager angefordert wird, wenn eine Report Server-Datenbank festgelegt wird.
  • SERVICE_LOGIN: die SQL Server-Anmeldung, die vom Berichtsserver verwendet wird, um während der SSRS-Einrichtung eine Verbindung zur Berichtsserver-Datenbank herzustellen. Dies ist die zweite Anmeldung, die im Report Server Configuration Manager angefordert wird, wenn eine Report Server-Datenbank festgelegt wird.
  • REPORT_DATABASE: Name einer vorhandenen oder neuen Berichtsdatenbank in der Instanz. Microsoft lässt bestimmte Sonderzeichen im Namen der Berichtsdatenbank nicht zu, z. B. Leerzeichen, Klammern oder nicht englische Zeichen.
  • DURATION: Optional. Gibt an, wie viele Stunden die SSRS-Freigabe aktiv ist und in denen Sie die SSRS-Einrichtung ausführen können. Zwischen 1 und 12  Stunden, z. B. 4h.

HTTP-Methode und URL: 

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

JSON-Text der Anfrage:

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

SSRS einrichten

So richten Sie SSRS ein:

  1. Öffnen Sie den Reporting Services-Konfigurationsmanager auf dem Host, auf dem SSRS installiert ist.
  2. Stellen Sie eine Verbindung zu Ihrer lokalen Report Server-Instanz her.
  3. Klicken Sie auf Datenbank ändern.
    1. Geben Sie den in Cloud DNS erstellten SQL Server-Hostnamen und die SQL Server-Anmeldedaten für die Einrichtungsanmeldung ein, die für die SSRS-Lease verwendet wird.
    2. Geben Sie den Namen einer neuen Report-Server-Datenbank oder einer vorhandenen Report-Datenbank ein, die für die SSRS-Drittlizenz verwendet wird.
    3. Geben Sie die SQL Server-Anmeldedaten für die Dienstanmeldung ein, die für die SSRS-Lease verwendet wird.
    4. Klicken Sie auf Weiter und führen Sie den letzten Schritt aus.
  4. Konfigurieren Sie die URL des Webdienstes und die URL des Webportals, falls noch nicht geschehen. Das Webportal sollte innerhalb weniger Sekunden geladen werden.

SSRS-Freigabe freigeben

Sie können eine Freigabe manuell freigeben oder warten, bis sie automatisch abläuft. Das Freigeben des Leasingzeitraums ist erforderlich, um alle erhöhten Berechtigungen für die Einrichtung rückgängig zu machen und die Anmeldung des Dienstes für die Verbindung mit der Berichtsdatenbank zu ermöglichen. Die Dienstanmeldung kann erst dann auf die Berichtsdatenbank zugreifen, wenn die Freigabe abläuft oder manuell freigegeben wird. Mit dem folgenden Befehl wird eine SSRS-Freigabe freigegeben.

gcloud

Verwenden Sie den folgenden Befehl, um einen Lease freizugeben:

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

REST Version 1

Mit der REST API können Sie eine SSRS-Freigabe für eine Instanz freigeben. Wie im folgenden Beispiel für eine Anfrage gezeigt, müssen Sie nur den Instanznamen und die Projekt-ID angeben.

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.

HTTP-Methode und URL: 

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

REST v1beta4

Mit der REST API können Sie eine SSRS-Freigabe für eine Instanz freigeben. Wie im folgenden Beispiel für eine Anfrage gezeigt, müssen Sie nur den Instanznamen und die Projekt-ID angeben.

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.

HTTP-Methode und URL: 

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

Beschränkungen

  • Active Directory-Anmeldungen werden für die Einrichtung der Berichtsdatenbank nicht unterstützt.
  • Der Name der Berichtsdatenbank darf nur alphanumerische Zeichen und Bindestriche enthalten.
  • Sie müssen eine Lizenz erwerben, um das Anmeldekonto zu ändern, das für die Verbindung zur Berichtsdatenbank über den Report Server Configuration Manager verwendet wird.
  • Bei einer Datenbank, die von einer Dienstanmeldung verarbeitet wird, können die Import-SQL-Dateien und das Löschen replizierter Datenbankvorgänge zwischen dem Abschluss der SSRS-Einrichtung und dem Release der Freigabe fehlschlagen.
  • Sie müssen den Datenbanknutzer für die Dienstanmeldung in einer importierten Berichtsdatenbank löschen und neu erstellen. Das liegt daran, dass der vorhandene Nutzer in der importierten Datenbank nicht zur neuen Instanz gehört.
  • Wenn Sie neue Berichtsserver für eine Bereitstellung mit horizontaler Skalierung in SSRS hinzufügen, müssen Sie die SSRS-Freigabe für jede neue Windows-VM, die einen Berichtsserver hostet, erwerben und freigeben. Für jede Cloud SQL-Instanz müssen Sie die neue Berichtsdatenbank mithilfe der vorhandenen Berichtsdatenbank konfigurieren.
  • Sie müssen jedes Mal eine neue Freigabe erstellen, wenn Sie die Anmeldedaten für die Berichtsserver-Datenbank im Konfigurationsmanager des Berichtsservers ändern möchten.