Bibliotecas cliente de Analysis Services
Se aplica a:
SQL Server Analysis Services Azure Analysis Services Power BI Premium
Se requieren bibliotecas de cliente para que las aplicaciones cliente y las herramientas de cliente se puedan conectar a Analysis Services. Las aplicaciones cliente de Microsoft como Power BI Desktop, Excel, SQL Server Management Studio (SSMS) y extensión de proyectos de Analysis Services para Visual Studio instalan las tres bibliotecas de cliente y las actualizan junto con las actualizaciones de aplicaciones normales. Las aplicaciones de cliente personalizadas también requieren la instalación de las bibliotecas de cliente. Las bibliotecas de cliente se actualizan mensualmente. Antes de descargar, asegúrese de ver problemas conocidos.
Descarga de la versión más reciente
Windows Installer
| Descargar | Versión |
|---|---|
| MSOLAP (amd64) | 16.0.39.19 |
| MSOLAP (x86) | 16.0.39.19 |
| AMO | 19.46.0.0 |
| ADOMD | 19.46.0.0 |
Paquetes NuGet
Los objetos de administración de Analysis Services (AMO) y las bibliotecas cliente de ADOMD están disponibles como paquetes instalables en NuGet.org. Se recomienda migrar a referencias de NuGet en lugar de usar Windows Installer.
A partir de febrero de 2021, también están disponibles las versiones de paquetes de .NET Core equivalentes a los paquetes cliente AMO y ADOMD. Sin embargo, hay algunos escenarios que no son compatibles con las versiones de .NET Core. Para más información, consulte Problemas conocidos más adelante en este artículo.
Los ensamblados del paquete de NuGet AssemblyVersion siguen el control de versiones semántico: PRINCIPAL.SECUNDARIA.REVISIÓN. Las referencias de NuGet cargan la versión esperada, incluso si hay una versión diferente en la caché global de ensamblados (resultante de la instalación de MSI). El valor de REVISIÓN se incrementa para cada publicación. Las versiones de AMO y ADOMD se mantienen sincronizadas.
AMO y ADOMD
| Paquete | Versión |
|---|---|
| AMO | 19.46.0.0 |
| ADOMD | 19.46.0.0 |
AMO y ADOMD .Net Core
| Paquete | Versión |
|---|---|
| AMO | 19.46.0.0 |
| ADOMD | 19.46.0.0 |
Versiones mínimas necesarias
La versión 1.0/1.1 del protocolo de seguridad de la capa de transporte (TLS) estará en desuso en Azure Active Directory el 30 de junio de 2021. En el futuro, se requiere TLS 1.2 y versiones posteriores. TLS 1.2 no se admite en versiones anteriores de las bibliotecas cliente de Analysis Services. Las versiones más recientes de la biblioteca cliente incluyen compatibilidad con TLS 1.2 y versiones posteriores, así como otras mejoras de seguridad importantes.
Para minimizar los riesgos y posibles vulnerabilidades de seguridad, a partir del 30 de junio de 2021, la seguridad mejorada en Azure Analysis Services y Power BI requieren las siguientes o versiones posteriores:
| Lib de cliente | Versión del archivo | Versión |
|---|---|---|
| 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 |
Problemas conocidos
AMO y ADOMD
A partir de la versión 19.42.0.4, ADOMD.NET y AMO/TOM usan MSAL (Microsoft.Identity.Client) versión 4.43.0 en lugar de ADAL para autenticar a los usuarios con AAD al establecer una conexión a servicios basados en la nube como Power-BI y Azure Analysis Services. Si la aplicación u otro componente de la aplicación depende de usa MSAL, es posible que sea necesario actualizar la configuración de redirección de enlace de la aplicación si hay conflictos entre las versiones de MSAL cargadas por los componentes.
AMO y ADOMD .Net Core
Entre los escenarios admitidos se incluyen conexiones a Azure Analysis Services, Power BI Premium y SQL Server Analysis Services. Solo se admite la conectividad basada en TCP para equipos Windows.
El inicio de sesión interactivo con Azure Active Directory solo es compatible con equipos Windows. Se requiere el entorno de ejecución de escritorio de .NET Core.
La dependencia en MSAL requiere la versión 4.43.0 y posteriores.
La versión 19.14.0 de las bibliotecas cliente de .Net Core introdujo compatibilidad con la versión preliminar para la publicación de Self-Contained (tanto en un directorio publicado como en modo de archivo único), así como compatibilidad con el consumo de proyectos de .NET 5.0. Se han corregido varios problemas relacionados con la conectividad con SQL Server Analysis Services identificados en la versión anterior.
La versión 19.12.7.2 de las bibliotecas cliente de .Net Core introdujo compatibilidad con SQL Server Analysis Services. Versiones preliminares inferiores solo se admiten Azure Analysis Services y conjuntos de datos de Power BI.
AMO
La versión 19.12.3.0 de la biblioteca cliente de AMO presenta una nueva enumeración , Microsoft.AnalysisServices.DataType. Sin embargo, la enumeración anterior, Microsoft.AnalysisServices.Tabular.DataType todavía existe. Si el código hace referencia a la enumeración anterior simplemente como DataType en un archivo de código con instrucciones en ambos espacios de nombres (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular), debido a la ambigüedad, podría obtener un error al compilar. Para resolver el error, califica completamente la referencia a la enumeración.
MSOLAP
Se detectó una regresión relacionada con las conexiones a sistemas basados en la nube mediante AAD en la versión 16.0.4.17 de OLEDB (MSOLAP). Se corrigió en la versión 16.0.20.201. Debido a la naturaleza del problema, una versión instalada 16.0.4.17, así como cualquier otra versión anterior a la 16.0.20.201, no se puede corregir simplemente actualizando el proveedor, incluso si el programa de instalación se ejecuta en modo de reparación. Se recomienda desinstalar completamente la versión 16.0.4.17 [u otra problemática] y, a continuación, instalar la versión 16.0.20.201 o posterior.
Descripción de las bibliotecas de cliente
Analysis Services utiliza tres bibliotecas cliente. ADOMD.NET y Analysis Services Management Objects (AMO) son bibliotecas de cliente administradas. Y el proveedor OLE DB de Analysis Services (DLL MSOLAP) es una biblioteca cliente nativa. Normalmente, las tres bibliotecas se instalan al mismo tiempo.
Las aplicaciones cliente de Microsoft, como Power BI Desktop y Excel, instalan las tres bibliotecas de cliente y las actualizan cuando hay nuevas versiones disponibles. En función de la versión o la frecuencia de las actualizaciones, es posible que algunas bibliotecas de cliente no sean las versiones más recientes requeridas por Azure Analysis Services y Power BI. Esto mismo se aplica a aplicaciones personalizadas u otras interfaces, como AsCmd, TOM, ADOMD.NET. Estas aplicaciones requieren la instalación manual o mediante programación de las bibliotecas. Las bibliotecas de cliente para la instalación manual se incluyen en los paquetes de características de SQL Server como paquetes de distribución. Sin embargo, estas bibliotecas de cliente están asociadas a la versión de SQL Server y no pueden ser la versión más reciente. Asegúrese de instalar siempre la versión más reciente y descargable de este artículo.
Tipos de biblioteca de cliente
Proveedor OLE DB Analysis Services (MSOLAP)
El proveedor OLE DB de Analysis Services (MSOLAP) es la biblioteca de cliente nativa para las conexiones de base de datos de Analysis Services. Es utilizada indirectamente por ADOMD.NET y AMO, que delegan las solicitudes de conexión en el proveedor de datos. También se puede llamar al proveedor OLE DB directamente desde el código de la aplicación.
El proveedor OLE DB de Analysis Services se instala automáticamente con la mayoría de las herramientas y aplicaciones cliente usadas para tener acceso a las bases de datos de Analysis Services. Debe instalarse en los equipos que se utilizan para tener acceso a datos de Analysis Services.
Los proveedores OLE DB suelen especificarse en las cadenas de conexión. Una cadena de conexión de Analysis Services usa una nomenclatura diferente para hacer referencia al proveedor OLE DB: MSOLAP.< versión>.dll.
AMO
AMO es una biblioteca de cliente administrada que se usa para la administración del servidor y la definición de datos. Las herramientas y aplicaciones de cliente la instalan y utilizan. Por ejemplo, SQL Server Management Studio (SSMS) usa AMO para conectarse a Analysis Services. La conexión mediante AMO suele ser mínima y consta de "data source=\<servername>". Una vez establecida una conexión, use la API para trabajar con las colecciones de base de datos y los objetos principales. Tanto Visual Studio como SSMS usan AMO para conectarse a una instancia de Analysis Services.
ADOMD
ADOMD.NET es una biblioteca de cliente de datos administrados que se usa para consultar datos de Analysis Services. Las herramientas y aplicaciones de cliente la instalan y utilizan.
Al conectarse a una base de datos, las propiedades de la cadena de conexión para las tres bibliotecas son similares. Casi cualquier cadena de conexión que defina para ADOMD.NET mediante Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString también funciona para AMO y el proveedor OLE DB de Analysis Services (MSOLAP). Para más información, consulte Propiedades de cadena de conexión.
Buscar versiones instaladas
OLEDDB (MSOLAP)
Ir a
C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Si tiene más de una carpeta, elija el número más alto.Haga clic con el botón derecho en msolap.dll>Propiedades>Detalles. Compruebe la propiedad Versión del producto . Nota: Si el nombre de archivo es msolap140.dll, es anterior a la versión más reciente y debe actualizarse.
AMO
Ir a
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Si tiene más de una carpeta, elija el número más alto.Haga clic con el botón derecho en Microsoft.AnalysisServices>Propiedades>Detalles.
ADOMD
Ir a
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Si tiene más de una carpeta, elija el número más alto.Haga clic con el botón derecho en Microsoft.AnalysisServices.AdomdClient>Propiedades>Detalles.
Actualización manual de
Normalmente, las bibliotecas cliente se instalan y actualizan automáticamente junto con herramientas y aplicaciones cliente que las usan. Sin embargo, en algunos casos es posible que las bibliotecas cliente no se actualicen automáticamente y cada una de ellas se debe actualizar manualmente. Para actualizar manualmente, descargue y ejecute el paquete de Windows Installer (.msi) para cada biblioteca cliente.
Para descargar y actualizar
Haga clic en:
En Descargas, haga clic en un paquete de Windows Installer para ejecutar el programa de instalación.
En Configuración, haga clic en Siguiente.
Lea el contrato de licencia. Si está de acuerdo, seleccione Acepto los términos del contrato de licencia y, a continuación, haga clic en Siguiente.
Haga clic en Instalar.
Cuando haya finalizado, haga clic en Finalizar.