Propiedades de las cadenas de conexión

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.

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.

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.

Propiedades de autenticación y seguridad

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.

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.

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.

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.

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 .

Tiempo de espera

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

Consulte también

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