Detalles de Conexión de monday.com¶

Introducción¶

Versión del conector

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

Empezando¶

Soporte de la versión del lunes

El conector aprovecha la API de Monday para habilitar el acceso bidireccional a Monday.

Establecer una Conexión¶

Conexión a la API de Monday GraphQL¶

Conéctese usando la autenticación de token API o la autenticación OAuth

Conexión con un Token API¶

Conéctese al conector especificando APIToken. Selecciona el AuthScheme a Token y obtener APIToken como sigue:

1. Inicie sesión en su cuenta de Monday y navegue hasta Manage Applications en el panel izquierdo.
2. Seleccione la aplicación para la que le gustaría crear un token. Es posible que primero deba crear una aplicación.
3. Haga clic en Create token botón para generar un APIToken.

OAuth¶

Alternativamente, puede establecer una conexión Usando la autenticación OAuth.

Conexión a la API de Monday AuditLog¶

Para generar el token API de registro de auditoría, acceda a la sección de administración de su cuenta de Monday, haga clic en la sección "Seguridad" y luego en la pestaña"Auditoría". Desde allí, seleccione el botón "Monitor por API" y cópielo.

Después de recuperar el token API, puede conectarse desde el controlador configurando las siguientes propiedades de conexión:

• Schema=AuditLog
• AuthScheme=Token
• APIToken=Su token API de registro de auditoría
• Domain=https://yourdomain.monday.com

Uso de la Autenticación OAuth¶

OAuth requiere que el usuario que se autentica interactúe con Monday usando el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Personalizadas¶

Necesitas registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Aplicaciones de escritorio

Cree una aplicación OAuth. Consulte Crear una aplicación OAuth personalizada para el procedimiento.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para el procedimiento.

Credenciales Personalizadas¶

Esta sección describe la autenticación de escritorio usando las credenciales para su aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada para más información.

Obtenga un Token de Acceso OAuth¶

Después de configurar lo siguiente, está listo para conectarse:

• AuthScheme: Ajustado a OAuth.
• OAuthClientId: establezca la ID de cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca el secreto del cliente en la configuración de su aplicación.
• CallbackURL: Configure la URL de redireccionamiento en la configuración de su aplicación.
• InitiateOAuth: Ajustado a GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

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 siguiente 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 anterior.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza¶

Para crear fuentes de datos de lunes en servidores sin periféricos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Crear una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Esta sección describe el procedimiento para autenticar y conectarse a los datos.

Obtener un Código Verificador¶

Primero, establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajustado a OFF.
• OAuthClientId: establezca la ID de la aplicación en la configuración de su aplicación.
• OAuthClientSecret: establezca el secreto de la aplicación en la configuración de su aplicación.

A continuación, autentíquese desde otra máquina y obtenga el OAuthVerifier propiedad de conexión:

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Necesita configurar esto en OAuthVerifier propiedad de conexión.

Finalmente, en la máquina sin periféricos, configure las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• AuthScheme: Ajustado a OAuth.
• OAuthClientId: establezca la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establecido en el código del verificador.
• OAuthSettingsLocation: configurado para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Ajustado a REFRESH.

Conectarse a Datos¶

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establecido en el archivo que contiene los valores de autenticación OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Ajustado a REFRESH.

Transferir la Configuración de OAuth¶

Para instalar el conector en otra máquina, autentíquese y luego transfiera los valores de OAuth resultantes:

1. En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:
   • OAuthSettingsLocation: Establecido en un archivo de texto grabable.
   • InitiateOAuth: Ajustado a GETANDREFRESH.
   • AuthScheme: Ajustado a OAuth.
   • OAuthClientId: establezca la ID de cliente en la configuración de su aplicación.
   • OAuthClientSecret: establezca el secreto del cliente en la configuración de su aplicación.
   • CallbackURL: establezca la URL de devolución de llamada en la configuración de su aplicación.
2. Pruebe la conexión para autenticar. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:
   • InitiateOAuth: Ajustado a REFRESH.
   • OAuthSettingsLocation: establezca la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.

Creación de una Aplicación OAuth Personalizada¶

