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 Berichtsserver-Datenbank
  • 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 Services installieren.
  • Ein Cloud DNS-Eintrag zum Zuweisen eines Hostnamens für Ihre Cloud SQL-Instanz. Sie haben folgende Möglichkeiten, einen Hostnamen zu erstellen:

    • Cloud DNS: Verwenden Sie Cloud DNS, um einen Hostnamen zu 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.
    • Zuordnung des lokalen 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 Log-ins 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.

Prozedur

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

  1. Fordern Sie eine SSRS-Freigabe an.
  2. SSRS einrichten
  3. SSRS-Freigabe freigeben

SSRS-Freigabe erwerben

SSRS erfordert während der Einrichtung erhöhte Berechtigungen. Mit dem folgenden Befehl erhalten Sie eine SSRS-Freigabe für Ihre Instanz:

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 für die Verbindung mit der Instanz während der SSRS-Einrichtung verwendet wird. Dies ist die erste Anmeldung, die im Konfigurationsmanager für Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank festgelegt 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 Konfigurationsmanager für Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank festgelegt wird. Dies muss eine vorhandene SQL Server-Anmeldung sein und sich von der Einrichtungsanmeldung unterscheiden.
--report-database Erforderlich. Ein vorhandener oder 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. Die Anzahl der Stunden, in denen die SSRS-Freigabe aktiv ist, während 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 eine SSRS-Freigabe für eine Instanz erhalten. Geben Sie Folgendes an, um eine SSRS-Freigabe zu erhalten:
  • Zwei verschiedene SQL Server-Anmeldungen: Einrichtungsanmeldung und Dienstanmeldung
  • Name der Berichtsdatenbank
  • Dauer, für die die Freigabe aktiv ist

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

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.
  • SETUP_LOGIN: die SQL Server-Anmeldung, die zum Herstellen einer Verbindung zur SQL Server-Instanz während der SSRS-Einrichtung verwendet wird. Dies ist die erste Anmeldung, die im Konfigurationsmanager für Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank eingerichtet wird.
  • SERVICE_LOGIN: 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 Konfigurationsmanager für den Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank festgelegt wird.
  • REPORT_DATABASE: ein vorhandener oder ein neuer Berichtsdatenbankname für die Instanz. Microsoft lässt bestimmte Sonderzeichen im Namen der Berichtsdatenbank nicht zu, z. B. Leerzeichen, Klammern oder nicht englische Zeichen.
  • DURATION: Optional. Die Anzahl der Stunden, in denen die SSRS-Freigabe aktiv ist, während 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 eine SSRS-Freigabe für eine Instanz erhalten. Geben Sie Folgendes an, um eine SSRS-Freigabe zu erhalten:
  • Zwei verschiedene SQL Server-Anmeldungen: Einrichtungsanmeldung und Dienstanmeldung
  • Name der Berichtsdatenbank
  • Dauer, für die die Freigabe aktiv ist

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

  • PROJECT_ID: die ID des Projekts.
  • INSTANCE_NAME: der Name der Instanz.
  • SETUP_LOGIN: die SQL Server-Anmeldung, die zum Herstellen einer Verbindung zur SQL Server-Instanz während der SSRS-Einrichtung verwendet wird. Dies ist die erste Anmeldung, die im Konfigurationsmanager für Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank eingerichtet wird.
  • SERVICE_LOGIN: 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 Konfigurationsmanager für den Berichtsserver angefordert wird, wenn eine Berichtsserverdatenbank festgelegt wird.
  • REPORT_DATABASE: ein vorhandener oder ein neuer Berichtsdatenbankname für die Instanz. Microsoft lässt bestimmte Sonderzeichen im Namen der Berichtsdatenbank nicht zu, z. B. Leerzeichen, Klammern oder nicht englische Zeichen.
  • DURATION: Optional. Die Anzahl der Stunden, in denen die SSRS-Freigabe aktiv ist, während 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

Führen Sie die folgenden Schritte aus, um die SSRS-Einrichtung durchzuführen:

  1. Öffnen Sie den Konfigurationsmanager für Berichtsdienste auf dem Host, auf dem SSRS installiert ist.
  2. Stellen Sie eine Verbindung zur lokalen Berichtsserverinstanz her.
  3. Klicken Sie auf Datenbank ändern.
    1. Geben Sie den in Cloud DNS erstellten SQL Server-Hostnamen sowie die SQL Server-Anmeldedaten für die Einrichtungsanmeldung ein, die für die SSRS-Freigabe verwendet wird.
    2. Geben Sie den Namen einer neuen Berichtsserverdatenbank oder einer vorhandenen Berichtsdatenbank ein, die für die SSRS-Freigabe verwendet wird.
    3. Geben Sie die SQL Server-Anmeldedaten für die Dienstanmeldung ein, die für die SSRS-Freigabe verwendet wird.
    4. Klicken Sie auf Weiter und schließen Sie den letzten Schritt ab.
  4. Wenn sie noch nicht festgelegt ist, konfigurieren Sie die Webdienst-URL und die Webportal-URL. 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 der Freigabe ist erforderlich, um alle erhöhten Berechtigungen wiederherzustellen, die für die Einrichtung erforderlich sind, und damit die Dienstanmeldung eine Verbindung zur Berichtsdatenbank herstellen kann. Der 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 eine Freigabe 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 Anfragebeispiel 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 Anfragebeispiel 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 Freigabe für die Änderung der Anmeldung erhalten, die für die Verbindung mit der Berichtsdatenbank über den Konfigurationsmanager des Berichtsservers verwendet wird.
  • Bei einer Datenbank, die durch eine 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 für eine importierte 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 erwerben und freigeben, die einen Berichtsserver hostet. Jede Cloud SQL-Instanz erfordert, dass Sie die neue Berichtsdatenbank mithilfe der vorhandenen Berichtsdatenbank konfigurieren.
  • Sie müssen jedes Mal ein neues Freigabe erstellen, wenn Sie die Anmeldedaten für die Berichtsserver-Datenbank im Konfigurationsmanager des Berichtsservers ändern möchten.