Ir al contenido

Consultas GraphQL

Las consultas GraphQL se utilizan para obtener datos a través de la API del proyecto.

El motor GraphQL de Archie Core genera automáticamente consultas como parte del esquema GraphQL basadas en las tablas de su proyecto. Todas las tablas del proyecto se pueden consultar a través del punto final del proyecto.

Cada vez que se agrega una tabla a un proyecto, se generan automáticamente dos operaciones de consulta GraphQL para la tabla. Ellas son:

  • tableNameById(…) - Acepta id y cualquier valor único como argumento para recuperar un solo registro de la base de datos.
  • tableNames(…) - Acepta filter, sort, skip, after, before, first, groupBy y last para recuperar una lista de registros seleccionados, admitiendo paginación, filtrado relacional, ordenación y más.

alt text

Archie Core responde a los siguientes argumentos de consulta cuando se especifican para listas.

  • filter: Filtra registros según valores de campo.
  • orderBy: [OBSOLETO - Use sort]
  • sort: Configuración del orden de clasificación. Puede ser una clasificación de campo único o múltiple.
  • first: Limita la consulta a los primeros N registros. El valor predeterminado y máximo es 5000.
  • last: Devuelve los N últimos registros del resultado.
  • groupBy: Agrupa los registros devueltos por los valores de un campo específico. Esto se usa típicamente junto con funciones de agregación (como count o sum) para analizar datos basados en categorías.
  • after: Devuelve registros después del ID especificado. Se utiliza para la paginación basada en cursor.
  • before: Devuelve registros antes del ID especificado. Se utiliza para la paginación basada en cursor.
  • skip: Omite N registros del resultado.