Compartir a través de

Propiedades de cadenas de conexión (Analysis Services)

En este tema se documentan las propiedades de la cadena de conexión que puede establecer en una de las herramientas de administración o del diseñador, o que puede ver en las cadenas de conexión creadas por aplicaciones cliente que se conectan a los datos de Analysis Services y los consultan. Por lo tanto, abarca solo un subconjunto de las propiedades disponibles. La lista completa incluye numerosas propiedades de servidor y base de datos, lo que le permite personalizar una conexión para una aplicación específica, independientemente de cómo se configura la instancia o la base de datos en el servidor.

Los desarrolladores que compilan cadenas de conexión personalizadas en el código de aplicación deben revisar la documentación de la API para ADOMD.NET cliente para ver una lista más detallada: ConnectionString

Las propiedades descritas en este tema se usan en las bibliotecas cliente de Analysis Services, ADOMD.NET, AMO y el proveedor OLE DB para Analysis Services. La mayoría de las propiedades de cadena de conexión se pueden usar con las tres bibliotecas cliente. Las excepciones se mencionan en la descripción.

Este tema incluye las siguientes secciones:

Parámetros de conexión en uso común

Autenticación y seguridad

Parámetros de propósito especial

Reservada para uso futuro

Cadenas de conexión de ejemplo

Formatos de cadena de conexión usados en Analysis Services

Cifrado de cadenas de conexión

Nota:

Al establecer propiedades, si establece accidentalmente la misma propiedad dos veces, se usa la última de la cadena de conexión.

Para obtener más información sobre cómo especificar una conexión de Analysis Services en aplicaciones de Microsoft existentes, consulte Conexión desde aplicaciones cliente (Analysis Services).

Parámetros de conexión en uso común

En la tabla siguiente se describen las propiedades que se usan con más frecuencia al crear una cadena de conexión.

Propiedad Descripción Ejemplo
Data Source o DataSource Especifica la instancia del servidor. Esta propiedad es necesaria para todas las conexiones. Los valores válidos incluyen el nombre de red o la dirección IP del servidor, local o localhost para las conexiones locales, una dirección URL si el servidor está configurado para el acceso HTTP o HTTPS, o el nombre de un archivo de cubo local (.cub). Data source=AW-SRV01 para la instancia y el puerto predeterminados (TCP 2383).

Data source=AW-SRV01$Finance:8081 para una instancia con nombre ($Finance) y un puerto fijo.

Data source=AW-SRV01.corp.Adventure-Works.com para un nombre de dominio totalmente calificado, suponiendo que la instancia y el puerto predeterminados.

Data source=172.16.254.1 para una dirección IP del servidor, sin utilizar la consulta con el servidor DNS, lo cual es útil para solucionar problemas de conexión.
Initial Catalog o Catalog Especifica el nombre de la base de datos de Analysis Services a la que se va a conectar. La base de datos debe implementarse en Analysis Services y debe tener permiso para conectarse a ella. Esta propiedad es opcional para las conexiones de AMO, pero es necesaria para ADOMD.NET. Initial catalog=AdventureWorks2012
Provider Los valores válidos incluyen MSOLAP o MSOLAP.<versión>, donde <versión> es 3, 4 o 5. En el sistema de archivos, el nombre del proveedor de datos es msolap110.dll para la versión de SQL Server 2012, msolap100.dll para SQL Server 2008 y 2008 R2 y msolap90.dll para SQL Server 2005.

La versión actual es MSOLAP.5. Esta propiedad es opcional. De forma predeterminada, las bibliotecas cliente leen la versión actual del proveedor OLE DB del registro. Solo tiene que establecer esta propiedad si necesita una versión específica del proveedor de datos, por ejemplo, para conectarse a una instancia de SQL Server 2008.

Los proveedores de datos corresponden a versiones de SQL Server. Si su organización usa versiones actuales y anteriores de Analysis Services, es probable que tenga que especificar qué proveedor usar en las cadenas de conexión que cree a mano. Es posible que también tenga que descargar e instalar versiones específicas del proveedor de datos en equipos que no tengan la versión que necesita. Puede descargar el proveedor OLE DB desde las páginas del SQL Server Feature Pack en el Centro de descargas. Vaya a Microsoft SQL Server 2012 Feature Pack para descargar el proveedor OLE DB de Analysis Services para SQL Server 2012.

