Propiedades de las cadenas de conexión

  • Artículo

Se aplica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

En este artículo se describen cadena de conexión propiedades que usan las aplicaciones cliente que se conectan a Azure Analysis Services y consultan Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) y Power BI Premium modelos semánticos. Estas propiedades las usan las bibliotecas cliente de Analysis Services, ADOMD.NET, AMO y OLE DB (MSOLAP) 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 indican en la descripción.

Use el selector versión situado encima de la tabla de contenido de la izquierda para ver solo las propiedades que se aplican a una plataforma o versión determinada.

Propiedades de la conexión

Origen de datos

Especifica la instancia del servidor. Esta propiedad es necesaria para todas las conexiones.

Los valores válidos para Azure Analysis Services incluyen <protocol>://<region>/<servername> dónde el protocolo es cadena asazure o link cuando se usa un alias de nombre de servidor, la región es el URI donde se creó el servidor (por ejemplo, westus.asazure.windows.net) y servername es el nombre del servidor único dentro de la región.

Ejemplo Descripción
Data source=asazure://westus.asazure.windows.net/myasserver Azure Analysis Services.
Data source=link://friendlyname.salesapp.azurewebsites.net/ Azure Analysis Services mediante el alias de nombre de servidor.

Los valores válidos para Power BI Premium incluyen <protocol>://api.powerbi.com/v1.0/[tenant name]/[workspace name] dónde el protocolo es cadena powerbi, Uri es api.powerbi.com, nombre de inquilino es el nombre del inquilino de la organización o myorg, y el nombre del área de trabajo es el nombre de un área de trabajo asignada a una capacidad dedicada.

Ejemplo Descripción
Data source=powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace Power BI Premium área de trabajo.

Los valores válidos para SQL Server Analysis Services 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).

Ejemplo Descripción
Data source=AW-SRV01 Instancia y puerto predeterminados de SSAS (TCP 2383).
Data source=AW-SRV01\Finance Instancia con nombre de SSAS.
Data source=AW-SRV01:8081 Instancia predeterminada de SSAS, puerto especificado.
Data source=AW-SRV01.corp.Adventure-Works.com Nombre de dominio completo de SSAS, instancia predeterminada y puerto.
Data source=172.16.254.1 Dirección IP de SSAS del servidor, omitiendo la búsqueda del servidor DNS. Resulta útil para solucionar problemas de conexión.
Proveedor

Esta propiedad es necesaria en el cadena de conexión cuando se usa un proveedor OLE DB como MSOLAP. Permite usar un proveedor independiente de versión (normalmente el más reciente), como "Provider=MSOLAP", o también puede especificar un proveedor dependiente de la versión como "Provider=MSOLAP.7". Los valores dependientes de la versión válidos siguen el patrón MSOLAP.<versión>, donde <la versión> es 7 o 8. Por ejemplo, MSOLAP.7 publicado en SQL Server 2016. La versión ".8" es la más reciente y se considera "evergreen". Se espera que siga actualizando con compatibilidad con versiones anteriores mantenidas. Los números de versión anteriores también son posibles, pero esas versiones de MSOLAP ya no son compatibles con el estándar.

Esta propiedad es opcional para ADOMD.NET y AMO. Se permite por comodidad al copiar un cadena de conexión MSOLAP para usarlo con ADOMD.NET y AMO.

Ejemplo Descripción
Provider=MSOLAP.7 Connections requerir SQL Server versión 2016 del proveedor OLE DB para Analysis Services.
Cubo

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.

Ejemplo Descripción
Cube=Sales Un cubo denominado Sales.
Cube=SalesPerspective Perspectiva denominada SalesPerspective.

Propiedades de autenticación y seguridad

Azure Analysis Services y Power BI Premium usar Microsoft Entra ID: universal con MFA (recomendado), Microsoft Entra autenticación con nombre de usuario y contraseña, tokens de acceso Microsoft Entra o autenticación de Windows.

SQL Server Analysis Services solo usa autenticación de Windows. La autenticación básica y la autenticación anónima se pueden usar si el acceso HTTP está habilitado a través de MSMDPUMP.dll, como se explica en el artículo Configuración del acceso HTTP a Analysis Services en IIS 8.0. Consulte Paso 3: Configuración de la autenticación de IIS para obtener más información sobre cómo configurar los métodos de autenticación admitidos para Analysis Services a través de HTTP.

Las propiedades se muestran en orden alfabético.

EffectiveUserName

Use cuando se debe suplantar una identidad de usuario en el servidor. Para SSAS, especifique en un formato domain\user. En Azure AS y Power BI Premium, especifique en formato UPN. Para usar esta propiedad, el autor de la llamada debe tener permisos administrativos en Analysis Services. En Power BI Premium, el autor de la llamada debe ser un administrador del área de trabajo donde se encuentra el modelo semántico.

CustomData

Valor de cadena que se va a pasar al motor en el cadena de conexión y, a continuación, se recupera mediante la función MDX CustomData() o CUSTOMDATA() DAX. Normalmente se usa para pasar un userID o un nombre de usuario como un valor y, a continuación, especificar ese valor en la definición de una expresión de seguridad.

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.

