SQL Azure-Verbindungstyp (SSRS)SQL Azure Connection Type (SSRS)

MicrosoftMicrosoft Azure SQL-DatenbankAzure SQL Database ist eine cloudbasierte, gehostete relationale Datenbank, die auf SQL ServerSQL Server -Technologien basiert. technologies. Wenn Sie Daten aus SQL-DatenbankSQL Database in den Bericht einschließen möchten, benötigen Sie ein Dataset, das auf einer Berichtsdatenquelle vom Typ " SQL-DatenbankSQL Database" basiert.To include data from SQL-DatenbankSQL Database in your report, you must have a dataset that is based on a report data source of type SQL-DatenbankSQL Database. Dieser integrierte Datenquellentyp basiert auf der SQL-DatenbankSQL Database -Datenerweiterung.This built-in data source type is based on the SQL-DatenbankSQL Database data extension. Verwenden Sie diesen Datenquellentyp, um eine Verbindung mit SQL-DatenbankSQL Databaseherzustellen und Daten abzurufen.Use this data source type to connect to and retrieve data from SQL-DatenbankSQL Database.

Diese Datenerweiterung unterstützt mehrwertige Parameter, Serveraggregate und getrennt von der Verbindungszeichenfolge verwaltete Anmeldeinformationen.This data extension supports multivalued parameters, server aggregates, and credentials managed separately from the connection string.

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

Hinweis

Legen Sie das Verbindungstimeout beim Öffnen einer Verbindung mit einer SQL-DatenbankSQL Databaseauf 30 Sekunden fest.When opening a connection to a SQL-DatenbankSQL Database, set the connection timeout to 30 seconds.

Weitere Informationen finden Sie unter Microsoft Azure SQL-Datenbank auf docs.microsoft.com.For more information, see Microsoft Azure SQL Database on docs.microsoft.com.

Verwenden Sie die Informationen in diesem Thema, um eine Datenquelle zu erstellen.Use the information in this topic to build a data source. Eine Schritt-für-Schritt-Anleitung finden Sie unter Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS)" basiert.For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

Verbindungszeichenfolge Connection String

Wenn Sie eine Verbindung mit SQL-DatenbankSQL Databaseherstellen, stellen Sie eine Verbindung mit einem Datenbankobjekt in der Wolke her.When you connect to SQL-DatenbankSQL Database, you are connecting to a database object in the cloud. Wie Onsitedatenbanken kann die gehostete Datenbank mehrere Schemas mit mehreren Tabellen, Sichten und gespeicherte Prozeduren enthalten.Just like onsite databases, the hosted database might have multiple schemas that have multiple tables, views, and stored procedures. Sie geben das zu verwendende Datenbankobjekt im Abfrage-Designer an.You specify the database object to use in the query designer. Falls Sie in der Verbindungszeichenfolge keine Datenbank angeben, wird eine Verbindung mit der vom Administrator zugewiesenen Standarddatenbank hergestellt.If you do not specify a database in the connection string, you connect to the default database that the administrator assigned to you.

Erfragen Sie bei Ihrem Datenbankadministrator die Verbindungsinformationen und die Anmeldeinformationen, die verwendet werden sollen, um eine Verbindung mit der Datenquelle herzustellen.Contact your database administrator for connection information and for the credentials to use to connect to the data source. In der Verbindungszeichenfolge im folgenden Beispiel wird eine gehostete Beispieldatenbank mit dem Namen AdventureWorks angegeben.The following connection string example specifies a hosted sample database named AdventureWorks.

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

Außerdem verwenden Sie das Dialogfeld Datenquelleneigenschaften , um Anmeldeinformationen wie Benutzername und Kennwort anzugeben.In addition, you use the Data Sources Properties dialog box to provide credentials such as user name and password. Die Optionen User Id und Password werden automatisch an die Verbindungszeichenfolge angefügt. Sie müssen nicht als Teil der Verbindungszeichenfolge eingegeben werden.The User Id and Password options are automatically appended to the connection string; you do not need to type them as part of the connection string.

Weitere Informationen sowie Beispiele für Verbindungszeichenfolgen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-Generator.For more information and connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Anmeldeinformationen Credentials

Die Windows-Authentifizierung (integrierte Sicherheit) wird nicht unterstützt.Windows Authentication (integrated security) is not supported. Wenn Sie versuchen, mithilfe der Windows-Authentifizierung eine Verbindung mit SQL-DatenbankSQL Database herzustellen, tritt ein Fehler auf.If you attempt to connect to SQL-DatenbankSQL Database using Windows Authentication an error occurs. SQL-DatenbankSQL Database 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-DatenbankSQL Databaseherstellen..

