Klientské knihovny služby Analysis Services

Applies to: Analytické služby SQL Serveru Azure Analysis Services Fabric/Power BI Premium

Klientské knihovny jsou nezbytné pro klientské aplikace a nástroje pro připojení ke službě Analysis Services. Microsoft klientské aplikace, jako je Power BI Desktop, Excel, SQL Server Management Studio (SSMS) a rozšíření projektů Analysis Services pro Visual Studio nainstalují všechny tři klientské knihovny a aktualizují je v rámci pravidelných aktualizací aplikací. Vlastní klientské aplikace pro Analysis Services mohou také vyžadovat instalaci jedné nebo více těchto klientských knihoven. Nové verze klientských knihoven se aktualizují přibližně měsíčně.

Důležité: Před získáním nejnovějších verzí nezapomeňte se podívat na Úvahy a omezení.

Stáhněte si nejnovější verzi.

Instalační program Windows

Stáhnout	Verze
MSOLAP (amd64)	17.0.69.18
MSOLAP (x86)	17.0.69.18
AMO	19.84.1.0
ADOMD	19.84.1.0

Note: Instalační program Windows pro objekty správy služby Analysis Services (AMO/TOM) a ADOMD se už neaktualizují a nebudou k dispozici po 31. prosinci 2024. Aplikace, které se spoléhají na tato stažení Windows Installeru, by měly být migrovány do balíčků NuGet.

Balíčky NuGet

Klientské knihovny služby Analysis Services (AMO/TOM) a ADOMD jsou k dispozici jako instalovatelné balíčky z NuGet.org. Důrazně doporučujeme migrovat na odkazy NuGet místo použití instalačního programu Windows.

Sestavení balíčků NuGet, označené jako AssemblyVersion, se řídí sémantickým verzovacím systémem: MAJOR.MINOR.PATCH. Odkazy NuGet načítají očekávanou verzi, i když je v GAC jiná verze (výsledkem je instalace MSI). PATCH se pro každou verzi zvyšuje. Verze AMO a ADOMD se synchronizují.

Od července 2024 obsahují balíčky AMO a ADOMD verze s více moduly runtime pro všechny podporované cílové moduly runtime, .NET FX i .NET Core; předchozí verze balíčků, které cílí pouze na jeden modul runtime, .NET FX nebo .NET Core, jsou k dispozici pro zpětnou kompatibilitu, ale už se neaktualizují.

Od září 2022, AMO (AMO/TOM) a ADOMD .Net Core (verze 19.48.0.0), komunikace založená na protokolu HTTP s cloudovými službami, jako jsou Power BI a Azure Analysis Services, se výrazně vylepšuje. Doporučujeme aktualizovat na nejnovější verzi, abyste mohli využívat vylepšení výkonu.

Od února 2021 je podpora modulu runtime .NET Core k dispozici pro balíčky klienta AMO a ADOMD. Existuje však několik scénářů, které verze .NET Core nepodporují. Další informace najdete v úvahách a omezeních dále v tomto článku.

AMO a ADOMD

Balíček	Verze
AMO	19.113.7.0
ADOMD	19.113.7.0

Note:

Nové balíčky s více moduly runtime už nemají příponu .retail.amd64 v identitě balíčku a teď se jednoduše nazývají Microsoft. AnalysisServices a Microsoft. AnalysisServices.AdomdClient.

Starší balíčky .NET Framework a .NET Core jsou stále dostupné na nuget.org kvůli zpětné kompatibilitě se starou identitou s příponou ".retail.amd64" pro .NET Framework a příponou ".NetCore.retail.amd64" pro .NET Core.

Minimální požadované verze

Protokol TLS (Transport Layer Security) verze 1.0/1.1 byl v Microsoft Entra ID označen jako zastaralý dne 30. června 2021. Teď se vyžaduje protokol TLS 1.2 nebo vyšší. Protokol TLS 1.2 není ve starších verzích klientských knihoven služby Analysis Services podporován. Novější verze klientské knihovny zahrnují kromě dalších důležitých vylepšení zabezpečení také podporu protokolu TLS 1.2 a vyšší.

