Analysis Services librerie client

Si applica a: SQL Server Analysis Services Azure Analysis Services Power BI Premium

Le librerie client sono necessarie per le applicazioni client e gli strumenti per connettersi Analysis Services. Le applicazioni client Microsoft come Power BI Desktop, Excel, SQL Server Management Studio (SSMS) e l'estensione di progetti Analysis Services per Visual Studio installano tutte e tre le librerie client e le aggiornano insieme ai normali aggiornamenti delle applicazioni. Le applicazioni client personalizzate richiedono anche l'installazione di librerie client. Le librerie client vengono aggiornate ogni mese. Prima di eseguire il download, assicurarsi di vedere Problemi noti.

Scaricare la versione più recente

Windows Installer

Scarica Versione
MSOLAP (amd64) 16.0.9.17
MSOLAP (x86) 16.0.9.17
AMO 19.32.0.0
ADOMD 19.32.0.0

Pacchetti NuGet

Analysis Services management objects (AMO) e le librerie client ADOMD sono disponibili come pacchetti installabili da NuGet.org. È consigliabile eseguire la migrazione a NuGet riferimenti anziché usare Windows Installer.

A partire da febbraio 2021 sono disponibili anche le versioni dei pacchetti .NET Core equivalenti ai pacchetti client AMO e ADOMD. Esistono tuttavia alcuni scenari non supportati dalle versioni di .NET Core. Per altre informazioni, vedere Problemi noti più avanti in questo articolo.

