Клиентские библиотеки для служб Analysis Services

Применимо к: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Клиентские библиотеки необходимы для клиентских приложений и инструментов для подключения к службам Analysis Services. Клиентские приложения Майкрософт, такие как Power BI Desktop, Excel, SQL Server Management Studio (SSMS) и расширение проектов Analysis Services для Visual Studio, устанавливают все три клиентские библиотеки и обновляют их вместе с регулярными обновлениями приложений. Для пользовательских клиентских приложений для служб Analysis Services также может потребоваться установить одну или несколько этих клиентских библиотек. Новые версии клиентских библиотек обновляются примерно ежемесячно.

Важно: перед получением последних версий обязательно просмотрите вопросы и ограничения.

Скачать последнюю версию

установщик Windows

Note: Установочные пакеты для объектов управления службами Analysis Services (AMO/TOM) и ADOMD больше не будут обновляться и будут недоступны после 31 декабря 2024 года. Приложения, использующие эти файлы установщика Windows, должны мигрировать в пакеты NuGet.

Пакеты NuGet

Клиентские библиотеки Объектов управления службами Analysis Services (AMO/TOM) и ADOMD доступны как устанавливаемые пакеты из NuGet.org. Настоятельно рекомендуется перенос ссылок на NuGet вместо использования установщика Windows.

Сборки пакетов NuGet Version соответствуют семантическому версионированию: МАЖОР. МИНОРНАЯ. ПАТЧ. NuGet-ссылки загружают ожидаемую версию, даже если в GAC находится другая версия (в результате установки через MSI). PATCH увеличивается с каждым выпуском. Версии AMO и ADOMD поддерживаются в синхронном состоянии.

Начиная с июля 2024 года пакеты AMO и ADOMD содержат выпуски с несколькими средами выполнения для всех поддерживаемых целевых сред выполнения, как .NET FX, так и .NET Core; предыдущие выпуски пакетов, предназначенных только для одной среды выполнения, либо .NET FX или .NET Core, доступны для обратной совместимости, но больше не обновляются.

Начиная с сентября 2022 года, AMO (AMO/TOM) и ADOMD .Net Core (версия 19.48.0.0.0), взаимодействие на основе HTTP с облачными службами, такими как Power BI и Azure Analysis Services, значительно улучшается. Рекомендуется обновить до последней версии, чтобы воспользоваться улучшениями производительности.

Начиная с февраля 2021 г. .NET Core поддержка среды выполнения доступна для клиентских пакетов AMO и ADOMD. Однако существует несколько сценариев, которые не поддерживаются версиями .NET Core. Дополнительные сведения см. в соображениях и ограничениях, далее в этой статье.

AMO и ADOMD

Note:

Новые пакеты с несколькими средами выполнения больше не имеют суффикса .retail.amd64 в идентификаторе пакета и теперь просто называются Майкрософт. AnalysisServices и Майкрософт. AnalysisServices.AdomdClient.

Старые пакеты .NET Framework и .NET Core по-прежнему доступны на nuget.org для поддержки обратной совместимости под старым идентификатором с суффиксом ".retail.amd64" для .NET Framework и ".NetCore.retail.amd64" для .NET Core.

Минимальные необходимые версии

Протокол TLS версии 1.0/1.1 был объявлен устаревшим в Microsoft Entra ID 30 июня 2021 г. Теперь требуется протокол TLS 1.2 или более поздней версии. TLS 1.2 не поддерживается в более ранних версиях клиентских библиотек служб Analysis Services. Более новые версии клиентской библиотеки включают поддержку TLS 1.2 и более поздних версий в дополнение к другим важным улучшениям безопасности.

Чтобы свести к минимуму риски и потенциальные уязвимости безопасности, начиная с 30 июня 2021 г., для повышения безопасности в Azure Analysis Services и Power BI требуются следующие или более поздние версии:

Рекомендации и ограничения

AMO и ADOMD