MSOLAP.4 se publicó en SQL Server 2008 y SQL Server 2008 R2. La versión 2008 R2 admite libros PowerPivot y, a veces, debe instalarse manualmente en servidores de SharePoint. Para distinguir entre estas versiones, debe comprobar el número de compilación en las propiedades de archivo del proveedor: Vaya a Archivos de programa\Microsoft Analysis Services\AS OLEDB\10. Haga clic con el botón derecho en msolap110.dll y seleccione Propiedades. Haga clic en Detalles. Vea la información de la versión del archivo. La versión debe incluir la versión 10.50.<buildnumber> para SQL Server 2008 R2. Para obtener más información, vea Instalar el proveedor OLE DB de Analysis Services en servidores de SharePoint y proveedores de datos usados para las conexiones de Analysis Services.

MSOLAP.3 se publicó en SQL Server 2005.

MSOLAP.4 se publicó en SQL Server 2008 y de nuevo SQL Server 2008 R2

MSOLAP.5 se publicó en SQL Server 2012		 Provider=MSOLAP.3 se usa para las conexiones que requieren la versión de SQL Server 2005 del proveedor OLE DB para Analysis Services.
Cube Nombre del cubo o nombre de perspectiva. Una base de datos puede contener varios cubos y perspectivas. Cuando hay varios objetivos posibles, incluya el nombre del cubo o de la perspectiva en la cadena de conexión. Cube=SalesPerspective indica que puede usar la propiedad de la cadena de conexión de Cube para especificar el nombre de un cubo o el nombre de una perspectiva.

Autenticación y seguridad

En esta sección se incluyen las propiedades de cadena de conexión relacionadas con la autenticación y el cifrado. Analysis Services solo usa la autenticación de Windows, pero puede establecer propiedades en la cadena de conexión para pasar un nombre de usuario y una contraseña específicos.

Las propiedades se enumeran en orden alfabético.

Propiedad Descripción
EffectiveUserName Use cuando se debe suplantar una identidad de usuario final en el servidor. Especifique la cuenta en un formato domain\user. Para usar esta propiedad, el autor de la llamada debe tener permisos administrativos en Analysis Services. Para obtener más información sobre cómo usar esta propiedad en un libro de Excel de SharePoint, vea Usar EffectiveUserName de Analysis Services en SharePoint Server 2013. Para obtener un ejemplo de cómo se utiliza esta propiedad con Reporting Services, consulte Uso de EffectiveUserName para impersonar en SSAS.

EffectiveUserName se usa en una instalación de PowerPivot para SharePoint para capturar información de uso. La identidad de usuario se proporciona al servidor para que los eventos o errores que incluyan la identidad de usuario se puedan registrar en los archivos de registro. En el caso de PowerPivot, no se usa con fines de autorización.
Cifrar contraseña Especifica si se va a usar una contraseña local para cifrar cubos locales. Los valores válidos son True o False. El valor predeterminado es False.
Encryption Password Contraseña usada para descifrar un cubo local cifrado. El valor predeterminado está vacío. El usuario debe establecer explícitamente este valor.
Impersonation Level Indica el nivel de suplantación que el servidor puede usar al suplantar al cliente. Entre los valores válidos se incluyen:

Anónimo: el cliente es anónimo para el servidor. El proceso de servidor no puede obtener información sobre el cliente ni se puede suplantar al cliente.

Identificar: el proceso de servidor puede obtener la identidad del cliente. El servidor puede suplantar la identidad de cliente con fines de autorización, pero no puede tener acceso a objetos del sistema como cliente.

Suplantar: Este es el valor predeterminado. La identidad del cliente se puede suplantar, pero solo cuando se establece la conexión y no en todas las llamadas.

Delegado: El proceso del servidor puede suplantar el contexto de seguridad del cliente mientras actúa en representación del cliente. El proceso del servidor también puede realizar llamadas salientes a otros servidores mientras actúa en nombre del cliente.
Integrated Security La identidad de Windows del autor de la llamada se usa para conectarse a Analysis Services. Los valores válidos son en blanco, SSPI y BASIC.