Gli assembly AssemblyVersion del pacchetto NuGet sono conformi al controllo delle versioni semantici: PRINCIPALE.SECONDARIA.PATCH. I riferimenti NuGet caricano la versione prevista anche se nella Global Assembly Cache è presente una versione diversa (risultante dall'installazione con file MSI). Il valore di PATCH viene incrementato a ogni versione. Le versioni di AMO e ADOMD vengono mantenute sincronizzate.

AMO e ADOMD

Pacchetto Versione
AMO 19.32.0.0
ADOMD 19.32.0.0

Amo e ADOMD .NET Core

Pacchetto Versione
AMO 19.32.0.0
ADOMD 19.32.0.0

Versioni minime richieste

Transport Layer Security protocollo TLS versione 1.0/1.1 verrà deprecato in Azure Active Directory entro il 30 giugno 2021. In futuro, è necessario TLS 1.2 e versioni successive. TLS 1.2 non è supportato nelle versioni precedenti delle librerie client Analysis Services client. Le versioni più recenti della libreria client includono il supporto per TLS 1.2 e versioni successive, nonché altri importanti miglioramenti della sicurezza.

Per ridurre al minimo i rischi e le potenziali vulnerabilità della sicurezza, a partire dal 30 giugno 2021, la sicurezza avanzata in Azure Analysis Services e Power BI richiede le versioni seguenti o successive:

Lib client Versione file Versione
MSOLAP 2018.151.61.21 15.1.61.21
AMO 15.1.61.21 19.12.3.0
ADOMD 15.1.61.21 19.12.3.0

Problemi noti

Amo e ADOMD .NET Core

Gli scenari supportati includono connessioni Azure Analysis Services, Power BI Premium e SQL Server Analysis Services. La connettività basata su TCP è supportata solo Windows computer.

L'accesso interattivo con Azure Active Directory è supportato solo per Windows computer. È necessario il runtime di .NET Core Desktop.

La dipendenza in MSAL richiede la versione 4.6.0 e successive.

La versione 19.14.0 delle librerie client di .NET Core ha introdotto il supporto dell'anteprima per la pubblicazione Self-Contained (sia in una directory pubblicata che in modalità a file singolo), nonché il supporto per l'utilizzo da parte dei progetti .NET 5.0. Sono stati risolti diversi problemi relativi alla connettività SQL Server Analysis Services che sono stati identificati nella versione precedente.

La versione 19.12.7.2 delle librerie client .NET Core il supporto per SQL Server Analysis Services. Le versioni di anteprima inferiori supportano Azure Analysis Services e Power BI set di dati.

AMO

La versione 19.12.3.0 della libreria client AMO introduce una nuova enumerazione, Microsoft.AnalysisServices.DataType. Tuttavia, l'enumerazione precedente, Microsoft.AnalysisServices.Tabular.DataType, esiste ancora. Se il codice fa riferimento all'enumerazione precedente semplicemente come DataType in un file di codice con istruzioni per entrambi gli spazi dei nomi (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular), a causa dell'ambiguità, è possibile che si otterrà un errore durante la compilazione. Per risolvere l'errore, qualificare completamente il riferimento all'enumerazione .

MSOLAP

Una regressione correlata alle connessioni ai sistemi basati sul cloud AAD è stata individuata nella versione 16.0.4.17 di OLEDB [MSOLAP]. È stato corretto nella versione 16.0.9.17 di MSOLAP.

Informazioni sulle librerie client

Analysis Services usa tre librerie client. ADOMD.NET e Analysis Services Management Objects (AMO) sono librerie client gestite. E Provider OLE DB Analysis Services (DLL MSOLAP) è una libreria client nativa. In genere, vengono installate tutte e tre nello stesso momento.

Le applicazioni client di Microsoft, come ad esempio Power BI Desktop ed Excel, installano tutte e tre le librerie client e le aggiornano quando sono disponibili nuove versioni. A seconda della versione o della frequenza degli aggiornamenti, alcune librerie client potrebbero non essere le versioni più recenti richieste da Azure Analysis Services e Power BI. Lo stesso vale per le applicazioni personalizzate o per le altre interfacce come AsCmd, TOM e ADOMD.NET. Queste applicazioni richiedono l'installazione manuale o a livello di codice delle librerie. Le librerie client per l'installazione manuale sono incluse nei Feature Pack di SQL Server come pacchetti distribuibili. Queste librerie client sono tuttavia collegate alla versione di SQL Server e potrebbero non essere le più recenti. Assicurarsi di installare sempre la versione più recente, scaricabile da questo articolo.

Tipi di librerie client

Provider OLE DB per Analysis Services (MSOLAP)

Il provider OLE DB Analysis Services (MSOLAP) è la libreria client nativa per le connessioni di database di Analysis Services. Viene usato in modo indiretto sia da ADOMD.NET che da AMO, delegando le richieste di connessione al provider di dati. È anche possibile chiamare il provider OLE DB direttamente dal codice dell'applicazione.

Il provider OLE DB Analysis Services viene installato automaticamente dalla maggior parte degli strumenti e delle applicazioni client usati per accedere ai database di Analysis Services. Deve essere installato nei computer usati per accedere ai dati di Analysis Services.

I provider OLE DB vengono spesso specificati nelle stringhe di connessione. Una Analysis Services di connessione usa una nomenclatura diversa per fare riferimento al provider OLE DB: MSOLAP. <version>.dll.

AMO

AMO è una libreria client gestita usata per l'amministrazione di server e la definizione di dati. Viene installata e usata da strumenti e applicazioni client. SQL Server Management Studio (SSMS), ad esempio, usa AMO per connettersi ad Analysis Services. Una connessione che usa AMO è in genere minima, costituita da "data source=\<servername>". Dopo che è stata stabilita una connessione, l'API consente di usare le raccolte di database e gli oggetti principali. Sia Visual Studio che SSMS AMO per connettersi a un Analysis Services istanza di .

ADOMD

ADOMD.NET è una libreria client di dati gestiti usata per eseguire query sui dati di Analysis Services. Viene installata e usata da strumenti e applicazioni client.

Durante la connessione a un database, le proprietà della stringa di connessione per tutte e tre le librerie sono simili. Quasi tutte le stringhe di connessione definite per ADOMD.NET usando Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString funzionano anche per AMO e il provider OLE DB Analysis Services (MSOLAP). Per altre informazioni, vedere Proprietà della stringa di connessione.

Controllare le versioni installate

OLEDDB (MSOLAP)

  1. Passare a C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Se si ha più di una cartella, scegliere il numero più elevato.

  2. Fare clic con il pulsante destromsolap.dll dettagli > > proprietà. Controllare la proprietà Versione prodotto. Nota: se il nome file msolap140.dll, è precedente alla versione più recente e deve essere aggiornato.

    Finestra di dialogo dei dettagli della libreria client MSOLAP

AMO

  1. Passare a C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Se si ha più di una cartella, scegliere il numero più elevato.

  2. Fare clic con il pulsante destro del mouse su Microsoft.AnalysisServices > Properties > Details.

    Finestra di dialogo dettagli libreria client AMO

ADOMD

  1. Passare a C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Se si ha più di una cartella, scegliere il numero più elevato.

  2. Fare clic con il pulsante destro del mouse su Microsoft.AnalysisServices.AdomdClient > Properties > Details.

    Finestra di dialogo dei dettagli della libreria client ADOMD

Aggiornare manualmente

Le librerie client vengono in genere installate e aggiornate automaticamente insieme agli strumenti e alle applicazioni client che le usano. Tuttavia, in alcuni casi le librerie client potrebbero non essere aggiornate automaticamente e ognuna deve essere aggiornata manualmente. Per eseguire l'aggiornamento manualmente, scaricare ed eseguire il pacchetto Windows Installer (.msi) per ogni libreria client.

Per scaricare e aggiornare

  1. Fare clic su:

  2. In Download fare clic su un pacchetto Windows programma di installazione per eseguire il programma di installazione.

  3. In Installazione fare clic su Avanti.

  4. Leggere il Contratto di Licenza. Se si accettano, selezionare Accetto le condizioni del contratto di licenza e quindi fare clic su Avanti.

  5. Fare clic su Installa.

  6. Al termine, fare clic su Fine.