Freigeben über

Upgraden von Berichten (SSRS)

  • Artikel

Gilt für: SQL Server 2016 (13.x) Power BI-Berichtsserver

Berichtsdefinitionsdateien (RDL) werden auf folgende Weise automatisch aktualisiert:

  • Wenn Sie einen paginierten Bericht im Berichts-Designer in SQL Server Data Tools (SSDT) öffnen, wird die Berichtsdefinition auf das derzeit unterstützte RDL-Schema aktualisiert. Wenn Sie in den Projekteigenschaften einen Berichtsserver für SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) angeben, wird die Berichtsdefinition in einem Schema gespeichert, das mit dem Zielserver kompatibel ist.

  • Wenn Sie ein Upgrade einer Reporting Services-Installation auf eine SQL Server 2016 (13x) Reporting Services-Installation (SSRS) oder höher durchführen, werden vorhandene Berichte und Momentaufnahmen, die auf einem Berichtsserver veröffentlicht wurden, bei der ersten Verarbeitung kompiliert und automatisch auf das neue Schema aktualisiert. Wenn ein Bericht nicht automatisch aktualisiert werden kann, wird er im Abwärtskompatibilitätsmodus verarbeitet. Die Berichtsdefinition bleibt im ursprünglichen Schema erhalten.

Nachdem ein Bericht lokal oder auf dem Berichtsserver aktualisiert wurde, werden möglicherweise weitere Fehler, Warnungen und Meldungen angezeigt. Das ist das Ergebnis der Änderungen am internen Berichtsobjektmodell und an Verarbeitungskomponenten, die das Anzeigen von Meldungen bewirken, sobald zugrunde liegende Probleme im Bericht erkannt werden. Weitere Informationen finden Sie unter Reporting Services Backward Compatibility.

Weitere Informationen zu neuen Features für SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher finden Sie unter Neuigkeiten in SQL Server Reporting Services (SSRS).

Vom Upgrade unterstützte Versionen

Berichte, die in früheren Versionen von Reporting Services erstellt wurden, können nicht aktualisiert werden. Dazu gehören die folgenden Versionen:

  • SQL Server 2008 (10.0.x)

  • SQL Server 2008 R2 (10.50.x)

  • SQL Server 2012 (11.x)

  • SQL Server 2014 (12.x)

Berichtsdefinitionsdateien (RDL-Dateien) und Berichts-Designer

Eine Berichtsdefinitionsdatei schließt einen Verweis auf den RDL-Namespace ein, der die Version des Berichtsdefinitionsschemas angibt, das zur Überprüfung der RDL-Datei verwendet wird.

Wenn Sie eine RDL-Datei im Berichts-Designer in SQL Server Data Tools (SSDT) öffnen und der Bericht für einen vorherigen Namespace erstellt wurde, erstellt der Berichts-Designer automatisch eine Sicherungsdatei und aktualisiert den Bericht auf den aktuellen Namespace. Dies ist die einzige Möglichkeit, wie Sie eine Berichtsdefinitionsdatei aktualisieren können.

Die von Ihnen festgelegten Bereitstellungseigenschaften können das Schema beeinflussen, in dem die Berichtsdefinitionsdatei gespeichert wird. Weitere Informationen finden Sie unter Bereitstellung und Versionsunterstützung in SQL Server Data Tools (SSRS).

Sie können eine mit einer früheren Version von Reporting Services erstellte RDL-Datei in die neue Version hochladen. Die Datei wird automatisch aktualisiert, wenn sie zum ersten Mal verwendet wird. Der Berichtsserver speichert die Berichtsdefinitionsdatei im ursprünglichen Format. Der Bericht wird automatisch aktualisiert, wenn er zum ersten Mal angezeigt wird. Die gespeicherte Berichtsdefinitionsdatei wird jedoch nicht verändert.

Informationen zum Ermitteln des aktuellen RDL-Schemas für einen Bericht, einen Berichtsserver oder den Berichts-Designer finden Sie unter Suchen der Berichtsdefinitions-Schemaversion (SSRS).