Integrated Security = SSPI es el valor predeterminado para las conexiones TCP, lo que permite la autenticación NTLM, Kerberos o Anónima. Blank es el valor predeterminado para las conexiones HTTP.

Al usar SSPI, ProtectionLevel debe establecerse en una de las siguientes opciones: Connect, PktIntegrity, PktPrivacy.
Persist Encrypted Establezca esta propiedad cuando la aplicación cliente requiera que el objeto de origen de datos conserve información confidencial de autenticación, como una contraseña, en formato cifrado. De forma predeterminada, la información de autenticación no se conserva.
Persist Security Info Los valores válidos son True y False. Cuando se establece en True, la información de seguridad, como la identidad de usuario o la contraseña especificadas anteriormente en la cadena de conexión, se puede obtener de la conexión una vez realizada la conexión. El valor predeterminado es False.
ProtectionLevel Determina el nivel de seguridad usado en la conexión. Los valores válidos son:

None. Conexiones no autenticadas o anónimas. No realiza ninguna autenticación en los datos enviados al servidor.

Connect. Conexiones autenticadas. Solo se autentica cuando el cliente establece una relación con un servidor.

PktIntegrity. Conexiones cifradas. Comprueba que todos los datos se reciben del cliente y que no se han cambiado en tránsito.

PktPrivacy. Cifrado firmado, solo compatible con XMLA. Comprueba que todos los datos se reciben del cliente, que no se han cambiado en tránsito y protegen la privacidad de los datos mediante el cifrado.



Para obtener más información, consulte Establecimiento de conexiones seguras en ADOMD.NET
Roles Especifique una lista delimitada por comas de roles predefinidos para conectarse a un servidor o base de datos mediante permisos transmitidos por ese rol. Si se omite esta propiedad, se usan todos los roles y los permisos efectivos son la combinación de todos los roles. Al establecer la propiedad en un valor vacío (por ejemplo, Roles=' '), la conexión del cliente no tendrá asociación con roles.

Un administrador que usa esta propiedad se conecta mediante los permisos transmitidos por el rol. Es posible que se produzca un error en algunos comandos si el rol no proporciona permiso suficiente.
SSPI Especifica explícitamente qué paquete de seguridad se va a usar para la autenticación de cliente cuando Integrated Security se establece en SSPI. SSPI admite varios paquetes, pero puede usar esta propiedad para especificar un paquete determinado. Los valores válidos son Negotiate, Kerberos, NTLM y Usuario anónimo. Si no se establece esta propiedad, todos los paquetes estarán disponibles para la conexión.
Use Encryption for Data Cifra las transmisiones de datos. Los valores de valor son True y False.
User ID=...; Password= User ID y Password se usan juntos. Analysis Services suplanta la identidad de usuario especificada a través de estas credenciales. En una conexión de Analysis Services, la colocación de credenciales en la línea de comandos solo se usa cuando el servidor está configurado para el acceso HTTP y especificó la autenticación básica en lugar de la seguridad integrada en el directorio virtual de IIS.

El nombre de usuario y la contraseña deben ser las credenciales de una identidad de Windows, ya sea una cuenta de usuario local o de dominio. Observe que User ID tiene un espacio incrustado. Otros alias de esta propiedad incluyen UserName (sin espacio) y UID. El alias de Password es PWD.

Parámetros de propósito especial

En esta sección se describe el resto de los parámetros de cadena de conexión. Se usan para garantizar comportamientos de conexión específicos requeridos por una aplicación.

Las propiedades se enumeran en orden alfabético.

Propiedad Descripción
Application Name Establece el nombre de la aplicación asociada a la conexión. Este valor puede ser útil al supervisar eventos de seguimiento, especialmente cuando tiene varias aplicaciones que acceden a las mismas bases de datos. Por ejemplo, agregar Nombre de aplicación="test" a una cadena de conexión hace que "test" aparezca en un seguimiento de SQL Server Profiler, como se muestra en la captura de pantalla siguiente:

SSAS_AppNameExcample