Contraseña de cifrado

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.

Nivel de suplantación

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 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 acceder 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, no en cada llamada.
  • Delegado. 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.
Seguridad integrada

La identidad de Windows del autor de la llamada se usa para conectarse a Analysis Services. Los valores válidos son SSPI, blank, Basic y ClaimsToken*.

SSPI es el valor predeterminado para las conexiones TCP, lo que permite la autenticación NTLM, Kerberos o Anónima. En el caso de Azure AS y Power BI Premium, SSPI indica AD Translation. Al usar SSPI, la propiedad ProtectionLevel debe establecerse en Connect, Pkt Integrity o Pkt Privacy.

blank es el valor predeterminado para las conexiones HTTP.

*ClaimsToken es compatible con Azure AS y Power BI Premium.

Persist Security Info

Los valores válidos son True o 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.

Nivel de protección

Determina el nivel de seguridad usado en la conexión. Los valores admitidos dependen del transporte subyacente. Los valores válidos son:

  • No. Conexiones no autenticadas o anónimas. No realiza ninguna autenticación sobre los datos enviados al servidor.
  • Conéctese. Conexiones autenticadas. Solo se realiza la autenticación cuando el cliente establece una relación con un servidor.
  • Integridad de PKT. Conexiones cifradas. Comprueba que todos los datos se reciben del cliente y que no se han cambiado en tránsito.
  • Privacidad de PKT. Cifrado firmado, solo compatible con TCP. Comprueba que todos los datos se reciben del cliente, que no se han cambiado en tránsito y protegen la privacidad de los datos cifrandolos.

Para más información, consulte Establecimiento de Connections seguros 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. Establecer la propiedad en un valor vacío, por ejemplo, Roles=' ' significa que 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. Es posible que se produzca un error en algunos comandos si el rol no proporciona permisos suficientes.

Si especifica roles al conectarse a un área de trabajo de Power BI Premium, use roles de área de trabajo del modelo de seguridad de Power BI.

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:

  • Negotiate
  • Kerberos
  • NTLM
  • Usuario anónimo

Si no se establece esta propiedad, todos los paquetes estarán disponibles para la conexión.

Utilizar cifrado para los datos

Cifra las transmisiones de datos. Los valores válidos son True o False.

Id. de usuario=...; Password=

Las propiedades Id. de usuario y Contraseña proporcionan las credenciales adecuadas al servidor cuando el usuario activo actual de la aplicación cliente no se puede propagar automáticamente al servidor. El comportamiento depende del protocolo de transporte y del servidor al que se está conectando:

  • Al conectarse a través de TCP a SSAS, la biblioteca cliente suplantará al usuario de Windows mediante el nombre de usuario y la contraseña especificados y, a continuación, se conectará como de costumbre al servidor.

  • Al conectarse a través de HTTP(S) a SSAS, las credenciales se proporcionan al servidor web en función del modo de autenticación configurado en el servidor web, por ejemplo autenticación básica o autenticación de Windows. El servidor web realizará la suplantación de Windows adecuada antes de conectarse al servidor SSAS, lo que proporciona el flujo de credenciales correcto al servidor.

  • Al conectarse a Azure AS o Power BI Premium, el identificador de usuario y la contraseña se usan para obtener un token de Microsoft Entra que se presenta al servicio durante la autenticación. Microsoft Entra ID también puede requerir autenticación multifactor (MFA), que puede requerir interacción adicional del usuario antes de que se pueda generar el token.

  • Si ya ha adquirido un token de acceso de portador válido Microsoft Entra ID desde su propia aplicación, puede establecer la propiedad AccessToken del objeto AdomdConnection antes de establecer la conexión. En la propiedad AccessToken del objeto de conectividad pertinente (AdomdConnection, Server, etc.), asegúrese de establecer el token de acceso y especifique su hora de expiración. La autenticación se admite para los tokens de portador adquiridos de forma interactiva para un usuario y mediante el flujo on-Behalf-Of de OAuth 2.0 (por ejemplo, una aplicación web de nivel intermedio que se conecta a Analysis Services en nombre del usuario). Omita el tipo de token al pasar el token de acceso en la propiedad AccessToken . Las bibliotecas cliente de Analysis Services agregan automáticamente el valor de esquema de autenticación "Bearer" al token de acceso. Asegúrese de tener en cuenta lo siguiente:

    • Microsoft Entra los tokens de acceso de portador tienen una duración limitada. De forma predeterminada, entre 60 y 90 minutos. Si la aplicación realiza operaciones de larga duración que superan la duración del token de acceso, puede proporcionar una función de devolución de llamada a través de la propiedad OnAccessTokenExpired del objeto AdomdConnection para actualizar el token de acceso cuando el token de acceso actual esté a punto de expirar. Como alternativa, puede actualizar la propiedad AccessToken directamente sin la ayuda de una función de devolución de llamada. Se recomienda usar una función de devolución de llamada para asegurarse de que el token de acceso se actualiza dentro de la duración del token de acceso actual.
    • No se recomienda usar la propiedad password cadena de conexión para pasar un token de acceso. Todavía puede omitir la propiedad Id. de usuario en el cadena de conexión y especificar solo el token de acceso en la propiedad Password, pero en esos casos no se puede actualizar el token de acceso. Use la propiedad AccessToken en su lugar para que pueda proporcionar un token de acceso nuevo para una conexión existente cuando sea necesario. No se admite establecer la propiedad Password ni la propiedad AccessToken .

