Interfaccia utente di Progettazione query basata su testo (Generatore report)Text-based Query Designer User Interface (Report Builder)

La finestra Progettazione query basata su testo consente di specificare una query tramite il linguaggio di query supportato dall'origine dati, eseguire la query e visualizzare i risultati in fase di progettazione.Use the text-based query designer to specify a query using the query language supported by the data source, run the query, and view the results at design time. È possibile specificare più istruzioni Transact-SQLTransact-SQL , la sintassi della query o dei comandi per estensioni per l'elaborazione dati personalizzata e query che vengono specificate come espressioni.You can specify multiple Transact-SQLTransact-SQL statements, query or command syntax for custom data processing extensions, and queries that are specified as expressions. Poiché non esegue la pre-elaborazione della query e può gestire qualsiasi tipo di sintassi della query, la finestra Progettazione query basata su testo rappresenta lo strumento di progettazione query predefinito per molti tipi di origine dati.Because the text-based query designer does not preprocess the query and can accommodate any kind of query syntax, this is the default query designer tool for many data source types.

Importante

Gli utenti accedono alle origini dati quando creano ed eseguono query.Users access data sources when they create and run queries. È necessario concedere autorizzazioni minime per le origini dati, ad esempio autorizzazioni di sola lettura.You should grant minimal permissions on the data sources, such as read-only permissions.

Nella finestra Progettazione query basata su testo vengono visualizzati una barra degli strumenti e i due riquadri seguenti:The text-based query designer displays a toolbar and the following two panes:

  • Query Mostra il testo della query e il nome della tabella o della stored procedure, a seconda del tipo di query.Query Shows the query text, table name, or stored procedure name depending on the query type. Non tutti i tipi di query sono disponibili per tutti i tipi di origine dati.Not all query types are available for all data source types. Il nome tabella, ad esempio, è supportato solo per le origini dati di tipo OLE DB.For example, table name is supported only for the data source type OLE DB.

  • Risultato Consente di visualizzare i risultati della query eseguita in fase di progettazione.Result Shows the results of running the query at design time.

Barra degli strumenti di Progettazione query basata su testoText-based Query Designer Toolbar

La finestra Progettazione query basata su testo include una sola barra degli strumenti per tutti i tipi di comandi.The text-based query designer provides a single toolbar for all the command types. Nella tabella seguente sono elencati tutti i pulsanti contenuti nella barra degli strumenti con la rispettiva funzione.The following table lists each button on the toolbar and its function.

PulsanteButton DescriptionDescription
Modifica come testoEdit As Text Consente di passare dalla finestra Progettazione query basata su testo alla finestra Progettazione query con interfaccia grafica e viceversa.Toggle between the text-based query designer and the graphical query designer. Le finestre Progettazione query con interfaccia grafica non sono supportate da tutti i tipi di origine dati.Not all data source types support graphical query designers.
ImportaImport Consente di importare una query esistente da un file o un report.Import an existing query from a file or report. Sono supportati solo i tipi di file con estensione sql e rdl.Only file types sql and rdl are supported
Esecuzione della queryRun the query Consente di eseguire la query e di visualizzare il set di risultati nel riquadro Risultati.Run the query and display the result set in the Result pane.
Tipo di comandoCommand Type Selezionare Text, StoredProcedureo TableDirect.Select Text, StoredProcedure, or TableDirect. Se una stored procedure dispone di parametri, facendo clic su Esegui sulla barra degli strumenti viene visualizzata la finestra di dialogo Definisci parametri query ed è possibile inserire i valori desiderati.If a stored procedure has parameters, the Define Query Parameters dialog box appears when you click Run on the toolbar, and you can fill in values as needed. Il supporto per il tipo di comando varia in base al tipo di origine dati.Support for command type varies by data source type. Ad esempio, solo OLE DB e ODBC supportano TableDirect.For example, only OLE DB and ODBC support TableDirect.

Nota: se una stored procedure restituisce più set di risultati, solo il primo set viene usato per popolare il set di dati.Note: If a stored procedure returns more than one result set, only the first result set is used to populate the dataset.

Tipo di comando TextCommand Type Text

Quando si crea un set di dati di SQL ServerSQL Server , per impostazione predefinita viene visualizzata la finestra Progettazione query relazionale.When you create a SQL ServerSQL Server dataset, the relational query designer opens by default. Per passare alla finestra Progettazione query basata su testo, fare clic sul pulsante Modifica come testo sulla barra degli strumenti.To switch to the text-based query designer, click the Edit As Text toggle button on the toolbar. La finestra Progettazione query basata su testo include due riquadri, il riquadro Query e il riquadro Risultati.The text-based query designer presents two panes: the Query pane and the Result pane. Nella figura seguente vengono etichettati tutti i riquadri.The following figure labels each pane.

Finestra Progettazione query standard per query di dati relazionaliGeneric query designer, for relational data query

Nella tabella seguente viene descritta la funzione di ogni riquadro.The following table describes the function of each pane.