Los alias de esta propiedad incluyen sspropinitAppName, AppName. Para obtener más información, vea Usar el parámetro Nombre de aplicación al conectarse a SQL Server.
AutoSyncPeriod Establece la frecuencia (en milisegundos) de sincronización de caché de cliente y servidor. ADOMD.NET proporciona almacenamiento en caché de cliente para objetos usados con frecuencia que tienen una sobrecarga mínima de memoria. Esto ayuda a reducir el número de recorridos de ida y vuelta al servidor. El valor predeterminado es 10000 milisegundos (o 10 segundos). Cuando se establece en NULL o 0, la sincronización automática está desactivada.
Character Encoding Define cómo se codifican los caracteres en la solicitud. Los valores válidos son Default o UTF-8 (son equivalentes) y UTF-16
CompareCaseSensitiveStringFlags Ajusta las comparaciones de cadenas que son sensibles a mayúsculas y minúsculas para un locale especificado. Para obtener más información sobre cómo establecer esta propiedad, vea CompareCaseSensitiveStringFlags Propiedad.
Compression Level Si TransportCompression es XPRESS, puede establecer el nivel de compresión para controlar la cantidad de compresión que se usa. Los valores válidos son de 0 a 9, con 0 con una compresión mínima y 9 con la mayor compresión. El aumento de la compresión ralentiza el rendimiento. El valor predeterminado es 0.
Connect Timeout Determina la cantidad máxima de tiempo (en segundos) que el cliente intenta una conexión antes de que se agote el tiempo de espera. Si una conexión no se realiza correctamente en este período, el cliente deja de intentar conectarse y genera un error.
MDX Compatibility El propósito de esta propiedad es garantizar un conjunto coherente de comportamientos MDX para las aplicaciones que emiten consultas MDX. Excel, que utiliza consultas MDX para rellenar y calcular una tabla dinámica conectada a Analysis Services, establece esta propiedad en 1, para garantizar que los miembros de marcador de posición en las jerarquías irregulares sean visibles en una tabla dinámica. Los valores válidos incluyen 0, 1, 2.

0 y 1 muestran elementos de marcador de posición; 2 no lo hace. Si está vacío, se supone que es 0.
MDX Missing Member Mode=Error Indica si los miembros que faltan se omiten en las instrucciones MDX. Los valores válidos son Default, Error y Ignore. El valor predeterminado usa un valor definido por el servidor. El error genera un error cuando un miembro no existe. Ignore especifica que se deben omitir los valores que faltan.
Optimize Response Máscara de bits que indica cuál de las siguientes optimizaciones de respuesta de consulta están habilitadas.

0x01: valor predeterminado. Uso de NormalTupleSet
0x02: usar cuando los filtros están vacíos
Packet Size Tamaño de paquete de red (en bytes) entre 512 y 32.767. El tamaño de paquete de red predeterminado es 4096.
Protocol Format Establece el formato del XML enviado al servidor. Los valores válidos son Default, XML o Binary. El protocolo es XMLA. Puede especificar que el XML se envíe en formato comprimido (este es el valor predeterminado), como XML sin formato o en un formato binario. El formato binario codifica los atributos y elementos XML, lo que los hace más pequeños. La compresión es un formato propietario que reduce aún más el tamaño de las solicitudes y respuestas. Los formatos de compresión y binarios se usan para acelerar las solicitudes y respuestas de transferencia de datos.

Debe usar una biblioteca cliente en la conexión si usa formato binario o comprimido. El proveedor OLE DB puede dar formato a solicitudes y respuestas en formato binario o comprimido. AMO y ADOMD.NET formatean las solicitudes en formato de texto, pero aceptan respuestas en formato binario o comprimido.

