Detalles de Conexión de Azure Analysis Services

Introducción

Versión del conector

Esta documentación se basa en la versión 22.0.8510 del conector.

Empezando

Compatibilidad con la versión de Azure Analysis Services

El conector envuelve la complejidad de conectarse a Azure Analysis Services en un controlador estándar: ejecutar consultas SQL-92 o pasar consultas MDX desde herramientas relacionales.

Establecer una Conexión

Conexión a los Azure Analysis Services

Para conectarse, configure URL propiedad a un servidor válido de Azure Analysis Services, por ejemplo, asazure://southcentralus.asazure.windows.net/server, además de autenticar.

Opcionalmente, establecer Database para distinguir a qué base de datos de Azure en el servidor conectarse.

Autenticación en Azure Analysis Services

Azure AD

Azure AD es un tipo de conexión que aprovecha OAuth para la autenticación. OAuth requiere que el usuario que se autentica interactúe con Azure Analysis Services mediante un navegador de Internet. El conector facilita esto de varias maneras, como se describe a continuación. Establecer su AuthScheme a AzureAD. Todos los flujos de Microsoft Entra ID asumen que lo ha hecho.

Aplicaciones de Escritorio

proporciona una aplicación OAuth integrada que simplifica la autenticación de escritorio OAuth. Como alternativa, puede crear una aplicación OAuth personalizada. Consulte Creación de una aplicación Microsoft Entra ID personalizada para obtener información sobre la creación de aplicaciones personalizadas y las razones para hacerlo.

Para la autenticación, la única diferencia entre los dos métodos es que debe establecer dos propiedades de conexión adicionales al usar aplicaciones OAuth personalizadas.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• OAuthClientId: (solo aplicaciones personalizadas) Establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: (solo aplicaciones personalizadas) Establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de redirección en la configuración de su aplicación.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation que persisten a través de las conexiones.

Entidad de Servicio de Azure

Azure Service Principal es un tipo de conexión que pasa por OAuth. Establecer su AuthScheme a AzureServicePrincipal. La autenticación como entidad principal de servicio de Azure se gestiona a través del flujo de credenciales de cliente de OAuth y no implica la autenticación directa del usuario. En cambio, las credenciales se crean solo para la aplicación en sí. Todas las tareas realizadas por la aplicación se realizan sin un contexto de usuario predeterminado, pero en función de los roles asignados. El acceso de la aplicación a los recursos se controla a través de los permisos de los roles asignados.

Nota: Debe crear una aplicación personalizada antes de asignar una rol. Consulte Creación de una aplicación Microsoft Entra ID personalizada para más información.

Al autenticarse con una entidad de servicio de Azure, debe registrar una aplicación con un arrendatario de Azure AD. Siga los pasos a continuación para crear una nueva entidad de servicio que se pueda usar con el control de acceso basado en roles.

Asignar un Rol a la Aplicación

Para acceder a los recursos de su suscripción, debe asignar un rol a la aplicación.

1. Abra el Subscriptions página buscando y seleccionando el servicio Suscripciones en la barra de búsqueda.
2. Seleccione la suscripción particular a la que asignar la aplicación.
3. Abra el Access control (IAM) y seleccione Add > Add role assignment para abrir el Add role assignment página.
4. Seleccione Owner como el rol para asignar a su aplicación de Azure AD creada.

Complete la Autenticación

Está listo para conectarse después de configurar uno de los siguientes grupos de propiedades de conexión, según la autenticación de la aplicación configurada (secreto de cliente o certificado).

En ambos métodos

Antes de elegir el secreto del cliente o la autenticación de certificado, siga estos pasos y luego continúe con la sección correspondiente a continuación:

1. AuthScheme: Establézcalo en AzureServicePrincipal en la configuración de su aplicación.
2. InitiateOAuth: Establézcalo en GETANDREFRESH. Puedes usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
3. AzureTenant: Configure esto para el arrendatario al que desea conectarse.
4. OAuthClientId: establezca esto en la identificación del cliente en la configuración de su aplicación.

Autenticación usando un secreto de cliente

Continúe con lo siguiente:

1. OAuthClientId: establezca esto en la identificación del cliente en la configuración de su aplicación.
2. OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.

Autenticación usando un Certificado

Continúe con lo siguiente:

1. OAuthJWTCert: establezca esto en el almacén de certificados JWT.
2. OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.

Contraseña Azure

Para conectarse usando sus credenciales de Azure directamente, especifique las siguientes propiedades de conexión:

• AuthScheme: Establézcalo en AzurePassword.
• User: establezca esto en su cuenta de usuario que usa para conectarse a Azure.
• Password: establezca esto en la contraseña que usa para conectarse a Azure.
• AzureTenant: Establézcalo en Directory (tenant) ID, que se encuentra en la página Información general de la aplicación OAuth utilizada para autenticarse en Azure Analysis Services en Azure.

