Tipo di connessione Azure SQL (SSRS)

Database SQL di Microsoft Azure è un servizio di database relazionale ospitato e basato sul cloud che si avvale delle tecnologie SQL Server. Per includere dati da un database SQL Server in un report, è necessario avere un set di dati basato su un'origine dati del report di tipo database SQL. Questo tipo di origine dati predefinito è basato sull'estensione per i dati del database SQL. Questo tipo di origine dati può essere utilizzato per connettersi e recuperare dati dal database SQL.

Questa estensione per i dati supporta parametri multivalore, aggregazioni server e credenziali gestiti separatamente dalla stringa di connessione.

Il database SQL è simile a un'istanza di SQL Server in locale e il recupero di dati da tale database è, con alcune eccezioni, identico al recupero dei dati da SQL Server.

Nota

Quando si apre una connessione a un database SQL, impostare il timeout di connessione su 30 secondi.

Per altre informazioni, vedere Database SQL di Microsoft Azure.

Usare le informazioni presenti in questo argomento per compilare un'origine dati. Per istruzioni dettagliate, vedere Aggiungere e verificare una connessione dati (Generatore report e SSRS).

Stringa di connessione

Quando ci si connette al database SQL, si esegue la connessione a un oggetto di database nel cloud. Proprio come i database in loco, il database di hosting potrebbe disporre di più schemi aventi più tabelle, viste e stored procedure. L'oggetto di database viene specificato in Progettazione query. Se non si specifica un database nella stringa di connessione, la connessione viene eseguita al database predefinito assegnato dall'amministratore.

Contattare l'amministratore del database per ottenere le informazioni di connessione e le credenziali da utilizzare per connettersi all'origine dati. Nella seguente stringa di connessione di esempio viene specificato un database di hosting di esempio denominato AdventureWorks.

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

Viene inoltre usata la finestra di dialogo Proprietà origini dati per fornire credenziali quale il nome utente e la password. Le opzioni User Id e Password vengono aggiunte automaticamente alla stringa di connessione; non è necessario digitarle come parte della stringa di connessione.

Per altre informazioni ed esempi di stringhe di connessione, vedere Creare stringhe di connessione dati - Generatore report e SSRS.

Titolo

L'autenticazione di Windows (sicurezza integrata) non è supportata. Se si tenta di connettersi al database SQL tramite l'autenticazione di Windows, si verificherà un errore. Il database SQL supporta solo l'autenticazione di SQL Server (nome utente e password) e gli utenti devono fornire le proprie credenziali (account di accesso e password) ogni volta che si connettono al database SQL.

Le credenziali devono essere sufficienti per accedere al database. A seconda della query, potrebbe essere necessario utilizzare altre autorizzazioni, ad esempio le autorizzazioni per eseguire stored procedure e accedere a tabelle e viste. Il proprietario dell'origine dati esterna deve configurare le credenziali sufficienti a fornire l'accesso in sola lettura agli oggetti di database di cui si necessita.

Da un client di creazione di report sono disponibili le opzioni seguenti per la specifica delle credenziali:

• Utilizzare un nome utente e una password archiviati. Per negoziare il doppio hop che si verifica quando il database contenente i dati del report è diverso dal server di report, selezionare le opzioni per utilizzare le credenziali come credenziali di Windows. È inoltre possibile scegliere di rappresentare l'utente autenticato dopo essersi connessi all'origine dati.

• Non sono necessarie credenziali. Per utilizzare questa opzione, è necessario aver configurato l'account di esecuzione automatica sul server di report. Per altre informazioni, vedere Configurare l'account di esecuzione automatica (Gestione configurazione Reporting Services).

Per altre informazioni, vedere Creare stringhe di connessione dati - Generatore report e SSRS o Specificare le credenziali e le informazioni sulla connessione per le origini dati del report.

Query

Una query consente di specificare quali dati recuperare per un set di dati del report. Le colonne nel set di risultati per una query popolano la raccolta dei campi per un set di dati. Se la query restituisce più set di risultati, nel report viene elaborato solo il primo set di risultati. Anche se esistono delle differenze tra i database di SQL Server e i database SQL, ad esempio le dimensioni di database supportate, la scrittura di query per i database SQL è simile a quella per i database di SQL Server. Alcune istruzioni Transact-SQL, ad esempio BACKUP, non sono supportate nel database SQL, ma non sono quelle che si utilizzano nelle query del report. Per altre informazioni, vedere Tipo di connessione SQL Server (SSRS).

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. È possibile specificare una query nei modi seguenti:

• Compilare una query in modo interattivo. Usare 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. Selezionare le colonne dalle tabelle o dalle viste o specificare le stored procedure o le funzioni con valori di tabella. Limitare il numero di righe di dati da recuperare specificando i criteri di filtro. Personalizzare il filtro quando il report viene eseguito impostando l'opzione del parametro.

• Digitare o incollare una query. Usare la finestra Progettazione query basata su testo per immettere direttamente testo Transact-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.

• Consente di importare una query esistente da un file o un report. Utilizzare il pulsante Importa da una finestra Progettazione query per individuare un file con estensione sql o rdl e importare una query.

La finestra Progettazione query basata su testo supporta le due modalità seguenti:

• Testo Digitare comandi Transact-SQL per selezionare dati dall'origine dati.

• Stored procedure Scegliere da un elenco di stored procedure.

