Consultas GraphQL

Consultas GraphQL são usadas para buscar dados através da API do projeto.

O mecanismo GraphQL do Archie Core gera automaticamente consultas como parte do esquema GraphQL com base nas tabelas do seu projeto. Todas as tabelas do projeto podem ser consultadas através do ponto de extremidade do projeto.

Consultas geradas automaticamente

Sempre que uma tabela é adicionada a um projeto, duas operações de consulta GraphQL são geradas automaticamente para a tabela. Elas são:

• tableNameById(…) - Aceita id e qualquer valor único como argumento para recuperar um único registro do banco de dados.
• tableNames(…) - Aceita filter, sort, skip, after, before, first, groupBy e last para recuperar uma lista de registros curados, suportando paginação, filtragem relacional, classificação e muito mais.

Argumentos de Lista

Archie Core responde aos seguintes argumentos de consulta quando especificados para listas.

• filter: Filtra registros com base nos valores dos campos.
• orderBy: [OBSOLETO - Use sort]
• sort: Configuração da ordem de classificação. Pode ser classificação de campo único ou múltiplo.
• first: Limita a consulta aos primeiros N registros. O valor padrão e máximo é 5000.
• last: Retorna os N últimos registros do resultado.
• groupBy: Agrupa os registros retornados pelos valores de um campo específico. Isso é tipicamente usado em conjunto com funções de agregação (como count ou sum) para analisar dados com base em categorias.
• after: Retorna registros após o ID especificado. Usado para paginação baseada em cursor.
• before: Retorna registros antes do ID especificado. Usado para paginação baseada em cursor.
• skip: Pula N registros do resultado.