Veröffentlichte Berichte und Berichtsmomentaufnahmen

Bei der ersten Verwendung versucht der Berichtsserver, vorhandene veröffentlichte Berichte und Berichtsmomentaufnahmen auf das neue Berichtsdefinitionsschema zu aktualisieren, ohne dass Sie etwas unternehmen müssen. Es wird versucht, das Upgrade auszuführen, wenn der Benutzer einen Bericht oder eine Berichtsmomentaufnahme anzeigt bzw. wenn der Berichtsserver ein Abonnement verarbeitet. Die Berichtsdefinition wird nicht ersetzt, sondern weiterhin auf dem Berichtsserver im ursprünglichen Schema gespeichert. Wenn ein Bericht nicht automatisch aktualisiert werden kann, wird er im Abwärtskompatibilitätsmodus ausgeführt.

Abwärtskompatibilitätsmodus

Ein erfolgreich aktualisierter Bericht wird vom Berichtsprozessor von SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher verarbeitet. Ein Bericht, der nicht upgegradet werden kann, wird vom Berichtsprozessor von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services im Abwärtskompatibilitätsmodus verarbeitet. Ein Bericht kann nicht von beiden Berichtsprozessoren verarbeitet werden. Bei der ersten Verwendung wird ein Bericht entweder erfolgreich aktualisiert oder für den Abwärtskompatibilitätsmodus markiert.

Nur der Berichtsprozessor von SQL Server 2016 (13.x) Reporting Services oder höher (SSRS) unterstützt neue Features. Wenn ein Bericht nicht aktualisiert werden kann, können Sie zwar den gerenderten Bericht anzeigen, die neuen Funktionen sind jedoch nicht verfügbar. Um die neuen Funktionen nutzen zu können, muss ein Bericht erfolgreich aktualisiert werden.

Aktualisieren eines Berichts mit Unterberichten

Wenn ein Bericht Unterberichte enthält, kann einer von vier möglichen Zustände während des Upgrades auftreten:

  • Der Hauptbericht und alle Unterberichte können erfolgreich aktualisiert werden. Sie werden vom Berichtsprozessor von SQL Server 2016 (13.x) Reporting Services oder höhere Berichtsprozessoren (SSRS) verarbeitet.

  • Der Hauptbericht und alle Unterberichte können nicht aktualisiert werden. Sie werden vom Berichtsprozessor von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services verarbeitet.

  • Der Hauptbericht kann aktualisiert werden, aber ein oder mehrere Unterberichte können nicht aktualisiert werden. Der Hauptbericht wird vom Berichtsprozessor von SQL Server 2016 (13.x) Reporting Services oder höhere Berichtsprozessoren (SSRS) verarbeitet. Im gerenderten Bericht wird jedoch an der Stelle, an der der Unterbericht angezeigt würde, der nicht aktualisiert werden konnte, die Meldung „Fehler: Unterbericht konnte nicht verarbeitet werden“ angezeigt.

  • Der Hauptbericht kann nicht aktualisiert werden, aber ein oder mehrere Unterberichte können aktualisiert werden. Der Hauptbericht wird vom Berichtsprozessor von SQL Server 2016 (13.x) Reporting Services oder höher verarbeitet. Im gerenderten Bericht wird jedoch an der Stelle, an der der Unterbericht angezeigt würde, die Meldung „Fehler: Unterbericht konnte nicht verarbeitet werden“ angezeigt.

Wenn die Fehlermeldung "Fehler: Unterbericht konnte nicht verarbeitet werden" angezeigt wird, müssen Sie die Definition des Hauptberichts oder des Unterberichts ändern, sodass alle Berichte von der gleichen Version des Berichtsprozessors verarbeitet werden können.

Für Drillthroughberichte gilt diese Einschränkung nicht, da sie als unabhängige Berichte verarbeitet werden.

Aktualisieren eines Berichts mit benutzerdefinierten Berichtselementen

