Klientské knihovny služby Analysis Services
platí pro:
SQL Server Analysis Services 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. Klientské aplikace Microsoftu, jako jsou 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 spolu s běžnými aktualizacemi 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í služba systému Windows
| Stáhnout | Verze |
|---|---|
| MSOLAP (amd64) | 16.0.164.18 |
| MSOLAP (x86) | 16.0.164.18 |
| AMO | 19.84.1.0 |
| ADOMD | 19.84.1.0 |
Poznámka: Soubor ke stažení pro instalační program systému Windows pro objekty správy služby Analysis Services (AMO/TOM) a ADOMD již nejsou aktualizovány a nebudou k dispozici po 31. prosinci 2024. Aplikace, které se spoléhají na tyto soubory ke stažení instalační služby systému Windows, by se měly migrovat 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 reference NuGet místo použití Windows Installer.
Sestavení balíčků NuGet AssemblyVersion se řídí sémantickým verzováním: 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 zvýší. Verze AMO a ADOMD se synchronizují.
Od července 2024 balíčky AMO a ADOMD obsahují verze s více prostředími runtime pro všechny podporované cílové prostředí runtime, včetně .NET FX i .NET Core. Předchozí verze balíčků, které cílují pouze jedno prostředí runtime, tedy .NET FX nebo .NET Core, jsou k dispozici pro zpětnou kompatibilitu, ale již nejsou aktualizovány.
Od září 2022 se výrazně zlepšila HTTP komunikace s cloudovými službami, jako je Power BI a Azure Analysis Services, prostřednictvím AMO (AMO/TOM) a ADOMD .Net Core (verze 19.48.0.0). Doporučujeme aktualizovat na nejnovější verzi, abyste mohli využívat vylepšení výkonu.
Od února 2021 je podpora modulu runtime .NET Core dostupná 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.87.2.0 |
| ADOMD | 19.87.2.0 |
Poznámka:
Nové balíčky s více moduly runtime už nemají příponu .retail.amd64 v identitě balíčku a nyní se jednoduše nazývají Microsoft.AnalysisServices a Microsoft.AnalysisServices.AdomdClient.
Starší balíčky .NET Framework a .NET Core jsou stále k dispozici na nuget.org pro zpětnou kompatibilitu pod starou identitou s příponou ".retail.amd64" pro rozhraní .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 zastaralý v rámci Microsoft Entra ID 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 vyžaduje rozšířené zabezpečení ve službě Azure Analysis Services a Power BI 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
Od verze 19.84.6 už není podpora pro .NET FX 4.5 a .NET Core 3.0 ve spravovaných sestaveních k dispozici. Sestavení AS na straně klienta jsou nyní vydána s podporou pouze verzí .NET FX 4.7.2, .NET 6.0 a .NET 8.0.
Počínaje verzí 19.82.0.0 podporují AMO a ADOMD pro ověřování instanční profily jako v následujícím příkladu připojovacího řetězce. 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 nemůžou připojit k pracovním prostorům přidruženým k licenci premium Per-User pomocí profilů instančních objektů 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>
Počínaje verzí 19.67.0 podporují objekty připojení, jako je Microsoft.AnalysisServices.AdomdClient.AdomdConnection a Microsoft.AnalysisServices.Server, novou vlastnost AccessToken, která umožňuje vylepšený způsob předávání externích tokenů OAuth, které se používají 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ů pomocí 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í ke službám Azure Analysis Services, Power BI Premium a SQL Server Analysis Services. Připojení založené na protokolu TCP je podporováno pouze pro počítače s Windows.
Interaktivní přihlášení s Microsoft Entra ID je podporováno pouze pro počítače s Windows. 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 zavedla podporu v náhledu pro publikování Self-Contained (jak v publikovaném adresáři, tak v režimu jednoho souboru), a také podporu pro využití projekty .NET 5.0. Opravili jsme několik problémů souvisejících s připojením ke službě SQL Server Analysis Services, které byly identifikovány v předchozí verzi.
Verze 19.12.7.2 klientských knihoven .Net Core zavedla podporu služby SQL Server Analysis Services. Nižší verze Preview podporovaly pouze sémantické modely Azure Analysis Services a Power BI.
AMO
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 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 může dojít k chybě při kompilaci. 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 chování rollbacku transakcí Microsoft.AnalysisServices.Server. V dřívějších verzích volání Server.RollbackTransaction() odešle požadavek modulu, který vrátí transakci zpět a pokusí se 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 rozhraním ADOMD (rozhraní .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
Počínaje verzí 16.0.139.27 podporuje MSOLAP pro ověřování instanční profily jako v následujícím příkladu připojovacího řetězce. Další informace najdete v tématu Použití profilů hlavních členů služby 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 tiché jednoúčelové Sign-On (SSO) pomocí Správce webových účtů (WAM), který je k dispozici ve 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:
- 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.
- 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.
- 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 při vytváření připojení ke cloudovým službám, jako je
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 ve 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é knihovny Microsoft Authentication Library (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 pro správu služby Analysis Services (AMO) jsou spravované klientské knihovny. Zprostředkovatel OLE DB pro Analysis Services (MSOLAP DLL) je klientská knihovna nativního typu. Obvykle se instalují všechny tři současně.
Klientské aplikace Microsoftu, jako je Power BI Desktop a Excel, nainstalují všechny tři klientské knihovny a aktualizují je, když 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 službou Azure Analysis Services a Power BI. Totéž platí pro vlastní aplikace nebo jiná rozhraní, jako je AsCmd, TOM, ADOMD.NET. Tyto aplikace vyžadují ruční nebo programovou instalaci knihoven. Klientské knihovny pro ruční instalaci jsou součástí balíčků funkcí SQL Serveru jako distribuovatelné balíčky. Tyto klientské knihovny jsou však svázané s verzí SQL Serveru 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žívají ADOMD.NET i AMO a delegují žá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. Připojovací řetězec služby Analysis Services používá jinou terminologii odkazující na zprostředkovatele OLE DB: MSOLAP.<verze>.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. Sql Server Management Studio (SSMS) například 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 pro připojení k instanci Analysis Services.
ADOMD
ADOMD.NET je spravovaná klientská knihovna dat 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ího řetězce pro všechny tři knihovny podobné. Téměř jakýkoli připojovací řetězec, který definujete pro ADOMD.NET pomocí Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString funguje také pro AMO a poskytovatele OLE DB analysis Services (MSOLAP). Další informace najdete v tématu Vlastnosti připojovacího řetězce.
Kontrola nainstalovaných verzí
OLEDDB (MSOLAP)
Přejděte na
C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Pokud máte více než jednu složku, zvolte vyšší číslo.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
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.Klepněte pravým tlačítkem myši Microsoft.AnalysisServices>Vlastnosti>Podrobnosti.
dialogové okno podrobností klientské knihovny AMO
ADOMD
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.Klikněte pravým tlačítkem na Microsoft.AnalysisServices.AdomdClient>Vlastnosti>Podrobnosti.
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 aktualizaci provést ručně, stáhněte a spusťte balíček Instalační služby systému Windows (.msi) pro každou klientskou knihovnu.
Stažení a aktualizace
Klikněte:
V Stažené souboryklepněte na balíček instalační služby systému Windows a spusťte instalační program.
V instalačním programu klepněte na tlačítko Další.
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ší.
Klikněte Nainstalovat.
Po dokončení klikněte na Dokončit.