Connection String

Credentials

Queries

Parameters

Remarks

How-To Topics

Related Sections

When you connect to a SQL Server database, you are connecting to the database object in an instance of SQL Server on a server. The database might have multiple schemas that have multiple tables, views, and stored procedures. You specify the database object to use in the query designer. If you do not specify a database in the connection string, you connect to the default database that the database administrator assigned to you.

Contact your database administrator for connection information and for the credentials to use to connect to the data source. The following connection string example specifies a sample database on the local client:

Data Source=<server>;Initial Catalog=AdventureWorks

For more information about connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.

From a report authoring client, the following options are available to specify credentials:

• Current Windows user (also known as integrated security).

• Use a stored user name and password.

• Prompt the user for credentials. This option supports Windows integrated security only.

• No credentials are required. To use this option, you must have the unattended execution account configured on the report server. For more information, see Configure the Unattended Execution Account in the Reporting Services documentation in on msdn.microsoft.com.

For more information, see Data Connections, Data Sources, and Connection Strings (SSRS) or Specify Credentials in Report Builder.

Back to Top

A query specifies which data to retrieve for a report dataset. The columns in the result set for a query populate the field collection for a dataset. A report processes only the first result set that a query retrieves.

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. You can specify a query in the following ways:

• Build a query interactively. Use the relational query designer that displays a hierarchical view of tables, views, stored procedures, and other database items, organized by database schema. Select columns from tables or views, or specify stored procedures or table-valued functions. Limit the number of rows of data to retrieve by specifying filter criteria. Customize the filter when the report runs by setting the parameter option.

• Type or paste a query. Use the text-based query designer to enter Transact-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.

• Import an existing query from a file or report. Use the Import query button from either query designer to browse to a .sql file or .rdl file and import a query.

For more information, see Relational Query Designer User Interface (Report Builder) and Text-based Query Designer User Interface (Report Builder).

The following query modes are supported:

• Text   Type in Transact-SQL commands.

• Stored Procedure   Choose from a list of stored procedures.

Using Query Type Text

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' 

Using Query Type StoredProcedure

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. The query text must not include the DECLARE statement for each query variable.

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)

Report parameters are created with default property values that you might need to modify. For example:

• By default, each report parameter is data type Text. If the underlying data is a different data type, you must change the parameter data type.

• If you select the option for multivalued parameters, you must manually change the query to test whether values are part of a set by using the IN operator, for example, WHERE EmployeeID IN (@EmpID).

For more information, see Report Parameters (Report Builder and SSRS).

Back to Top

You can also retrieve data from a SQL Server database by using an OLE DB or ODBC data source type. For more information, see OLE DB Connection Type (SSRS) or ODBC Connection Type (SSRS).

This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Add and Verify a Data Connection or Data Source (Report Builder and SSRS)

Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Add a Filter to a Dataset (Report Builder and SSRS)

Back to Top

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.

Add Data to a Report (Report Builder and SSRS)

Provides an overview of accessing data for your report.

Data Connections, Data Sources, and Connection Strings in Report Builder

Provides information about data connections and data sources.

Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)

Provides information about embedded and shared datasets.

Dataset Fields Collection (Report Builder and SSRS)

Provides information about the dataset field collection generated by the query.

Data Sources Supported by Reporting Services (SSRS) in the Reporting Services documentation in SQL Server Books Online.

Provides in-depth information about platform and version support for each data extension.

Back to Top

Concepts

Verbindungszeichenfolge

Anmeldeinformationen

Abfragen

Parameter

Hinweise

Themen zur Vorgehensweise

Verwandte Abschnitte

Wenn Sie eine Verbindung mit einer SQL Server-Datenbank herstellen, stellen Sie eine Verbindung mit dem Datenbankobjekt in einer SQL Server-Instanz auf einem Server her. Für die Datenbank können mehrere Schemas mit mehreren Tabellen, Sichten und gespeicherten Prozeduren vorhanden sein. Sie geben das zu verwendende Datenbankobjekt im Abfrage-Designer an. Falls Sie in der Verbindungszeichenfolge keine Datenbank angeben, wird eine Verbindung mit der vom Datenbankadministrator zugewiesenen Standarddatenbank hergestellt.

