Creare stringhe di connessione dati - Generatore report e SSRS

Si applica a:✅ SQL Server Reporting Services 2016 (13.x) e versioni successive ✅ Server di report di Power BI ✅ SharePoint

Per includere dati in Generatore report e report impaginati di Reporting Services, è necessario prima creare una stringa di connessione all'origine dati in uso. Questo articolo illustra come creare stringhe di connessione dati e include informazioni importanti relative alle credenziali delle origini dati. Un'origine dati include il tipo di origine dati, le informazioni di connessione e il tipo di credenziali da usare. Per altre informazioni, vedere Introduzione ai dati del report in SQL Server Reporting Services (SSRS).

Estensioni per i dati predefinite

Le estensioni per i dati predefinite in Reporting Services includono Microsoft SQL Server, il database SQL di Microsoft Azure e Microsoft SQL Server Analysis Services. Per un elenco completo di origini dati e versioni supportate da Reporting Services, vedere Origini dati supportate da Reporting Services (SSRS).

Esempi comuni di stringhe di connessione

Le stringhe di connessione sono la rappresentazione di testo delle proprietà di connessione per un provider di dati. Nella tabella seguente sono elencati esempi di stringhe di connessione per diversi tipi di connessione dati.

Nota

Un'altra risorsa per ottenere esempi di stringhe di connessione èConnectionStrings.com .

Origine dati Esempio Descrizione
Database SQL Server sul server locale Data Source="(local)"; Initial Catalog=AdventureWorks Impostare il tipo di origine dati su Microsoft SQL Server. Per altre informazioni, vedere Tipo di connessione SQL Server (SSRS).
Istanza denominata di SQL Server Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks Impostare il tipo di origine dati su Microsoft SQL Server. Per altre informazioni, vedere Tipo di connessione SQL Server (SSRS).
Database SQL di Microsoft Azure Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True Impostare il tipo di origine dati su Database SQL di Microsoft Azure. Per altre informazioni, vedere Tipo di connessione Azure SQL (SSRS).
SQL Server Parallel Data Warehouse HOST=<IP address>; database=AdventureWorks; port=<port> Impostare il tipo di origine dati su Microsoft SQL Server Parallel Data Warehouse. Per altre informazioni, vedere Tipo di connessione SQL Server Parallel Data Warehouse (SSRS).
Database Analysis Services sul server locale Data Source=localhost; Initial Catalog=Adventure Works DW Impostare il tipo di origine dati su Microsoft SQL Server Analysis Services. Per altre informazioni, vedere Tipo di connessione Analysis Services per MDX (SSRS) e Tipo di connessione di Analysis Services per DMX (SSRS).
Database modello tabulare di Analysis Services con la prospettiva Sales Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' Impostare il tipo di origine dati su Microsoft SQL Server Analysis Services. Specificare il nome della prospettiva nell'impostazione cube=. Per altre informazioni, vedere Prospettive (SSAS tabulare).
Azure Analysis Services Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks Impostare il tipo di origine dati su Microsoft SQL Server Analysis Services. Per altre informazioni, vedere Estensione per l'elaborazione dati di Microsoft SQL Server Analysis Services.
Server Oracle Data Source=<host> Impostare il tipo di origine dati su Oracle. È necessario installare gli strumenti client Oracle nel computer di Progettazione report e nel server di report. Per altre informazioni, vedere Tipo di connessione Oracle (SSRS).
Origine dati SAP NetWeaver BI Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla Impostare il tipo di origine dati su SAP NetWeaver BI. Per altre informazioni, vedere Tipo di connessione SAP NetWeaver BI (SSRS).
Origine dati Hyperion Essbase Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample Impostare il tipo di origine dati su Hyperion Essbase. Per altre informazioni, vedere Tipo di connessione Hyperion Essbase (SSRS).
Origine dati Teradata Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Impostare il tipo di origine dati su Teradata. La stringa di connessione è un indirizzo IP (Internet Protocol) nel formato in quattro campi, ognuno dei quali può contenere da una a tre cifre. Per altre informazioni, vedere Tipo di connessione Teradata (SSRS).
Origine dati Teradata Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True Impostare il tipo di origine dati su Teradata, analogamente all'esempio precedente. Utilizzare solo il database predefinito specificato nel tag Database e non individuare automaticamente le relazioni dei dati.
Origine dati XML, servizio Web data source=https://adventure-works.com/results.aspx Impostare il tipo di origine dati su XML. La stringa di connessione è un URL per un servizio Web che supporta Web Services Definition Language (WSDL). Per altre informazioni, vedere Tipo di connessione XML (SSRS).
Origine dati XML, documento XML https://localhost/XML/Customers.xml Impostare il tipo di origine dati su XML. La stringa di connessione è un URL per il documento XML.
Origine dati XML, documento XML incorporato vuoto Impostare il tipo di origine dati su XML. I dati XML vengono incorporati nella definizione del report.
Elenco SharePoint Data Source=https://MySharePointWeb/MySharePointSite/ Impostare il tipo di origine dati su Elenco SharePoint.
Set di dati di Power BI Premium (a partire da Reporting Services 2019 e Server di report di Power BI gennaio 2020) Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> Impostare il tipo di origine dati su Microsoft SQL Server Analysis Services.