RiquadroPane FunzioneFunction
QueryQuery Consente di visualizzare il testo della query Transact-SQLTransact-SQL .Displays the Transact-SQLTransact-SQL query text. Usare questo riquadro per scrivere o modificare una query Transact-SQLTransact-SQL .Use this pane to write or edit a Transact-SQLTransact-SQL query.
RisultatoResult Consente di visualizzare i risultati della query.Displays the results of the query. Per eseguire la query, fare clic con il pulsante destro del mouse su un riquadro qualsiasi e scegliere Eseguioppure fare clic sul pulsante Esegui sulla barra degli strumenti.To run the query, right-click in any pane and click Run, or click the Run button on the toolbar.

EsempioExample

La query seguente restituisce l'elenco dei nomi dalla tabella ContactType del database AdventureWorks2014 per lo schema Person .The following query returns the list of names from the AdventureWorks2014 database ContactType table for the Person schema.

SELECT Name FROM Person.ContactType  

Quando si fa clic su Esegui sulla barra degli strumenti, il comando nel riquadro Query viene eseguito e i risultati vengono visualizzati nel riquadro Risultati .When you click Run on the toolbar, the command in the Query pane runs and the results are displayed in the Result pane. Il set di risultati visualizza un elenco di 20 tipi di contatti, ad esempio, Owner o Sales Agent.The resultset displays a list of 20 types of contacts, for example, Owner or Sales Agent.

Tipo di comando StoredProcedureCommand Type StoredProcedure

Quando si seleziona Tipo di comando StoredProcedure, la finestra Progettazione query basata su testo mostra due riquadri, il riquadro Query e il riquadro Risultati.When you select Command typeStoredProcedure, the text-based query designer presents two panes: the Query pane and the Result pane. Immettere il nome della stored procedure nel riquadro Query e fare clic su Esegui sulla barra degli strumenti.Enter the stored procedure name in the Query pane and click Run on the toolbar. Se la stored procedure usa parametri, verrà visualizzata la finestra di dialogo Definisci parametri query .If the stored procedures uses parameters, the Define Query Parameters dialog box opens. Immettere i valori dei parametri per la stored procedure.Enter the parameter values for the stored procedure. Per ogni parametro di input della stored procedure viene creato un parametro del report.A report parameter is created for every stored procedure input parameter.

Nella figura seguente vengono illustrati i riquadri Query e Risultati quando si esegue una stored procedure.The following figure shows the Query and Results panes when you run a stored procedure. In questo caso, i parametri di input sono costanti.In this case, the input parameters are constants.

Stored procedure in Progettazione query basata su testoStored procedure in text-based query designer

Nella tabella seguente viene descritta la funzione di ogni riquadro.The following table describes the function of each pane.

RiquadroPane FunzioneFunction
QueryQuery Visualizza il nome della stored procedure e di qualsiasi parametro di input.Displays the name of the stored procedure and any input parameters.
RisultatoResult Consente di visualizzare i risultati della query.Displays the results of the query. Per eseguire la query, fare clic con il pulsante destro del mouse su un riquadro qualsiasi e scegliere Eseguioppure fare clic sul pulsante Esegui sulla barra degli strumenti.To run the query, right-click in any pane and click Run, or click the Run button on the toolbar.

EsempioExample

La query seguente chiama la stored procedure di AdventureWorks2014 denominata uspGetWhereUsedProductID.The following query calls the AdventureWorks2014 stored procedure uspGetWhereUsedProductID. Quando si esegue la query, è necessario immettere un valore per il parametro del numero di identificazione del prodotto.You must enter a value for the product identification number parameter when you run the query.

uspGetWhereUsedProductID  

Fare clic sul pulsante Esegui (!).Click the Run (!) button. Quando vengono richiesti i parametri di query, utilizzare la tabella seguente per immettere i valori.When prompted for the query parameters, use the following table to enter values.

@StartProductID 820820
@CheckDate 2001011520010115

Per la data specificata, il set di risultati visualizza un elenco di 13 identificatori del prodotto che hanno utilizzato il numero del componente specificato.For the specified date, the result set displays a list of 13 product identifiers that used the specified component number.

Tipo di comando TableDirectCommand Type TableDirect

Quando si seleziona Tipo di comando TableDirect, la finestra Progettazione query basata su testo mostra due riquadri, il riquadro Query e il riquadro Risultati.When you select Command typeTableDirect, the text-based query designer presents two panes: the Query pane and the Result pane. Quando si immette una tabella e si fa clic sul pulsante Esegui , vengono restituite tutte le colonne della tabella.When you enter a table and click the Run button, all the columns for that table are returned.

EsempioExample

Per un'origine dati di tipo OLE DB, la query del set di dati riportata di seguito restituisce un set di risultati per tutti i tipi di contatto nel database AdventureWorks2014.For a data source type OLE DB, the following dataset query returns a result set for all contact types in the AdventureWorks2014 database.

Person.ContactType

L'immissione del nome della tabella Person.ContactType, è equivalente alla creazione dell'istruzione Transact-SQLTransact-SQL di SELECT * FROM Person.ContactType.When you enter the table name Person.ContactType, it is the equivalent of creating the Transact-SQLTransact-SQL statement SELECT * FROM Person.ContactType.

Vedere ancheSee Also

Interfaccia utente di Progettazione query relazionale (Generatore report) Relational Query Designer User Interface (Report Builder)
Finestre di progettazione query (Generatore report)Query Designers (Report Builder)