Crear una Aplicación OAuth Personalizada: Escritorio¶

Complete el siguiente procedimiento para obtener el OAuthClientId, OAuthClientSecret, y CallbackURL.

Limitaciones de GraphQL¶

Cada API de GraphQL tiene sus propias limitaciones y no podemos consultar una cantidad arbitrariamente grande de nodos porque cada consultar tiene un costo y la API devolverá un error si el conector excede el costo máximo. La función de costo de consultar depende directamente de los tamaños de página. El conector utiliza sus propios algoritmos para encontrar los tamaños de página, pero también le da la libertad de ajustarlos según sus necesidades. Hay dos formas de lograr este comportamiento:

• Especifique pesos de tamaño de página personalizados incluyendo "other:pageSizeWeights" atributo. Supongamos que tenemos una tabla "Clientes" que tiene dos conexiones GraphQl anidadas, empresas y clientes. Si desea una relación específica entre estas dos entidades por consultar, digamos 200 clientes por 1 negocio, debe especificar "otro: tamaño de página = 1: 200" en el secuencia de comandos respectivo. La ventaja de este atributo es que no pasa por alto nuestra lógica para encontrar el tamaño de página óptimo en función del costo de la consultar.
• Especifique tamaños de página personalizados incluyendo "other:pageSizes" atributo. Al especificar este atributo, omitirá cualquier verificación que hagamos para el costo de la consultar, por lo que debe tener cuidado porque habrá errores de API si excede el costo máximo por consultar. Ejemplo: "other:pageSizeWeights=10,30", recupera como máximo 10 empresas y como máximo 30 clientes por empresa en una consultar.

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector Monday.

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 cantidad posible del procesamiento de la declaración SELECT al lunes 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¶

El Jitterbit Connector for Monday te permite definir una tabla virtual cuyos contenidos se deciden 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 Invoices 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.

Modelo de Datos¶

Jitterbit Connector for Monday modela los objetos Monday como tablas y vistas relacionales. Un objeto lunes tiene relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas. Las siguientes secciones muestran los objetos API disponibles y brindan más información sobre la ejecución de las APIs de SQL to Monday.

Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto.

El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT a las APIs de Monday y luego procesa el resto de la consultar en la memoria. Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Usando la API de GraphQL

Consulte Modelo de datos de GraphQL para las entidades disponibles en la API de GraphQL.

Usando la API de registro de auditoría

Consulte Modelo de datos de AuditLog para las entidades disponibles en la API AuditLog.

Modelo de Datos GraphQL¶

Descripción General¶

Jitterbit Connector for Monday modela los objetos Monday como tablas y vistas relacionales.

Un objeto Lunes tiene relaciones con otros objetos en las tablas. Estas relaciones se expresan a través de claves foráneas. Las siguientes secciones muestran los objetos API disponibles y brindan más información sobre la ejecución de las APIs SQL to Monday.

Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto.

Puntos de Vista¶

Puntos de vista describe las vistas disponibles. Las vistas se definen estáticamente para modelar cuentas, clientes, productos y más.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido.

Se admiten las vistas dinámicas, como las consultas expuestas como vistas y las vistas para buscar combinaciones específicas de elementos de trabajo project_team.

Conector Jitterbit para Vistas de Lunes¶

Registros de Actividad¶

Los eventos de registro de la junta.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• BoardId admite los operadores '=, IN'.
• UserId admite los operadores '=, IN'.
• ColumnId admite los operadores '=, IN'.
• GroupId admite los operadores '=, IN'.
• ItemId admite los operadores '=, IN'.
• CreatedAt admite los operadores '=, >, >=, <, <='.

SELECCIONAR

SELECT * FROM ActivityLogs WHERE BoardId IN ('2307103055','2182296646')
SELECT * FROM ActivityLogs WHERE UserId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE ColumnId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE GroupId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE ItemId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE CreatedAt > '2022-02-17 05:12:04.419' AND CreatedAt < '2022-02-17 05:12:04.861'
SELECT * FROM ActivityLogs WHERE CreatedAt >= '2022-02-17 05:12:04.419' AND CreatedAt <= '2022-02-17 05:12:04.861'