MSI

Si ejecuta Azure Analysis Services en una máquina virtual de Azure, puede aprovechar las credenciales de Managed Service Identity (MSI) para conectarse:

• AuthScheme: Establézcalo en AzureMSI.

Las credenciales de MSI se obtienen automáticamente para la autenticación.

Creación de una Aplicación Microsoft Entra ID Personalizada

Hay dos tipos de aplicaciones personalizadas de Microsoft Entra ID: Microsoft Entra ID y Microsoft Entra ID con una entidad de servicio de Azure. Ambos están basados en OAuth.

Cuándo Crear una Aplicación Personalizada

incorpora Credenciales de aplicación OAuth con marca que se puede usar cuando se conecta a través de una aplicación de escritorio o desde una máquina sin cabeza.

Puede optar por utilizar sus propias Credenciales de aplicación de Microsoft Entra ID cuando desee

• controlar la marca del diálogo de autenticación
• controlar el URI de redireccionamiento al que la aplicación redirige al usuario después de que el usuario se autentica
• personalizar los permisos que está solicitando al usuario

Aplicaciones Personalizadas de Microsoft Entra ID

Puede usar una aplicación Microsoft Entra ID personalizada para autenticar una cuenta de servicio o una cuenta de usuario. Siempre puede crear una aplicación Microsoft Entra ID personalizada, pero tenga en cuenta que las conexiones de escritorio y sin cabeza admiten OAuth integrado, lo que simplifica el proceso de autenticación. Consulte "Establecimiento de una conexión" para obtener información sobre el uso de la aplicación OAuth integrada.

Crear una Aplicación Microsoft Entra ID Personalizada

Siga los pasos a continuación para obtener los valores de Microsoft Entra ID para su aplicación, el OAuthClientId y OAuthClientSecret.

1. Inicie sesión en <https://portal.azure.com>.
2. En el panel de navegación de la izquierda, seleccione Azure Active Directory, entonces applicationRegistrations y haga clic en New registration.
3. Ingrese un nombre de aplicación y seleccione la configuración de inquilino deseada. Al crear una aplicación personalizada de Microsoft Entra ID en Azure Active Directory, puede definir si la aplicación es de un solo inquilino o de varios inquilinos. Si selecciona la opción predeterminada, "Solo cuentas en este directorio organizacional", debe configurar AzureTenant propiedad de conexión al ID del arrendatario de Azure AD al establecer una conexión con Jitterbit Connector para Azure Analysis Services. De lo contrario, el intento de autenticación falla con un error. Si su aplicación es solo para uso privado, "Cuentas en el directorio de esta organización solamente" debería ser suficiente. De lo contrario, si desea distribuir su aplicación, elija una de las opciones de múltiples inquilinos.
4. Establezca la URL de redirección en http://localhost:33333, el valor predeterminado del conector. O bien, especifique un puerto diferente y configure CallbackURL a la URL de respuesta exacta que definiste.
5. Haga clic en Register para registrar la nueva aplicación. Esto abre una pantalla de administración de aplicaciones. Tenga en cuenta el valor en Application (client) ID como el OAuthClientId y el Directory (tenant) ID como el AzureTenant.
6. Navegue hasta "Certificados y secretos" y defina el tipo de autenticación de la aplicación. Hay dos tipos de autenticación disponibles: secreto de cliente o certificado. El método de autenticación recomendado es mediante un certificado.
   • Opción 1: Cargar un certificado: En "Certificados y secretos", seleccione Upload certificate y el certificado para cargar desde su máquina local.
   • Opción 2: Crear un nuevo secreto de aplicación: En "Certificados y secretos", seleccione New Client Secret para la aplicación y especificar su duración. Después de guardar el secreto del cliente, se muestra el valor de la clave. Copie este valor ya que solo se muestra una vez. Lo necesitará como OAuthClientSecret.
7. Seleccione API Permissions > Add > Delegated permissions.
8. Guarde sus cambios.
9. Si ha seleccionado usar permisos que requieren el consentimiento del administrador, puede otorgarlos desde el arrendatario actual en la página Permisos de la API.

Uso de la Autenticación Principal de Servicio de Azure

La autenticación como entidad principal de servicio de Azure se gestiona a través del flujo de credenciales de cliente de OAuth y no implica la autenticación directa del usuario. En cambio, las credenciales se crean solo para la aplicación en sí. Todas las tareas realizadas por la aplicación se realizan sin un contexto de usuario predeterminado, pero en función de los roles asignados. El acceso de la aplicación a los recursos se controla a través de los permisos de los roles asignados.

Cree una Aplicación de Microsoft Entra ID y una Entidad de Servicio de Azure

Al autenticarse con una entidad de servicio de Azure, debe registrar una aplicación con un arrendatario de Azure AD.

Asignar un Rol a la Aplicación

