Erstellen von Datenverbindungszeichenfolgen in Report Builder
Gilt für: SQL Server 2016 (13.x) Reporting Services und höher Power BI-Berichtsserver SharePoint
Sie müssen zuerst eine Verbindungszeichenfolge in Ihrer Datenquelle erstellen, um Daten in paginierten Berichten von Berichts-Generator und Reporting Services einzuschließen. In diesem Artikel wird beschrieben, wie Sie Datenverbindungszeichenfolgen erstellen. Zudem erhalten Sie wichtige Informationen zu Anmeldeinformationen für Datenquellen. Eine Datenquelle umfasst den Datenquellentyp, Verbindungsinformationen und den Typ der erforderlichen Anmeldedaten. Weitere Informationen finden Sie unter Einführung in Berichtsdaten in SQL Server Reporting Services (SSRS).
Integrierte Datenerweiterungen
Standarddatenerweiterungen in Reporting Services enthalten Microsoft SQL Server, Microsoft Azure SQL-Datenbank und SQL Server Analysis Services. Eine vollständige Liste der von Reporting Services unterstützten Datenquellen und -versionen finden Sie unter Von Reporting Services unterstützte Datenquellen (SSRS).
Beispiele für häufige Verbindungszeichenfolgen
Verbindungszeichenfolgen sind die Textdarstellung von Verbindungseigenschaften für einen Datenanbieter. In der folgenden Tabelle sind Beispiele von Verbindungszeichenfolgen für verschiedene Datenverbindungstypen aufgeführt.
Hinweis
Connectionstrings.com ist eine weitere Ressource für den Bezug von Verbindungszeichenfolgen.
Datenquelle | Beispiel | Beschreibung |
---|---|---|
SQL Server-Datenbank auf dem lokalen Server | Data Source="(local)"; Initial Catalog=AdventureWorks |
Legen Sie den Datenquellentyp auf Microsoft SQL Serverfest. Weitere Informationen finden Sie unter SQL Server-Verbindungstyp (SSRS). |
Benannte SQL Server-Instanz | Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks |
Legen Sie den Datenquellentyp auf Microsoft SQL Serverfest. Weitere Informationen finden Sie unter SQL Server-Verbindungstyp (SSRS). |
Azure SQL-Datenbank | Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True |
Legen Sie den Datenquellentyp auf Microsoft Azure SQL-Datenbank fest. Weitere Informationen finden Sie unter Azure SQL-Verbindungstyp (SSRS). |
SQL Server Parallel Data Warehouse | HOST=<IP address>; database=AdventureWorks; port=<port> |
Legen Sie den Datenquellentyp auf Microsoft SQL Server Parallel Data Warehousefest. Weitere Informationen finden Sie unter SQL Server Parallel Data Warehouse-Verbindungstyp (SSRS). |
Analysis Services-Datenbank auf dem lokalen Server | Data Source=localhost; Initial Catalog=Adventure Works DW |
Legen Sie den Datenquellentyp auf Microsoft SQL Server Analysis Servicesfest. Weitere Informationen finden Sie unter Analysis Services-Verbindungstyp für MDX (SSRS) oder Analysis Services-Verbindungstyp für DMX (SSRS). |
Analysis Services-Datenbank für tabellarische Modelle mit Sales-Perspektive | Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' |
Legen Sie den Datenquellentyp auf Microsoft SQL Server Analysis Servicesfest. Geben Sie den Perspektivennamen in der cube= -Einstellung an. Weitere Informationen finden Sie unter Perspektiven in tabellarischen Modellen. |
Azure Analysis Services | Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks |
Legen Sie den Datenquellentyp auf Microsoft SQL Server Analysis Servicesfest. Weitere Informationen finden Sie unter Microsoft SQL Server Analysis Services – Datenverarbeitungserweiterung. |
Oracle-Server | Data Source=<host> |
Legen Sie den Datenquellentyp auf Oraclefest. Auf dem Computer mit Berichts-Designer und auf dem Berichtsserver müssen die Oracle-Clienttools installiert sein. Weitere Informationen finden Sie unter Oracle-Verbindungstyp (SSRS & Power BI-Berichtsserver). |
SAP NetWeaver BI-Datenquelle | Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla |
Legen Sie den Datenquellentyp auf SAP NetWeaver BIfest. Weitere Informationen finden Sie unter SAP NetWeaver BI-Verbindungstyp (SSRS). |
Hyperion Essbase-Datenquelle | Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample |
Legen Sie den Datenquellentyp auf Hyperion Essbasefest. Weitere Informationen finden Sie unter Hyperion Essbase-Verbindungstyp (SSRS). |
Teradata-Datenquelle | Data Source=<NNN>.<NNN>.<NNN>.<NNN>; |
Legen Sie den Datenquellentyp auf Teradatafest. Die Verbindungszeichenfolge ist eine IP-Adresse in Form von vier Feldern, wobei jedes Feld ein bis drei Ziffern aufweisen kann. Weitere Informationen finden Sie unter Teradataverbindungstyp (SSRS). |
Teradata-Datenquelle | Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True |
Legen Sie den Datenquellentyp auf Teradatafest, ähnlich dem vorherigen Beispiel. Verwenden Sie nur die Standarddatenbank, die im Database -Tag angegeben wird, und ermitteln Sie nicht automatisch Datenbeziehungen. |
XML-Datenquelle, Webdienst | data source=https://adventure-works.com/results.aspx |
Legen Sie den Datenquellentyp auf XMLfest. Die Verbindungszeichenfolge ist eine URL für einen Webdienst, der Webdienste-Definitionssprache (WSDL) unterstützt. Weitere Informationen finden Sie unter XML-Verbindungstyp (SSRS). |
XML-Datenquelle, XML-Dokument | https://localhost/XML/Customers.xml |
Legen Sie den Datenquellentyp auf XMLfest. Die Verbindungszeichenfolge besteht aus einer URL für das XML-Dokument. |
XML-Datenquelle, eingebettetes XML-Dokument | Leer | Legen Sie den Datenquellentyp auf XMLfest. Die XML-Daten sind in der Berichtsdefinition eingebettet. |
SharePoint-Liste | Data Source=https://MySharePointWeb/MySharePointSite/ |
Legen Sie den Datenquellentyp auf SharePoint-Listefest. |
Power BI Premium-Dataset (ab Reporting Services 2019 und Power BI-Berichtsserver im Januar 2020) | Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> |
Legen Sie den Datenquellentyp auf Microsoft SQL Server Analysis Servicesfest. |
Wenn Sie mittels localhost keine Verbindung zu einem Berichtsserver herstellen können, vergewissern Sie sich, dass das Netzwerkprotokoll für das TCP/IP-Protokoll aktiviert ist. Weitere Informationen finden Sie unter Konfigurieren von Clientprotokollen.
Weitere Informationen zu den Konfigurationen, die zum Herstellen einer Verbindung mit diesen Datenquellentypen erforderlich sind, finden Sie im spezifischen Datenverbindungsartikel unter Hinzufügen von Daten aus externen Datenquellen (SSRS) oder Von Reporting Services unterstützte Datenquellen (SSRS).
Sonderzeichen in Kennwörtern
Wenn Sie Ihre ODBC- oder SQL-Datenquelle mit einem Passwort konfigurieren, können Fehler mit Sonderzeichen auftreten. Wenn ein Benutzer das Passwort oder die Zeichenfolge mit Sonderzeichen, z. B. Satzzeichen, eingibt, können einige zugrunde liegende Datenquellentreiber diese Sonderzeichen nicht überprüfen. Beim Verarbeiten des Berichts kann die Meldung "Kein zulässiges Kennwort" auf dieses Problem hinweisen. Falls die Änderung des Kennworts unmöglich ist, können Sie mit dem Datenbankadministrator vereinbaren, dass die entsprechenden Anmeldeinformationen auf dem Server als Teil eines ODBC-System-Datenquellennamens (Data Source Name, DSN) gespeichert werden. Weitere Informationen finden Sie unter OdbcConnection.ConnectionString in der .NET Framework SDK-Dokumentation.
Auf Ausdrücken basierende Verbindungszeichenfolgen
Auf Ausdrücken beruhende Verbindungszeichenfolgen werden zur Laufzeit ausgewertet. Sie können beispielsweise die Datenquelle als Parameter angeben, den Parameterverweis in die Verbindungszeichenfolge einbinden und dem Benutzer das Auswählen einer Datenquelle für den Bericht gestatten. Nehmen Sie beispielsweise an, ein multinationales Unternehmen verfügt über Datenserver in verschiedenen Ländern/Regionen. Mit einer ausdrucksbasierten Verbindungszeichenfolge kann ein Benutzer, der einen Umsatzbericht ausführt, vor der Ausführung des Berichts eine Datenquelle für ein bestimmtes Land/eine bestimmte Region auswählen.
Im folgenden Beispiel wird die Verwendung eines Datenquellenausdrucks in einer SQL Server-Verbindungszeichenfolge veranschaulicht. Für das Beispiel wird vorausgesetzt, dass Sie einen Berichtsparameter mit dem Namen ServerName
erstellt haben:
="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"
Datenquellenausdrücke werden zur Laufzeit oder beim Anzeigen einer Berichtsvorschau verarbeitet. Der Ausdruck muss in Visual Basic geschrieben sein. Halten Sie sich an die folgenden Richtlinien, wenn Sie einen Datenquellenausdruck definieren:
Entwerfen Sie den Bericht mithilfe einer statischen Verbindungszeichenfolge. Eine statische Verbindungszeichenfolge ist eine Verbindungszeichenfolge, die nicht über einen Ausdruck festgelegt wird. Wenn Sie beispielsweise die Schritte zum Erstellen einer berichtsspezifischen oder freigegebenen Datenquelle ausführen, definieren Sie eine statische Verbindungszeichenfolge. Die Verwendung einer statischen Verbindungszeichenfolge ermöglicht es Ihnen, im Berichts-Designer eine Verbindung mit der Datenquelle herzustellen, damit Sie die Abfrageergebnisse abrufen können, die Sie zum Erstellen des Berichts benötigen.
Verwenden Sie keine freigegebene Datenquelle, wenn Sie die Datenquellenverbindung definieren. Es ist nicht möglich, einen Datenquellenausdruck in einer freigegebenen Datenquelle zu verwenden. Sie müssen eine eingebettete Datenquelle für den Bericht definieren.
Geben Sie die Anmeldeinformationen getrennt von der Verbindungszeichenfolge an. Sie können gespeicherte Anmeldeinformationen, auf Anforderung eingegebene Anmeldeinformationen oder die integrierte Sicherheit verwenden.
Fügen Sie einen Berichtsparameter zum Angeben einer Datenquelle hinzu. Als Parameterwerte können Sie entweder eine statische Liste verfügbarer Werte angeben oder eine Abfrage definieren, die zur Laufzeit eine Liste mit Datenquellen abruft. In diesem Fall sollte es sich bei der statischen Liste der verfügbaren Werte um Datenquellen handeln, die Sie mit dem Bericht verwenden können.
Stellen Sie sicher, dass die Datenquellen in der Liste das gleiche Datenbankschema verwenden. Die Schemainformationen stellen den Ausgangspunkt bei jedem Berichtsentwurf dar. Wenn das Schema, das zum Definieren des Berichts verwendet wird, nicht mit dem Schema identisch ist, das zur Laufzeit vom Bericht verwendet wird, kann der Bericht möglicherweise nicht ausgeführt werden.
Ersetzen Sie die statische Verbindungszeichenfolge durch einen Ausdruck, bevor Sie den Bericht veröffentlichen. Ersetzen Sie die statische Verbindungszeichenfolge erst dann durch einen Ausdruck, wenn der Entwurf des Berichts vollständig abgeschlossen ist. Sobald Sie einen Ausdruck verwenden, können Sie die Abfrage nicht mehr im Berichts-Designer ausführen. Außerdem werden die Feldliste im Bereich Berichtsdaten und die Liste der Parameter nicht mehr automatisch aktualisiert.