Nota: "Id. de usuario" tiene un espacio incrustado. Un alias alternativo para el identificador de usuario es UID y un alias alternativo para password es PWD.

Propiedades de propósito especial

Estas propiedades se usan para garantizar comportamientos de conexión específicos requeridos por una aplicación. Las propiedades se muestran en orden alfabético.

Nombre de la aplicación

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, al agregar Application Name='test' a un cadena de conexión hace que "test" aparezca en un seguimiento de SQL Server Profiler. Los alias de esta propiedad incluyen SspropInitAppName, AppName. Para más información, consulte Nombre de la aplicación para SQL Server Connections.

Período de sincronización automática

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 10 000 milisegundos (o 10 segundos). Cuando se establece en NULL o en 0, se desactiva la sincronización automática.

Por motivos de rendimiento, las bibliotecas cliente almacenan en caché cierta información del servidor, por ejemplo, determinados conjuntos de filas de esquema. El período de sincronización automática permite al usuario cambiar el período de tiempo después del cual la biblioteca cliente comprueba con el servidor si es necesario vaciar o no las memorias caché. En general, no es necesario cambiar el valor de predeterminado.

Codificación de caracteres

Define cómo se codifican los caracteres en la solicitud. Los valores válidos son Default o UTF-8 (son equivalentes) y UTF-16.

CommitTimeout

Una propiedad XMLA. Determina cuánto tiempo, en milisegundos, espera la fase de confirmación de un comando que se está ejecutando en ese momento antes de revertirse. Cuando es mayor que 0, reemplaza el valor de la propiedad CommitTimeout correspondiente en la configuración del servidor.

CompareCaseSensitiveStringFlags

Ajusta las comparaciones de cadenas con distinción entre mayúsculas y minúsculas para una configuración regional especificada.

Nivel de compresión

Si TransportCompression está comprimido, 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. Una compresión mayor reduce el rendimiento. El valor predeterminado es 0.

Tiempo de espera de la conexión

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.

DbpropMsmdRequestMemoryLimit

Invalida el valor de la propiedad del servidor Memory\QueryMemoryLimit para una conexión.

Especificado en kilobytes, esta propiedad puede reducir la cantidad de memoria utilizada durante una consulta de la memoria máxima permitida (especificada como porcentaje) en QueryMemoryLimit. No puede aumentar la cantidad de memoria usada más allá de la memoria máxima permitida especificada en QueryMemoryLimit.

Modo visual MDX predeterminado

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 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 valores ocultos en el total. Este es el valor predeterminado en el servidor.

El alias de esta propiedad es VisualMode.

Compatibilidad de MDX

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.

Modo de miembro que falta MDX

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. El error genera un error cuando un miembro no existe. Ignore especifica que se deben pasar por alto los valores ausentes.

Optimizar la respuesta

Máscara de bits que indica cuáles de las siguientes optimizaciones de respuesta de consulta están habilitadas.

  • 0x01 Usar normalTupleSet (valor predeterminado).
  • 0x02 Usar cuando las segmentaciones están vacías.
Tamaño del paquete

Solo se aplica a las conexiones TCP. Tamaño del paquete de red (en bytes) entre 512 y 32.767. El tamaño de paquete de red predeterminado es 4096.

Formato de protocolo

Establece el formato del XML utilizado por el protocolo de comunicación XMLA. Los valores válidos son Default, XML o Binary. Puede especificar que el XML se envíe en un formato binario o como XML de texto. El formato binario codifica los elementos y atributos XML, haciéndolos menores. Además, la compresión también se puede habilitar para que los mensajes reduzcan el tamaño de las solicitudes y respuestas mediante la opción Compresión de transporte. Las solicitudes y respuestas pueden usar diferentes formatos de protocolo en función de lo que admita el cliente y el servidor. Por ejemplo, una biblioteca cliente solo puede admitir binarios para las respuestas, pero no para las solicitudes, o un servidor podría haber deshabilitado binario para las solicitudes entrantes.

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 .

Olap en tiempo real

Establezca esta propiedad para omitir el almacenamiento en caché, lo que hace que todas las consultas de almacenamiento capturen datos del sistema de origen. De forma predeterminada, esta propiedad no está establecida.

Opciones de seguridad

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.

Tiempo de espera

Especifica cuánto tiempo (en segundos) la biblioteca de cliente espera que se complete un comando antes de generar un error.

Compresión de transporte

Define cómo se comprimen las comunicaciones de cliente y servidor. Los valores válidos son Default, None, Compressed. None indica que no se usa ninguna compresión. Comprimido usa la compresión XPRESS.

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.

Consulte también

Clases fundamentales de AMO: objetos de servidor
Clase AdomdConnection: propiedades