온톨로지 속성의 자료형

속성 정의의 dataType은 type으로 22가지 분기를 구분합니다. 이는 속성의 메타데이터이며 실제 값의 JSON 인코딩은 속성 자료형별 JSON 표현을 따릅니다.

복합 속성과 배열

구조체는 각 필드의 API 이름, RID와 자료형 및 타입 클래스 정보를 가집니다. 선택적인 mainValue는 주값의 자료형과 이를 구성하는 필드 목록을 지정합니다.

배열의 subType은 필수입니다. reducers가 있으면 지정한 순서대로 리듀서를 적용해 하위 유형 값 하나를 선택할 수 있습니다. 객체 집합에서는 축약된 값 또는 전체 배열을 로드할 수 있습니다. 정렬 방향의 두 값은 모두 null을 마지막에 두며, 선택적인 field는 구조체 필드 이름입니다.

시계열과 벡터

시계열 항목은 string, double 또는 숫자와 비숫자를 함께 다루는 numericOrNonNumeric 형식입니다. 마지막 형식의 isNonNumericPropertyTypeId는 boolean 속성 유형을 가리키며 값이 true이면 비숫자형입니다. 참조가 없으면 조회 결과로 유형을 판별합니다.

벡터는 고정 차원의 실수 배열입니다. 유사도 함수마다 해당 검색 인덱스를 구성하며 supportsSearchWith의 항목은 선택적인 value를 가진 객체입니다. 임베딩 모델은 LMS의 명명된 모델 또는 Foundry 온라인 배포를 가리킵니다.

자료형 분기

온톨로지 객체 속성의 자료형입니다.

분기 `date`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `date`.	`date`

분기 `struct`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `struct`.	`struct`
`structFieldTypes`	`list<StructFieldType>`	선택
`mainValue`	`object`	선택

`structFieldTypes`의 구조

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

이름	자료형	필수 여부	의미와 조건
`apiName`	`string`	필수	온톨로지 구조체 필드의 API 이름입니다.
`rid`	`string`	필수	구조체 필드의 고유 RID입니다.
`dataType`	`union`	필수	온톨로지 객체 속성의 자료형입니다.
`typeClasses`	`list<TypeClass>`	선택

`dataType`의 구조

같은 속성 자료형 분기를 재귀적으로 사용합니다.

`typeClasses`의 구조

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

온톨로지를 사용하는 애플리케이션이 해석할 수 있는 추가 메타데이터입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`kind`	`string`	필수	타입 클래스의 네임스페이스입니다.
`name`	`string`	필수	타입 클래스의 값입니다.

`mainValue`의 구조

이름	자료형	필수 여부	의미와 조건	예시 값
`mainValueType`	`union`	필수	온톨로지 객체 속성의 자료형입니다.
`fields`	`list<StructFieldApiName>`	선택	구조체의 주값을 구성하는 필드 목록입니다.

`mainValueType`의 구조

같은 속성 자료형 분기를 재귀적으로 사용합니다.

`fields`의 구조

배열 항목은 StructFieldApiName이며 자료형은 string입니다.

온톨로지 구조체 필드의 API 이름입니다.

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `string`.	`string`

분기 `byte`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `byte`.	`byte`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `double`.	`double`

분기 `geopoint`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `geopoint`.	`geopoint`

분기 `geotimeSeriesReference`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `geotimeSeriesReference`.	`geotimeSeriesReference`

분기 `integer`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `integer`.	`integer`

분기 `float`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `float`.	`float`

분기 `geoshape`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `geoshape`.	`geoshape`

분기 `long`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `long`.	`long`

분기 `boolean`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `boolean`.	`boolean`

분기 `cipherText`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `cipherText`.	`cipherText`
`defaultCipherChannel`	`string`	선택	빈 값에 암호화된 값을 갱신할 때 사용할 수 있는 선택적인 Cipher Channel RID입니다.	`ri.bellaso.main.cipher-channel.00000000-0000-0000-0000-000000000000`

분기 `marking`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `marking`.	`marking`
`markingType`	`enum`	선택	보안 표지의 종류입니다. CBAC는 보안 분류 기반 접근 제어 표지이며 MANDATORY는 조직 같은 일반적인 비분류 표지입니다. 허용값: `CBAC`, `MANDATORY`.

