함수 입력과 출력의 JSON 값
DataValue는 실행 요청의 parameters 값과 실행 응답의 value에 사용합니다. 값은 중첩될 수 있으므로 구조체 배열도 표현할 수 있습니다. 각 매개변수에 허용되는 형식은 실제 Query의 dataType과 필수 여부를 확인합니다.
| 값 유형 | JSON 표현 | 예시 |
|---|---|---|
| Array | 배열 | ["alpha", "bravo", "charlie"] |
| Attachment | 첨부 파일 RID 문자열 | "ri.attachments.main.attachment.2f944bae-5851-4204-8615-920c969a9f2e" |
| Boolean | 불리언 | true |
| Byte | 수 | 31 |
| Date | ISO 8601 확장 로컬 날짜 문자열 | "2021-05-01" |
| Decimal | 문자열 | "2.718281828" |
| Float | 수 | 3.14159265 |
| Double | 수 | 3.14159265 |
| Integer | 수 | 238940 |
| Long | 문자열 | "58319870951433" |
| Marking | 문자열 | "MU" |
| Null | JSON null | null |
| Set | 배열 | ["alpha", "bravo", "charlie"] |
| Short | 수 | 8739 |
| String | 문자열 | "Call me Ishmael" |
| Struct | JSON 객체 | {"name":"John Doe","age":42} |
| TwoDimensionalAggregation | JSON 객체 | {"groups":[{"key":"alpha","value":100},{"key":"beta","value":101}]} |
| ThreeDimensionalAggregation | JSON 객체 | {"groups":[{"key":"NYC","groups":[{"key":"Engineer","value":100}]}]} |
| Timestamp | UTC의 ISO 8601 확장 오프셋 날짜 및 시각 문자열 | "2021-01-04T05:00:00Z" |
Long과 Decimal을 일반 부동소수점 수로 바꾸어 정밀도를 잃지 않도록 문자열 표현을 유지합니다. 이 표는 값의 인코딩 규칙이며 모든 함수가 여기에 있는 모든 유형을 입력으로 허용한다는 뜻은 아닙니다. QueryDataType에 선언된 실제 자료형을 함께 사용합니다.
일반 실행의 응답은 {"value": ...} 객체입니다. SSE 실행에서는 이벤트의 JSON 메시지가 {"type":"data","value": ...} 형태이며, value가 항상 배열이라고 가정하지 않습니다. 비스트리밍 함수는 전체 결과를 담은 이벤트 하나를, 스트리밍 함수는 결과 배치마다 이벤트를 반환합니다.