Ontology SQL 함수

Ontology SQL 함수는 객체를 조회하는 SQL을 매개변수 있는 함수로 게시하는 기능입니다. Workshop, Actions, Automate와 OSDK 등 온톨로지 함수를 사용하는 경로에서 호출할 수 있습니다. 함수 자체는 읽기 전용이며 온톨로지를 수정하지 않습니다.

베타 기능으로 환경에 제공되지 않거나 개발 중 동작이 바뀔 수 있습니다. 접근이 필요하면 Palantir Support에 요청합니다. 높은 동시성 부하는 아직 지원하지 않으며 자원이 부족하면 대기하거나 실패할 수 있습니다. Ontology SQL의 시간 및 결과 한도도 적용됩니다.

정의

SQL Studio의 Object mode에서 작성합니다. DECLARE 변수는 함수 매개변수가 됩니다. 다음 예시의 animalParam은 호출자가 전달하며 'dog'는 편집기에서 시험할 기본값입니다. 객체 유형 RID는 실제 환경의 값으로 바꿉니다.

DECLARE @animalParam STRING = 'dog';

SELECT *
FROM `ri.ontology.main.object-type...`
WHERE animaltype = @animalParam;

리터럴 매개변수는 지원 자료형의 문자열, 숫자나 불리언 같은 값만 받습니다. SQL 조각이나 식을 담을 수 없으며 WHERE 비교의 오른쪽처럼 문법이 리터럴을 허용하는 위치에서 사용합니다. ObjectSet 매개변수는 FROM 절에만 둡니다.

게시

워크시트를 프로젝트에 저장한 뒤 Publish를 선택합니다. 개인 워크시트는 게시할 수 없습니다.

Publish function 대화상자에서 함수 Name과 API name을 지정합니다.

반환값과 호출

여러 열을 선택하면 행마다 선택 열을 필드로 가진 구조체 목록을 반환합니다. 예를 들어 animal, animalType, age는 List<Struct<animal: STRING, animalType: STRING, age: INTEGER>>입니다. 한 열만 선택하면 그 열 자료형의 목록을 반환하므로 animal 한 열은 List<STRING>이 됩니다.

게시 함수는 다른 온톨로지 함수처럼 앱에서 사용하고 TypeScript나 Python 함수에서도 호출할 수 있습니다. 브랜치와 시나리오 조회를 지원합니다. 모델이 아니라 SQL의 입력과 결과 자료형을 정의한 함수라는 점을 구분하여 호출 매핑을 구성합니다.