분기 `attachment`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `attachment`.	`attachment`

분기 `mediaReference`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `mediaReference`.	`mediaReference`

분기 `timeseries`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `timeseries`.	`timeseries`
`itemType`	`union<string, double, numericOrNonNumeric>`	필수	시계열 속성에 담을 값의 자료형입니다.

`itemType`의 구조

분기 `string`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `string`.	`string`

분기 `double`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `double`.	`double`

분기 `numericOrNonNumeric`

숫자 또는 비숫자 데이터를 담을 수 있는 시계열입니다. 일부 센서는 수치형이고 일부는 범주형인 경우를 지원합니다. boolean 속성 참조로 종류를 판별할 수 있으며 참조가 없으면 시계열 조회 결과에서 판별해야 합니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `numericOrNonNumeric`.	`numericOrNonNumeric`
`isNonNumericPropertyTypeId`	`string`	선택	시계열이 비숫자형인지 나타내는 boolean 속성 유형 ID입니다. 값이 true이면 비숫자형입니다.

분기 `array`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `array`.	`array`
`subType`	`union`	필수	온톨로지 객체 속성의 자료형입니다.
`reducers`	`list<OntologyObjectArrayTypeReducer>`	선택	목록이 비어 있지 않으면 배열을 하위 유형의 값 하나로 축약할 수 있습니다. 리듀서를 나열한 순서대로 적용하여 값을 선택하며 객체 집합에서 축약값 또는 전체 배열로 로드할 수 있습니다.

`subType`의 구조

같은 속성 자료형 분기를 재귀적으로 사용합니다.

`reducers`의 구조

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

이름	자료형	필수 여부	의미와 조건	예시 값
`direction`	`enum`	필수	허용값: `ASCENDING_NULLS_LAST`, `DESCENDING_NULLS_LAST`.
`field`	`string`	선택	온톨로지 구조체 필드의 API 이름입니다.

분기 `short`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `short`.	`short`

분기 `vector`

고정된 차원 수를 갖는 실수 벡터이며 벡터 유사도 검색에 사용할 수 있습니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `vector`.	`vector`
`dimension`	`integer`	필수	벡터 차원 수입니다.
`supportsSearchWith`	`list<VectorSimilarityFunction>`	선택
`embeddingModel`	`union<lms, foundryLiveDeployment>`	선택

`supportsSearchWith`의 구조

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

근사 최근접 이웃 검색에 사용할 유사도 함수입니다. 함수마다 해당 인덱스를 만듭니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`value`	`enum`	선택	허용값: `COSINE_SIMILARITY`, `DOT_PRODUCT`, `EUCLIDEAN_DISTANCE`.

`embeddingModel`의 구조

분기 `lms`

Language Model Service가 제공하는 모델입니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `lms`.	`lms`
`value`	`enum`	필수	허용값: `OPENAI_TEXT_EMBEDDING_ADA_002`, `TEXT_EMBEDDING_3_LARGE`, `TEXT_EMBEDDING_3_SMALL`, `SNOWFLAKE_ARCTIC_EMBED_M`, `INSTRUCTOR_LARGE`, `BGE_BASE_EN_V1_5`.

분기 `foundryLiveDeployment`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `foundryLiveDeployment`.	`foundryLiveDeployment`
`rid`	`string`	선택	온라인 모델 배포 RID입니다. 형식은 `ri.foundry-ml-live.main.live-deployment.<uuid>`입니다.
`inputParamName`	`string`	선택	질의 문자열을 전달할 모델 입력 매개변수 이름입니다.
`outputParamName`	`string`	선택	계산된 임베딩을 반환할 모델 출력 매개변수 이름입니다.

분기 `decimal`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `decimal`.	`decimal`
`precision`	`integer`	선택	Decimal의 전체 자릿수이며 최대값은 38입니다.	`38`
`scale`	`integer`	선택	소수점 오른쪽 자릿수이며 최대값은 38입니다.	`18`

분기 `timestamp`

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	허용값: `timestamp`.	`timestamp`

Keyboard shortcuts

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