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.

Häufig gestellte Fragen

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

Einrichtung und Leasingmechanismus

In den folgenden Abschnitten finden Sie Antworten auf Fragen zur Einrichtung und zur SSRS-Freigabe.

Wie richte ich SSRS mit Cloud SQL ein?

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

Was ist der SSRS-Leasingvertrag und warum ist er erforderlich?

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

Sie erhalten einen Lease mit gcloud sql instances acquire-ssrs-lease vor der Konfiguration und geben ihn danach mit gcloud sql instances release-ssrs-lease frei. Die Dauer des Leases ist konfigurierbar.

Authentifizierung

Im folgenden Abschnitt finden Sie Antworten auf Fragen zur Authentifizierung.

Nein. Sie müssen SQL Server-Anmeldungen für die Parameter --setup-login und --service-login verwenden, wenn Sie die Lease erwerben und die Berichtsserverdatenbank konfigurieren. Windows-Anmeldungen werden für diesen ersten Einrichtungsvorgang 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 finden Sie Antworten auf Fragen zu Einschränkungen.

Welche Einschränkungen gelten bei der Verwendung von SSRS mit Cloud SQL?

  • Während der Einrichtung der Datenbank sind keine Microsoft Active Directory-Anmeldungen möglich.
  • Der Name der Berichtsdatenbank darf nur alphanumerische Zeichen und Bindestriche enthalten.
  • Wenn Sie die Anmeldedaten des Dienstkontos später ändern möchten, müssen Sie ein neues Lease erwerben.
  • Für Bereitstellungen mit horizontaler Skalierung ist der Lease-Prozess für jeden neuen SSRS-Host erforderlich.
  • Beim Importieren vorhandener Berichtsserverdatenbanken sind manuelle Schritte erforderlich, um den Nutzer für die Dienstanmeldung neu zuzuordnen.

Kosten

Im folgenden Abschnitt werden Preisaspekte behandelt.

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 Sie darauf achten, dass das Windows-Betriebssystem und alle SQL Server-Komponenten auf diesem Computer ordnungsgemäß lizenziert sind. 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.

Automatisierung

Im folgenden Abschnitt werden Fragen zur Automatisierung beantwortet.

Kann der Installations- und Konfigurationsprozess für den SSRS-Host automatisiert werden?

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

Die Installation und Konfiguration von SSRS in der Windows-Umgebung selbst erfordert in der Regel manuelle Schritte über die Reporting Services Configuration Manager-Oberfläche, was die vollständige End-to-End-Automatisierung erschwert.

Weitere Informationen finden Sie unter SSRS installieren und konfigurieren.

Wartung

Im folgenden Abschnitt finden Sie Antworten auf Fragen zur Wartung.

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

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