Начиная с версии 19.98.0.3:

• Дополнительный набор свойств строки подключения можно использовать для управления опытом аутентификации на основе Entra-Id через HTTP-подключения. Дополнительные сведения см. в статье о свойствах строки подключенияAnalysis-Services в документации по продукту.
• Обмен данными на основе HTTP улучшается с помощью более эффективного управления открытыми каналами HTTP на транспортном уровне, особенно при использовании библиотек .NET Core.

Пакеты AdomdClient и AMO версии 19.94.1.1 заменяют версию 19.94.0.0. Обновите до последней версии.

С версией 19.94.1.1:

• Классы параметров сериализации TMDL в пакете AMO включают набор методов расширения для упрощения их использования. Дополнительные сведения см. в справочной документации по API.
• Сведения об ошибках в определенных сценариях разработки семантической модели включают дополнительные сведения о нарушениях совместимости и перекрестных проблемах со ссылкой:
  • Нарушения совместимости: класс CompatibilityViolationException предоставляет подробные сведения в тексте сообщения для устранения неполадок. Дополнительные свойства, такие как SupportedCompatibilityLevel и CompatibilityLevelRequest, также предоставляют более подробные сведения.
  • Ошибки перекрестных ссылок: классы TmdlDeserializationWithReferenceErrorsException и JsonDeserializationWithReferenceErrorsException предоставляют подробные сообщения об ошибках, которые перечисляют неразрешенные свойства и предоставляют дополнительные сведения об ошибках перекрестных ссылок. Эти новые классы исключений могут помочь в обработке проблем десериализации TMDL и TMSL.

Начиная с версии 19.84.6 поддержка .NET FX 4.5 и .NET Core 3.0 в управляемых сборках больше недоступна. Теперь клиентские сборки AS выпускаются с поддержкой .NET FX 4.7.2, а также только .NET 6.0 и .NET 8.0.

Начиная с версии 19.82.0.0, AMO и ADOMD поддерживают профили служебных идентификаторов для проверки подлинности, как показано в следующем примере строки подключения. Дополнительные сведения см. в статье Использование профилей субъекта-службы для управления данными клиентов в мультитенантных приложениях. Пользователи не могут подключаться к рабочим областям, связанным с лицензией Premium Per-User, с помощью профилей сервисного принципала через конечную точку 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>

Начиная с версии 19.67.0, объекты подключения, такие как Майкрософт. AnalysisServices.AdomdClient.AdomdConnection и Майкрософт. AnalysisServices.Server поддерживает новое свойство AccessToken, позволяющее улучшить способ передачи внешних маркеров OAuth, используемых уровнем подключения XMLA. Дополнительные сведения см. в разделе Свойства строки подключения — идентификатор пользователя=...; Password=.

Начиная с версии 19.42.0.4, ADOMD.NET и AMO/TOM используют MSAL (Майкрософт. Identity.Client) версии 4.43.0 или выше вместо ADAL для проверки подлинности пользователей с Microsoft Entra ID при установке подключения к облачным службам, таким как Power-BI и Azure Analysis Services. Если ваше приложение или другой компонент, от которого зависит приложение, использует MSAL, может потребоваться обновить настройки перенаправления привязки приложения, если между версиями MSAL, используемыми компонентами, возникают конфликты.

AMO и ADOMD .Net Core

Поддерживаемые сценарии включают подключения к Azure Analysis Services, Power BI Premium и SQL Server Analysis Services. Подключение на основе TCP поддерживается только для Windows компьютеров.

Поддерживается интерактивный вход с Microsoft Entra ID только для компьютеров с Windows. Требуется среда выполнения .NET Core Desktop.

Зависимость в MSAL требует версии 4.43.0 или выше.

Версия 19.14.0 клиентских библиотек .NET Core представила предварительную поддержку публикации Self-Contained (как в опубликованном каталоге, так и в однофайловом режиме), а также поддержку для использования в проектах .NET 5.0. Исправлены некоторые проблемы, связанные с подключением к SQL Server Analysis Services, обнаруженным в предыдущем выпуске.

