테이블 조회

POST /table/query

테이블 조회

cURL

curl --request POST \
  --url https://api.example.com/table/query \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "digest": "<string>",
  "filter": {
    "row_digests": [
      "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims",
      "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"
    ]
  },
  "limit": 100,
  "offset": 10,
  "sort_by": [
    {
      "field": "col_a.prop_b",
      "order": "desc"
    }
  ]
}
'

200

{
  "rows": [
    {
      "digest": "<string>",
      "val": "<unknown>",
      "original_index": 123
    }
  ]
}

인증

Authorization · string · header · 필수

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

본문

application/json

project_id · string · 필수

프로젝트 ID

예시:

"my_entity/my_project"

digest · string · 필수

쿼리할 테이블의 다이제스트

예시:

"aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"

filter · TableRowFilter · object

쿼리에 적용할 선택적 필터입니다. 자세한 내용은 TableRowFilter를 참조하세요.

표시 하위 속성

예시:

{
  "row_digests": [
    "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims",
    "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"
  ]
}

limit · integer | null

반환할 최대 행 수

예시:

100

offset · integer | null

행을 반환하기 시작하기 전에 건너뛸 행의 개수

예시:

10

sort_by · SortBy · object[] | null

정렬에 사용할 필드 목록입니다. 필드는 점(.) 표기법으로 구분하여 사전 값에 접근할 수 있습니다. 정렬 기준을 지정하지 않으면 기본 테이블 순서(삽입 순서)가 사용됩니다.

표시 하위 속성

예시:

[
  { "field": "col_a.prop_b", "order": "desc" }
]

응답

200

application/json

성공 응답

rows · TableRowSchema · object[] · 필수

표시 하위 속성