Die Anmeldeinformationen müssen über Zugriffsberechtigungen für die Datenbank verfügen.Credentials must be sufficient to access the database. 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.Depending on your query, you might need other permissions, such as sufficient permissions to run stored procedures and access tables and views. Der Besitzer der externen Datenquelle muss entsprechende Anmeldeinformationen konfigurieren, die Lesezugriff auf die benötigten Datenbankobjekte gewähren.The owner of the external data source must configure credentials that are sufficient to provide read-only access to the database objects that you need.

Auf einem Berichterstellungsclient sind die folgenden Optionen zum Angeben von Anmeldeinformationen verfügbar:From a report authoring client, the following options are available to specify credentials:

Abfragen Queries

Mit einer Abfrage wird angegeben, welche Daten für ein Berichtsdataset abgerufen werden sollen.A query specifies which data to retrieve for a report dataset. Die Feldauflistung für ein Dataset wird mit den Spalten aus dem Resultset einer Abfrage aufgefüllt.The columns in the result set for a query populate the field collection for a dataset. Wenn die Abfrage mehrere Resultsets zurückgibt, verarbeitet der Bericht nur das erste Resultset, das durch eine Abfrage abgerufen wird.If the query returns multiple result sets, the report processes only the first result set that the query retrieves. Obwohl einige Unterschiede zwischen SQL ServerSQL Server und SQL-DatenbankSQL Databasebestehen, z. B. die Größe unterstützter Datenbanken, ähnelt das Schreiben von Abfragen für SQL-DatenbankSQL Databaseweitgehend dem Schreiben von Abfragen für SQL ServerSQL Server -Datenbanken.Although there are some differences between SQL ServerSQL Server and SQL-DatenbankSQL Databases such as the sizes of databases supported, writing queries against SQL-DatenbankSQL Databases is similar to writing queries against SQL ServerSQL Server databases. Einige Transact-SQLTransact-SQL -Anweisungen (z. B. BACKUP) werden nicht in SQL-DatenbankSQL Databaseunterstützt. Diese Anweisungen werden allerdings nicht in Berichtsabfragen verwendet.Some Transact-SQLTransact-SQL statements such as BACKUP are not supported in SQL-DatenbankSQL Database, but they are not ones that you use in report queries. Weitere Informationen finden Sie unter SQL Server-Verbindungstyp (SSRS).For more information, see SQL Server Connection Type (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.By default, if you create a new query or open an existing query that can be represented in the graphical query designer, the relational query designer is available. Zum Angeben einer Abfrage stehen Ihnen folgende Methoden zur Auswahl:You can specify a query in the following ways:

  • Erstellen Sie eine Abfrage interaktiv.Build a query interactively. Verwenden Sie den relationalen Abfrage-Designer, der eine hierarchische Ansicht der Tabellen, Sichten, gespeicherten Prozeduren und anderen Datenbankelemente nach Datenbankschema angeordnet anzeigt.Use the relational query designer that displays a hierarchical view of tables, views, stored procedures, and other database items, organized by database schema. Wählen Sie Spalten aus Tabellen oder Sichten aus, oder geben Sie gespeicherte Prozeduren oder Tabellenwertfunktionen an.Select columns from tables or views, or specify stored procedures or table-valued functions. Begrenzen Sie die Anzahl abzurufender Datenzeilen durch Angabe von Filterkriterien.Limit the number of rows of data to retrieve by specifying filter criteria. Passen Sie den Filter an, wenn der Bericht ausgeführt wird, indem Sie die Parameteroption festlegen.Customize the filter when the report runs by setting the parameter option.

  • Geben Sie eine Abfrage ein, oder fügen Sie sie ein.Type or paste a query. Verwenden Sie den textbasierten Abfrage-Designer, um Transact-SQLTransact-SQL -Text direkt einzugeben, Abfragetext aus einer anderen Quelle einzufügen, komplexe Abfragen einzugeben, die mit dem relationalen Abfrage-Designer nicht erstellt werden können, oder um abfragebasierte Ausdrücke einzugeben.Use the text-based query designer to enter Transact-SQLTransact-SQL text directly, to paste query text from another source, to enter complex queries that cannot be built by using the relational query designer, or to enter query-based expressions.

  • Importiert eine vorhandene Abfrage aus einer Datei oder einem Bericht.Import an existing query from a file or report. 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.Use the Import query button from either query designer to browse to a .sql file or .rdl file and import a query.

    Der textbasierte Abfrage-Designer unterstützt die folgenden zwei Modi:The text-based query designer supports the following two modes:

  • Text Geben Sie Transact-SQLTransact-SQL -Befehle zur Auswahl von Daten aus der Datenquelle ein.Text Type Transact-SQLTransact-SQL commands that select data from the data source.

  • Gespeicherte Prozedur Treffen Sie in einer Liste von gespeicherten Prozeduren eine Auswahl.Stored Procedure Choose from a list of stored procedures.

    Weitere Informationen finden Sie unter Benutzeroberfläche des relationalen Abfrage-Designers (Berichts-Generator) und Benutzeroberfläche des textbasierten Abfrage-Designers (Berichts-Generator).For more information, see Relational Query Designer User Interface (Report Builder) and Text-based Query Designer User Interface (Report Builder).

    Der in SQL-DatenbankSQL Database 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.The graphical query designer that SQL-DatenbankSQL Database uses provides built-in support for grouping and aggregates to help you write queries that retrieve only summary data. Die Transact-SQLTransact-SQL -Sprachfunktionen sind die GROUP BY-Klausel, das DISTINCT-Schlüsselwort und Aggregate wie SUM und COUNT.The Transact-SQLTransact-SQL language features are: the GROUP BY clause, DISTINCT keyword, and aggregates such as SUM and COUNT. Der textbasierte Abfrage-Designer bietet vollständige Unterstützung für die Transact-SQLTransact-SQL-Sprache, einschließlich Gruppieren und Aggregate.The text-based query designer provides full support for the Transact-SQLTransact-SQL language, including grouping and aggregates. Weitere Informationen zu Transact-SQLTransact-SQL finden Sie unter Transact-SQL-Referenz (Datenbankmodul) in der SQL ServerSQL Server-Onlinedokumentation auf msdn.microsoft.com.For more information about Transact-SQLTransact-SQL, see Transact-SQL Reference (Database Engine)in SQL ServerSQL Server Books Online on msdn.microsoft.com.

Verwenden des Abfragetyps "Text" Using Query Type Text

Im textbasierten Abfrage-Designer geben Sie Transact-SQLTransact-SQL -Befehle ein, um die Daten in einem Dataset zu definieren.In the text-based query designer, you type Transact-SQLTransact-SQL commands to define the data in a dataset. Mit der folgenden Transact-SQLTransact-SQL -Abfrage werden z. B. die Namen aller Mitarbeiter ausgewählt, die Marketingassistenten sind:For example, the following Transact-SQLTransact-SQL query selects the names of all employees who are marketing assistants:

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.Click the Run button (!) on the toolbar to run the query and display a result set.

Um diese Abfrage zu parametrisieren, fügen Sie einen Abfrageparameter hinzu.To parameterize this query, add a query parameter. Beispiel: Ändern Sie die WHERE-Klausel wie folgt:For example, change the WHERE clause to the following:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)  