Версия 19.12.7.2 клиентских библиотек .Net Core представила поддержку SQL Server Analysis Services. Предыдущие версии предварительного просмотра поддерживали только семантические модели Azure Analysis Services и Power BI.

АМО

Начиная с версии 19.98.0.3 уровень совместимости по умолчанию для баз данных табличной модели — 1700. Базы данных, созданные без явного указания уровня совместимости, используют уровень 1700 по умолчанию.

Начиная с версии 19.84.6, поддержка TMDL в AMO\TOM рассматривается как имеющая статус общей доступности, и в области API не будет критических изменений.

Версия 19.12.3.0 клиентской библиотеки AMO представляет новое перечисление, Майкрософт. AnalysisServices.DataType. Однако предыдущее перечисление Майкрософт. AnalysisServices.Tabular.DataType по-прежнему существует. Если ваш код ссылается на предыдущее перечисление как DataType в файле кода, содержащем ссылки на оба пространства имен (Майкрософт.AnalysisServices, Майкрософт.AnalysisServices.Tabular), из-за неоднозначности может возникнуть ошибка при компиляции. Чтобы устранить ошибку, полностью укажите квалификацию ссылки на перечисление.

Версия 19.61.1.4 клиентской библиотеки AMO представляет изменение поведения отката транзакций Майкрософт. AnalysisServices.Server. В более ранних версиях вызов Server.RollbackTransaction() отправляет обработчику запрос на откат транзакции, а затем пытается откатить локальные изменения. В отличие от более ранних версий, в версиях 19.61.1.4 и более поздних, если локальные изменения невозможно безопасно откатить, табличные базы данных, включённые в транзакцию, блокируют любые дополнительные изменения до тех пор, пока они не будут полностью синхронизированы, а устаревшие изменения из откатированных транзакций не будут удалены. При изменении соответствующей табличной базы данных возникает исключение InvalidOperationException. Если код вызывает Server.RollbackTransaction(), рекомендуется следовать этому вызову с полной синхронизацией [Database.Refresh(true)] для любой табличной базы данных, которая изменяется в рамках транзакции.

Начиная с версии 19.77.0, при клонировании или копировании объекта метаданных в другой экземпляр объекта метаданных с помощью табличной объектной модели (TOM), TOM возвращает значение null для свойств, которые ссылались на объекты вне прямого дерева дочерних объектов MetadataObject. Необходимо добавить клонированный экземпляр MetadataObject в семантику модели, чтобы разрешить перекрестные ссылки на объекты вне дерева MetadataObject.

Например, при клонировании таблицы с разделом, ссылающимся на именованное выражение в EntityPartitionSource, свойство ExpressionSource объекта EntityPartitionSource возвращает значение NULL, пока клонированная таблица не будет добавлена в семантическую модель, как в фрагменте кода ниже, чтобы можно было разрешить ссылку на клонированный объект ExpressionSource. Клон необходимо добавить в модель, потому что ссылаемое по именам выражение является элементом коллекции выражений модели, а не частью иерархического дерева дочерних объектов таблицы.

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

ADOMD

Начиная с ADOMD (как .NET Framework, так и .NET Core) версии 19.61.1.4 сжатие полностью доступно на уровне транспорта XMLA. Предыдущие выпуски после версии 19.55.3.1 реализовали некоторую частичную поддержку сжатия. Были получены отчеты о проблемах с этими выпусками. Эти проблемы были исправлены в составе выпуска 16.61.1.4. Не забудьте обновить до версии 19.61.1.4 или более поздней версии, если возникают проблемы, связанные с сжатием.

MSOLAP

Начиная с версии 17.0.25.23, можно использовать дополнительный набор свойств строки подключения для управления интерфейсом проверки подлинности на основе Entra-Id через HTTP-подключения. Дополнительные сведения см. в статье о свойствах строки подключенияAnalysis-Services в документации по продукту.

