Interfaccia utente di Progettazione query basata su testo (Generatore report 3.0)
La finestra Progettazione query basata su testo consente di specificare una query tramite il linguaggio di query supportato dall'origine dei dati, eseguire la query e visualizzare i risultati in fase di progettazione. È possibile specificare più istruzioni Transact-SQL, la sintassi della query o dei comandi per estensioni per l'elaborazione dati personalizzata e query che vengono specificate come espressioni. 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.
.gif "Nota sulla sicurezza") Nota sulla sicurezza |
|---|
Gli utenti accedono alle origini dati quando creano ed eseguono query. È necessario concedere autorizzazioni minime per le origini dati, ad esempio autorizzazioni di sola lettura. |
Nella finestra Progettazione query basata su testo vengono visualizzati una barra degli strumenti e i due riquadri seguenti:
**Query **Mostra il testo della query e il nome della stored procedure o della tabella, a seconda del tipo di query. Non tutti i tipi di query sono disponibili per tutti i tipi di origine dati. Il nome tabella, ad esempio, è supportato solo per le origini dati di tipo OLE DB.
**Risultati **Consente di visualizzare i risultati della query eseguita in fase di progettazione.
Barra degli strumenti della finestra Progettazione query basata su testo
La finestra Progettazione query basata su testo include una sola barra degli strumenti per tutti i tipi di comandi. Nella tabella seguente sono elencati tutti i pulsanti contenuti nella barra degli strumenti con la rispettiva funzione.
Pulsante |
Descrizione |
|---|---|
Modifica come testo |
Consente di passare dalla finestra Progettazione query basata su testo alla finestra con interfaccia grafica e viceversa. Le finestre di progettazione query con interfaccia grafica non sono supportate da tutti i tipi di origine dati. |
Importa |
Consente di importare una query esistente da un file o un report. Sono supportati solo i tipi di file con estensione sql e rdl. |
.gif "Esecuzione della query") |
Consente di eseguire la query e di visualizzare il set di risultati nel riquadro Risultati. |
Tipo di comando |
Selezionare Text, StoredProcedure o TableDirect. Se una stored procedure dispone di parametri, facendo clic su Esegui nella barra degli strumenti viene visualizzata la finestra di dialogo Definisci parametri query ed è possibile inserire i valori desiderati. .gif "Nota") Nota
Se una stored procedure restituisce più set di risultati, solo il primo set è utilizzato per popolare il set di dati.
|
Tipo di comando Text
Quando si crea un set di dati di SQL Server, per impostazione predefinita viene visualizzata la finestra Progettazione query relazionale. Per passare alla finestra Progettazione query basata su testo, fare clic sul pulsante Modifica come testo sulla barra degli strumenti. La finestra Progettazione query basata su testo include due riquadri, il riquadro Query e il riquadro Risultati. Nella figura seguente vengono etichettati tutti i riquadri.
.gif "Finestra Progettazione query standard per query di dati relazionali")
Nella tabella seguente viene descritta la funzione di ogni riquadro.
Riquadro |
Funzione |
|---|---|
Query |
Consente di visualizzare il testo della query Transact-SQL. Utilizzare questo riquadro per scrivere o modificare una query Transact-SQL. |
Risultati |
Consente di visualizzare i risultati della query. Per eseguire la query, fare clic con il pulsante destro del mouse su un riquadro qualsiasi e scegliere Esegui oppure fare clic sul pulsante Esegui sulla barra degli strumenti. |
Esempio
La query seguente restituisce l'elenco dei cognomi dalla tabella ContactType del database AdventureWorks2008R22008 per lo schema Person.
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. Il set di risultati visualizza un elenco di 20 tipi di contatti, ad esempio, Owner o Sales Agent.
Tipo di comando StoredProcedure
Quando si seleziona Tipo di comandoStoredProcedure, nella finestra Progettazione query basata su testo vengono visualizzati due riquadri, il riquadro Query e il riquadro Risultati. Immettere il nome della stored procedure nel riquadro Query e fare clic su Esegui sulla barra degli strumenti. Se la stored procedure utilizza parametri, verrà visualizzata la finestra di dialogo Definisci parametri query. Immettere i valori dei parametri per la stored procedure. Per ogni parametro di input della stored procedure viene creato un parametro del report.
Nella figura seguente vengono illustrati i riquadri Query e Risultati quando si esegue una stored procedure. In questo caso, i parametri di input sono costanti.
.gif "Stored procedure nella finestra Progettazione query basata su testo")
Nella tabella seguente viene descritta la funzione di ogni riquadro.
Riquadro |
Funzione |
|---|---|
Query |
Visualizza il nome della stored procedure e di qualsiasi parametro di input. |
Risultati |
Consente di visualizzare i risultati della query. Per eseguire la query, fare clic con il pulsante destro del mouse su un riquadro qualsiasi e scegliere Esegui oppure fare clic sul pulsante Esegui sulla barra degli strumenti. |
Esempio
La query seguente chiama la stored procedure uspGetWhereUsedProductID di AdventureWorks2008R22008. Quando si esegue la query, è necessario immettere un valore per il parametro del numero di identificazione del prodotto.
uspGetWhereUsedProductID
Fare clic sul pulsante Esegui (!). Quando vengono richiesti i parametri di query, utilizzare la tabella seguente per immettere i valori.
@StartProductID |
820 |
@CheckDate |
20010115 |
Per la data specificata, il set di risultati visualizza un elenco di 13 identificatori del prodotto che hanno utilizzato il numero del componente specificato.
Tipo di comando TableDirect
Quando si seleziona Tipo di comandoTableDirect, nella finestra Progettazione query basata su testo vengono visualizzati due riquadri, il riquadro Query e il riquadro Risultati. Se si inserisce una tabella e si fa clic sul pulsante Esegui, vengono restituite tutte le colonne della tabella.
Esempio
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 AdventureWorks2008R22008.
Person.ContactType
L'immissione del nome della tabella Person.ContactType, è equivalente alla creazione dell'istruzione SELECT * FROM Person.ContactType di Transact-SQL.
Vedere anche