Propiedades de cadena de conexión (Analysis Services)

Artículo
11/10/2015

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

Los desarrolladores que compilen cadenas de conexión personalizadas en el código de la aplicación deben consultar la documentación de la API del cliente ADOMD.NET con el fin de obtener una lista más detallada: ConnectionString

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

En este tema se incluyen las secciones siguientes:

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

Autenticación y seguridad

Parámetros de uso especial

Reservado para uso futuro

Ejemplos de cadena de conexión

Formatos de cadena de conexión usados en Analysis Services

Cifrar cadenas de conexión

[!NOTA]

Si al establecer propiedades se establece involuntariamente 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, vea Conectarse desde aplicaciones cliente (Analysis Services).

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

En la tabla siguiente se describen las propiedades más usadas para generar una cadena de conexión.

Propiedad	Descripción	Ejemplo
Data Source o bien 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 acceso HTTP o HTTPS, o el nombre de un archivo de cubo (.cub) local.	Data source=AW-SRV01 para la instancia predeterminada y el puerto (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 completo, suponiendo la instancia y el puerto predeterminados. Data source=172.16.254.1 para una dirección IP del servidor, omitiendo la búsqueda del servidor DNS, que es útil para solucionar problemas de conexión.
Initial Catalog o bien Catalog	Especifica el nombre de la base de datos de Analysis Services a la que se va a conectar. La base de datos se debe implementar en Analysis Services y debe tener permiso para conectarse a ella. Esta propiedad es opcional para las conexiones de AMO, pero es obligatoria 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, msolap110.dll para SQL Server 2008 y 2008 R2 y msolap90.dll para SQL Server 2005. MSOLAP.3 se publicó en SQL Server 2005. MSOLAP.4 se publicó en SQL Server 2008 y en SQL Server 2008 R2 MSOLAP.5 se publicó en SQL Server 2012 La versión actual es MSOLAP.5. Esta propiedad es opcional. De forma predeterminada, las bibliotecas de cliente leen la versión actual del proveedor OLE DB del Registro. Solo necesita 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 las versiones de SQL Server. Si su organización usa la versión actual y versiones anteriores de Analysis Services, lo más probable es que tenga que especificar manualmente qué proveedor usará en las cadenas de conexión que cree. Puede que también sea necesario descargar e instalar versiones específicas del proveedor de datos en aquellos equipos que no tengan la versión necesaria. Puede descargar el proveedor OLE DB desde las páginas de SQL Server Feature Pack del Centro de descarga. 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ó tanto en SQL Server 2008 como en SQL Server 2008 R2. La versión 2008 R2 admite libros PowerPivot en ocasiones debe instalarse manualmente en los servidores de SharePoint. Para distinguir entre estas versiones, debe comprobar el número de compilación en las propiedades de archivo del proveedor: En Archivos de programa\Microsoft Analysis Service\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 10.50.<númeroDeCompilación> 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 Bibliotecas de cliente usadas para conexiones de Analysis Services.	Provider=MSOLAP.3 se usa para las conexiones que necesitan la versión SQL Server 2005 del proveedor OLE DB para Analysis Services.
Cube	Nombre del cubo o nombre de la perspectiva. Una base de datos puede contener varios cubos y perspectivas. Cuando hay varios destinos posibles, incluya el nombre del cubo o de la perspectiva en la cadena de conexión.	Cube=SalesPerspective muestra que puede usar la propiedad de cadena de conexión Cube para especificar el nombre de un cubo o el nombre de una perspectiva.

Autenticación y seguridad

Esta sección incluye 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 muestran en orden alfabético.

Propiedad	Descripción
EffectiveUserName	Se emplea cuando se debe suplantar una identidad de usuario final en el servidor. Especifique la cuenta en el formato dominio\usuario. Para usar esta propiedad, el autor de la llamada debe tener permisos administrativos en Analysis Services. Para obtener más información acerca de esta propiedad en un libro de Excel desde SharePoint, vea Usar EffectiveUserName de Analysis Services en SharePoint Server 2013. Para obtener una ilustración de cómo se usa esta propiedad con Reporting Services, vea Usar EffectiveUserName para suplantar en SSAS. EffectiveUserName se usa en una instalación de PowerPivot para SharePoint con el fin de capturar información de uso. La identidad del usuario se proporciona al servidor para poder grabar en los archivos de registro los eventos o los errores que incluyen la identidad del usuario. En el caso de PowerPivot, no se emplea con fines de autorización.
Encrypt Password	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 que se usa para descifrar un cubo local cifrado. El valor predeterminado es una contraseña vacía. El usuario debe establecer explícitamente este valor.
Impersonation Level	Indica el nivel de suplantación que se permite usar al servidor al suplantar al cliente. Los valores válidos incluyen: Anónimo. El cliente es anónimo para el servidor. El proceso de servidor no puede obtener información sobre el cliente y no se puede suplantar al cliente. Identificar. El proceso de servidor puede obtener la identidad del cliente. El servidor puede suplantar la identidad del cliente con fines de autorización, pero no puede obtener acceso a los objetos del sistema como el cliente. Suplantar. Es el valor predeterminado. La identidad del cliente se puede suplantar, pero solo cuando se establece la conexión, no en cada llamada. Delegar. El proceso de servidor puede suplantar el contexto de seguridad del cliente mientras actúa en nombre de este. El proceso de 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, que permiten una autenticación NTLM, Kerberos o anónima. El valor predeterminado es dejarla en blanco para las conexiones HTTP. Cuando use SSPI, ProtectionLevel debe configurarse de una de las siguientes formas: Connect, PktIntegrity, PktPrivacy.
Persist Encrypted	Establezca esta propiedad cuando la aplicación cliente necesite 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 guarda.
Persist Security Info	Los valores válidos son True y False. Cuando se establece en True, se puede obtener de la conexión la información de seguridad, como la identidad del usuario o la contraseña especificada anteriormente en la cadena de 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 sobre los datos enviados al servidor. Connect Conexiones autenticadas. Solo se realiza la autenticación cuando el cliente establece una relación con un servidor. PktIntegrity. Conexiones cifradas. Comprueba que se reciben todos los datos del cliente y que no se han cambiado durante el tránsito. PktPrivacy. Cifrado firmado, solo se admite para XMLA. Comprueba que se reciben todos los datos del cliente, que no han cambiado en el tránsito y protege la privacidad de los datos cifrándolos. Para obtener más información, vea Establecer conexiones seguras en ADOMD.NET.
Roles	Especifique una lista delimitada por comas de los roles predefinidos para conectarse a un servidor o una base de datos mediante los permisos propios de ese rol. Si se omite esta propiedad, se usan todos los roles y los permisos vigentes son la combinación de todos los roles. Si se establece la propiedad en un valor vacío (por ejemplo, Roles=’ ‘), la conexión de cliente no tendrá pertenencia a roles. Un administrador que usa esta propiedad se conecta con los permisos concedidos por el rol. Pueden producirse errores en algunos comandos si el rol no proporciona suficientes permisos.
SSPI	Especifica explícitamente qué paquete de seguridad se va a usar para la autenticación de cliente cuando Integrated Security se ha establecido en SSPI. SSPI admite varios paquetes, pero puede usar esta propiedad para especificar un paquete determinado. Los valores válidos son Negociar, 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 válidos son True y False.
User ID=…; Password=	User ID y Password se usan juntos. Analysis Services suplanta la identidad de usuario especificada mediante estas credenciales. En una conexión de Analysis Services, solo se ponen las credenciales en la línea de comandos cuando el servidor está configurado para acceso HTTP y ha especificado 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 para esta propiedad pueden ser UserName (sin espacio en blanco) y UID. El alias para Password es PWD.

Parámetros de uso especial

En esta sección se describen los restantes parámetros de cadena de conexión. Se emplean para asegurar comportamientos de conexión específicos que necesita una aplicación.

Las propiedades se muestran 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 para supervisar eventos de seguimiento, especialmente si varias aplicaciones tienen acceso a las mismas bases de datos. Por ejemplo, agregar Application Name=’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: Los alias para esta propiedad incluyen sspropinitAppName, AppName. Para obtener más información, vea Usar el parámetro de 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 los objetos usados con frecuencia que tienen una sobrecarga mínima de memoria. Esto ayuda a reducir el número de ciclos de ida y vuelta al servidor. El valor predeterminado es de 10000 milisegundos (o diez segundos). Cuando se establece en NULL o en 0, se desactiva la sincronización automática.
Character Encoding	Define cómo se codifican los caracteres en la solicitud. Los valores válidos son Default (predeterminado) o UTF-8 (son equivalentes) y UTF-16
CompareCaseSensitiveStringFlags	Ajusta las comparaciones de cadenas con distinción entre mayúsculas y minúsculas para una configuración regional especificada. Para obtener más información sobre la configuración de esta, vea CompareCaseSensitiveStringFlags (Propiedad).
Compression Level	Si TransportCompression es XPRESS, puede establecer el nivel de compresión para controlar cuánta compresión se usa. Los valores válidos son de 0 a 9, siendo 0 el que tiene menos compresión y 9 el que tiene más compresión. Una compresión mayor reduce el rendimiento. El valor predeterminado es 0.
Connect Timeout	Determina el tiempo máximo (en segundos) durante el que el cliente intenta establecer una conexión antes de agotarse el tiempo de espera. Si una conexión no se completa dentro de este período, el cliente deja de intentar la conexión y genera un error.
MDX Compatibility	El propósito de esta propiedad es asegurar un conjunto coherente de comportamientos MDX para las aplicaciones que emiten consultas MDX. Excel, que usa consultas MDX para rellenar y calcular una tabla dinámica conectada a Analysis Services, establece esta propiedad en 1 para asegurarse de que los miembros marcadores de posición en jerarquías desiguales son visibles en una tabla dinámica. Los valores válidos incluyen 0, 1, 2. 0 y 1 exponen los miembros marcadores de posición; 2 no los expone. Si está vacío, se supone el valor0.
MDX Missing Member Mode=Error	Indica si los miembros que faltan se omiten en las instrucciones MDX. Los valores válidos son Default, Error e Ignore. Default (el valor predeterminado) usa un valor definido por el servidor. Error genera un error cuando no existe un miembro. Ignore especifica que se deben pasar por alto los valores ausentes.
Mode	Define los permisos de acceso a bases de datos en la cadena de conexión, lo que le permite invalidar el valor existente. Los valores válidos incluyen Read y ReadWrite. En SSMS, esta propiedad de base de datos se indica como Modo de lectura y escritura. El valor predeterminado es ReadWrite.
Optimize Response	Máscara de bits que indica cuáles de las siguientes optimizaciones de respuesta de consulta están habilitadas. 0x01 Usar el NormalTupleSet (este es el valor predeterminado) 0x02 Usar cuando las segmentaciones de datos están vacías
Packet Size	Un 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 que se envía 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 elementos y atributos XML, haciéndolos menores. La compresión es un formato propietario que reduce aún más el tamaño de las solicitudes y las respuestas. Los formatos de compresión y binario se usan para acelerar las solicitudes y las respuestas de transferencia de datos. Debe usar una biblioteca de cliente en la conexión si emplea un formato binario o comprimido. El proveedor OLE DB puede dar formato a las solicitudes y las respuestas como un formato binario o comprimido. AMO y ADOMD.NET dan formato a las solicitudes como texto, pero aceptan respuestas en formato binario o comprimido. Esta propiedad de cadena de conexión es equivalente a las configuraciones del servidor EnableBinaryXML y EnableCompression.
Real Time Olap	Establezca esta propiedad para omitir el almacenamiento en caché, haciendo 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 para las funciones y las acciones definidas por el usuario. Los valores válidos son 0, 1 y 2. En una conexión de Excel, esta propiedad es Safety Options=2. Puede encontrar información acerca de esta opción en ConnectionString
SQLQueryMode	Especifica si las consultas SQL incluyen cálculos. Los valores válidos son Data, Calculated, IncludeEmpty. Data significa que no se permite ningún cálculo. Calculated permite cálculos. IncludeEmpty permite que se devuelvan cálculos y filas vacías en el resultado de la consulta.
Timeout	Especifica cuánto tiempo (en milisegundos) la biblioteca de cliente espera que se complete un comando antes de generar un error.
Transport Compression	Define cómo se comprimen las comunicaciones de cliente y servidor, cuando la compresión se especifica mediante la propiedad Protocol Format. Los valores válidos son Default, None, Compressed y gzip. Default indica que no hay compresión para TCP, o gzip para HTTP. None indica que no se usa ninguna compresión. Compressed usa compresión de 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 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. En el caso de datos de cubo que todos pueden ver, tiene sentido agregar todos los miembros porque todos los valores que contribuyen al total son visibles. Sin embargo, si se filtran o se limitan las dimensiones según la identidad del usuario, mostrar un total basado en todos los miembros (combinando los valores restringidos y los permitidos en un único 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 en False para excluir del total los valores restringidos. Cuando se establece en la cadena de conexión, este valor se aplica en el nivel de cubo o de perspectiva. Dentro de un modelo, puede controlar los totales visuales en un nivel más específico. 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 los valores que se ocultan al usuario. 1 excluye los valores ocultos del total. Esta es la configuración predeterminada para Excel. 2 incluye los valores ocultos en el total. Este es el valor predeterminado en el servidor. Los alias para esta propiedad incluyen Visual Total o Default MDX Visual Mode.

Reservado para uso futuro

Las propiedades siguientes 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 investigó en versiones anteriores. Aunque puede encontrar entradas de blog que recomienden su uso, debe evitar establecer esta propiedad a menos que se lo indique el personal de soporte técnico de Microsoft).
Directiva de caché
Relación de caché
Relación de caché2
Usar caché de fórmulas
Límite de depuración dinámica
Modo de depuración
SQLCompatibility

Ejemplos de cadena de conexión

En esta sección se muestra la cadena de conexión que es más probable que deba usar al configurar una conexión de Analysis Services en las aplicaciones que se usan 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 con MDX siempre se establece en 1. Aunque puede cambiar el valor de la sesión actual, Excel restablecerá MDX Compatibility a 1 cuando el archivo se abre 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 (SSRS) y Autenticación de datos para Servicios de Excel 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. Excepto para las conexiones a bases de datos PowerPivot, puede especificar estas cadenas de conexiones en aplicaciones que se conectan a Analysis Services.

Conexiones nativas (o directas) con el servidor

Data Source=server[:port][\instance] donde “port” e “\instance” son opcionales. Por ejemplo, si se especifica “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 ejecute en el puerto “port1” en “server1”.

“Data Source=server1\instance1” abrirá una conexión con el Explorador de SQL (en su puerto predeterminado 2382), resolverá el puerto para la instancia denominada “instance1” y, después, abrirá la conexión con ese puerto de Analysis Services.

“Data Source=server1:port1\instance1” abrirá una conexión con el Explorador de SQL en “port1”, resolverá el puerto para la instancia denominada “instance1” y, después, abrirá la conexión con ese puerto de Analysis Services.

Conexiones de cubo locales (archivos .cub)

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

Conexiones HTTP a msmdpump.dll

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

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

Data Source=<URL>, donde URL es la ruta de acceso de SharePoint a un libro PowerPivot publicado en una biblioteca de SharePoint. Por ejemplo, “Data Source=https://localhost/Shared Documents/Sales.xlsx”.

Conexiones HTTP a los archivos de conexión de modelos semánticos BI

Data Source=<URL> donde URL es la ruta de acceso de SharePoint al archivo .bism. Por ejemplo, “Data Source=https://localhost/Shared Documents/Sales.bism”.

Conexiones incrustadas de PowerPivot

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

Contexto del servidor local en los procedimientos almacenados de Analysis Services

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

Cifrar cadenas de conexión

Analysis Services cifra y almacena las cadenas de conexión que utiliza 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 contraseña, puede hacer que Analysis Services almacene el nombre y la contraseña con la cadena de conexión o puede hacer que se le solicite el nombre y la contraseña cada vez que se requiera una conexión al origen de datos. Si Analysis Services solicita la información de usuario, significa que esta información no tiene por qué almacenarse y cifrarse. No obstante, si almacena esta información en la cadena de conexión, será necesario cifrar y proteger esta información.

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 la cadena de conexión de cada base de datos de Analysis Services. Analysis Services crea esta clave cuando se crea la base de datos y cifra la información de la cadena de conexión basándose en la cuenta de inicio de sesión de Analysis Services. Cuando se inicia Analysis Services, la clave cifrada de cada base de datos se lee, se descifra y se almacena. Después, cuando Analysis Services necesita conectarse a un origen de datos, Analysis Services utiliza la clave descifrada adecuada para descifrar la información de la cadena de conexión del origen de datos.