Functions 쿼리 자료형

QueryDataType은 쿼리 매개변수와 출력의 형식입니다. type 구분자로 22가지 분기를 표현합니다. Query 메타데이터의 parameters와 output, typeReferences에서 사용합니다.

자료형을 설명하는 객체와 실제로 전달하는 DataValue를 구분합니다. 예를 들어 {"type":"integer"}는 자료형 정의이고 42는 그 자료형의 값입니다. unsupported는 미지원 유형의 정보를 담는 분기이므로 다른 지원 타입으로 임의 치환하지 않습니다.

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `struct`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `struct`.	`struct`
`fields`	`list<QueryStructField>`	선택

`fields`의 구조

배열 항목은 QueryStructField이며 자료형은 object입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`name`	`string`	필수	구조체 필드의 이름입니다.	`productId`
`fieldType`	`QueryDataType`	필수	쿼리 매개변수와 출력의 자료형을 구분합니다.

`fieldType`의 구조

같은 QueryDataType 정의를 중첩하여 사용합니다.

분기 `set`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `set`.	`set`
`subType`	`QueryDataType`	필수	쿼리 매개변수와 출력의 자료형을 구분합니다.

`subType`의 구조

같은 QueryDataType 정의를 중첩하여 사용합니다.

분기 `void`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `void`.	`void`

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `string`.	`string`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `threeDimensionalAggregation`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `threeDimensionalAggregation`.	`threeDimensionalAggregation`
`keyType`	`union<date, boolean, string, double, range, integer, timestamp>`	필수	쿼리 집계 키의 자료형을 구분합니다.
`valueType`	`object`	필수

`keyType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `boolean`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `boolean`.	`boolean`

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `string`.	`string`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `range`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `range`.	`range`
`subType`	`union<date, double, integer, timestamp>`	필수	쿼리 집계 범위의 하위 자료형을 구분합니다.

`subType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

`valueType`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`keyType`	`union<date, boolean, string, double, range, integer, timestamp>`	필수	쿼리 집계 키의 자료형을 구분합니다.
`valueType`	`union<date, double, timestamp>`	필수	쿼리 집계값의 자료형을 구분합니다.

`keyType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `boolean`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `boolean`.	`boolean`

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `string`.	`string`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `range`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `range`.	`range`
`subType`	`union<date, double, integer, timestamp>`	필수	쿼리 집계 범위의 하위 자료형을 구분합니다.

`subType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

`valueType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

분기 `union`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `union`.	`union`
`unionTypes`	`list<QueryDataType>`	선택

`unionTypes`의 구조

배열의 각 항목에 QueryDataType 객체를 넣습니다.

분기 `float`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `float`.	`float`

분기 `geoshape`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `geoshape`.	`geoshape`

분기 `long`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `long`.	`long`

분기 `boolean`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `boolean`.	`boolean`

분기 `unsupported`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `unsupported`.	`unsupported`
`unsupportedType`	`string`	필수
`params`	`map<UnsupportedTypeParamKey, UnsupportedTypeParamValue>`	선택

`params`의 구조

맵의 키는 UnsupportedTypeParamKey(string), 값은 UnsupportedTypeParamValue(string)입니다.

분기 `attachment`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `attachment`.	`attachment`

분기 `mediaReference`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `mediaReference`.	`mediaReference`

분기 `null`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `null`.	`null`

분기 `array`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `array`.	`array`
`subType`	`QueryDataType`	필수	쿼리 매개변수와 출력의 자료형을 구분합니다.

`subType`의 구조

같은 QueryDataType 정의를 중첩하여 사용합니다.

분기 `twoDimensionalAggregation`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `twoDimensionalAggregation`.	`twoDimensionalAggregation`
`keyType`	`union<date, boolean, string, double, range, integer, timestamp>`	필수	쿼리 집계 키의 자료형을 구분합니다.
`valueType`	`union<date, double, timestamp>`	필수	쿼리 집계값의 자료형을 구분합니다.

`keyType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `boolean`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `boolean`.	`boolean`

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `string`.	`string`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `range`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `range`.	`range`
`subType`	`union<date, double, integer, timestamp>`	필수	쿼리 집계 범위의 하위 자료형을 구분합니다.

`subType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `integer`.	`integer`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

`valueType`의 구조

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `date`.	`date`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `double`.	`double`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

분기 `valueTypeReference`

온톨로지에 등록한 값 유형의 참조입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `valueTypeReference`.	`valueTypeReference`
`rid`	`string`	필수	온톨로지에 등록한 값 유형의 RID입니다.	`ri.type-registry.main.value-type.f5ee06ef-6dfd-4d91-a01e-91bd457c719d`
`versionId`	`string`	필수	온톨로지에 등록한 값 유형의 버전 ID입니다.	`00000000-0000-0000-0000-000000000001`

분기 `typeReference`

현재 Query의 typeReferences 맵에 정의한 유형의 참조입니다. 자기 자신을 참조하는 재귀 자료형도 표현할 수 있습니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `typeReference`.	`typeReference`
`typeId`	`string`	필수	현재 Query의 `typeReferences` 맵에서 자료형 정의를 찾을 식별자입니다.	`MyTypeReference`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `timestamp`.	`timestamp`

재귀 자료형과 값 유형 참조

typeReference.typeId는 현재 Query의 typeReferences 맵을 조회합니다. 자기 참조가 가능하므로 자료형을 화면이나 코드에서 펼칠 때 순환을 고려합니다. 이 참조의 이름을 전역 온톨로지 RID로 처리하지 않습니다.

valueTypeReference는 온톨로지에 등록된 값 유형의 rid와 versionId가 모두 필요합니다. 함수의 1.2.3 버전 문자열과 값 유형의 버전 ID를 구분합니다.

집계 자료형의 구분

집계 키는 date, boolean, string, double, integer, timestamp, range를 사용합니다. 범위의 하위 유형은 date, double, integer, timestamp입니다. 집계값 유형은 date, double, timestamp로 한정됩니다.

2차원 집계는 키와 집계값의 유형을 지정합니다. 3차원 집계는 바깥 키와 안쪽 2차원 집계의 키 및 값 유형을 함께 지정합니다. 일반 쿼리의 22가지 자료형을 집계 키나 집계값 위치에 모두 사용할 수 있는 것은 아닙니다.

Keyboard shortcuts

팔란티어 플랫폼 한국어 해설