Se non è possibile connettersi a un server di report usando localhost, verificare che il protocollo di rete per TCP/IP sia abilitato. Per altre informazioni, vedere Configure Client Protocols.

Per altre informazioni sulle configurazioni necessarie per connettersi a questi tipi di origini dati, vedere l'articolo specifico relativo alla connessione dati in Aggiungere dati da origini dati esterne (SSRS) oppure Origini dati supportate da Reporting Services (SSRS).

Caratteri speciali in una password

Se si configura l'origine dei dati ODBC o SQL per la richiesta di una password o l'inclusione della password nella stringa di connessione e un utente immette la password con caratteri speciali quali segni di punteggiatura, è possibile che alcuni driver dell'origine dei dati sottostante non convalidino i caratteri speciali. In tal caso, quando si elabora il report verrà visualizzato un messaggio che indica che la password non è valida. Se la modifica della password è complessa, è possibile rivolgersi all'amministratore del database per fare in modo che vengano archiviate sul server le credenziali appropriate come parte del nome di un'origine dei dati (DSN) ODBC del sistema. Per altre informazioni, vedere OdbcConnection.ConnectionString nella documentazione di .NET Framework.

Stringhe di connessione basate su espressioni

Le stringhe di connessione basate su espressioni vengono valutate in fase di esecuzione. È ad esempio possibile specificare l'origine dati come parametro, includere il riferimento del parametro nella stringa di connessione e consentire all'utente di scegliere un'origine dati per il report. Si supponga ad esempio che una società multinazionale abbia server dei dati in diversi paesi/aree geografiche. Con una stringa di connessione basata su un'espressione, un utente che esegue un report relativo alle vendite può selezionare un'origine dei dati per un determinato paese/area geografica prima dell'esecuzione del report.

Nell'esempio seguente viene illustrato l'utilizzo di un'espressione di origine dati in una stringa di connessione di SQL Server. Nell'esempio si presuppone che sia stato creato un parametro di report denominato ServerName:

="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"  

Le espressioni delle origini dati vengono elaborate in fase di esecuzione oppure quando si visualizza l'anteprima di un report. L'espressione deve essere scritta in Visual Basic. Utilizzare le linee guida seguenti per definire un'espressione di origine dati:

  • Progettare il report utilizzando una stringa di connessione statica. Un stringa di connessione statica fa riferimento a una stringa di connessione che non viene impostata tramite un'espressione. Una stringa di connessione statica viene definita, ad esempio, quando si esegue la procedura per la creazione di un'origine dei dati in base al report o condivisa. L'utilizzo di una stringa di connessione statica consente all'utente di connettersi all'origine dei dati in Progettazione report per ottenere i risultati della query necessari per la creazione del report.

  • Quando si definisce la connessione all'origine dei dati, non utilizzare un'origine dei dati condivisa. Non è possibile utilizzare un'espressione di origine dati in un'origine dati condivisa. È necessario definire un'origine dati incorporata per il report.

  • Specificare le credenziali separatamente rispetto alla stringa di connessione. È possibile utilizzare credenziali archiviate, credenziali fornite dall'utente o sicurezza integrata.

  • Aggiungere un parametro del report per specificare un'origine dei dati. Per i valori dei parametri è possibile specificare un elenco statico dei valori disponibili, in questo caso le origini dei dati che possono essere utilizzate per il report, oppure definire una query che recupera un elenco di origini dei dati in fase di esecuzione.

  • Assicurarsi che l'elenco delle origini dei dati condivida lo stesso schema di database. Ogni progettazione di report inizia dalle informazioni relative allo schema. Se non c'è corrispondenza tra lo schema utilizzato per definire il report e lo schema effettivamente utilizzato dal report in fase di esecuzione, il report potrebbe non essere eseguito.

  • Prima della pubblicazione del report, sostituire la stringa di connessione statica con un'espressione. Attendere di aver completato la progettazione del report prima di eseguire questa operazione. Dopo aver utilizzato un'espressione, non è possibile eseguire la query in Progettazione report. L'elenco dei campi del riquadro dei dati del report e l'elenco Parametri, inoltre, non verranno aggiornati automaticamente.

Passaggi successivi

Introduzione ai dati del report in SQL Server Reporting Services (SSRS)Creare e modificare origini dati condivise
Creare e modificare origini dati incorporate
Impostare le proprietà di distribuzione
Specificare le credenziali e le informazioni sulla connessione per le origini dati del report

Altre domande? Visitare il forum su Reporting Services