Para acceder a los recursos de su suscripción, debe asignar un rol a la aplicación.

1. Abra el Subscriptions página buscando y seleccionando el servicio Suscripciones en la barra de búsqueda.
2. Seleccione la suscripción particular a la que asignar la aplicación.
3. Abra el Access control (IAM) y seleccione Add > Add role assignment para abrir el Add role assignment página.
4. Seleccione Owner como el rol para asignar a su aplicación de Azure AD creada.

Complete la Autenticación

Está listo para conectarse después de configurar uno de los siguientes grupos de propiedades de conexión, según la autenticación de la aplicación configurada (secreto de cliente o certificado).

En ambos métodos

Antes de elegir el secreto del cliente o la autenticación de certificado, siga estos pasos y luego continúe con la sección correspondiente a continuación:

1. AuthScheme: Establézcalo en AzureServicePrincipal en la configuración de su aplicación.
2. InitiateOAuth: Establézcalo en GETANDREFRESH. Puedes usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
3. AzureTenant: Configure esto para el arrendatario al que desea conectarse.
4. OAuthClientId: establezca esto en la identificación del cliente en la configuración de su aplicación.

Autenticación usando un secreto de cliente

Continúe con lo siguiente:

1. OAuthClientId: establezca esto en la identificación del cliente en la configuración de su aplicación.
2. OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.

Autenticación usando un Certificado

Continúe con lo siguiente:

1. OAuthJWTCert: establezca esto en el almacén de certificados JWT.
2. OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.

Recuperación de Datos de Servicios de Análisis

Azure Analysis Services es una base de datos OLAP que expone datos como cubos, que consultar con MDX (expresiones multidimensionales). El conector modela estos cubos en vistas relacionales que puede consultar con SQL-92. La siguiente asignación es para el diseño del modelo:

• Catalog - Mostrado en el conector como un Catálogo.
• Cube: se muestra en el conector como esquema.
• Measure - Disponible en el conector bajo la vista especial de Medidas.
• Dimension - Cada dimensión se expone como una vista.
• Level - Cada nivel individual de una jerarquía se expone como una columna en la vista de dimensión adecuada.

Unión de Medidas y Dimensiones

Para recuperar medidas por valor de nivel específico, emita una unión entre la vista de medida y cualquier dimensión o conjunto de dimensiones. Por ejemplo, emitir lo siguiente recuperará el número de clientes en cada ciudad:

SELECT m.[Customer Count], c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Tenga en cuenta que no es necesaria una condición de ENCENDIDO. Esto se debe a que las tablas ya están relacionadas correctamente en Azure Analysis Services. Si está utilizando una herramienta que requiere condiciones de ENCENDIDO, configure IncludeJoinColumns a verdadero. Esto agregará una serie de columnas de clave externa a cada vista que las relacionará entre sí. Estas columnas no devolverán datos por sí solas, pero pueden seleccionarse automáticamente con herramientas para construir las condiciones ON para las uniones cuando sea necesario.

Agregando Datos

Los datos almacenados en Azure Analysis Services ya están agregados. En muchos casos, intentar recuperar un agregado puede ser sintácticamente equivalente a no especificar nada. Por ejemplo, la siguiente consultar devolverá exactamente los mismos datos que la anterior:

SELECT SUM(m.[Customer Count]), c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
GROUP BY c.[City]

La excepción a esta regla es cuando se solicita una agregación de resultados filtrados. En tales casos, se solicitará un cálculo a Azure Analysis Services. Por ejemplo, para calcular la suma y el promedio de clientes en Francia y Alemania:

SELECT SUM(m.[Customer Count]), AVG(m.[Customer Count]), c.[Country]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
WHERE c.[Country] IN ('France', 'Germany')
GROUP BY c.[Country]

Selección de Varias Jerarquías

En Azure Analysis Services, las dimensiones individuales se componen de jerarquías que pueden tener uno o más niveles. Por ejemplo, la tabla Clientes de AdventureWorks tiene Ciudad, País y Sexo. Ciudad y País forman parte de la misma jerarquía, mientras que Género es su propia jerarquía.

Al seleccionar varias jerarquías, el método para admitir esto es unir de forma cruzada los valores en MDX. Si bien no es obvio a partir de un modelo de tabla relacional de los datos que presenta el conector, esto puede ocasionar que se ejecuten consultas muy costosas. Por ejemplo, ejecutando lo siguiente:

SELECT c.[Country], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Dará como resultado 6 filas. Sin embargo, al seleccionar Género también:

SELECT c.[Country], c.[Gender], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Ahora resultará en 12 filas. Se debe a que Género y País se encuentran en jerarquías diferentes, por lo que se requiere una unión cruzada para devolver ambos juntos. Cada jerarquía adicional agregada a SELECT multiplicará los resultados totales por la cantidad de valores disponibles en esa jerarquía. Por lo tanto, para contar cuántas filas esperar, se puede ejecutar lo siguiente:

SELECT (Count(c.[Country])*Count(c.[Gender])) AS totalrows
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 

Límite de Fila de Respuesta

Debido a que la selección de varias jerarquías multiplicará el número total de filas de resultados, es posible aumentar el número de filas de respuesta muy rápidamente, lo que provocará tiempos de espera. Para tratar de dar cierta visibilidad a las consultas que serán muy costosas, ResponseRowLimit La propiedad de conexión se ha agregado como un mecanismo para tratar de guiar a los usuarios hacia mejores prácticas. Cuando se establece, calculará cuántas filas esperar antes de que se ejecute cualquier consultar. Si el número de filas pronosticadas supera el límite, se generará un error que indicará cuántas filas se esperan con la consultar.

Se recomienda seleccionar solo las columnas requeridas o aplicar un criterio DONDE. Ambos pueden reducir significativamente el número de filas de respuesta, lo que tendrá un gran impacto en el rendimiento. Si ya está familiarizado con el conector y qué consultas pueden ser costosas, ResponseRowLimit se puede deshabilitar configurándolo en 0.

Ajuste Fino del Acceso a los Datos

Ajuste Fino del Acceso a Datos

Establecer las siguientes otras propiedades también puede ser útil en ciertas situaciones:

• UseMDX: Indica si se están enviando consultas MDX. De forma predeterminada, esto es falso, lo que hará que el controlador acepte solo consultas compatibles con SQL-92. Establecer esta propiedad en true hará que todas las consultas se pasen directamente a Azure Analysis Services.

• ExtraProperties: propiedades adicionales para enviar junto con una consultar MDX. Solo significativo si UseMDX es verdad.

• IncludeJoinColumns: Booleano que indica si se deben agregar columnas adicionales utilizadas para hacer condiciones ON con combinaciones. Estos no regresan con ningún valor: se agregan únicamente para habilitar las herramientas que los requieren para configurar automáticamente las relaciones entre las tablas al crear uniones.

• ResponseRowLimit: Establece un límite calculado en el número de filas para permitir que el usuario seleccione antes de devolver un error. Debido a que las consultas se traducen a MDX, seleccionar solo unas pocas columnas puede multiplicar exponencialmente la cantidad de resultados esperados.

  Por este motivo, ResponseRowLimit está disponible para tratar de brindar orientación sobre los tipos de consultas que pueden resultar en un tiempo de espera. Se puede deshabilitar configurando a 0.

Características Avanzadas

Esta sección detalla una selección de características avanzadas del conector de Azure Analysis Services.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Procesamiento de consultas

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a Azure Analysis Services y luego procesa el resto de la consultar en la memoria (lado del cliente).

Consulte Procesamiento de consultas para más información.

Vistas Definidas por el Usuario

Jitterbit Connector for Azure Analysis Services le permite definir una tabla virtual cuyo contenido se decide mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM [adventureworks].[Model].Customer WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definición de Vistas Usando Sentencias DDL

El conector también es capaz de crear y modificar el esquema a través de instrucciones DDL como CREATE LOCAL VIEW, ALTER LOCAL VIEW y DROP LOCAL VIEW.

Crear una Vista

Para crear una nueva vista usando declaraciones DDL, proporcione el nombre de la vista y la consultar de la siguiente manera:

CREATE LOCAL VIEW [MiNombre de Vista] AS SELECT * FROM Customers LIMIT 20;

Si no existe ningún archivo JSON, el código anterior crea uno. Luego, la vista se crea en el archivo de configuración JSON y ahora se puede detectar. La ubicación del archivo JSON se especifica mediante UserDefinedViews propiedad de conexión.

Modificar una Vista

Para modificar una vista existente, proporcione el nombre de una vista existente junto con la nueva consultar que le gustaría usar en su lugar:

ALTER LOCAL VIEW [MiNombre de Vista] AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Luego, la vista se actualiza en el archivo de configuración JSON.

Suelta una Vista

Para descartar una vista existente, proporcione el nombre de un esquema existente junto con la nueva consultar que le gustaría usar en su lugar.

DROP LOCAL VIEW [MyViewName]

Esto elimina la vista del archivo de configuración JSON. Ya no se puede consultar.

Esquema para Vistas Definidas por el Usuario

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL

Personalización de la Configuración SSL

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Certificados SSL de Cliente

El conector de Azure Analysis Services también admite la configuración de certificados de cliente. Configure lo siguiente para conectarse usando un certificado de cliente.

• SSLClientCert: el nombre del almacén de certificados para el certificado de cliente.
• SSLClientCertType: el tipo de almacén de claves que contiene el certificado de cliente TLS/SSL.
• SSLClientCertPassword: La contraseña para el certificado de cliente TLS/SSL.
• SSLClientCertSubject: El asunto del certificado de cliente TLS/SSL.