Columnas¶

Activos¶

Obtenga una colección de activos por ID.

Información Específica de la Tabla¶

Nota: Se requiere el filtro de ID para recuperar datos de esta tabla.

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Assets WHERE Id = '397532775'
SELECT * FROM Assets WHERE ID IN ('397532775','397532776')

Columnas¶

TableroItemsInterno¶

Obtenga una colección de ID de tableros y artículos. Esta vista es solo para uso interno.

Columnas¶

Tableros¶

Consigue una colección de tableros.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '=, IN'.
• BoardKind admite los operadores '='.

SELECCIONAR

SELECT * FROM Boards WHERE Id = '2182296646'
SELECT * FROM Boards WHERE Id IN ('2307103055','2182296646','2181960030')
SELECT * FROM Boards WHERE Id IN ('2307103055','2182296646','2181960030') AND BoardKind = 'public'
SELECT * FROM Boards WHERE BoardKind = 'public'

Columnas¶

Vistas del Tablero¶

Las opiniones de la junta.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• BoardId admite los operadores '=, IN'.
• Type apoya el = operador.

SELECCIONAR

SELECT * FROM BoardViews WHERE BoardId = '2182296646'
SELECT * FROM BoardViews WHERE Type = 'Chart'
SELECT * FROM BoardViews WHERE BoardId IN ('2182296646','2181960030')

Columnas¶

Columnas¶

Las columnas visibles del tablero.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• ID admite los operadores '=, IN'.
• BoardId admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Columns WHERE ID = 'name'
SELECT * FROM Columns WHERE ID IN ('name','person')
SELECT * FROM Columns WHERE BoardId = '2182296646'
SELECT * FROM Columns BoardId IN ('2182296646','2181960030')

Columnas¶

Valores de Columna¶

Los valores de columna del elemento.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '=, IN'.
• ItemId admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM ColumnValues WHERE Id = 'person'
SELECT * FROM ColumnValues WHERE Id IN ('person','status')
SELECT * FROM ColumnValues WHERE ItemId IN ('2181853162','2181853151')
SELECT * FROM ColumnValues WHERE ItemId = '2181853162'
SELECT * FROM ColumnValues WHERE ItemId = '2181853162' AND ID = 'status'

Columnas¶

Grupos¶

Los grupos visibles del tablero.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '=, IN'.
• BoardId admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Groups WHERE Id = 'topics'
SELECT * FROM Groups WHERE Id IN ('topics','group_title')
SELECT * FROM Groups WHERE BoardId IN ('2182296646','21822966')
SELECT * FROM Groups WHERE BoardId = '2182296646' AND ID = 'topics'

Columnas¶

Elementos¶

Consigue una colección de artículos.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '='.
• BoardId admite los operadores '='.
• ColumnId admite los operadores '='.
• ColumnValue admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Items ORDER BY CreatedAt DESC
SELECT * FROM Items WHERE Id = 2181917692
SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue = 'test'
SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue IN ('Working on it','test')

Columnas¶

Etiquetas¶

Obtener una colección de etiquetas.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• ID admite los operadores '=, IN'.
• IsPrivate apoya el = operador.

SELECCIONAR

SELECT * FROM Tags WHERE IsPrivate = true
SELECT * FROM Tags WHERE IsPrivate = false
SELECT * FROM Tags WHERE ID = '13327214'
SELECT * FROM Tags WHERE ID IN ('13327214','13327217')

Columnas¶

Equipos¶

Obtener una colección de equipos.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Id admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Teams WHERE Id = '565332'
SELECT * FROM Teams WHERE ID IN ('565332,565333')

Columnas¶

Actualizaciones¶

Obtenga una colección de actualizaciones.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor. SELECCIONAR

SELECT * FROM Updates

Columnas¶

Usuarios¶

Obtener una colección de usuarios.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes. Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• ID admite los operadores '=, IN'.
• IsPending admite los operadores '='.
• IsGuest admite los operadores '='.
• Email admite los operadores '=, IN'.