Berichte von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services können benutzerdefinierte Berichtselemente (Custom Report Items, CRIs) enthalten, die von Drittanbietersoftware bereitgestellt und von Systemadministrator*innen auf dem Computer, auf dem der Bericht erstellt wurde, und auf dem Berichtsserver installiert wurden. Berichte, die CRIs enthalten, können auf die folgenden Weisen aktualisiert werden:

  • Für einen Berichtsserver von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services wird ein Upgrade auf einen Berichtsserver von SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher durchgeführt. Auf dem Berichtsserver veröffentlichte Berichte werden automatisch bei der ersten Verwendung aktualisiert.

  • Ein Bericht von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services wird auf einen Berichtsserver von SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher hochgeladen. Der Bericht wird bei seiner ersten Verwendung automatisch aktualisiert.

  • Ein Bericht von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services wird im Berichts-Designer in SQL Server Data Tools (SSDT) geöffnet. Es wird eine Sicherungskopie des ursprünglichen Berichts erstellt. Einer der folgenden zwei Fälle tritt auf:

    1. Alle CRIs im Bericht verfügen über keine nicht unterstützten Funktionen. Die CRIs werden in Berichtselemente im neuen Berichtsdefinitionsformat konvertiert, sodass der gesamte Bericht aktualisiert wird. Wenn Sie die Datei speichern, wird sie im aktuellen RDL-Namespace gespeichert.

    2. Ein oder mehrere CRIs im Bericht verfügen über nicht unterstützte Funktionen. Ein Dialogfeld fordert den Benutzer zur Angabe auf, ob die CRIs konvertiert oder unverändert beibehalten werden sollen.

    Weitere Informationen hierzu finden Sie unter Öffnen eines Berichts mit CRIs im Berichts-Designer weiter hinten in diesem Thema

Informationen zum Identifizieren des aktuellen RDL-Namespace für einen Berichtsserver, für SQL Server Data Tools oder für einem Bericht finden Sie unter Suchen der Berichtsdefinitions-Schemaversion (SSRS).

Aktualisieren eines Berichts auf einem Berichtsserver

Wenn ein Bericht von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services zum ersten Mal auf einem Berichtsserver ausgeführt wird, für den ein Upgrade auf SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher durchgeführt wurde, wird der Bericht automatisch auf den aktuellen Berichtsdefinitionsnamespace upgegradet, der vom Berichtsserver unterstützt wird. Es ist möglich, dass der Bericht vor dem Upgrade auf dem Berichtsserver vorhanden war, über das Webportal hochgeladen oder vom Berichts-Designer in SQL Server Data Tools von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) auf dem Berichtsserver veröffentlicht wurde.

In der folgenden Tabelle werden die Upgradeaktionen aufgeführt, die vom Berichtsserver für bestimmte Typen von CRIs in einem Bericht ausgeführt werden.

CRI-Typ Upgradeaktion des Berichtsservers
CRIs von Drittanbietern Es wird kein Upgrade durchgeführt.

Sie werden vom Berichtsprozessor von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services verarbeitet.

Öffnen eines Berichts mit CRIs im Berichts-Designer

Wenn Sie einen Bericht von SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) oder SQL Server 2014 (12.x) Reporting Services mit CRIs im Berichts-Designer in SQL Server Data Tools (SSDT) öffnen, wird der Bericht auf das neue Berichtsdefinitionsschema upgegradet. Abhängig von den im Bericht enthaltenen CRIs wird eine der folgenden Aktionen ausgeführt:

  • Es wurden CRIs von Drittanbietern erkannt. Wenn die auf dem Computer zur Berichtserstellung installierte CRI-Version nicht mit dem neuen RDL-Schema kompatibel ist, wird in der Entwurfsoberfläche ein Textfeld mit einem roten X angezeigt. Sie müssen sich an Ihren Systemadministrator wenden, um neue Versionen der CRIs von Drittanbietern zu installieren, die mit dem neuen RDL-Schema kompatibel sind.

Ein vorhandener Bericht lässt sich nur dadurch mit dem neuen Berichtsdefinitionsschema aktualisieren, dass er nach dem Upgrade in der Berichterstellungsumgebung gespeichert wird.

