Azure SQL-Verbindungstyp (SSRS)

Microsoft Azure SQL-Datenbank ist eine cloudbasierte, gehostete relationale Datenbank, die auf SQL Server-Technologien basiert. Wenn Sie Daten aus SQL-Datenbank in den Bericht einschließen möchten, benötigen Sie ein Dataset, das auf einer Berichtsdatenquelle vom Typ " SQL-Datenbank" basiert. Dieser integrierte Datenquellentyp basiert auf der SQL-Datenbank -Datenerweiterung. Verwenden Sie diesen Datenquellentyp, um eine Verbindung mit SQL-Datenbankherzustellen und Daten abzurufen.

Diese Datenerweiterung unterstützt mehrwertige Parameter, Serveraggregate und getrennt von der Verbindungszeichenfolge verwaltete Anmeldeinformationen.

SQL-Datenbank mit einer vor Ort installierten Instanz von SQL Server und dem Abrufen von Daten aus SQL-Datenbank vergleichbar. Die Vorgehensweise entspricht dem Abrufen von Daten aus SQL Server.

Hinweis

Legen Sie das Verbindungstimeout beim Öffnen einer Verbindung mit einer SQL-Datenbankauf 30 Sekunden fest.

Weitere Informationen finden Sie unter Microsoft Azure SQL-Datenbank.

Verwenden Sie die Informationen in diesem Thema, um eine Datenquelle zu erstellen. Eine Schritt-für-Schritt-Anleitung finden Sie unter Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS).

Verbindungszeichenfolge

Wenn Sie eine Verbindung mit SQL-Datenbank herstellen, stellen Sie eine Verbindung mit einem Datenbankobjekt in der Cloud her. Wie Onsitedatenbanken kann die gehostete Datenbank mehrere Schemas mit mehreren Tabellen, Sichten und gespeicherte Prozeduren enthalten. Sie geben das zu verwendende Datenbankobjekt im Abfrage-Designer an. Wenn Sie in der Verbindungszeichenfolge keine Datenbank angeben, wird eine Verbindung mit der Standarddatenbank hergestellt, die Ihnen vom Administrator zugewiesen wurde.

Erfragen Sie bei Ihrem Datenbankadministrator die Verbindungsinformationen und die Anmeldeinformationen, die verwendet werden sollen, um eine Verbindung mit der Datenquelle herzustellen. In der Verbindungszeichenfolge im folgenden Beispiel wird eine gehostete Beispieldatenbank mit dem Namen AdventureWorks angegeben.

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;  

Außerdem verwenden Sie das Dialogfeld Datenquelleneigenschaften, um Anmeldeinformationen wie Benutzername und Kennwort anzugeben. Die Optionen User Id und Password werden automatisch an die Verbindungszeichenfolge angefügt, sie müssen nicht als Teil der Verbindungszeichenfolge eingegeben werden.

Weitere Informationen und Beispiele für Verbindungszeichenfolgen finden Sie unter Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS).

Anmeldeinformationen

Die Windows-Authentifizierung (integrierte Sicherheit) wird nicht unterstützt. Wenn Sie versuchen, mithilfe der Windows-Authentifizierung eine Verbindung mit SQL-Datenbank herzustellen, tritt ein Fehler auf. SQL-Datenbank unterstützt nur die SQL Server-Authentifizierung (Benutzername und Kennwort). Benutzer müssen daher jedes Mal Anmeldeinformationen (Benutzername und Kennwort) eingeben, wenn sie eine Verbindung mit SQL-Datenbankherstellen.

Die Anmeldeinformationen müssen über Zugriffsberechtigungen für die Datenbank verfügen. Abhängig von der Abfrage benötigen Sie u. U. andere Berechtigungen, z. B. Berechtigungen für die Ausführung von gespeicherten Prozeduren und den Zugriff auf Tabellen und Sichten. Der Besitzer der externen Datenquelle muss entsprechende Anmeldeinformationen konfigurieren, die Lesezugriff auf die benötigten Datenbankobjekte gewähren.

Auf einem Berichterstellungsclient sind die folgenden Optionen zum Angeben von Anmeldeinformationen verfügbar:

  • Verwendung eines gespeicherten Benutzernamens und eines gespeicherten Kennworts. Aktivieren Sie Optionen zur Verwendung der Anmeldeinformationen als Windows-Anmeldeinformationen, um den doppelten Sprung auszuhandeln, der auftritt, wenn sich die Datenbank mit den Berichtsdaten vom Berichtsserver unterscheidet. Sie können auch die Identität des authentifizierten Benutzers annehmen, nachdem die Verbindung mit der Datenquelle hergestellt wurde.

  • Anmeldeinformationen sind nicht erforderlich. Zur Verwendung dieser Option müssen Sie zuvor das Konto für die unbeaufsichtigte Ausführung auf dem Berichtsserver konfigurieren. Weitere Informationen finden Sie unter Konfigurieren des Kontos für die unbeaufsichtigte Ausführung (Berichtsserver-Konfigurations-Manager).

