コンテンツにスキップ

GraphQLクエリ

GraphQLクエリは、プロジェクトAPIを介してデータを取得するために使用されます。

Archie CoreのGraphQLエンジンは、プロジェクトテーブルに基づいてGraphQLスキーマの一部としてクエリを自動的に生成します。すべてのプロジェクトテーブルは、プロジェクトエンドポイントを介してクエリ可能です。

テーブルがプロジェクトに追加されるたびに、テーブルに対して2つのGraphQLクエリ操作が自動的に生成されます。それらは次のとおりです:

  • tableNameById(…) - データベースから単一のレコードを取得するために、引数としてidおよび任意のユニークな値を受け入れます。
  • tableNames(…) - ページネーション、リレーショナルフィルタリング、ソートなどをサポートしながら、キュレーションされたレコードのリストを取得するために、filtersortskipafterbeforefirstgroupBy、およびlastを受け入れます。

alt text

Archie Coreは、リストに対して指定された場合に次のクエリ引数に応答します。

  • filter: フィールド値に基づいてレコードをフィルタリングします。
  • orderBy: [非推奨 - sortを使用してください]
  • sort: ソート順の設定。単一または複数のフィールドのソートが可能です。
  • first: クエリを最初のNレコードに制限します。デフォルトおよび最大値は5000です。
  • last: 結果から最後のNレコードを返します。
  • groupBy: 特定のフィールドの値によって返されたレコードをグループ化します。これは通常、カテゴリに基づいてデータを分析するために集計関数(countやsumなど)と組み合わせて使用されます。
  • after: 指定されたIDの後のレコードを返します。カーソルベースのページネーションに使用されます。
  • before: 指定されたIDの前のレコードを返します。カーソルベースのページネーションに使用されます。
  • skip: 結果からNレコードをスキップします。