Detalles de Conexión de Microsoft SSAS

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión de SQL Server Analysis Services

El conector envuelve la complejidad de conectarse a SQL Server Analysis Services en un controlador estándar: autenticación con HTTP, Windows (NTLM) o Kerberos. A continuación, puede ejecutar consultas SQL-92 o pasar consultas MDX desde herramientas relacionales.

Establecer una Conexión

Conexión a SQL Server Analysis Services

Para conectarse, configure URL propiedad a un extremo válido de SQL Server Analysis Services y proporcionar autenticación. El conector debe conectarse a las instancias de SQL Server Analysis Services alojadas a través de HTTP con acceso XMLA. Consulte la documentación de Microsoft para configurar el acceso HTTP a SQL Server Analysis Services.

Autenticación en SQL Server Analysis Services

El conector es compatible con los principales esquemas de autenticación, incluidos HTTP y Windows.

Colocar AuthScheme para usar los siguientes tipos de autenticación.

Autenticación Anónima

Si la autenticación anónima está disponible, configure AuthScheme a ninguno para evitar la autenticación.

Autenticación Básica

Establecer base de datos de SQL Server User y Password y establecer AuthScheme a "BÁSICO".

Windows (ntlm)

Configurar las Windows User y Password y establecer AuthScheme a "NTLM".

Autenticación con Kerberos

Consulte Uso de Kerberos para obtener detalles sobre cómo autenticarse con Kerberos.

Protección de las Conexiones de SQL Server Analysis Services

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 para los formatos disponibles.

Uso de Kerberos

Esta sección muestra cómo usar el conector para autenticarse en SQL Server Analysis Services mediante Kerberos.

Autenticación con Kerberos

Para autenticarse en SQL Server Analysis Services mediante Kerberos, establezca las siguientes propiedades:

• AuthScheme: Establézcalo en NEGOTIATE.
• KerberosKDC: Establézcalo en host name or IP Address de su máquina Kerberos KDC.
• KerberosRealm: Establézcalo en the realm of the SQL Server Analysis Services Kerberos principal. Este será el valor después del símbolo '@' (por ejemplo, EXAMPLE.COM) de principal value (por ejemplo, ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Establézcalo en service and host of the SQL Server Analysis Services Kerberos Principal. Este será el valor antes del símbolo '@' (por ejemplo, ServiceName/MyHost) de principal value (por ejemplo, ServiceName/MyHost@EXAMPLE.COM).

Recuperar el Ticket de Kerberos

Puede utilizar una de las siguientes opciones para recuperar el vale de Kerberos requerido.

Archivo de Caché de Credenciales MIT Kerberos

Esta opción le permite utilizar el administrador de tickets MIT Kerberos o el comando kinit para obtener tickets. Tenga en cuenta que usted no necesitará configurar el User o Password propiedades de conexión con esta opción.

1. Asegúrese de tener una variable de ambiente creada llamada KRB5CCNAME.
2. Configure el KRB5CCNAME variable de ambiente a una ruta que apunta a su credential cache file (por ejemplo, C:\krb_cache\krb5cc_0 o /tmp/krb5cc_0). Este archivo se creará al generar su ticket con MIT Kerberos Ticket Manager.
3. Para obtener un ticket, abra la aplicación MIT Kerberos Ticket Manager, haga clic en Get Ticket, enter your principal name and password, then click OK. Si tiene éxito, la información del ticket aparecerá en Kerberos Ticket Manager y ahora se almacenará en el archivo de caché de credenciales.
4. Ahora que se ha creado el archivo de caché de credenciales, el conector utilizará el archivo de caché para obtener el vale de kerberos para conectarse a SQL Server Analysis Services.

Como alternativa a la configuración de KRB5CCNAME variable de ambiente, puede establecer directamente la ruta del archivo usando KerberosTicketCache propiedad. Cuando se establece, el conector utilizará el archivo de caché especificado para obtener el vale de Kerberos para conectarse a SQL Server Analysis Services.

Archivo de Tabla de Claves

Si no se ha configurado la variable de entorno KRB5CCNAME, puede recuperar un ticket de Kerberos usando un Keytab File. Para hacer esto, configure User propiedad al nombre de usuario deseado y configure KerberosKeytabFile propiedad a una ruta de archivo que apunta al archivo keytab asociado con el usuario.

Usuario y Contraseña

Si no se han establecido ni la variable de entorno KRB5CCNAME ni la propiedad KerberosKeytabFile, puede recuperar un boleto usando un User and Password combination. Para hacer esto, configure User y Password propiedades al combo de usuario/contraseña que usa para autenticarse con SQL Server Analysis Services.

Autenticación Entre Reinos

Los ambientes de Kerberos más complejos pueden requerir la autenticación entre dominios donde se utilizan múltiples dominios y servidores KDC (por ejemplo, donde se usa un dominio/KDC para la autenticación del usuario y otro dominio/KDC para obtener el ticket de servicio).

En tal ambiente, el KerberosRealm y KerberosKDC las propiedades se pueden establecer en los valores necesarios para la autenticación del usuario. El KerberosServiceRealm y KerberosServiceKDC las propiedades se pueden configurar a los valores requeridos para obtener el ticket de servicio.

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 pasen directamente a SQL Server 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 arrojar 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.

Recuperación de Datos de Servicios de Análisis

SQL Server 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 SQL Server 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 SQL Server 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 SQL Server 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 SQL Server 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.

Notas Importantes

Procedimientos Almacenados

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas

Esta sección detalla una selección de características avanzadas del conector de SQL Server 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.

Vistas Definidas por el Usuario

El conector Jitterbit para SQL Server 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 Utilizando 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 [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].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"

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 SQL Server 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

SQL Server 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 o MDX.

Acceso a cubos como vistas

SQL Server Analysis Services es fundamentalmente diferente de una base de datos relacional; como reflejo de estas diferencias, Jitterbit Connector para SQL Server Analysis Services no es compatible con muchas funciones de SQL-92 que se encuentran en un controlador para un RDBMS. Para evitar cualquier limitación con la traducción de consultar, puede enviar consultas MDX de transferencia desde el conector.

Consulte Recuperación de datos de Analysis Services para consultar las limitaciones de las consultas y obtener más información sobre las consultas de SQL Server Analysis Services.

Modelado de vistas dinámicamente

Puede consultar todos los cubos en su instancia de SQL Server Analysis Services; cuando se conecta, el conector recupera los metadatos de SQL Server Analysis Services y muestra las dimensiones y medidas disponibles como columnas para las vistas (cubos). El conector actualiza dinámicamente los esquemas en las conexiones posteriores.

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' y cada atributo de medida se incluirá en su vista respectiva según el valor del Grupo de medida. No se incluirán clasificaciones adicionales basadas en 'Directorios de medidas'.

Acceso a la información del esquema

Consultar las Tablas del sistema para acceder a la información del esquema y otros metadatos del conector.

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 SQL Server 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 Consulta

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 [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Customer' AND CatalogName='AdventureWorksDW2012Multidimensional-SE' AND SchemaName='Adventure Works'

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 [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Customer' AND CatalogName='AdventureWorksDW2012Multidimensional-SE' AND SchemaName='Adventure Works'

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_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:ssas: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.

Procesamiento Colaborativo de Consultas

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

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

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

Kerberos

SSL

Esquema

Misceláneas

Autenticación

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

AuthScheme

El esquema utilizado para la autenticación. Las entradas aceptadas son NTLM, Basic, Digest, None y Negotiate.

Valores Posibles

NTLM, Basic, Digest, None, Negotiate

Tipo de Datos

string

Valor por Defecto

"NTLM"

Observaciones

Junto con Contraseña y Usuario, este campo se utiliza para autenticarse en el servidor. NTLM es la opción predeterminada. Utilice las siguientes opciones para seleccionar su esquema de autenticación:

• NTLM: configure esto para usar sus credenciales de Windows para autenticarse.
• Básico: Establezca esto para usar la autenticación HTTP básica.
• Negociar: Si AuthScheme está configurado en Negociar, el conector negociará un mecanismo de autenticación con el servidor. Colocar AuthScheme para negociar el uso de la autenticación Kerberos.
• Digest: configure esto para usar la autenticación HTTP Digest.

URL

La URL utilizada para conectarse a SQL Server Analysis Services.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL HTTP o HTTPS utilizada para conectarse a SQL Server Analysis Services.

El conector debe conectarse a las instancias de SQL Server Analysis Services alojadas a través de HTTP con acceso XMLA. Consulte la documentación de Microsoft para configurar el acceso HTTP a SQL Server Analysis Services.

Usuario

La cuenta de usuario de SQL Server 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 SQL Server 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.

Kerberos

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

KerberosKDC

El servicio Kerberos Key Distribution Center (KDC) utilizado para autenticar al usuario.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades de Kerberos se usan cuando se usa SPNEGO o la autenticación de Windows. El conector solicitará vales de sesión y claves de sesión temporales del servicio Kerberos KDC. El servicio Kerberos KDC se coloca convencionalmente con el controlador de dominio.

Si no se especifica Kerberos KDC, el conector intentará detectar estas propiedades automáticamente desde las siguientes ubicaciones:

• KRB5 Config File (krb5.ini/krb5.conf): Si se establece la variable de ambiente KRB5_CONFIG y el archivo existe, el conector obtendrá el KDC del archivo especificado. De lo contrario, intentará leer desde la ubicación MIT predeterminada según el sistema operativo: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) o /etc/krb5.conf (Linux)
• Java System Properties: Utilizando las propiedades del sistema java.security.krb5.realm y java.security.krb5.kdc.
• Domain Name and Host: El conector inferirá Kerberos Realm y Kerberos KDC a partir del nombre de dominio y el alojar configurados como último recurso.

Nota: La autenticación de Windows solo es compatible con JRE 1.6 y superior.

Reino de Kerberos

El reino de Kerberos utilizado para autenticar al usuario.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades de Kerberos se usan cuando se usa SPNEGO o la autenticación de Windows. Kerberos Realm se utiliza para autenticar al usuario con el servicio de distribución de claves Kerberos (KDC). Un administrador puede configurar Kerberos Realm para que sea cualquier cadena, pero convencionalmente se basa en el nombre de dominio.

Si no se especifica Kerberos Realm, el conector intentará detectar estas propiedades automáticamente desde las siguientes ubicaciones:

• KRB5 Config File (krb5.ini/krb5.conf): Si se establece la variable de ambiente KRB5_CONFIG y el archivo existe, el conector obtendrá el dominio predeterminado del archivo especificado. De lo contrario, intentará leer desde la ubicación MIT predeterminada según el sistema operativo: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) o /etc/krb5.conf (Linux)
• Java System Properties: Utilizando las propiedades del sistema java.security.krb5.realm y java.security.krb5.kdc.
• Domain Name and Host: El conector inferirá Kerberos Realm y Kerberos KDC a partir del nombre de dominio y el alojar configurados por el usuario como último recurso. Esto podría funcionar en algunos ambientes de Windows.

Nota: La autenticación basada en Kerberos solo es compatible con JRE 1.6 y versiones posteriores.

KerberosSPN

El nombre principal de servicio (SPN) para el controlador de dominio Kerberos.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si el SPN en el controlador de dominio Kerberos no es el mismo que la URL en la que se está autenticando, use esta propiedad para configurar el SPN.

KerberosKeytabFile

El archivo Keytab que contiene sus pares de principales de Kerberos y claves cifradas.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El archivo Keytab que contiene sus pares de principales de Kerberos y claves cifradas.

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%\\\SSAS 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%\\SSAS 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.

Misceláneas

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

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.

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.

ExtraPropiedades

Propiedades adicionales para enviar en cada solicitud MDX a SQL Server 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.

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 SQL Server 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 para SQL Server Analysis Services admite la unión sin especificar una condición ON, por lo que es opcional especificarlos.

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 no tener límite.

Tipo de Datos

int

Valor por Defecto

100000

Observaciones

La selección de muchas columnas da como resultado una cantidad de combinaciones cruzadas que ocurren bajo el capó cuando se traduce a algo que es aceptable para SQL Server 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 caras.

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 SQL Server 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 SQL Server Analysis Services. Si utiliza consultas MDX directamente, se recomienda especificar también el Catálogo para garantizar que las consultas MDX se envíen al catálogo correcto.

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