Tipo di connessione SQL Server (SSRS)SQL Server Connection Type (SSRS)

Per includere dati da un database SQL ServerSQL Server in un report, è necessario disporre di un set di dati basato su un'origine dati del report di tipo MicrosoftMicrosoft SQL ServerSQL Server.To include data from a SQL ServerSQL Server database in your report, you must have a dataset that is based on a report data source of type MicrosoftMicrosoft SQL ServerSQL Server. Questo tipo di origine dati predefinito è basato sull'estensione per i dati di MicrosoftMicrosoft SQL ServerSQL Server .This built-in data source type is based on the MicrosoftMicrosoft SQL ServerSQL Server data extension. Questo tipo di origine dati può essere utilizzata per stabilire la connessione e recuperare dati dalla versione corrente e da versioni precedenti di database SQL ServerSQL Server .Use this data source type to connect to and retrieve data from the current version and earlier versions of SQL ServerSQL Server databases.

Questa estensione per i dati supporta parametri multivalore, aggregazioni server e credenziali gestiti separatamente dalla stringa di connessione.This data extension supports multivalue parameters, server aggregates, and credentials managed separately from the connection string.

Usare le informazioni presenti in questo argomento per compilare un'origine dati.Use the information in this topic to build a data source. Per istruzioni dettagliate, vedere Aggiungere e verificare una connessione dati (Generatore report e SSRS).For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

Stringa di connessione Connection String

Quando si effettua la connessione a un database SQL ServerSQL Server , ci si connette all'oggetto di database in un'istanza di SQL ServerSQL Server in un server.When you connect to a SQL ServerSQL Server database, you are connecting to the database object in an instance of SQL ServerSQL Server on a server. Il database potrebbe disporre di più schemi aventi più tabelle, viste e stored procedure.The database might have multiple schemas that have multiple tables, views, and stored procedures. L'oggetto di database viene specificato in Progettazione query.You specify the database object to use in the query designer. Se non si specifica un database nella stringa di connessione, la connessione viene eseguita al database predefinito assegnato dall'amministratore.If you do not specify a database in the connection string, you connect to the default database that the database administrator assigned to you.

Contattare l'amministratore del database per ottenere le informazioni di connessione e le credenziali da utilizzare per connettersi all'origine dati.Contact your database administrator for connection information and for the credentials to use to connect to the data source. Nella stringa di connessione di esempio seguente viene specificato un database di esempio nel client locale:The following connection string example specifies a sample database on the local client:

Data Source=<server>;Initial Catalog=AdventureWorks  

Per altre informazioni ed esempi di stringhe di connessione, vedere Connessioni dati, origini dati e stringhe di connessione in Generatore report.For more information about connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

Credenziali Credentials

Le credenziali sono necessarie per eseguire query, nonché per visualizzare l'anteprima del report in locale e dal server di report.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

Dopo aver pubblicato il report, potrebbe essere necessario modificare le credenziali per l'origine dati affinché quando il report viene eseguito nel server di report, le autorizzazioni per il recupero dei dati risultino valide.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.

Da un client di creazione di report sono disponibili le opzioni seguenti per la specifica delle credenziali:From a report authoring client, the following options are available to specify credentials:

Query Queries

Una query consente di specificare quali dati recuperare per un set di dati del report.A query specifies which data to retrieve for a report dataset. Le colonne nel set di risultati per una query popolano la raccolta dei campi per un set di dati.The columns in the result set for a query populate the field collection for a dataset. In un report viene elaborato solo il primo set di risultati recuperato da una query.A report processes only the first result set that a query retrieves.