SELECCIONAR

SELECT * FROM Users ORDER BY CreatedAt DESC
SELECT * FROM Users WHERE IsPending = true
SELECT * FROM Users WHERE IsGuest = true
SELECT * FROM Users WHERE ID = '27278379'
SELECT * FROM Users WHERE ID IN ('27278379','27278377')
SELECT * FROM Users WHERE Email = 'test@cdata.com'
SELECT * FROM Users WHERE Email IN ('test@cdata.com','test@gmail.com')

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 Monday.

Procedimientos almacenados* aceptar una lista de parámetros, realizar su función prevista y luego devolver, si corresponde, cualquier dato de respuesta relevante del lunes, junto con una indicación de si el procedimiento tuvo éxito o falló.

Conector Jitterbit para los Procedimientos Almacenados del Lunes¶

Obtener Token de Acceso de OAuth¶

Obtiene el token de acceso de OAuth de GitHub.

Aporte¶

Columnas del Conjunto de Resultados¶

Obtener URL de Autorización de OAuth¶

Obtiene la URL de autorización de GitHub. Acceda a la URL devuelta en la salida en un navegador web. Esto solicita el token de acceso que se puede usar como parte de la cadena de conexión a GitHub.

Aporte¶

Columnas del Conjunto de Resultados¶

Modelo de Datos de Registro de Auditoría¶

Descripción General¶

Jitterbit Connector for Monday modela los objetos Monday como tablas y vistas relacionales.

Un objeto Lunes tiene relaciones con otros objetos en las tablas. Estas relaciones se expresan a través de claves foráneas. Las siguientes secciones muestran los objetos API disponibles y brindan más información sobre la ejecución de las APIs SQL to Monday.

Los esquemas para la mayoría de los objetos de la base de datos se definen en archivos de configuración simples basados en texto.

Puntos de Vista¶

Puntos de vista describe las vistas disponibles. Las vistas se definen estáticamente para modelar AuditLogs.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido.

Se admiten las vistas dinámicas, como las consultas expuestas como vistas y las vistas para buscar combinaciones específicas de elementos de trabajo project_team.

Conector Jitterbit para Vistas de Lunes¶

Registros de Auditoría¶

Los eventos de registro de auditoría de la junta.

Información Específica de la Tabla¶

El conector usa la API de Monday para procesar algunos de los filtros. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL en falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a otras columnas generará datos incoherentes.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor.

• Timestamp admite los operadores '=, >, >=, <, <='.
• UserId apoya el = operador.
• IpAddress apoya el = operador.
• Event admite los operadores '=, IN'.

Todos los valores disponibles para el filtro de eventos se enumeran y explican a continuación:

• export-board-activity-log: Exportación del registro de actividad del tablero de registros por parte de los usuarios
• export-account-data: Exportación de datos de cuenta de registros por administradores
• download-attachment: Registros de descargas de archivos por parte de los usuarios
• export-board: Exportaciones del tablero de registros por parte de los usuarios
• export-dashboard: Registros de las exportaciones del tablero por parte de los usuarios
• export-content-directory: Registra las exportaciones de directorios de contenido por parte de los administradores
• login: Registra los inicios de sesión de los usuarios en el sistema
• forgot-password: Registros de los usuarios "¿Olvidó su contraseña?" clics desde la página de inicio de sesión
• logout: Registra los cierres de sesión de los usuarios del sistema
• failed-login: Registra los intentos fallidos de inicio de sesión de los usuarios
• user-reactivated: Registra la reactivación de los usuarios por parte de los administradores
• user-deactivated: Registra la desactivación de usuarios por parte de los administradores
• user-details-deleted: Registra la eliminación de usuarios por parte de los administradores
• user-invite: Registra la invitación de los usuarios desde dentro del sistema
• cancel-user-invite: Registra la invitación de los usuarios cancelados desde dentro del sistema
• user-role-change: Registra el cambio de tipo de usuario por parte de los administradores
• delete-board: Eliminación del tablero de registros por parte de los usuarios
• delete-workspace: Registra la eliminación del espacio de trabajo por parte de los usuarios
• create-team: Registros de creación de equipos por parte de los usuarios.
• delete-team: Eliminación de registros del equipo por parte de los usuarios
• security-settings-change: Registra los cambios de configuración de seguridad por parte de los administradores
• board-broadcast-enabled: Habilitación de transmisión del tablero de registros por parte de los usuarios
• add-user-to-team: Registra la adición de usuarios a los equipos por parte de los usuarios
• remove-user-from-team: Registra la eliminación de los usuarios de los equipos por parte de los usuarios
• add-user-to-product: Registra la adición de los usuarios a los productos Work OS
• remove-user-from-product: Registra la eliminación de los usuarios de los productos Work OS
• add-team-to-product: Registra la adición de equipos a los productos Work OS
• remove-team-from-product: Registra la eliminación de los equipos de los productos Work OS
• api-complexity-breach-over-time: Registra las llamadas a la API que alcanzan el límite de la cuenta