Esta propiedad de cadena de conexión es equivalente a las configuraciones de servidor EnableBinaryXML y EnableCompression.
Real Time Olap Establezca esta propiedad para omitir el almacenamiento en caché, lo que hace que todas las particiones escuchen activamente las notificaciones de consulta. De forma predeterminada, esta propiedad no está establecida.
Safety Options Establece el nivel de seguridad de las funciones y acciones definidas por el usuario. Los valores válidos son 0, 1, 2. En una conexión de Excel, esta propiedad es Safety Options=2. Puede encontrar detalles sobre esta opción en ConnectionString.
SQLQueryMode Especifica si las consultas SQL incluyen cálculos. Los valores válidos son Data, Calculated, IncludeEmpty. Los datos significan que no se permite ningún cálculo. Calculado permite realizar cálculos. IncludeEmpty permite que los cálculos y las filas vacías se devuelvan en el resultado de la consulta.
Timeout Especifica cuánto tiempo (en milisegundos) la biblioteca cliente espera a que se complete un comando antes de generar un error.
Transport Compression Define cómo se comprimen las comunicaciones de cliente y servidor, cuando se especifica la compresión a través de la Protocol Format propiedad . Los valores válidos son Default, None, Compressed y gzip. El valor predeterminado no es ninguna compresión para TCP o gzip para HTTP. Ninguno indica que no se usa ninguna compresión. Comprimido usa la compresión XPRESS (SQL Server 2008 y versiones posteriores). gzip solo es válido para las conexiones HTTP, donde la solicitud HTTP incluye Accept-Encoding=gzip.
UseExistingFile Se usa al conectarse a un cubo local. Esta propiedad especifica si se sobrescribe o no el cubo local. Los valores válidos son True o False. Si se establece en True, el archivo de cubo debe existir. El archivo existente será el destino de la conexión. Si se establece en False, se sobrescribe el archivo de cubo.
VisualMode Establezca esta propiedad para controlar cómo se agregan los miembros cuando se aplica la seguridad de dimensión.

Para los datos de cubo que todos los usuarios pueden ver, la agregación de todos los miembros tiene sentido porque todos los valores que contribuyen al total son visibles. Sin embargo, si filtra o restringe las dimensiones en función de la identidad del usuario, mostrar un total basado en todos los miembros (combinando valores restringidos y permitidos en un solo total) puede resultar confuso o mostrar más información de la que se debe revelar.

Para especificar cómo se agregan los miembros cuando se aplica la seguridad de dimensión, puede establecer esta propiedad en True para usar solo los valores permitidos en la agregación o False para excluir los valores restringidos del total.

Cuando se establece en la cadena de conexión, este valor se aplica al nivel de cubo o perspectiva. Dentro de un modelo, puede controlar los detalles visuales en un nivel más granular.

Los valores válidos son 0, 1 y 2.

0 es el valor predeterminado. Actualmente, el comportamiento predeterminado es equivalente a 2, donde las agregaciones incluyen valores ocultos del usuario.

1 excluye los valores ocultos del total. Este es el valor predeterminado para Excel.

2 incluye valores ocultos en el total. Este es el valor predeterminado en el servidor.



Los alias de esta propiedad incluyen Visual Total o Default MDX Visual Mode.

Reservado para uso futuro

Las siguientes propiedades se permiten en una cadena de conexión, pero no están operativas en las versiones actuales de Analysis Services.

  • Usuario autenticado

  • Autenticación de caché

  • Modo de caché (el uso de esta propiedad se ha investigado en versiones anteriores. Aunque puede encontrar entradas de blog que recomiendan su uso, debe evitar establecer esta propiedad a menos que se lo indique el soporte técnico de Microsoft).

  • Directiva de caché

  • Proporción de caché

  • Proporción de caché2

  • Límite de depuración dinámica

  • Modo de depuración

  • Modo

  • Compatibilidad SQL

  • Usar caché de fórmulas

Ejemplos de cadena de conexión

En esta sección se muestra la cadena de conexión que probablemente usará al configurar una conexión de Analysis Services en aplicaciones usadas habitualmente.

Cadena de conexión genérica

Puede usar una cadena de conexión como esta si va a configurar una conexión desde Reporting Services.

Data source=<servername>; initial catalog=<databasename>

Cadena de conexión en Excel

La cadena de conexión predeterminada de ADOMD.NET en Excel especifica el proveedor de datos, el servidor, el nombre de la base de datos y la seguridad integrada de Windows. El nivel de compatibilidad MDX siempre se establece en 1. Aunque puede cambiar el valor de la sesión actual, Excel restablecerá MDX Compatibility to1 cuando el archivo se abra a continuación.

Provider=MSOLAP.5;Integrated Security=SSPI;Persist Security Info=True;Initial Catalog=Adventure Works DW 2008R2;Data Source=AW-SRV01;MDX Compatibility=1;Safety Options=2;MDX Missing Member Mode=Error

Para obtener más información, vea Conexiones de datos, orígenes de datos y cadenas de conexión en Reporting Services y autenticación de datos para Excel Services en SharePoint Server 2013.

Formatos de cadena de conexión usados en Analysis Services