Начиная с версии 16.0.139.27 MSOLAP поддерживает профили сервисных принципалов для проверки подлинности, как показано в следующем примере строки подключения. Дополнительные сведения см. в статье Использование профилей субъекта-службы для управления данными клиентов в мультитенантных приложениях.

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>

Начиная с версии 16.0.134.22 MSOLAP поддерживает автоматический единый вход без введения пароля (SSO) через Менеджер веб-аккаунтов (WAM), доступный в Windows 10 и более поздних версиях, а также Windows Server 2019 и более поздних версиях. При открытии нового HTTP-подключения MSOLAP получает маркер доступа следующим образом:

1. Если кэширование маркеров включено, а подходящий маркер доступен в кэше, MSOLAP использует кэшированный маркер.
2. Если подходящий кэшированный токен недоступен, MSOLAP пытается тихо получить токен доступа через WAM.
3. Если единый вход с использованием WAM не удался, MSOLAP переходит к интерактивной аутентификации и открывает окно входа.

Пользователи могут обойти процесс тихого единого входа и немедленно запустить интерактивный интерфейс проверки подлинности, указав пустой идентификатор пользователя в строке подключения (User ID='').

Начиная с версии 16.0.43.20 MSOLAP использует MSAL (Майкрософт. Identity.Client) версии 4.43.0 или выше вместо ADAL для проверки подлинности пользователей с Microsoft Entra ID при установке подключения к облачным службам, таким как Power-BI и Azure Analysis Services. Если ваше приложение или другой компонент, от которого зависит приложение, использует MSAL, может потребоваться обновить параметры перенаправления привязки приложения, если существуют конфликты между версиями MSAL, загруженными компонентами.

Регрессия, связанная с подключениями к облачным системам с помощью Microsoft Entra ID, обнаружена в версии OLEDB 16.0.4.17 (MSOLAP). Она была исправлена в версии 16.0.20.201. Из-за проблемы установленная версия 16.0.4.17, а также любая другая версия до 16.0.20.201, не может быть исправлена путем замены поставщика, даже если установка выполняется в режиме восстановления. Рекомендуется полностью удалить версию 16.0.4.17 [или другие проблемы], а затем установить версию 16.0.20.201 или более поздней.

В предыдущем выпуске MSOLAP было обновлено для подключения к облачным службам Analysis Services с использованием управляемой библиотеки Microsoft Authentication Library (MSAL). Начиная с версии 16.0.87.16, программа установки MSOLAP больше не устанавливает нативный компонент библиотеки проверки подлинности Azure Active Directory (ADAL).

Общие сведения о клиентских библиотеках

Службы Analysis Services используют три клиентские библиотеки. ADOMD.NET и объекты управления службами Analysis Services (AMO) являются клиентскими библиотеками. Поставщик OLE DB служб Analysis Services (MSOLAP DLL) — это нативная клиентская библиотека. Как правило, все три устанавливаются одновременно.

Клиентские приложения Майкрософт, такие как Power BI Desktop и Excel, устанавливают все три клиентские библиотеки и обновляют их при выходе новых версий. В зависимости от версии или частоты обновлений некоторые клиентские библиотеки могут не быть последними версиями, необходимыми для Azure Analysis Services и Power BI. Это же относится к пользовательским приложениям или другим интерфейсам, таким как AsCmd, TOM, ADOMD.NET. Для этих приложений требуется вручную или программно устанавливать библиотеки. Клиентские библиотеки для ручной установки включены в SQL Server пакеты компонентов в качестве распространяемых пакетов. Однако эти клиентские библиотеки привязаны к версии SQL Server и могут не быть последней. Убедитесь, что вы всегда устанавливаете последнюю, скачиваемую из этой статьи.

Типы клиентской библиотеки

Провайдер OLE DB для служб Analysis Services (MSOLAP)

