Creare stringhe di connessione dati in Generatore di report
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 fornisce 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 necessari. Per maggiori 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 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 nei modelli tabulari. |
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 e Power BI Report Server). |
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 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, assicurarsi che il protocollo di rete per TCP/IP sia abilitato. Per altre informazioni, vedere Configurare protocolli del client.
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 dati ODBC o SQL con una password, è possibile che si verifichino errori con caratteri speciali. Se un utente inserisce la password con caratteri speciali, ad esempio i segni di punteggiatura, alcuni driver dell’origine dati sottostanti non vengono convalidati dai driver dell'origine dati. 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 è un stringa di connessione non impostata tramite un'espressione. Ad esempio, quando si seguono i passaggi per la creazione di un'origine dati specifica del report o condivisa, si definisce un stringa di connessione statica. 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 oppure definire una query che recupera un elenco di origini dei dati in fase di esecuzione. In questo caso, l'elenco statico dei valori disponibili deve essere costituito da origini dati che è possibile usare con il report.
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 vengono aggiornati automaticamente.