SQL Azure Connection Type (SSRS)

In This Article

Connection String

Credentials

Queries

Parameters

Remarks

How-To Topics

Related Sections

Connection String

When you connect to SQL Azure, you are connecting to a database object in the cloud. Just like onsite databases, the hosted 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 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 hosted sample database named AdventureWorks.

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

In addition, you use the Data Sources Properties dialog box to provide credentials such as user name and password. 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.

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

Credentials

Windows Authentication (integrated security) is not supported. If you attempt to connect to SQL Azure using Windows Authentication an error occurs. SQL Azure supports only SQL Server Authentication (user name and password) and users must provide credentials (login and password) every time they connect to SQL Azure.

Credentials must be sufficient to access the database. Depending on your query, you might need other permissions, such as sufficient permissions to run stored procedures and access tables and views. 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.

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

• Use a stored user name and password. To negotiate the double hop that occurs when the database that contains the report data is different than the report server, select options to use credentials as Windows credentials. You can also chose to impersonate the authenticated user after connecting to the data source.

• No credentials are required. To use this option, you must have the unattended execution account configured on the report server. For more information, see Configuring 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 Specifying Credentials in Report Builder 3.0.

Back to Top

Queries

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. If the query returns multiple result sets, the report processes only the first result set that the query retrieves. Although there are some differences between SQL Server and SQL Azure databases such as the sizes of databases supported, writing queries against SQL Azure databases is similar to writing queries against SQL Server databases. Some Transact-SQL statements such as BACKUP are not supported in SQL Azure, but they are not ones that you use in report queries. For more information, see SQL Server Connection Type (SSRS).

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.

The text-based query designer supports the following two modes:

• Text   Type Transact-SQL commands that select data from the data source.

• Stored Procedure   Choose from a list of stored procedures.

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

Depending on the complexity of a query and the data that the query returns, the query might take a long time to complete. In this release of SQL Azure, idle connections and long running queries or transactions are closed after five minutes. Queries that require more than five minutes to complete will fail. It is recommended that you design report queries to be as efficient as possible when getting report data from SQL Azure.

The graphical query designer that SQL Azure uses provides built-in support for grouping and aggregates to help you write queries that retrieve only summary data. The Transact-SQL language features are: the GROUP BY clause, DISTINCT keyword, and aggregates such as SUM and COUNT. The text-based query designer provides full support for the Transact-SQL language, including grouping and aggregates. For more information about Transact-SQL, see Transact-SQL Reference (Database Engine)in SQL Server Books Online on msdn.microsoft.com.

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' 

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Using Query Type StoredProcedure

Parameters

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)

By default, each report parameter has data type Text and an automatically created dataset to provide a drop-down list of available values. After the report parameters are created, you might have to change default values. For more information, see Parameters (Report Builder 3.0 and SSRS).

Back to Top

Remarks

How-To Topics

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

How to: Add and Verify a Data Connection or Data Source (Report Builder 3.0 and SSRS)

How to: Create a Shared Dataset or Embedded Dataset (Report Builder 3.0 and SSRS)

How to: Add a Filter to a Dataset (Report Builder 3.0 and SSRS)

Back to Top

Related Sections

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.

• Adding Data to a Report (Report Builder 3.0 and SSRS)
  Provides an overview of accessing data for your report.

• Data Connections, Data Sources, and Connection Strings in Report Builder 3.0
  Provides information about data connections and data sources.

• Creating and Adding Datasets (Report Builder 3.0 and SSRS)
  Provides information about embedded and shared datasets.

• Working with Fields in a Report Dataset (Report Builder 3.0 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

See Also

Concepts