Pokud chcete minimalizovat rizika a potenciální ohrožení zabezpečení, od 30. června 2021 rozšířené zabezpečení v Azure Analysis Services a Power BI vyžadují následující nebo vyšší verze:

Klientská knihovna	Verze souboru	Verze
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

Důležité informace a omezení

AMO a ADOMD

Počínaje verzí 19.98.0.3:

• Další sadu vlastností připojovacího řetězce lze použít k řízení autentizačního prostředí založeného na Entra-Id pro připojení přes HTTP. Další informace najdete v článku o vlastnostech připojovacího řetězceAnalysis-Services v dokumentaci k produktu.
• Komunikace založená na protokolu HTTP je vylepšená díky lepší správě otevřených kanálů HTTP v přenosové vrstvě, zejména při použití knihoven .NET Core.

Balíčky AdomdClient a AMO verze 19.94.1.1 nahrazují verzi 19.94.0.0. Upgradujte na nejnovější verzi.

S verzí 19.94.1.1:

• Třídy možností serializace TMDL v balíčku AMO zahrnují sadu rozšiřujících metod pro zjednodušení jejich použití. Další podrobnosti najdete v referenční dokumentaci k rozhraní API.
• Informace o chybách v určitých scénářích vytváření sémantických modelů obsahují další podrobnosti o porušení kompatibility a problémech s křížovým odkazem:
  • Porušení kompatibility: Třída CompatibilityViolationException nabízí podrobné informace v textu zprávy, které pomáhají při řešení potíží. Další vlastnosti, například SupportedCompatibilityLevel a CompatibilityLevelRequest, také zveřejňují podrobnější informace.
  • Chyby křížového odkazu: Třídy TmdlDeserializationWithReferenceErrorsException a JsonDeserializationWithReferenceErrorsException poskytují podrobné chybové zprávy, které obsahují nevyřešené vlastnosti a nabízejí další podrobnosti o chybách křížového odkazu. Tyto nové třídy výjimek můžou pomoct zpracovat problémy deserializace TMDL a TMSL.

Od verze 19.84.6 už není dostupná podpora .NET FX 4.5 a .NET Core 3.0 ve spravovaných sestaveních. Sestavení AS na straně klienta nyní podporují pouze .NET FX 4.7.2, .NET 6.0 a .NET 8.0.

Počínaje verzí 19.82.0.0 podporují AMO a ADOMD instanční profily pro ověřování, jak je znázorněno v následujícím příkladu připojovací řetězec. Další informace najdete v tématu Použití profilů hlavních služeb ke správě zákaznických dat ve víceklientských aplikacích. Uživatelé se nemohou připojit k pracovním prostorům přidruženým k licenci Premium na uživatele pomocí profilů hlavní služby prostřednictvím koncového bodu XMLA.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

Od verze 19.67.0 jsou objekty připojení, jako je Microsoft. AnalysisServices.AdomdClient.AdomdConnection a Microsoft. AnalysisServices.Server podporuje novou vlastnost AccessToken, která umožňuje lepší způsob předávání externích tokenů OAuth pro použití vrstvou připojení XMLA. Další informace najdete v tématu Vlastnosti připojovacího řetězce – ID uživatele=...; Password=.

Počínaje verzí 19.42.0.4, ADOMD.NET a AMO/TOM používají MSAL (Microsoft. Identity.Client) verze 4.43.0 nebo vyšší místo knihovny ADAL k ověřování uživatelů s Microsoft Entra ID při vytváření připojení ke cloudovým službám, jako jsou Power-BI a Azure Analysis Services. Pokud vaše aplikace nebo jiná komponenta, na které aplikace závisí, používá knihovnu MSAL, může být nutné aktualizovat nastavení přesměrování vazby knihoven aplikace, pokud dojde ke konfliktům mezi verzemi MSAL, které načítají komponenty.

AMO a ADOMD .Net Core

Mezi podporované scénáře patří připojení k Azure Analysis Services, Power BI Premium a Analytické služby SQL Serveru. Připojení založené na protokolu TCP je podporováno pouze pro Windows počítače.

Interaktivní přihlášení s Microsoft Entra ID se podporuje jenom pro Windows počítače. Vyžaduje se modul runtime .NET Core Desktop.

Závislost v MSAL vyžaduje verzi 4.43.0 nebo vyšší.