Per impostazione predefinita, se si crea una nuova query o si apre una query esistente che può essere rappresentata nella finestra Progettazione query con interfaccia grafica, è disponibile la progettazione query relazionale.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. È possibile specificare una query nei modi seguenti:You can specify a query in the following ways:

  • Compilare una query in modo interattivo.Build a query interactively. Utilizzare la finestra Progettazione query relazionale in cui è visualizzata una vista gerarchica di tabelle, viste, stored procedure e altri elementi del database organizzati in base allo schema del database.Use the relational query designer that displays a hierarchical view of tables, views, stored procedures, and other database items, organized by database schema. Selezionare le colonne dalle tabelle o dalle viste o specificare le stored procedure o le funzioni con valori di tabella.Select columns from tables or views, or specify stored procedures or table-valued functions. Limitare il numero di righe di dati da recuperare specificando i criteri di filtro.Limit the number of rows of data to retrieve by specifying filter criteria. Personalizzare il filtro quando il report viene eseguito impostando l'opzione del parametro.Customize the filter when the report runs by setting the parameter option.

  • Digitare o incollare una query.Type or paste a query. Usare questa finestra per immettere direttamente testo Transact-SQLTransact-SQL , per incollare testo di query da un'altra origine, per immettere query complesse che non è possibile compilare usando la progettazione query relazionale o per immettere espressioni basate su query.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.

  • Consente di importare una query esistente da un file o un report.Import an existing query from a file or report. Utilizzare il pulsante Importa da una finestra Progettazione query per individuare un file con estensione sql o rdl e importare una query.Use the Import query button from either query designer to browse to a .sql file or .rdl file and import a query.

    Per altre informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report) e Interfaccia utente di Progettazione query basata su testo (Generatore report).For more information, see Relational Query Designer User Interface (Report Builder) and Text-based Query Designer User Interface (Report Builder).

    Sono supportate le modalità query seguenti:The following query modes are supported:

  • Testo Digitare nei comandi Transact-SQLTransact-SQL .Text Type in Transact-SQLTransact-SQL commands.

  • Stored procedure Scegliere da un elenco di stored procedure.Stored Procedure Choose from a list of stored procedures.

Utilizzo di query di tipo Text Using Query Type Text

Nella finestra Progettazione query basata su testo è possibile digitare i comandi Transact-SQLTransact-SQL per definire i dati in un set di dati.In the text-based query designer, you can type Transact-SQLTransact-SQL commands to define the data in a dataset. La query Transact-SQLTransact-SQL seguente, ad esempio, seleziona i nomi di tutti i dipendenti con mansioni di assistente marketing: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'   

Fare clic sul pulsante Esegui (!) sulla barra degli strumenti per eseguire la query e visualizzare il set di risultati.Click the Run button (!) on the toolbar to run the query and display a result set.

Per parametrizzare questa query, aggiungere un parametro di query.To parameterize this query, add a query parameter. Modificare ad esempio la clausola WHERE nella stringa seguente:For example, change the WHERE clause to the following:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)

Quando si esegue la query, i parametri del report corrispondenti ai parametri di query verranno creati automaticamente.When you run the query, report parameters that correspond to query parameters are automatically created. Per ulteriori informazioni, vedere Parametri di query di seguito in questo argomento.For more information, see Query Parameters later in this topic.

Utilizzo di query di tipo StoredProcedure Using Query Type StoredProcedure

È possibile specificare una stored procedure per una query del set di dati in uno dei seguenti modi:You can specify a stored procedure for a dataset query in one of the following ways:

  • Nella finestra di dialogo Proprietà set di dati , impostare l'opzione Stored procedure .In the Dataset Properties dialog box, set the Stored Procedure option. Scegliere dall'elenco a discesa di stored procedure e funzioni con valori di tabella.Choose from the drop-down list of stored procedures and table-valued functions.

  • Nel riquadro Vista di database della finestra Progettazione query relazionale, selezionare una stored procedure o una funzione con valori di tabella.In the relational query designer, in the Database view pane, select a stored procedure or table-valued function.

  • Nella finestra Progettazione query basata su testo, selezionare StoredProcedure sulla barra degli strumenti.In the text-based query designer, select StoredProcedure from the toolbar.

    Dopo aver selezionato una stored procedure o una funzione con valori di tabella, è possibile eseguire la query.After you select a stored procedure or table-valued function, you can run the query. Verranno richiesti i valori dei parametri di input.You will be prompted for input parameter values. Quando si esegue la query, i parametri del report corrispondenti ai parametri di input verranno creati automaticamente.When you run the query, report parameters that correspond to input parameters are automatically created. Per ulteriori informazioni, vedere Parametri di query di seguito in questo argomento.For more information, see Query Parameters later in this topic.

    È supportato solo il primo set di risultati recuperato per una stored procedure.Only the first result set that is retrieved for a stored procedure is supported. Se una stored procedure restituisce più set di risultati, viene utilizzato solo il primo.If a stored procedure returns multiple result sets, only the first one is used.

    Se in una stored procedure è presente un parametro con un valore predefinito, è possibile accedere a tale valore utilizzando la parola chiave DEFAULT come valore per il parametro.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. Se il parametro di query è collegato a un parametro di report, l'utente può digitare o selezionare la parola DEFAULT nella casella di input del parametro di report.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.

    Per altre informazioni, vedere "Stored procedure (Motore di database)" nella documentazione online di SQL Server nel sito msdn.microsoft.com.For more information, see "Stored Procedures (Database Engine)" in SQL Server Books Online on msdn.microsoft.com.