SELECCIONAR

Las siguientes consultas se ejecutan en el lado del servidor:

SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z'
SELECT * FROM AuditLogs WHERE Event IN ('export-board-activity-log', 'delete-board')
SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z' AND Event = 'delete-board' AND UserId = 27 AND IpAddress = '123.123'

Columnas¶

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 el lunes:

• 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 de la tabla Facturas:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Invoices' 

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 SampleProcedure:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' 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 Facturas:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Invoices'

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:monday: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¶

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

OAuth

SSL

Esquema

Misceláneas

Autenticación¶

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

Esquema¶

Especifica qué API de lunes usar.

Valores Posibles¶

GraphQL, AuditLog

Tipo de Datos¶

string

Valor por Defecto¶

"GraphQL"

Observaciones¶

Los valores disponibles son GraphQL y AuditLog.

AuthScheme¶

El tipo de autenticación que se usará cuando se conecte a Monday.

Valores Posibles¶

Token, OAuth

Tipo de Datos¶

string

Valor por Defecto¶

"Token"

Observaciones¶

• Token: configure esto para realizar la autenticación de token de lunes.
• OAuth: configure esto para realizar la autenticación OAuth del lunes.

APIToken¶

El token API obtenido de su cuenta Monday.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Pestaña de administración

Si eres un usuario administrador en tu cuenta de monday.com, puedes acceder a tus tokens API desde la pestaña "Administrador" con los siguientes pasos:

1. Inicia sesión en tu cuenta de monday.com.
2. Haga clic en su avatar (icono de imagen) en la esquina inferior izquierda de su pantalla.
3. Seleccione Admin en el menú resultante (esto requiere que tenga permisos de administrador).
4. Vaya a la sección API.
5. Genere un "Token API v2"
6. Copie su ficha.

Pestaña Desarrollador

Si eres un usuario miembro de tu cuenta de monday.com, puedes acceder a tus tokens de API desde la pestaña Desarrollador con los siguientes pasos:

1. Inicia sesión en tu cuenta de monday.com.
2. Haga clic en su avatar (icono de imagen) en la esquina inferior izquierda de su pantalla.
3. Seleccione Desarrollador en el menú resultante.
4. En el menú superior, haga clic en el menú desplegable "Desarrollador".
5. Seleccione la primera opción en el menú desplegable titulado "Mis tokens de acceso".
6. Haga clic en el botón azul "Mostrar" para exponer su token API y copiarlo.

Dominio¶

Especifique el dominio de su cuenta Monday. Requerido solo cuando se usa el esquema AuditLog. Ejemplo: https://yourdomain.monday.com.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Especifique el dominio de su cuenta Monday. Requerido solo cuando se usa el esquema AuditLog. Ejemplo: https://yourdomain.monday.com

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.

SSL¶

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

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

MaxPointsPerCall¶

Especifica cuántos puntos costará una llamada.

Tipo de Datos¶

string

Valor por Defecto¶

"1000000"

Observaciones¶

El costo total de sus consultas no puede exceder los 5,000,000 puntos en un momento dado.

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¶

Pseudocolumnas¶

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

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.

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 Invoices 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"