CRI konvertieren (Dialogfeld)

Dieser Bericht enthält benutzerdefinierte Berichtselemente (Custom Report Item, CRI) mit nicht unterstützten Funktionen. CRIs sind Erweiterungen der Berichtsdefinitionssprache (Report Definition Language, RDL) zur Unterstützung benutzerdefinierter Objekte, die Daten in einem Bericht anzeigen. CRIs umfassen Entwurfszeit- und Laufzeitkomponenten, die von Drittanbietern bereitgestellt werden.

Hinweis

Die Entscheidung, benutzerdefinierte Berichtselemente auf einem Berichtsserver zuzulassen, wird vom Systemadministrator getroffen. Zum Anzeigen von CRIs in einem Bericht müssen die CRI-Komponenten auf dem Berichterstellungsserver installiert sein, um einen Bericht als Vorschau anzuzeigen, und auf dem Berichtsserver, um einen veröffentlichten oder hochgeladenen Bericht anzuzeigen. Weitere Informationen finden Sie unter Benutzerdefinierte Berichtselemente und in der Dokumentation des Softwaredrittanbieters.

Einige CRIs können im neuen Berichtsdefinitionsformat in Berichtselemente konvertiert werden. Entscheiden Sie anhand der folgenden Liste, ob die CRIs in diesem Bericht konvertiert werden sollen:

  • Ja Wählen Sie Ja aus, um nach Möglichkeit alle CRIs im Bericht zu konvertieren. Nicht unterstützte Funktionen in den CRIs können nicht aktualisiert werden und werden aus der Berichtsdefinitionsdatei entfernt. Bei der Anzeige des Berichts werden möglicherweise Unterschiede in der Darstellung der CRIs im Bericht deutlich.

  • Nein Wählen Sie Nein aus, wenn die CRIs im Bericht nicht konvertiert werden sollen. Diese CRIs können vom Berichtsprozessor nicht in ihrer aktuellen Version angezeigt werden. Wenn der Systemadministrator die Installation einer neuen CRI-Version von einem Softwaredrittanbieter plant, die mit dem neuen Berichtsdefinitionsformat kompatibel ist, sollten Sie Neinauswählen. Bis neue Versionen zur Verfügung stehen, werden die CRIs im Bericht als leere Textfelder mit einem roten X dargestellt.

In beiden Fällen wird der Bericht auf das neue Berichtsdefinitionsformat aktualisiert, und eine Sicherungskopie des ursprünglichen Berichts wird als „<Berichtsname> - Backup.rdl“ gespeichert. Wenn Sie den Bericht im Berichterstellungstool speichern, wird der aktualisierte Bericht im neuen Berichtsdefinitionsformat gespeichert. Beim Veröffentlichen des Berichts wird dieser zuerst auf Ihrem Computer gespeichert und dann auf dem Berichtsserver veröffentlicht. Sie veröffentlichen die aktualisierte Version des Berichts auf dem Berichtsserver.

Wenn Sie den Bericht nicht speichern, bleibt der ursprüngliche Bericht unverändert. Sie können diesen Bericht jedoch nicht in der SQL Server 2016-Version von SQL Server Data Tools oder in einer Berichterstellungsumgebung bearbeiten, die ein neueres Berichterstellungsformat verwendet. Sie können die ursprüngliche Version des Berichts weiterhin ausführen, indem Sie ihn über das Webportal auf einen Berichtsserver von SQL Server 2016 (13.x) Reporting Services (SSRS) oder höhere Berichtsprozessoren hochladen. Weitere Informationen finden Sie unter Webportal.

Bei Berichten, die Sie hochladen, statt sie auf einem Berichtsserver zu veröffentlichen, bestimmt der Berichtsprozessor, ob der Bericht bei der ersten Verwendung aktualisiert werden kann. Berichte, die nicht aktualisiert werden können, werden im Abwärtskompatibilitätsmodus verarbeitet und weiterhin wie in der früheren Version von Reporting Servicesangezeigt.

Zugehöriger Inhalt