Bei der Ausführung der Abfrage werden automatisch Berichtsparameter erstellt, die den Abfrageparametern entsprechen.When you run the query, report parameters that correspond to query parameters are automatically created. Weitere Informationen finden Sie unter Abfrageparameter weiter unten in diesem Thema.For more information, see Query Parameters later in this topic.

Verwenden des Abfragetyps "StoredProcedure" Using Query Type StoredProcedure

Zum Angeben einer gespeicherte Prozedur für eine Datasetabfrage stehen Ihnen folgende Methoden zur Verfügung:You can specify a stored procedure for a dataset query in one of the following ways:

  • Legen Sie im Dialogfeld Dataseteigenschaften die Option Gespeicherte Prozedur fest.In the Dataset Properties dialog box, set the Stored Procedure option. Wählen Sie aus der Dropdownliste mit gespeicherten Prozeduren und Tabellenwertfunktionen aus.Choose from the drop-down list of stored procedures and table-valued functions.

  • Wählen Sie im relationalen Abfrage-Designer im Bereich Datenbanksicht eine gespeicherte Prozedur oder Tabellenwertfunktion aus.In the relational query designer, in the Database view pane, select a stored procedure or table-valued function.

  • Wählen Sie im textbasierten Abfrage-Designer StoredProcedure auf der Symbolleiste aus.In the text-based query designer, select StoredProcedure from the toolbar.

    Nachdem Sie eine gespeicherte Prozedur oder Tabellenwertfunktion gewählt haben, können Sie die Abfrage ausführen.After you select a stored procedure or table-valued function, you can run the query. Sie werden zur Eingabe von Eingabeparameterwerten aufgefordert.You will be prompted for input parameter values. Bei der Ausführung der Abfrage werden automatisch Berichtsparameter erstellt, die den Eingabeparametern entsprechen.When you run the query, report parameters that correspond to input parameters are automatically created. Weitere Informationen finden Sie unter Abfrageparameter weiter unten in diesem Thema.For more information, see Query Parameters later in this topic.

    Nur das erste Resultset wird unterstützt, das für eine gespeicherte Prozedur abgerufen wird.Only the first result set that is retrieved for a stored procedure is supported. Wenn eine gespeicherte Prozedur mehrere Resultsets zurückgibt, wird nur das erste Resultset verwendet.If a stored procedure returns multiple result sets, only the first one is used.

    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.If a stored procedure has a parameter that has a default value, you can access that value by using the DEFAULT keyword as a value for the parameter. 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.If the query parameter is linked to a report parameter, the user can type or select the word DEFAULT in the input box for the report parameter.

    Weitere Informationen zu gespeicherten Prozeduren finden Sie unter „Gespeicherte Prozeduren (Datenbankmodul)“ in der SQL Server-Onlinedokumentation auf msdn.microsoft.com.For more information about stored procedures, see "Stored Procedures (Database Engine)" in SQL Server Books Online on msdn.microsoft.com.