Per altre informazioni, vedere Interfaccia utente di Progettazione query relazionale (Generatore report) e Interfaccia utente di Progettazione query basata su testo (Generatore report).

La finestra Progettazione query con interfaccia grafica usata dal database SQL offre il supporto predefinito per il raggruppamento e le aggregazioni per semplificare la scrittura di query che recuperano solo dati di riepilogo. Le funzionalità relative al linguaggio Transact-SQL sono la clausola GROUP BY, la parola chiave DISTINCT e gli aggregati come SUM e COUNT. La finestra Progettazione query basata su testo offre il supporto completo per il linguaggio Transact-SQL, inclusi il raggruppamento e le aggregazioni. Per altre informazioni su Transact-SQL, vedere Guida di riferimento a Transact-SQL (Motore di database).

Utilizzo di query di tipo Text

Nella finestra Progettazione query basata su testo digitare i comandi Transact-SQL per definire i dati in un set di dati. La query Transact-SQL seguente, ad esempio, seleziona i nomi di tutti i dipendenti con mansioni di assistente marketing:

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.

Per parametrizzare questa query, aggiungere un parametro di query. Modificare ad esempio la clausola WHERE nella stringa seguente:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)  

Quando si esegue la query, i parametri del report corrispondenti ai parametri di query verranno creati automaticamente. Per ulteriori informazioni, vedere Parametri di query di seguito in questo argomento.

Utilizzo di query di tipo StoredProcedure

È possibile specificare una stored procedure per una query del set di dati in uno dei seguenti modi:

• Nella finestra di dialogo Proprietà set di dati , impostare l'opzione Stored procedure . Scegliere dall'elenco a discesa di stored procedure e funzioni con valori di tabella.

• Nel riquadro Vista di database della finestra Progettazione query relazionale, selezionare una stored procedure o una funzione con valori di tabella.

• Nella finestra Progettazione query basata su testo, selezionare StoredProcedure sulla barra degli strumenti.

Dopo aver selezionato una stored procedure o una funzione con valori di tabella, è possibile eseguire la query. Verranno richiesti i valori dei parametri di input. Quando si esegue la query, i parametri del report corrispondenti ai parametri di input verranno creati automaticamente. Per ulteriori informazioni, vedere Parametri di query di seguito in questo argomento.

È supportato solo il primo set di risultati recuperato per una stored procedure. Se una stored procedure restituisce più set di risultati, viene utilizzato solo il primo.

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

Per altre informazioni sulle stored procedure, vedere Stored procedure (Motore di database).

Parametri

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. Il testo della query non deve includere l'istruzione DECLARE per ogni variabile della query.

La query SQL seguente, ad esempio, crea un parametro di report denominato EmpID:

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

Per impostazione predefinita, ogni parametro del report dispone di tipo di dati Text e un set di dati creato automaticamente per fornire un elenco a discesa di valori disponibili. Dopo aver creato i parametri di report, potrebbe essere necessario modificare i valori predefiniti. Per altre informazioni, vedere Parametri report (Generatore report e Progettazione report).

Osservazioni:

Estensioni per i dati alternative

È anche possibile recuperare dati da un database SQL Server tramite un tipo di origine dati ODBC. La connessione al database SQL tramite OLE DB non è supportata.

Per altre informazioni, vedere Tipo di connessione ODBC (SSRS).

Informazioni sulla piattaforma e sulla versione

Per altre informazioni sulle piattaforme e le versioni supportate, vedere Origini dati supportate da Reporting Services (SSRS).

Database SQL di Azure Microsoft Entra ID

È possibile usare database SQL di Azure con Microsoft Entra ID (in precedenza Azure Active Directory).

Questo scenario è supportato quando vengono configurati correttamente gli elementi seguenti:

• Active Directory Authentication Library per SQL Server (ADALSQL) è installato nel server di report.
• Active Directory Federation Services (AD FS) è configurato per la federazione tra Active Directory (AD) locale e Microsoft Entra ID.
• La delega vincolata Kerberos (KDC) è configurata dal server di report al server AD FS.
• Configurare il report/l'origine dati per eseguire l'autenticazione al database SQL di Azure come l'utente che visualizza il report.

Procedure

In questa sezione sono contenute istruzioni dettagliate per l'utilizzo di connessioni dati, origini dati e set di dati.

Aggiungere e verificare una connessione dati (Generatore di report e SSRS)

Creare un set di dati condiviso o un set di dati incorporato (Generatore di report e SSRS)

Aggiungere un filtro a un set di dati (Generatore di report e SSRS)

Sezioni correlate

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.

Set di dati del report (SSRS)
Viene fornita una panoramica sull'accesso ai dati del report.

Creare stringhe di connessione dati - Generatore report e SSRS
Vengono fornite informazioni sulle connessioni dati e sulle origini dati.

Set di dati condivisi e incorporati del report (Generatore di report e SSRS)
Vengono fornite informazioni sui set di dati incorporati e condivisi.

Raccolta di campi del set di dati (Generatore di report e SSRS)
Vengono fornite informazioni sulla raccolta di campi di set di dati generata dalla query.

Origini dei dati supportate da Reporting Services (SSRS).
Vengono fornite informazioni dettagliate sul supporto delle piattaforme e delle versioni per ogni estensione per i dati.

Vedi anche

Database SQL di Microsoft Azure
Parametri report (Generatore di report e Progettazione report)
Filtro, raggruppamento e ordinamento di dati (Generatore di report e SSRS)
Espressioni (Generatore di report e SSRS)