Verze 19.14.0 klientských knihoven .Net Core přinesla preview podporu pro publikování ve formátu Self-Contained (jak v publikovaném adresáři, tak v režimu s jedním souborem), vedle podpory využití projekty .NET 5.0. Opravili jsme několik problémů souvisejících s připojením k Analytické služby SQL Serveru, které byly identifikovány v předchozí verzi.

Verze 19.12.7.2 klientských knihoven .Net Core zavedla podporu pro Analytické služby SQL Serveru. Nižší verze Preview podporují pouze Azure Analysis Services a sémantické modely Power BI.

AMO

Počínaje verzí 19.98.0.3 je výchozí úroveň kompatibility pro databáze tabulkových modelů 1700. Databáze vytvořené bez explicitního zadání úrovně kompatibility ve výchozím nastavení používají úroveň 1700.

Počínaje verzí 19.84.6 se podpora TMDL v AMO\TOM považuje za stav General-Availability a v rozhraní API nebudou žádné zásadní změny.

Verze 19.12.3.0 klientské knihovny AMO zavádí nový výčet Microsoft. AnalysisServices.DataType. Předchozí výčet však Microsoft. AnalysisServices.Tabular.DataType stále existuje. Pokud váš kód odkazuje na předchozí výčet jako DataType v souboru kódu s příkazy na oba obory názvů (Microsoft. AnalysisServices, Microsoft. AnalysisServices.Tabular) kvůli nejednoznačnosti se může při kompilaci zobrazit chyba. Pokud chcete tuto chybu vyřešit, plně kvalifikujte odkaz na výčet.

Verze 19.61.1.4 klientské knihovny AMO zavádí změnu v chování vrácení transakce u Microsoft.AnalysisServices.Server. V dřívějších verzích volání Server.RollbackTransaction() odešle požadavek jádru, aby vrátilo transakci zpět, a poté se pokusí vrátit zpět místní změny. Na rozdíl od dřívějších verzí 19.61.1.4 a novějších, pokud místní změny nelze bezpečně vrátit zpět, tabulkové databáze zahrnuté do transakce blokují všechny další změny, dokud nebudou plně synchronizovány a zastaralé změny z transakce, které byly vráceny zpět, budou odebrány. InvalidOperationException je vyvolána při změně příslušné tabulkové databáze. Pokud váš kód volá Server.RollbackTransaction(), doporučujeme toto volání následovat úplnou synchronizací [Database.Refresh(true)] pro všechny tabulkové databáze, které jsou změněny v rámci transakce.

Počínaje verzí 19.77.0 při klonování nebo kopírování objektu MetadataObject do jiné instance objektu MetadataObject pomocí tabulkového objektového modelu (TOM) vrátí TOM hodnotu null pro vlastnosti, které křížově odkazují objekty mimo přímý strom MetadataObject podřízených objektů. Do sémantického modelu je nutné přidat klonovanou instanci MetadataObject, aby bylo možné přeložit křížové odkazy na objekty mimo strom MetadataObject.

Například při klonování tabulky s oddílem, který odkazuje na pojmenovaný výraz v EntityPartitionSource, vrátí vlastnost ExpressionSource objektu EntityPartitionSource hodnotu null, dokud není klonovaná tabulka přidána do sémantického modelu jako v fragmentu kódu níže, aby mohl být vyřešen odkaz na klonovaný ExpressionSource. Klon musí být přidán do modelu, protože odkazovaný pojmenovaný výraz je členem kolekce pojmenovaných výrazů modelu a ne součástí hierarchické struktury podřízených objektů tabulky.

Table tableClone = model.Tables[0].Clone();
anotherModel.Tables.Add(tableClone);

ADOMD

Počínaje verzí ADOMD (.NET Framework a .NET Core) verze 19.61.1.4 je komprese plně dostupná v přenosové vrstvě XMLA. Předchozí verze po verzi 19.55.3.1 implementovali částečnou podporu komprese. Zprávy o problémech s těmito verzemi byly přijaty. Tyto problémy byly opraveny jako součást verze 16.61.1.4. Pokud máte problémy související s kompresí, nezapomeňte upgradovat na verzi 19.61.1.4 nebo novější.

MSOLAP