Erfragen Sie die Verbindungsinformationen und die Anmeldeinformationen zum Herstellen einer Verbindung mit der Datenquelle bei Ihrem Datenbankadministrator. In der Verbindungszeichenfolge im folgenden Beispiel wird eine Beispieldatenbank auf dem lokalen Client angegeben:

Data Source=<server>;Initial Catalog=AdventureWorks

Weitere Informationen und Beispiele für Verbindungszeichenfolgen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-Generator.

Anmeldeinformationen sind erforderlich, um Abfragen auszuführen und den Bericht lokal oder vom Berichtsserver aus in der Vorschau anzuzeigen.

Nachdem Sie den Bericht veröffentlicht haben, müssen Sie eventuell die Anmeldeinformationen für die Datenquelle ändern, sodass die Berechtigungen zum Abrufen der Daten beim Ausführen des Berichts auf dem Berichtsserver gültig sind.

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

• Aktueller Windows-Benutzer (auch bekannt als integrierte Sicherheit).

• Verwendung eines gespeicherten Benutzernamens und eines gespeicherten Kennworts.

• Aufforderung zur Eingabe der Anmeldeinformationen. Diese Option unterstützt nur die integrierte Windows-Sicherheit.

• 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 in der Reporting Services-Dokumentation auf "msdn.microsoft.com".

Weitere Informationen finden Sie unter Datenverbindungen, Datenquellen und Verbindungszeichenfolgen (SSRS) oder Angeben von Anmeldeinformationen im Berichts-Generator.

Zurück zum Anfang

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. In Berichten wird nur das erste Resultset verarbeitet, das von einer Abfrage abgerufen wird.

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, 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.

• Importieren einer vorhandenen 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.

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

Die folgenden Abfragemodi werden unterstützt:

• Text   Geben Sie Transact-SQL-Befehle ein.

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

Verwenden des Abfragetyps "Text"

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' 

Verwenden des Abfragetyps "StoredProcedure"

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 EmpID erstellt:

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

Berichtsparameter werden mit Standardeigenschaftswerten erstellt, die Sie ggf. ändern müssen. Beispiel:

• Standardmäßig ist jeder Berichtsparameter vom Datentyp Text. Wenn die zugrunde liegenden Daten von einem anderen Datentyp sind, müssen Sie den Parameterdatentyp ändern.

• Wenn Sie die Option für mehrwertige Parameter aktivieren, müssen Sie die Abfrage manuell ändern, um mit dem IN-Operator zu überprüfen, ob Werte Teil eines Satzes sind, z. B. WHERE EmployeeID IN (@EmpID).

Weitere Informationen finden Sie unter Berichtsparameter (Berichts-Generator und SSRS).

Zurück zum Anfang

Mit einem OLE DB- oder einem ODBC-Datenquellentyp können Sie Daten auch aus einer SQL Server-Datenbank abrufen. Weitere Informationen finden Sie unter OLE-Datenbank-Verbindungstyp (SSRS) oder OBDC-Verbindungstyp (SSRS).

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

Hinzufügen und Prüfen einer Datenverbindung oder Datenquelle (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)

Zurück zum Anfang

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.

Hinzufügen von Daten zu einem Bericht (Berichts-Generator und SSRS)

Bietet eine Übersicht über den Zugriff auf Daten für den Bericht.

Datenverbindungen, Datenquellen und Verbindungszeichenfolgen in Berichts-Generator

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) in der Dokumentation zu Reporting Services in der SQL Server-Onlinedokumentation.

Enthält ausführliche Informationen zur Plattform- und Versionsunterstützung für die einzelnen Datenerweiterungen.

Zurück zum Anfang

Konzepte