콘텐츠로 이동

GraphQL 쿼리

GraphQL 쿼리는 프로젝트 API를 통해 데이터를 가져오는 데 사용됩니다.

Archie Core의 GraphQL 엔진은 프로젝트 테이블을 기반으로 GraphQL 스키마의 일부로 쿼리를 자동 생성합니다. 모든 프로젝트 테이블은 프로젝트 엔드포인트를 통해 쿼리할 수 있습니다.

테이블이 프로젝트에 추가될 때마다 해당 테이블에 대해 두 개의 GraphQL 쿼리 작업이 자동 생성됩니다. 다음과 같습니다:

  • tableNameById(…) - id 및 고유 값을 인수로 받아 데이터베이스에서 단일 레코드를 검색합니다.
  • tableNames(…) - filter, sort, skip, after, before, first, groupBy, last를 받아 페이지네이션, 관계형 필터링, 정렬 등을 지원하면서 큐레이션된 레코드 목록을 검색합니다.

alt text

Archie Core는 목록에 대해 지정될 때 다음 쿼리 인수에 응답합니다.

  • filter: 필드 값을 기반으로 레코드를 필터링합니다.
  • orderBy: [더 이상 사용되지 않음 - sort 사용]
  • sort: 정렬 순서 구성입니다. 단일 또는 다중 필드 정렬일 수 있습니다.
  • first: 쿼리를 처음 N개 레코드로 제한합니다. 기본값 및 최대값은 5000입니다.
  • last: 결과에서 마지막 N개 레코드를 반환합니다.
  • groupBy: 반환된 레코드를 특정 필드의 값으로 그룹화합니다. 이는 일반적으로 범주를 기반으로 데이터를 분석하기 위해 집계 함수(count 또는 sum 등)와 함께 사용됩니다.
  • after: 지정된 ID 이후의 레코드를 반환합니다. 커서 기반 페이지네이션에 사용됩니다.
  • before: 지정된 ID 이전의 레코드를 반환합니다. 커서 기반 페이지네이션에 사용됩니다.
  • skip: 결과에서 N개 레코드를 건너뜁니다.