Parametri Parameters

Quando il testo della query contiene variabili di query o stored procedure con parametri di input, vengono generati automaticamente i parametri di query corrispondenti per il set di dati e i parametri di report per il report.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. Il testo della query non deve includere l'istruzione DECLARE per ogni variabile della query.The query text must not include the DECLARE statement for each query variable.

La query SQL seguente, ad esempio, crea un parametro di report denominato EmpID: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)  

I parametri di report vengono creati con valori di proprietà predefiniti che all'occorrenza possono essere modificati.Report parameters are created with default property values that you might need to modify. Esempio:For example:

  • Per impostazione predefinita, i dati di ogni parametro di report sono di tipo Text.By default, each report parameter is data type Text. Se i dati sottostanti sono di un tipo diverso, è necessario modificare il tipo di dati del parametri.If the underlying data is a different data type, you must change the parameter data type.

  • Se si seleziona l'opzione per i parametri multivalore, è necessario modificare manualmente la query per verificare se i valori fanno parte di un set tramite l'operatore IN , ad esempio WHERE EmployeeID IN (@EmpID).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).

    Per altre informazioni, vedere Parametri report (Generatore report e Progettazione report).For more information, see Report Parameters (Report Builder and Report Designer).

Osservazioni Remarks

È inoltre possibile recuperare dati da un database SQL ServerSQL Server tramite un tipo di origine dati OLE DB o ODBC.You can also retrieve data from a SQL ServerSQL Server database by using an OLE DB or ODBC data source type. Per altre informazioni, vedere Tipo di connessione OLE DB (SSRS) o Tipo di connessione ODBC (SSRS).For more information, see OLE DB Connection Type (SSRS) or ODBC Connection Type (SSRS).

Informazioni sulla piattaforma e sulla versionePlatform and Version Information

Per altre informazioni sul supporto della piattaforma e della versione, vedere Origini dati supportate da Reporting Services (SSRS) nella documentazione relativa a Reporting ServicesReporting Services inclusa nella documentazione online di SQL ServerSQL Server.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.

Procedure How-To Topics

In questa sezione sono contenute istruzioni dettagliate per l'utilizzo di connessioni dati, origini dati e set di dati.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

Aggiungere e verificare una connessione dati (Generatore report e SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

Creare un set di dati condiviso o un set di dati incorporato (Generatore report e SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

Aggiungere un filtro a un set di dati ( Generatore report e SSRS )Add a Filter to a Dataset (Report Builder and SSRS)

In queste sezioni della documentazione sono incluse informazioni concettuali approfondite sui dati dei report, nonché le procedure per definire, personalizzare e utilizzare parti di un report correlate ai dati.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.

Set di dati del report (SSRS)Report Datasets (SSRS)
Viene fornita una panoramica sull'accesso ai dati del report.Provides an overview of accessing data for your report.

Connessioni dati, origini dati e stringhe di connessione in Generatore ReportData Connections, Data Sources, and Connection Strings in Report Builder
Vengono fornite informazioni sulle connessioni dati e sulle origini dati.Provides information about data connections and data sources.

Report di set di dati incorporati e condivisi ( Generatore report e SSRS )Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
Vengono fornite informazioni sui set di dati incorporati e condivisi.Provides information about embedded and shared datasets.

Raccolta di campi del set di dati ( Generatore report e SSRS )Dataset Fields Collection (Report Builder and SSRS)
Vengono fornite informazioni sulla raccolta di campi di set di dati generata dalla query.Provides information about the dataset field collection generated by the query.

Origini dati supportate da Reporting Services (SSRS) nella documentazione relativa a Reporting ServicesReporting Services inclusa nella documentazione online di SQL ServerSQL Server.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
Vengono fornite informazioni dettagliate sul supporto delle piattaforme e delle versioni per ogni estensione per i dati.Provides in-depth information about platform and version support for each data extension.

Vedere ancheSee Also

I parametri di report ( Generatore report e progettazione Report ) Report Parameters (Report Builder and Report Designer)
Filtro, gruppo e ordinamento dei dati ( Generatore report e SSRS ) Filter, Group, and Sort Data (Report Builder and SSRS)
Espressioni ( Generatore report e SSRS )Expressions (Report Builder and SSRS)