Parameter Parameters

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.When query text contains query variables or stored procedures that have input parameters, the corresponding query parameters for the dataset and report parameters for the report are automatically generated. Der Abfragetext darf keine DECLARE-Anweisung für jede Abfragevariable enthalten.The query text must not include the DECLARE statement for each query variable.

Durch die folgende SQL-Abfrage wird z. B. ein Berichtsparameter mit dem Namen EmpIDerstellt:For example, the following SQL query creates a report parameter named EmpID:

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.By default, each report parameter has data type Text and an automatically created dataset to provide a drop-down list of available values. Die Standardwerte müssen möglicherweise nach dem Erstellen der Berichtsparameter geändert werden.After the report parameters are created, you might have to change default values. Weitere Informationen finden Sie unter Berichtsparameter (Berichts-Generator und Berichts-Designer)" basiert.For more information, see Report Parameters (Report Builder and Report Designer).

Hinweise Remarks

Alternative DatenerweiterungenAlternate Data Extensions

Sie können mit einem ODBC-Datenquellentyp auch aus einer SQL ServerSQL Server -Datenbank Daten abrufen.You can also retrieve data from a SQL ServerSQL Server database by using an ODBC data source type. Das Herstellen einer Verbindung mit SQL-DatenbankSQL Database über OLE DB wird nicht unterstützt.Connecting to SQL-DatenbankSQL Database by using OLE DB is not supported.

Weitere Informationen finden Sie unter ODBC-Verbindungstyp (SSRS).For more information, see ODBC Connection Type (SSRS).

Plattform- und VersionsinformationenPlatform and Version Information

Weitere Informationen zur Unterstützung einzelner Plattformen und Versionen finden Sie unter Von Reporting Services unterstützte Datenquellen (SSRS) in der Reporting ServicesReporting Services-Dokumentation der SQL ServerSQL Server-Onlinedokumentation.For more information about platform and version support, see Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.

Themen zur Vorgehensweise How-To Topics

Dieser Abschnitt enthält schrittweise Anweisungen zum Arbeiten mit Datenverbindungen, Datenquellen und Datasets.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Erstellen eines freigegebenen Datasets oder eingebetteten Datasets (Berichts-Generator und SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Hinzufügen eines Filters zu einem Dataset (Berichts-Generator und SSRS)Add a Filter to a Dataset (Report Builder and 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.These sections of the documentation provide in-depth conceptual information about report data, and procedural information about how to define, customize, and use parts of a report that are related to data.

Berichtsdatasets (SSRS)Report Datasets (SSRS)
Bietet eine Übersicht über den Zugriff auf Daten für den Bericht.Provides an overview of accessing data for your report.

Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-GeneratorData Connections, Data Sources, and Connection Strings in Report Builder
Enthält Informationen zu Datenverbindungen und Datenquellen.Provides information about data connections and data sources.

Erstellen von Berichten zu eingebetteten und freigegebenen Datasets (Berichts-Generator und SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Enthält Informationen zu eingebetteten und freigegebenen Datasets.Provides information about embedded and shared datasets.

Datasetfeld-Sammlung (Berichts-Generator und SSRS)Dataset Fields Collection (Report Builder and SSRS)
Enthält Informationen zur von der Abfrage generierten Datasetfeldauflistung.Provides information about the dataset field collection generated by the query.

Von Reporting Services unterstützte Datenquellen (SSRS) in der Reporting ServicesReporting Services-Dokumentation der SQL ServerSQL Server-Onlinedokumentation.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Enthält ausführliche Informationen zur Plattform- und Versionsunterstützung für die einzelnen Datenerweiterungen.Provides in-depth information about platform and version support for each data extension.

Siehe auchSee Also

Microsoft Azure SQL-Datenbank auf docs.microsoft.comMicrosoft Azure SQL Database on docs.microsoft.com
Berichtsparameter (Berichts-Generator und Berichts-Designer) Report Parameters (Report Builder and Report Designer)
Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
Ausdrücke (Berichts-Generator und SSRS) Expressions (Report Builder and SSRS)
Weiteren Fragen wenden?More questions? Wiederholen Sie den Reporting Services-forumTry the Reporting Services forum