Propiedades de cadena de conexión (Analysis Services)
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 crean cadenas de conexión personalizadas en código de aplicación deben revisar la documentación de la API para el cliente de ADOMD.NET con el fin de ver 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.
Este tema incluye las siguientes secciones:
Parámetros de conexión de uso común
Ejemplos de cadena de conexión
Formatos de cadena de conexión usados en Analysis Services
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, consulte Conexión 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 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 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 <la 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 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 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: vaya a Archivos de programa\Microsoft Analysis Services\AS OLEDB\10. Haga clic con el botón secundario 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 más información, consulte 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 lanzó 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 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. |
| Cifrar la 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 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 son: 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 del 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. Suplantación: este es el valor predeterminado. La identidad del cliente se puede suplantar, pero solo cuando se establece la conexión, no en cada llamada. Delegado: el proceso de servidor puede suplantar el contexto de seguridad del cliente mientras actúa en nombre del cliente. 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, lo que permite la autenticación NTLM, Kerberos o Anónima. El valor predeterminado es dejarla en blanco para las conexiones HTTP.Cuando se usa SSPI, ProtectionLevel debe establecerse en uno de los valores siguientes: 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 Establishing Secure Connections in 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. Establecer la propiedad en un valor vacío (por ejemplo, Roles=" ") la conexión de cliente no tiene 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 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 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. |
Optimize Response |
Máscara de bits que indica cuáles de las siguientes optimizaciones de respuesta de consulta están habilitadas. 0x01: valor predeterminado. Uso de NormalTupleSet 0x02: se usa cuando las segmentaciones están vacías |
Packet Size |
Tamaño del 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, 2. En una conexión de Excel, esta propiedad es Safety Options=2. Los detalles acerca de esta opción se encuentran 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 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 ha investigado en versiones anteriores. Aunque es posible que encuentre entradas de blog que recomiendan su uso, debe evitar establecer esta propiedad a menos que Soporte técnico de Microsoft lo indique).
Directiva de caché
Relación de caché
Relación de caché2
Límite de depuración dinámica
Modo de depuración
Modo
SQLCompatibility
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 con frecuencia.
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 para la sesión actual, Excel restablecerá la compatibilidad con MDX en 1 la próxima vez que se abra el archivo.
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. 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" y "\instance" son opcionales. Por ejemplo, al especificar "Origen de datos=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 locales (archivos .cub)
Data Source=<path>, por ejemplo, "Data Source=c:\temp\a.cub"
Conexiones HTTP a msmdpump.dll
Data Source=<URL>, donde URL es la dirección HTTP o HTTPS a la carpeta virtual de IIS que contiene 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 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, "Origen de datos=https://localhost/Shared Documentos/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, "Origen de datos=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 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. 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 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.
Consulte también
Configurar el 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
Conectar a Analysis Services