Modelo de Datos

Azure Analysis Services es una base de datos OLAP que expone datos como cubos, que consultar con MDX (expresiones multidimensionales). El conector modela estos cubos en vistas relacionales que puede consultar con SQL-92. La siguiente asignación es para el diseño del modelo:

• Catalog - Mostrado en el conector como un Catálogo.
• Cube: se muestra en el conector como esquema.
• Measure - Disponible en el conector bajo la vista especial de Medidas.
• Dimension - Cada dimensión se expone como una vista.
• Level - Cada nivel individual de una jerarquía se expone como una columna en la vista de dimensión adecuada.

Atributos de medida

De forma predeterminada, todos los atributos de medida se enumeran en una vista de 'Medidas'. Sin embargo, puede establecer SplitMeasures a 'verdadero' para dividir la vista de medidas; el resultado es que cada atributo de medida se incluye en su vista respectiva según el valor del Grupo de medida. No se incluye una clasificación adicional basada en 'Directorios de medidas'.

Medidas de Unión y Dimensiones

Para recuperar medidas por valor de nivel específico, emita una unión entre la vista de medida y cualquier dimensión o conjunto de dimensiones. Por ejemplo, emitir lo siguiente recuperará el número de clientes en cada ciudad:

SELECT m.[Customer Count], c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Tenga en cuenta que no es necesaria una condición de ENCENDIDO. Esto se debe a que las tablas ya están relacionadas correctamente en Azure Analysis Services. Si está utilizando una herramienta que requiere condiciones de ENCENDIDO, configure IncludeJoinColumns a verdadero. Esto agregará una serie de columnas de clave externa a cada vista que las relacionará entre sí. Estas columnas no devolverán datos por sí solas, pero pueden seleccionarse automáticamente con herramientas para construir las condiciones ON para las uniones cuando sea necesario.

Agregación de datos

Los datos almacenados en Azure Analysis Services ya están agregados. En muchos casos, intentar recuperar un agregado puede ser sintácticamente equivalente a no especificar nada. Por ejemplo, la siguiente consultar devolverá exactamente los mismos datos que la anterior:

SELECT SUM(m.[Customer Count]), c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
GROUP BY c.[City]

La excepción a esta regla es cuando se solicita una agregación de resultados filtrados. En tales casos, se solicitará un cálculo a Azure Analysis Services. Por ejemplo, para calcular la suma y el promedio de clientes en Francia y Alemania:

SELECT SUM(m.[Customer Count]), AVG(m.[Customer Count]), c.[Country]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
WHERE c.[Country] IN ('France', 'Germany')
GROUP BY c.[Country]

Selección de jerarquías múltiples

En Azure Analysis Services, las dimensiones individuales se componen de jerarquías que pueden tener uno o más niveles. Por ejemplo, la tabla Clientes de AdventureWorks tiene Ciudad, País y Género. Ciudad y País forman parte de la misma jerarquía, mientras que Género es su propia jerarquía.

Al seleccionar varias jerarquías, el método para admitir esto es unir de forma cruzada los valores en MDX. Si bien no es obvio a partir de un modelo de tabla relacional de los datos que presenta el conector, esto puede ocasionar que se ejecuten consultas muy costosas. Por ejemplo, ejecutando lo siguiente:

SELECT c.[Country], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Dará como resultado 6 filas. Sin embargo, al seleccionar Género también:

SELECT c.[Country], c.[Gender], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Ahora resultará en 12 filas. Se debe a que Género y País se encuentran en jerarquías diferentes, por lo que se requiere una unión cruzada para devolver ambos juntos. Cada jerarquía adicional agregada a SELECT multiplicará los resultados totales por la cantidad de valores disponibles en esa jerarquía. Por lo tanto, para contar cuántas filas esperar, se puede ejecutar lo siguiente:

SELECT (COUNT(c.[Country])*COUNT(c.[Gender])) AS totalrows
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 

Límite de fila de respuesta

Debido a que la selección de varias jerarquías multiplicará el número total de filas de resultados, es posible aumentar el número de filas de respuesta muy rápidamente, lo que provocará tiempos de espera. Para tratar de dar cierta visibilidad a las consultas que serán muy costosas, ResponseRowLimit La propiedad de conexión se ha agregado como un mecanismo para tratar de guiar a los usuarios hacia mejores prácticas. Cuando se establece, calculará cuántas filas esperar antes de que se ejecute cualquier consultar. Si el número de filas pronosticadas supera el límite, se generará un error que indicará cuántas filas se esperan con la consultar.

Se recomienda seleccionar solo las columnas requeridas o aplicar un criterio DONDE. Ambos pueden reducir significativamente el número de columnas de respuesta, lo que tendrá un gran impacto en el rendimiento. Si ya está familiarizado con el conector y qué consultas pueden ser costosas, ResponseRowLimit se puede deshabilitar configurándolo en 0.

