Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

온톨로지 질의 API의 개념 (V2)

질의 유형은 온톨로지에서 실행할 읽기 전용 로직의 정의입니다. Query Functions로 생성하고 게시한 뒤 API로 입력과 출력의 형식을 조회하거나 질의를 실행합니다. 질의는 온톨로지를 수정하거나 외부 시스템을 변경하는 등의 부수 효과를 허용하지 않습니다.

정의에서 실행까지

  1. 질의 유형 목록에서 API 이름과 최신 버전을 확인합니다.
  2. 질의 유형 조회로 사용할 버전의 매개변수와 출력 형식을 읽습니다.
  3. 질의 실행에 입력을 전달하고 응답의 value를 출력 형식에 맞춰 해석합니다.

최신 버전은 가장 최근에 게시한 버전이므로 사전 릴리스일 수도 있습니다. 실행 버전을 제어할 때는 version 조건과 Foundry 브랜치를 함께 확인합니다.

질의 메타데이터는 입력의 필수 여부와 버전을, 질의 자료형은 중첩 구조와 재귀 형식 참조를 설명합니다. 객체를 반환하는 질의의 데이터 값에는 객체의 기본 키를 사용합니다.