Weitere Informationen finden Sie unter Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS) oder Angeben der Anmeldeinformationen und Verbindungsinformationen für Berichtsdatenquellen.

Abfragen

Mit einer Abfrage wird angegeben, welche Daten für ein Berichtsdataset abgerufen werden sollen. Die Feldauflistung für ein Dataset wird mit den Spalten aus dem Resultset einer Abfrage aufgefüllt. Wenn die Abfrage mehrere Resultsets zurückgibt, verarbeitet der Bericht nur das erste Resultset, das durch eine Abfrage abgerufen wird. Obwohl einige Unterschiede zwischen SQL Server und SQL-Datenbankbestehen, z. B. die Größe unterstützter Datenbanken, ähnelt das Schreiben von Abfragen für SQL-Datenbankweitgehend dem Schreiben von Abfragen für SQL Server -Datenbanken. Einige Transact-SQL-Anweisungen (z. B. BACKUP) werden in SQL-Datenbank nicht unterstützt. Diese Anweisungen werden allerdings in Berichtsabfragen nicht verwendet. Weitere Informationen finden Sie unter SQL Server-Verbindungstyp (SSRS).

Wenn Sie eine neue Abfrage erstellen oder eine vorhandene Abfrage öffnen, die im grafischen Abfrage-Designer dargestellt werden kann, ist der relationale Abfrage-Designer standardmäßig verfügbar. Zum Angeben einer Abfrage stehen Ihnen folgende Methoden zur Auswahl:

  • Erstellen Sie eine Abfrage interaktiv. Verwenden Sie den relationalen Abfrage-Designer, der eine hierarchische Ansicht der Tabellen, Sichten, gespeicherten Prozeduren und anderen Datenbankelemente nach Datenbankschema angeordnet anzeigt. Wählen Sie Spalten aus Tabellen oder Sichten aus, oder geben Sie gespeicherte Prozeduren oder Tabellenwertfunktionen an. Begrenzen Sie die Anzahl abzurufender Datenzeilen durch Angabe von Filterkriterien. Passen Sie den Filter an, wenn der Bericht ausgeführt wird, indem Sie die Parameteroption festlegen.

  • Geben Sie eine Abfrage ein, oder fügen Sie sie ein. Verwenden Sie den textbasierten Abfrage-Designer, um Transact-SQL-Text direkt einzugeben, um Abfragetext aus einer anderen Quelle einzufügen, um komplexe Abfragen einzugeben, die mit dem relationalen Abfrage-Designer nicht erstellt werden können, oder um abfragebasierte Ausdrücke einzugeben.

  • Importiert eine vorhandene Abfrage aus einer Datei oder einem Bericht. Verwenden Sie die Schaltfläche Abfrage importieren in einem Abfrage-Designer, um nach einer SQL- oder RDL-Datei zu suchen und eine Abfrage zu importieren.

Der textbasierte Abfrage-Designer unterstützt die folgenden zwei Modi:

  • Text Geben Sie Transact-SQL-Befehle zur Auswahl von Daten aus der Datenquelle ein.

  • Gespeicherte Prozedur Treffen Sie in einer Liste von gespeicherten Prozeduren eine Auswahl.

Weitere Informationen finden Sie unter Benutzeroberfläche des relationalen Abfrage-Designers (Berichts-Generator) und Benutzeroberfläche des textbasierten Abfrage-Designers (Berichts-Generator).

Der in SQL-Datenbank verwendete grafische Abfrage-Designer bietet integrierte Unterstützung für das Gruppieren und für Aggregate, sodass Sie Abfragen schreiben können, durch die nur Zusammenfassungsdaten abgerufen werden. Die Transact-SQL-Sprachfunktionen sind die GROUP BY-Klausel, das DISTINCT-Schlüsselwort und Aggregate wie SUM und COUNT. Der textbasierte Abfrage-Designer bietet vollständige Unterstützung für die Transact-SQL-Sprache, einschließlich Gruppieren und Aggregate. Weitere Informationen zu Transact-SQL finden Sie unter Transact-SQL-Referenz (Datenbank-Engine).

Verwenden des Abfragetyps "Text"

Im textbasierten Abfrage-Designer geben Sie Transact-SQL-Befehle ein, um die Daten in einem Dataset zu definieren. Mit der folgenden Transact-SQL-Abfrage werden z. B. die Namen aller Mitarbeiter ausgewählt, die Marketingassistenten sind:

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'   

Klicken Sie auf der Symbolleiste auf die Schaltfläche Ausführen ( ! ), um die Abfrage auszuführen und ein Resultset anzuzeigen.

Um diese Abfrage zu parametrisieren, fügen Sie einen Abfrageparameter hinzu. Beispiel: Ändern Sie die WHERE-Klausel wie folgt:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)  

Bei der Ausführung der Abfrage werden automatisch Berichtsparameter erstellt, die den Abfrageparametern entsprechen. Weitere Informationen finden Sie unter Abfrageparameter weiter unten in diesem Thema.

Verwenden des Abfragetyps "StoredProcedure"