Tablas del Sistema

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema

Las siguientes tablas devuelven metadatos de la base de datos para Azure Analysis Services:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consultas

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas

Sys_tablecolumns

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos para la tabla [adventureworks].[Model].Customer:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Customer' AND CatalogName='adventureworks' AND SchemaName='Model'

Columnas

Sys_procedimientos

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas

Sys_procedureparameters

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SelectEntries:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Columnas

Sys_keycolumns

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla [adventureworks].[Model].Customer:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Customer' AND CatalogName='adventureworks' AND SchemaName='Model'

Columnas

Sys_foreignkeys

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas

Sys_primarykeys

Describe las claves primarias. La siguiente consultar recupera las claves principales de todas las tablas y vistas:

SELECT * FROM sys_primarykeys

Columnas

Sys_indexes

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas

Sys_connection_props

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:aas:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas

Sys_sqlinfo

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas

Sys_identidad

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas

Procedimientos Almacenados

Procedimientos almacenados* son interfaces similares a funciones que amplían la funcionalidad del conector más allá de las simples operaciones SELECT con Azure Analysis Services.

Procedimientos almacenados* aceptan una lista de parámetros, realizan la función prevista y luego devuelven, si corresponde, cualquier dato de respuesta relevante de Azure Analysis Services, junto con una indicación de si el procedimiento se realizó correctamente o no.

Jitterbit Connector para Procedimientos Almacenados de Azure Analysis Services

GetAdminConsentURL

Obtiene la URL de consentimiento del administrador que un administrador de un dominio determinado debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita cuando se usan credenciales de OAuth personalizadas.

Aporte

Columnas del Conjunto de Resultados

Obtener Token de Acceso de OAuth

Obtiene el token de autenticación utilizado para autenticarse en el servicio.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

Obtiene una URL de autorización del origen de datos. La URL de autorización se puede utilizar para generar un verificador necesario para obtener el token de OAuth.

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Obtiene un OAuthAccessToken actualizado si se pasa un token para actualizar.

Aporte

Columnas del Conjunto de Resultados

Propiedades de Configuraciones Avanzadas

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Autenticación de Azure

OAuth

JWT OAuth

SSL

Esquema

Misceláneas

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

AuthScheme

El tipo de autenticación que se usará al conectarse a Azure Analysis Services.

Valores Posibles

AzureAD, AzureMSI, AzurePassword, AzureServicePrincipal

Tipo de Datos

string

Valor por Defecto

"AzureAD"

Observaciones

• Microsoft Entra ID: configure esto para realizar la autenticación OAuth de Azure Active Directory.
• AzureMSI: configure esto para obtener automáticamente las credenciales de identidad de servicio administrado cuando se ejecuta en una máquina virtual de Azure.
• AzurePassword: Configure esto para enviar Usuario y contraseña a Azure. Bajo el capó, aún se llevará a cabo un proceso de OAuth, pero se enviarán las credenciales de usuario/contraseña, lo que evitará que una ventana del navegador solicite autorización.
• AzureServicePrincipal: configure esto para autenticarse como una entidad de servicio de Azure.

URL

La URL utilizada para conectarse a Azure Analysis Services.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL HTTP o HTTPS utilizada para conectarse a Azure Analysis Services en el formato asazure://\[region\].asazure.windows.net/\[server\]. Puede obtener el nombre del servidor en Azure Portal -> Descripción general -> Nombre del servidor.

Usuario

La cuenta de usuario de Azure Analysis Services utilizada para la autenticación.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Junto con Contraseña, este campo se usa para autenticarse en el servidor de Azure Analysis Services.

Contraseña

La contraseña utilizada para autenticar al usuario.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El usuario y Password se usan juntos para autenticarse con el servidor.

Autenticación de Azure

Esta sección proporciona una lista completa de las propiedades de autenticación de Azure que puede configurar.

AzureInquilino

El inquilino de Microsoft Online que se usa para acceder a los datos. Si no se especifica, se utiliza su arrendatario predeterminado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El inquilino de Microsoft Online que se usa para acceder a los datos. Por ejemplo, contoso.onmicrosoft.com. Como alternativa, especifique el Id. de arrendatario. Este valor es el ID de directorio en Azure Portal > Active Directory de Azure > Propiedades.

Por lo general, no es necesario especificar el Arrendatario. Microsoft puede determinar esto automáticamente cuando se utiliza el OAuthGrantType establecido en CÓDIGO (predeterminado). Sin embargo, puede fallar en el caso de que el usuario pertenezca a varios inquilinos. Por ejemplo, si un administrador del dominio A invita a un usuario del dominio B a ser un usuario invitado. El usuario ahora pertenecerá a ambos inquilinos. Es una buena práctica especificar el Tenant, aunque en general las cosas normalmente deberían funcionar sin tener que especificarlo.