Od verze 17.0.25.23 je možné použít další sadu vlastností připojovacího řetězce k řízení prostředí ověřování na základě Entra-Id přes připojení HTTP. Další informace najdete v článku o vlastnostech připojovacího řetězceAnalysis-Services v dokumentaci k produktu.

Počínaje verzí 16.0.139.27, MSOLAP podporuje profily principálů služeb pro ověřování, jak ukazuje následující příklad připojovací řetězec. Další informace najdete v tématu Použití profilů hlavních služeb ke správě zákaznických dat ve víceklientských aplikacích.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

Počínaje verzí 16.0.134.22 podporuje MSOLAP bezobslužné jednotné Sign-On (SSO) pomocí Správce webových účtů (WAM), který je k dispozici na Windows 10 a novějších i Windows Serveru 2019 a novějších. Při otevření nového připojení HTTP získá MSOLAP přístupový token následujícím způsobem:

1. Pokud je povolené ukládání tokenů do mezipaměti a v mezipaměti je k dispozici vhodný token, použije MSOLAP token uložený v mezipaměti.
2. Pokud není k dispozici vhodný token v mezipaměti, služba MSOLAP se pokusí získat přístupový token bezobslužně prostřednictvím WAM.
3. Pokud jednotné přihlašování pomocí WAM selhalo, MSOLAP se vrátí k interaktivnímu ověřování a zobrazí okno pro přihlášení.

Uživatelé mohou obejít tichý tok jednotného přihlašování a okamžitě spustit interaktivní ověřovací proces zadáním "prázdné" hodnoty ID uživatele v připojovacím řetězci (User ID='').

Počínaje verzí 16.0.43.20 používá msOLAP (Microsoft. Identity.Client) verze 4.43.0 nebo vyšší místo knihovny ADAL k ověřování uživatelů s Microsoft Entra ID při vytváření připojení ke cloudovým službám, jako jsou Power-BI a Azure Analysis Services. Pokud aplikace nebo jiná komponenta, na které aplikace závisí, používá knihovnu MSAL, může být nutné aktualizovat nastavení přesměrování vazby aplikace, pokud existují konflikty mezi verzemi knihovny MSAL načtenými komponentami.

Regrese související s připojeními ke cloudovým systémům používajícím Microsoft Entra ID byla zjištěna ve verzi OLEDB (MSOLAP) 16.0.4.17. Byla opravena v verzi 16.0.20.201. Vzhledem k povaze problému nelze instalaci verze 16.0.4.17 a jakékoli jiné verze starší než 16.0.20.201 opravit supgradováním poskytovatele, i když je instalace spuštěna v režimu opravy. Doporučujeme úplně odinstalovat verzi 16.0.4.17 [nebo jinou problematickou] a pak nainstalovat verzi 16.0.20.201 nebo novější.

V dřívější verzi se služba MSOLAP aktualizovala tak, aby se připojila ke cloudové službě Analysis Services pomocí spravovaného Identity a ověřování Microsoftu (MSAL). Počínaje verzí 16.0.87.16 už instalační program MSOLAP nenainstaluje původní nativní komponentu Azure Active Directory Authentication Library (ADAL).

Porozumění klientským knihovnám

Služba Analysis Services využívá tři klientské knihovny. ADOMD.NET a objekty správy služby Analysis Services (AMO) jsou spravované klientské knihovny. Zprostředkovatel OLE DB pro Analysis Services (MSOLAP DLL) je natívní klientská knihovna. Obvykle se instalují všechny tři současně.

Microsoft klientské aplikace, jako jsou Power BI Desktop a Excel, instalují všechny tři klientské knihovny a aktualizují je, jakmile jsou k dispozici nové verze. V závislosti na verzi nebo frekvenci aktualizací nemusí být některé klientské knihovny nejnovějšími verzemi vyžadovanými Azure Analysis Services a Power BI. Totéž platí pro vlastní aplikace nebo jiná rozhraní, jako jsou AsCmd, TOM, ADOMD.NET. Tyto aplikace vyžadují ruční nebo programovou instalaci knihoven. Klientské knihovny pro ruční instalaci jsou součástí SQL Server balíčků funkcí jako distribuovatelné balíčky. Tyto klientské knihovny jsou však svázané s SQL Server verzí a nemusí to být nejnovější. Ujistěte se, že vždy nainstalujete nejnovější verzi, kterou si můžete stáhnout z tohoto článku.