Zum Angeben einer gespeicherte Prozedur für eine Datasetabfrage stehen Ihnen folgende Methoden zur Verfügung:

  • Legen Sie im Dialogfeld Dataseteigenschaften die Option Gespeicherte Prozedur fest. Wählen Sie aus der Dropdownliste mit gespeicherten Prozeduren und Tabellenwertfunktionen aus.

  • Wählen Sie im relationalen Abfrage-Designer im Bereich Datenbanksicht eine gespeicherte Prozedur oder Tabellenwertfunktion aus.

  • Wählen Sie im textbasierten Abfrage-Designer StoredProcedure auf der Symbolleiste aus.

Nachdem Sie eine gespeicherte Prozedur oder Tabellenwertfunktion gewählt haben, können Sie die Abfrage ausführen. Sie werden zur Angabe von Eingabeparameterwerten aufgefordert. Bei der Ausführung der Abfrage werden automatisch Berichtsparameter erstellt, die den Eingabeparametern entsprechen. Weitere Informationen finden Sie unter Abfrageparameter weiter unten in diesem Thema.

Nur das erste Resultset wird unterstützt, das für eine gespeicherte Prozedur abgerufen wird. Wenn eine gespeicherte Prozedur mehrere Resultsets zurückgibt, wird nur das erste Resultset verwendet.

Falls eine gespeicherte Prozedur einen Parameter mit einem Standardwert enthält, können Sie auf diesen Wert zugreifen, indem Sie das DEFAULT-Schlüsselwort als Wert für den Parameter verwenden. Wenn der Abfrageparameter mit einem Berichtsparameter verknüpft ist, kann der Benutzer das Wort DEFAULT im Eingabefeld für den Berichtsparameter eingeben oder auswählen.

Weitere Informationen zum Aufrufen von gespeicherten Prozeduren finden Sie unter Gespeicherte Prozeduren (Datenbank-Engine).

Parameter

Wenn Abfragetext Abfragevariablen oder gespeicherte Prozeduren mit Eingabeparametern enthält, werden die entsprechenden Abfrageparameter für das Dataset und Berichtsparameter für den Bericht automatisch generiert. Der Abfragetext darf keine DECLARE-Anweisung für jede Abfragevariable enthalten.

Durch die folgende SQL-Abfrage wird z. B. ein Berichtsparameter mit dem Namen EmpIDerstellt:

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)  

Jeder Berichtsparameter ist standardmäßig vom Datentyp "Text" und verfügt über ein automatisch erstelltes Dataset, mit dem eine Dropdownliste verfügbarer Werte bereitgestellt wird. Die Standardwerte müssen möglicherweise nach dem Erstellen der Berichtsparameter geändert werden. Weitere Informationen finden Sie unter Berichtsparameter (Berichts-Generator und Berichts-Designer).

Hinweise

Alternative Datenerweiterungen

Sie können mit einem ODBC-Datenquellentyp auch aus einer SQL Server -Datenbank Daten abrufen. Das Herstellen einer Verbindung mit SQL-Datenbank über OLE DB wird nicht unterstützt.

Weitere Informationen finden Sie unter ODBC-Verbindungstyp (SSRS).

Plattform- und Versionsinformationen

Weitere Informationen zur Plattform- und Versionsunterstützung finden Sie unter Von Reporting Services unterstützte Datenquellen (SSRS).

Azure SQL-Datenbank und Microsoft Entra ID

Sie können die Azure SQL-Datenbank mit Microsoft Entra ID (früher Azure Active Directory) verwenden.

Dieses Szenario wird unterstützt, wenn Sie die folgenden Elemente ordnungsgemäß einrichten:

Themen zur Vorgehensweise

Dieser Abschnitt enthält schrittweise Anweisungen zum Arbeiten mit Datenverbindungen, Datenquellen und Datasets.

Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS)

Erstellen eines freigegebenen Datasets oder eingebetteten Datasets (Berichts-Generator und SSRS)

Hinzufügen eines Filters zu einem Dataset (Berichts-Generator und SSRS)

Diese Abschnitte der Dokumentation enthalten umfassende grundlegende Informationen zu Berichtsdaten und Informationen zum Definieren, Entwerfen, Anpassen und Verwenden der mit Daten zusammenhängenden Teile eines Berichts.

Berichtsdatasets (SSRS)
Bietet eine Übersicht über den Zugriff auf Daten für den Bericht.

Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS)
Enthält Informationen zu Datenverbindungen und Datenquellen.

Erstellen von Berichten zu eingebetteten und freigegebenen Datasets (Berichts-Generator und SSRS)
Enthält Informationen zu eingebetteten und freigegebenen Datasets.

Datasetfeldauflistung (Berichts-Generator und SSRS)
Enthält Informationen zur von der Abfrage generierten Datasetfeldauflistung.

Von Reporting Services unterstützte Datenquellen (SSRS).
Enthält ausführliche Informationen zur Plattform- und Versionsunterstützung für die einzelnen Datenerweiterungen.

Weitere Informationen

Microsoft Azure SQL-Datenbank
Berichtsparameter (Berichts-Generator und Berichts-Designer)
Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS)
Ausdrücke (Berichts-Generator und SSRS)