El AzureTenant es necesario cuando se configura OAuthGrantType al CLIENTE. Cuando se usan credenciales de cliente, no hay contexto de usuario. Las credenciales se toman del contexto de la propia aplicación. Si bien Microsoft todavía permite obtener las credenciales de los clientes sin especificar qué arrendatario, tiene una probabilidad mucho menor de elegir el arrendatario específico con el que desea trabajar. Por esta razón, requerimos AzureTenant debe indicarse explícitamente para todas las conexiones de credenciales de clientes para garantizar que obtenga las credenciales que se aplican al dominio al que desea conectarse.

AzureAmbiente

El ambiente de Azure que se usará al establecer una conexión.

Valores Posibles

GLOBAL, CHINA, USGOVT, USGOVTDOD

Tipo de Datos

string

Valor por Defecto

"GLOBAL"

Observaciones

En la mayoría de los casos, funcionará dejar el ambiente establecido en global. Sin embargo, si su cuenta de Azure se ha agregado a un ambiente diferente, el AzureEnvironment se puede utilizar para especificar qué ambiente. Los valores disponibles son GLOBAL, CHINA, USGOVT, USGOVTDOD.

OAuth

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles

OFF, GETANDREFRESH, REFRESH

Tipo de Datos

string

Valor por Defecto

"OFF"

Observaciones

Las siguientes opciones están disponibles:

1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
3. REFRESH: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecretOAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret propiedad.

Token de Acceso de OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

URL de Devolución de Llamada

La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Durante el proceso de autenticación, el servidor de autorización de OAuth redirige al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

OAuthVerifier

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth a GETANDREFRESH para automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

JWT OAuth

Esta sección proporciona una lista completa de las propiedades de JWT OAuth que puede configurar.

OAuthJWTCert

El almacén de certificados JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El nombre del almacén de certificados para el certificado de cliente.

El OAuthJWTCertType especifica el tipo de almacén de certificados especificado por OAuthJWTCert. Si la tienda está protegida con contraseña, especifique la contraseña en OAuthJWTCertPassword.

OAuthJWTCert se usa junto con OAuthJWTCertSubject para especificar certificados de cliente. Si OAuthJWTCert tiene un valor y OAuthJWTCertSubject, se inicia una búsqueda de un certificado. Consulte OAuthJWTCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

OAuthJWTCertType

El tipo de almacén de claves que contiene el certificado JWT.

Valores Posibles

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Datos

string

Valor por Defecto

"USER"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

OAuthJWTCertPassword

La contraseña para el certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se usa para especificar esa contraseña para abrir el almacén de certificados.

OAuthJWTCertSubject

El asunto del certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

"\*"

Observaciones

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@cdata.com". Los campos comunes y sus significados se muestran a continuación.

Si un valor de campo contiene una coma, debe estar entre comillas.

OAuthJWTIssuer

El emisor del token web de Java.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El emisor del token web de Java. Suele ser el ID del cliente o la dirección de Correo de la aplicación OAuth.

OAuthJWTAsunto

El sujeto de usuario para el que la aplicación solicita acceso delegado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El sujeto de usuario para el que la aplicación solicita acceso delegado. Por lo general, el nombre de la cuenta de usuario o la dirección de correo.

SSL

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

SSLClientCert

El almacén de certificados de cliente TLS/SSL para la autenticación de cliente SSL (SSL bidireccional).

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El nombre del almacén de certificados para el certificado de cliente.

El SSLClientCertType especifica el tipo de almacén de certificados especificado por SSLClientCert. Si la tienda está protegida con contraseña, especifique la contraseña en SSLClientCertPassword.

SSLClientCert se usa junto con SSLClientCertSubject para especificar certificados de cliente. Si SSLClientCert tiene un valor y SSLClientCertSubject, se inicia una búsqueda de un certificado. Vea SSLClientCertSubject para más información.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (por ejemplo, almacén de certificados PKCS12).

SSLClientCertType

El tipo de almacén de claves que contiene el certificado de cliente TLS/SSL.

Valores Posibles

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Datos

string

Valor por Defecto

"USER"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

SSLClientCertPassword

La contraseña para el certificado de cliente TLS/SSL.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se utiliza para especificar esa contraseña para abrir el almacén de certificados.

SSLClientCertSubject

El asunto del certificado de cliente TLS/SSL.

Tipo de Datos

string

Valor por Defecto

"\*"

Observaciones

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad. Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@company.com". Los campos comunes y sus significados se muestran a continuación.

Si un valor de campo contiene una coma, debe estar entre comillas.

SSLServerCert

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Ubicación

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos

string

Valor por Defecto

"%APPDATA%\\\AAS Data Provider\\Schema"

Observaciones

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\AAS Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Esquemas Navegables

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Catalogar