En esta sección se enumeran todos los formatos de cadena de conexión admitidos por Analysis Services. Con la excepción de las conexiones a bases de datos PowerPivot, puede especificar estas cadenas de conexiones en las aplicaciones que se conectan a Analysis Services.

Conexiones nativas (o directas) al servidor

Data Source=server[:port][\instance] donde "port" y "\instance" son opcionales. Por ejemplo, al especificar "Data Source=server1" se abre una conexión a la instancia predeterminada (y el puerto predeterminado 2383) en un servidor denominado "server1".

"Data Source=server1:port1" abrirá una conexión a una instancia de Analysis Services que se ejecuta en el puerto "port1" en "server1".

"Data Source=server1\instance1" abrirá una conexión a SQL Browser (en su puerto predeterminado 2382), resolverá el puerto de la instancia con nombre "instance1" y, a continuación, abrirá la conexión a ese puerto de Analysis Services.

"Data Source=server1:port1\instance1" abrirá una conexión a SQL Browser en "port1", resolverá el puerto de la instancia con nombre "instance1" y, a continuación, abrirá la conexión a ese puerto de Analysis Services.

Conexiones de cubo local (archivos .cub)

Data Source=<path>, por ejemplo, "Data Source=c:\temp\a.cub"

Conexiones HTTP a msmdpump.dll

Data Source=<URL>, donde la dirección URL es la dirección HTTP o HTTPS de la carpeta IIS virtual que contiene el msmdpump.dll. Para obtener más información, vea Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 8.0.

Conexiones HTTP a libros PowerPivot (.xlsx, archivos .xlsb o .xlsm)

Data Source=<URL>, donde la dirección URL es la ruta de acceso de SharePoint a un libro PowerPivot que se ha publicado en una biblioteca de SharePoint. Por ejemplo, "Origen de datos=https://localhost/Shared Documentos/Sales.xlsx".

Conexiones HTTP a archivos de conexión de modelo semántico de BI

Data Source=<URL> donde la dirección URL es la ruta de acceso de SharePoint al archivo .bism. Por ejemplo, "Origen de datos=https://localhost/Shared Documentos/Sales.bism".

Conexiones PowerPivot incrustadas

Data Source=$Embedded$ donde $embedded$ es un identificador que hace referencia a un modelo de datos PowerPivot incrustado dentro del libro de trabajo. Esta cadena de conexión se crea y administra internamente. No lo modifique. Las cadenas de conexión incrustadas se resuelven mediante el complemento PowerPivot para Excel en estaciones de trabajo cliente, o mediante instancias de PowerPivot para SharePoint en una granja de SharePoint.

Contexto del servidor local en procedimientos almacenados de Analysis Services

Data Source=*, donde * se resuelve en la instancia local.

Cifrado de cadenas de conexión

Analysis Services cifra y almacena las cadenas de conexión que usa para conectarse a cada uno de sus orígenes de datos. Si la conexión a un origen de datos requiere un nombre de usuario y una contraseña, puede hacer que Analysis Services almacene el nombre y la contraseña con la cadena de conexión, o bien solicitarle el nombre y la contraseña cada vez que se requiera una conexión al origen de datos. El hecho de que Analysis Services le pida información de usuario significa que esta información no tiene que almacenarse y cifrarse. Sin embargo, si almacena esta información en la cadena de conexión, esta información debe cifrarse y protegerse.

Para cifrar y proteger la información de la cadena de conexión, Analysis Services usa la API de protección de datos. Analysis Services usa una clave de cifrado independiente para cifrar la información de cadena de conexión para cada base de datos de Analysis Services. Analysis Services crea esta clave al crear una base de datos y cifra la información de la cadena de conexión en función de la cuenta de inicio de Analysis Services. Cuando se inicia Analysis Services, la clave cifrada de cada base de datos se lee, descifra y almacena. A continuación, Analysis Services usa la clave descifrada adecuada para descifrar la información de la cadena de conexión del origen de datos cuando Analysis Services necesita conectarse a un origen de datos.

Véase también

Configuración del acceso HTTP a Analysis Services en Internet Information Services (IIS) 8.0
Configurar Analysis Services para la delegación restringida de Kerberos
Proveedores de datos usados para las conexiones de Analysis Services
Conexión a Analysis Services

  • Last updated on