Typy klientských knihoven

Zprostředkovatel OLE DB služby Analysis Services (MSOLAP)

Zprostředkovatel OLE DB služby Analysis Services (MSOLAP) je nativní klientská knihovna pro připojení k databázi služby Analysis Services. Nepřímo ho používá ADOMD.NET i AMO a deleguje žádosti o připojení poskytovateli dat. Můžete také volat zprostředkovatele OLE DB přímo z kódu aplikace.

Zprostředkovatel OLE DB služby Analysis Services se instaluje automaticky pomocí většiny nástrojů a klientských aplikací používaných pro přístup k databázím služby Analysis Services. Musí být nainstalovaná na počítačích používaných pro přístup k datům služby Analysis Services.

Zprostředkovatelé OLE DB jsou často specifikovány v připojovacích řetězcích. Řetězec připojení pro službu Analysis Services používá jinou terminologii, která odkazuje na OLE DB provider: MSOLAP.<version>.dll.

AMO

AMO je spravovaná klientská knihovna používaná pro správu serveru a definici dat. Instaluje se a používá v nástrojích a klientských aplikacích. Například SQL Server Management Studio (SSMS) používá AMO pro připojení ke službě Analysis Services. Připojení využívající AMO je obvykle minimální, které se skládá z "data source=\<servername>". Po navázání připojení použijete rozhraní API pro práci s kolekcemi databází a hlavními objekty. Visual Studio i SSMS používají AMO k připojení k instanci služby Analysis Services.

ADOMD

ADOMD.NET je spravovaná datová klientská knihovna používaná k dotazování dat služby Analysis Services. Instaluje se a používá v nástrojích a klientských aplikacích.

Při připojování k databázi jsou vlastnosti připojovací řetězec pro všechny tři knihovny podobné. Téměř všechny připojovací řetězce, které definujete pro ADOMD.NET za pomocí Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString, fungují také pro AMO a zprostředkovatele OLE DB pro Analytické služby (MSOLAP). Další informace najdete v tématu Vlastnosti připojovacího řetězce.

Kontrola nainstalovaných verzí

OLEDDB (MSOLAP)

1. Přejděte na C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Pokud máte více než jednu složku, zvolte vyšší číslo.

2. Klepněte pravým tlačítkem myši msolap.dll>Vlastnosti>Podrobnosti. Zkontrolujte vlastnost verze produktu . Poznámka: Pokud je název souboru msolap140.dll, je starší než nejnovější verze a měl by být upgradován.

   

AMO

1. Přejděte na C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Pokud máte více než jednu složku, zvolte vyšší číslo.

2. Klikněte pravým tlačítkem na Microsoft. AnalysisServices>Properties>Details.

   Dialog podrobností knihovny klienta AMO

ADOMD

1. Přejděte na C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Pokud máte více než jednu složku, zvolte vyšší číslo.

2. Klikněte pravým tlačítkem na Microsoft. AnalysisServices.AdomdClient>Properties>Details.

   

Ruční aktualizace

Klientské knihovny se obvykle instalují a aktualizují automaticky společně s nástroji a klientskými aplikacemi, které je používají. V některých případech však klientské knihovny nemusí být aktualizovány automaticky a každá z nich musí být aktualizována ručně. Pokud chcete aktualizovat ručně, stáhněte a spusťte balíček Windows Installer (.msi) pro každou klientskou knihovnu.

Stažení a aktualizace

1. Klikněte:

   • stáhnout MSOLAP (amd64) nebo stáhnout MSOLAP (x86)
   • Stáhnout AMO
   • Stáhnout ADOMD

2. V Stažené soubory kliknutím na balíček instalačního programu pro Windows spusťte instalační program.

3. V instalačním programu klepněte na tlačítko Další.

4. Přečtěte si licenční smlouvu. Pokud souhlasíte, vyberte Souhlasím s podmínkami v licenční smlouvěa potom klikněte na tlačítko Další.

5. Klikněte Nainstalovat.

6. Po dokončení klikněte na Dokončit.