El catálogo de Analysis Services que se va a utilizar. Esto también puede conocerse como una base de datos dentro de Analysis Services.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Esta entrada es opcional ya que los catálogos se mostrarán de forma predeterminada. Sin embargo, si tiene UseMDX establecido en verdadero, este valor garantizará que las consultas MDX se envíen al catálogo correcto.

IncluirJoinColumns

Establézcalo en verdadero para incluir columnas de combinación adicionales en cada tabla.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

Algunas herramientas pueden requerir una condición ON (o generarlas automáticamente) en función de las referencias de clave externa. Configurando IncludeJoinColumns a verdadero, cada tabla incluirá una referencia de clave externa a las otras tablas. Estas columnas no devolverán ningún dato y no son útiles para nada más que pasar como condiciones ON para realizar uniones.

En Azure Analysis Services, las dimensiones y medidas que componen las tablas ya están relacionadas de forma natural. No hay contexto en el que unirse a ellos siempre. Por lo tanto, Jitterbit Connector for Azure Analysis Services admite la unión sin especificar una condición ON, por lo que es opcional especificarlos.

Misceláneas

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Encabezados Personalizados

Otros encabezados según lo determine el usuario (opcional).

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Esta propiedad se puede establecer en una cadena de encabezados que se agregarán a los encabezados de solicitud HTTP creados a partir de otras propiedades, como ContentType, From, etc.

Los encabezados deben tener el formato "encabezado: valor " como se describe en las especificaciones HTTP. Las líneas de encabezado deben estar separadas por los caracteres de retorno de carro y avance de línea (CRLF).

Utilice esta propiedad con precaución. Si esta propiedad contiene encabezados no válidos, las solicitudes HTTP pueden fallar.

Esta propiedad es útil para ajustar la funcionalidad del conector para integrarlo con APIs especializadas o no estándar.

ExpressionInDescription

Establézcalo en verdadero para informar expresiones como parte de la descripción en las columnas de medida.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

El conector informa los comentarios para varios tipos de entidades (dimensiones, medidas, grupos de medidas y jerarquías) como descripciones de tablas y columnas. De forma predeterminada, el conector incluirá solo los comentarios en las descripciones de las columnas de medida.

Si esta opción está habilitada, la expresión de medida se incluye en la descripción de la columna de medida, junto con los comentarios. Las descripciones de otros tipos de entidades no se ven afectadas.

ExtraPropiedades

Propiedades adicionales para enviar en cada solicitud MDX a Azure Analysis Services.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Al configurar Usar MDX en true, las propiedades se pueden especificar mediante esta propiedad de conexión para completar valores adicionales en la lista de propiedades de la solicitud XMLA. Utilice pares nombre=valor separados por un punto y coma para enviar las propiedades. Por ejemplo, Catalog=MyCatalog;Cube=MyCube;.

Se puede encontrar una lista de propiedades ejecutando SELECT * FROM $System.DISCOVER_PROPERTIES.

Filas Máximas

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos

int

Valor por Defecto

-1

Observaciones

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo

ResponseRowLimitResponseRowLimit

El número de filas de respuesta que se permitirán antes de generar un error. Establézcalo en 0 para el límite actual.

Tipo de Datos

int

Valor por Defecto

100000

Observaciones

La selección de muchas columnas da como resultado una serie de combinaciones cruzadas que se producen bajo el capó cuando se traduce a algo que es aceptable para Azure Analysis Services. Esto no es intuitivo si no está familiarizado con MDX. Puede resultar fácilmente en respuestas muy grandes que se agotan. El ResponseRowLimit está diseñado para tratar de alertar al usuario para que comprenda lo que pueden ser solicitudes muy costosas.

Mostrar Entidades Ocultas

Establézcalo en verdadero para incluir dimensiones, medidas y niveles ocultos.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

De forma predeterminada, el conector no informa de las entidades que Azure Analysis Services marca como ocultas. Habilitar esta opción le permite consultar.

DividirMedidas

Establézcalo en verdadero para dividir la tabla de medidas en tablas individuales.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

Todas las medidas están actualmente agrupadas en una sola tabla 'Medidas'. Establézcalo en verdadero para dividir la tabla de medidas en tablas individuales (si una tabla solo contiene medidas) e incluir medidas en las tablas de dimensiones respectivas.

Se Acabó el Tiempo

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos

int

Valor por Defecto

60

Observaciones

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.

UsarMDX

Establézcalo en verdadero para pasar consultas MDX a Azure Analysis Services tal cual.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

Puede ejecutar consultas SQL-92 SELECT a las vistas modeladas por el conector; establezca esta propiedad para ejecutar consultas MDX directamente en Azure Analysis Services.

Consulte Recuperación de datos de Analysis Services para obtener más información sobre cómo consultar Azure Analysis Services a través del conector.

Vistas Definidas por el Usuario

Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM [adventureworks].[Model].Customer WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"