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.

Prozedur

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

  • Sie können SSRS-Berichte nicht in Cloud SQL hosten oder von dort aus ausführen.
  • 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.

Häufig gestellte Fragen

In den folgenden Abschnitten werden häufig gestellte Fragen zu SSRS beantwortet.

Einrichtung und Freigabemechanismus

In den folgenden Abschnitten werden Fragen zur Einrichtung und zur SSRS-Freigabe beantwortet.

Wie richte ich SSRS mit Cloud SQL ein?

Sie müssen SSRS auf einem separaten Windows-Host installieren, z. B. auf einer Compute Engine-VM. Konfigurieren Sie dann SSRS so, dass Ihre Cloud SQL-Instanz für die Datenbanken ReportServer und ReportServerTempDB verwendet wird. Die „SSRS-Freigabe“ ist ein wichtiger Bestandteil dieses Prozesses, wenn Sie die Einrichtung mit Cloud SQL verwalten.

Was ist die SSRS-Freigabe und warum ist sie erforderlich?

Für die SSRS-Einrichtung sind normalerweise sysadmin-Berechtigungen erforderlich, die Nutzern in Cloud SQL nicht gewährt werden. Der Freigabemechanismus gewährt einer bestimmten SQL Server-Anmeldung, z. B. --setup-login, vorübergehend die erforderlichen erhöhten Berechtigungen, um die Datenbankeinrichtung abzuschließen.

Sie erwerben eine Freigabe mit gcloud sql instances acquire-ssrs-lease vor der Konfiguration und geben sie anschließend mit gcloud sql instances release-ssrs-lease frei. Die Dauer der Freigabe ist konfigurierbar.

Authentifizierung

Im folgenden Abschnitt werden Fragen zur Authentifizierung beantwortet.

Nein. Sie müssen SQL Server-Anmeldungen für die Parameter --setup-login und --service-login verwenden, wenn Sie die Freigabe erwerben und die Berichtsserver-Datenbank konfigurieren. Windows-Anmeldungen werden für diesen ersten Einrichtungsprozess nicht unterstützt.

Für die Einrichtung sind zwar SQL-Anmeldungen erforderlich, Sie können aber möglicherweise die Windows-Authentifizierung für den Zugriff auf Berichte verwenden, wenn Ihre Cloud SQL-Instanz und der SSRS-Host beide mit einem der folgenden Domänentypen verbunden sind:

Beschränkungen

Im folgenden Abschnitt werden Fragen zu Beschränkungen beantwortet.

Welche Einschränkungen gelten für die Verwendung von SSRS mit Cloud SQL?

  • Für die Datenbankeinrichtung sind keine Microsoft Active Directory-Anmeldungen verfügbar.
  • Der Name der Berichtsdatenbank darf nur alphanumerische Zeichen und Bindestriche enthalten.
  • Sie müssen eine neue Freigabe erwerben, wenn Sie die Anmeldedaten des Dienstkontos später ändern möchten.
  • Für Bereitstellungen mit horizontaler Skalierung ist für jeden neuen SSRS-Host der Freigabeprozess erforderlich.
  • Für den Import vorhandener Berichtsserver-Datenbanken sind manuelle Schritte erforderlich, um den Nutzer der Dienstanmeldung neu zuzuordnen.

Kosten

Im folgenden Abschnitt werden Fragen zu den Kosten beantwortet.

Welche Kosten sind mit der Lizenzierung verbunden?

  • Für Ihre Cloud SQL-Instanz ist eine SQL Server-Lizenz erforderlich.

  • Da SSRS auf einem separaten Windows-Computer ausgeführt wird, müssen das Windows-Betriebssystem und alle SQL Server-Komponenten auf diesem Computer ordnungsgemäß lizenziert sein. Gemäß den Richtlinien von Microsoft ist für die Ausführung von SSRS auf einem separaten Server möglicherweise eine zusätzliche SQL Server-Lizenz erforderlich. Alternativ bietet Cloud SQL vorgefertigte SQL Server-Images an.

    Weitere Informationen finden Sie unter SQL Server auf Google Cloud.

Automatisierung

Im folgenden Abschnitt werden Fragen zur Automatisierung beantwortet.

Kann ich die Installation und Konfiguration des SSRS-Hosts automatisieren?

Sie können Vorgänge zum Erwerben und Freigeben der SSRS-Freigabe in Cloud SQL mit der gcloud CLI oder REST APIs ausführen.

Die SSRS-Installation und -Konfiguration in der Windows-Umgebung selbst umfasst in der Regel manuelle Schritte über die Benutzeroberfläche des Reporting Services-Konfigurationsmanagers, was die vollständige End-to-End-Automatisierung erschwert.

Weitere Informationen finden Sie unter SSRS installieren und konfigurieren.

Wartung

Im folgenden Abschnitt werden Fragen zur Wartung beantwortet.

Welche potenziellen Verwaltungs- und Wartungsaktivitäten sind mit der Verwendung von SSRS verbunden?

Berücksichtigen Sie vor Beginn den laufenden Verwaltungsaufwand, der mit dem separaten SSRS-Server verbunden ist. Sie sind für die Verwaltung, das Patchen und die Sicherheit der Windows-VM verantwortlich, auf der der SSRS-Dienst ausgeführt wird. Cloud SQL verwaltet nur die Datenbankinstanz.