Поставщик OLE DB для служб Analysis Services (MSOLAP) — это родная клиентская библиотека для подключения к базам данных Analysis Services. Он используется косвенно как ADOMD.NET, так и AMO, делегируя запросы на подключение к поставщику данных. Вы также можете вызвать поставщика OLE DB непосредственно из кода приложения.

Поставщик OLE DB служб Analysis Services устанавливается автоматически большинством средств и клиентских приложений, используемых для доступа к базам данных служб Analysis Services. Он должен быть установлен на компьютерах, используемых для доступа к данным служб Analysis Services.

Поставщики OLE DB часто указываются в строках подключения. Строка подключения для Analysis Services использует другую номенклатуру, чтобы указать на поставщика OLE DB: MSOLAP.<version>.dll.

АМО

AMO — это управляемая клиентская библиотека, используемая для администрирования сервера и определения данных. Он устанавливается и используется утилитами и клиентскими приложениями. Например, SQL Server Management Studio (SSMS) использует AMO для подключения к службам Analysis Services. Подключение с помощью AMO обычно минимальное, состоящее из "data source=\<servername>". После установки подключения используйте API для работы с коллекциями баз данных и основными объектами. Оба Visual Studio и SSMS используют AMO для подключения к экземпляру служб анализа.

ADOMD

ADOMD.NET — это клиентская библиотека управляемых данных, используемая для запроса данных служб Analysis Services. Он устанавливается и используется утилитами и клиентскими приложениями.

При подключении к базе данных свойства строка подключения для всех трех библиотек похожи. Почти любая строка подключения, которую вы определяете для ADOMD.NET с помощью Майкрософт.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString, также работает для AMO и поставщика OLE DB служб Analysis Services (MSOLAP). Дополнительные сведения см. в разделе свойства строки подключения.

Проверка установленных версий

OLEDDB (MSOLAP)

1. Перейдите к C:\Program Files\Майкрософт Analysis Services\AS OLEDB\. Если у вас несколько папок, выберите большее число.

2. Щелкните правой кнопкой мыши msolap.dll>Свойства>Сведения. Проверьте свойство product version. Примечание. Если имя файла msolap140.dll, оно старше последней версии и должно быть обновлено.

   диалоговое окно сведений о клиентской библиотеке MSOLAP

АМО

1. Перейдите на C:\Windows\Майкрософт.NET\assembly\GAC_MSIL\Майкрософт.AnalysisServices\. Если у вас несколько папок, выберите большее число.

2. Щелкните правой кнопкой мыши Майкрософт. AnalysisServices>Properties>Details.

   

ADOMD

1. Перейдите к C:\Windows\Майкрософт.NET\assembly\GAC_MSIL\Майкрософт.AnalysisServices.AdomdClient\. Если у вас несколько папок, выберите большее число.

2. Щелкните правой кнопкой мыши Майкрософт. AnalysisServices.AdomdClient>Properties>Details.

   диалоговое окно сведений о клиентской библиотеке ADOMD

Обновление вручную

Клиентские библиотеки обычно устанавливаются и обновляются автоматически вместе с инструментами и клиентскими приложениями, которые используют их. Однако в некоторых случаях клиентские библиотеки могут не обновляться автоматически, и каждый из них должен обновляться вручную. Чтобы обновить вручную, скачайте и запустите пакет установщика Windows (.msi) для каждой клиентской библиотеки.

Скачивание и обновление

1. Нажмите:

   • скачать MSOLAP (amd64) или скачать MSOLAP (x86)
   • Скачайте AMO
   • Скачивание ADOMD

2. В Downloads щелкните файл установщика Windows, чтобы запустить программу установки.

3. В разделе "Настройка" нажмите кнопку Далее.

4. Прочитайте лицензионное соглашение. Если вы согласны, выберите я принимаю условия лицензионного соглашения, а затем нажмите кнопку Далее.

5. Щелкните Установить.

6. По завершении нажмите кнопку Готово.