쿼리 언어에는 쿼리 언어에 기본 제공되고 다양한 일반적인 작업을 처리하도록 설계된 일련의 시스템 함수가 포함되어 있습니다.
Functions
다음은 쿼리 언어가 현재 지원하는 함수 목록입니다.
수학 함수
| Description | |
|---|---|
ABS |
이 함수는 ABS 지정된 숫자 식의 절대(양수) 값을 계산합니다. |
ACOS |
이 함수는 ACOS 지정된 숫자 값의 삼각 아크코사인을 계산합니다. 아크코사인은 라디안 단위의 각도이며, 코사인은 지정된 숫자 식입니다. |
ASIN |
이 함수는 ASIN 지정된 숫자 값의 삼각 아크사인을 계산합니다. 아크사인은 지정된 숫자 식인 사인의 각도(라디안)입니다. |
ATAN |
이 함수는 ATAN 지정된 숫자 값의 삼각 아크탄젠트를 계산합니다. 아크탄젠트는 라디안 단위의 각도이며 탄젠트는 지정된 숫자 식입니다. |
ATN2 |
이 함수는 ATN2 라디안으로 표현된 아크탄젠트의 y/x주체 값을 계산합니다. |
CEILING |
이 함수는 CEILING 지정된 숫자 식보다 크거나 같은 가장 작은 정수 값을 계산합니다. |
COS |
이 함수는 COS 지정된 각도의 삼각 코사인(라디안)을 계산합니다. |
COT |
이 함수는 COT 지정된 각도의 삼각 코탄젠트(라디안)를 계산합니다. |
DEGREES |
이 함수는 DEGREES 라디안으로 지정된 각도에 해당하는 각도를 도 단위로 계산합니다. |
EXP |
함수는 EXP 지정된 숫자 식의 지수 값을 계산합니다. |
FLOOR |
이 함수는 FLOOR 지정된 숫자 식보다 작거나 같은 가장 큰 정수를 계산합니다. |
INTADD |
이 함수는 INTADD 두 정수 값의 합계를 반환합니다. |
INTBITAND |
함수는 INTBITAND 포함 AND 연산자를 사용하여 각 피연산자의 비트 비교를 반환합니다. |
INTBITLEFTSHIFT |
이 함수는 INTBITLEFTSHIFT 정수 값에 대한 비트 왼쪽 시프트 작업의 결과를 반환합니다. |
INTBITNOT |
이 함수는 INTBITNOT 정수 값에 대한 비트 NOT 연산의 결과를 반환합니다. |
INTBITOR |
이 함수는 INTBITOR 두 정수 값에 대해 비트 포괄 OR 연산의 결과를 반환합니다. |
INTBITRIGHTSHIFT |
이 함수는 INTBITRIGHTSHIFT 정수 값에 대한 비트 오른쪽 시프트 작업의 결과를 반환합니다. |
INTBITXOR |
이 함수는 INTBITXOR 두 정수 값에 대한 비트 배타적 OR 연산의 결과를 반환합니다. |
INTDIV |
이 함수는 INTDIV 첫 번째 정수 값을 두 번째로 나눈 결과를 반환합니다. |
INTMOD |
함수는 INTMOD 첫 번째 정수 값을 두 번째로 나누는 나머지를 반환합니다. |
INTMUL |
이 함수는 INTMUL 두 정수 값의 곱을 반환합니다. |
INTSUB |
함수는 INTSUB 첫 번째 정수 값에서 두 번째 정수 값을 빼는 결과를 반환합니다. |
LOG |
이 함수는 LOG 지정된 숫자 식의 자연 로그를 반환합니다. |
LOG10 |
이 함수는 LOG10 지정된 숫자 식의 base-10 로그를 반환합니다. |
NUMBERBIN |
함수는 NUMBERBIN 지정된 크기의 배수로 반올림된 입력 값을 계산합니다. |
PI |
함수는 PI Pi의 상수 값을 반환합니다. |
POWER |
이 함수는 POWER 지정된 횟수만큼 배수된 지정된 식의 값을 반환합니다. |
RADIANS |
이 함수는 RADIANS 각도로 지정된 각도에 대해 라디안 단위로 해당 각도를 반환합니다. |
RAND |
이 함수는 RAND 임의로 생성된 숫자 값을 0에서 1로 반환합니다. |
ROUND |
함수는 ROUND 가장 가까운 정수 값으로 반올림된 숫자 값을 반환합니다. |
SIGN |
이 함수는 SIGN 지정된 숫자 식의 양수(+1), 0(0) 또는 음수(-1) 기호를 반환합니다. |
SIN |
이 함수는 SIN 지정된 각도의 삼각 사인을 라디안으로 반환합니다. |
SQRT |
이 함수는 SQRT 지정된 숫자 값의 제곱근을 반환합니다. |
SQUARE |
이 함수는 SQUARE 지정된 숫자 값의 제곱을 반환합니다. |
TAN |
이 함수는 TAN 지정된 각도의 삼각 탄젠트를 라디안으로 반환합니다. |
TRUNC |
함수는 TRUNC 가장 가까운 정수 값으로 잘린 숫자 값을 반환합니다. |
배열 함수
| Description | |
|---|---|
ARRAY_CONCAT |
함수는 ARRAY_CONCAT 둘 이상의 배열 값을 연결한 결과인 배열을 반환합니다. |
ARRAY_CONTAINS_ALL |
이 함수는 ARRAY_CONTAINS_ALL 배열에 지정된 값이 모두 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
ARRAY_CONTAINS_ANY |
이 함수는 ARRAY_CONTAINS_ANY 배열에 지정된 값이 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
ARRAY_CONTAINS |
이 함수는 ARRAY_CONTAINS 배열에 지정된 값이 포함되어 있는지 여부를 나타내는 부울을 반환합니다. 함수 내에서 부울 식을 사용하여 개체의 부분 또는 전체 일치를 확인할 수 있습니다. |
ARRAY_LENGTH |
이 함수는 ARRAY_LENGTH 지정된 배열 식의 요소 수를 반환합니다. |
ARRAY_SLICE |
이 함수는 ARRAY_SLICE 지정된 인덱스 및 길이를 사용하여 배열 식의 하위 집합을 반환합니다. |
CHOOSE |
이 함수는 CHOOSE 목록의 지정된 인덱스에 있는 식을 반환하거나 인덱스가 목록의 범위를 초과하는 경우 Undefined를 반환합니다. |
OBJECTTOARRAY |
이 함수는 OBJECTTOARRAY JSON 개체의 필드/값 쌍을 JSON 배열로 변환합니다. |
SETINTERSECT |
이 함수는 SETINTERSECT 중복되지 않은 두 입력 배열에 포함된 식 집합을 반환합니다. |
SETUNION |
이 함수는 SETUNION 중복 항목 없이 수집된 두 집합의 모든 식을 포함하는 식 집합을 반환합니다. |
집계 함수
| Description | |
|---|---|
AVG |
함수는 AVG 식에 있는 값의 평균을 계산합니다. |
COUNT |
함수는 COUNT 식의 값 수를 반환합니다. |
MAX |
이 함수는 MAX 지정된 식의 최대값을 반환합니다. |
MIN |
함수는 MIN 지정된 식의 최소값을 반환합니다. |
SUM |
함수는 SUM 식에 있는 값의 합계를 계산합니다. |
문자열 함수
| Description | |
|---|---|
CONCAT |
이 함수는 CONCAT 문서에서 여러 필드를 연결한 결과인 문자열을 반환합니다. |
CONTAINS |
함수는 CONTAINS 첫 번째 문자열 식에 두 번째 문자열 식이 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
ENDSWITH |
이 함수는 ENDSWITH 문자열이 지정된 접미사로 끝나는지 여부를 나타내는 부울을 반환합니다. 필요에 따라 비교는 대/소문자를 구분하지 않을 수 있습니다. |
INDEX-OF |
이 함수는 INDEX_OF 문자열이 처음 나타나는 인덱스입니다. |
LEFT |
이 함수는 LEFT 문자열의 왼쪽 부분을 지정된 문자 수까지 반환합니다. |
LENGTH |
이 함수는 LENGTH 지정된 문자열 식의 문자 수를 반환합니다. |
LOWER |
이 함수는 LOWER 대문자 데이터를 소문자로 변환한 후 문자열 식을 반환합니다. |
LTRIM |
이 함수는 LTRIM 선행 공백 또는 지정된 문자를 제거한 후 문자열 식을 반환합니다. |
REGEXMATCH |
이 함수는 REGEXMATCH 제공된 문자열이 지정된 정규식과 일치하는지 여부를 나타내는 부울을 반환합니다. 정규식은 텍스트 패턴을 찾기 위한 간결하고 유연한 표기법입니다. |
REPLACE |
이 함수는 REPLACE 지정된 문자열이 모두 대체된 문자열을 반환합니다. |
REPLICATE |
함수는 REPLICATE 특정 횟수만큼 반복되는 문자열 값을 반환합니다. |
REVERSE |
이 함수는 REVERSE 문자열 값의 역순을 반환합니다. |
RIGHT |
이 함수는 RIGHT 문자열의 오른쪽 부분을 지정된 문자 수까지 반환합니다. |
RTRIM |
이 함수는 RTRIM 후행 공백 또는 지정된 문자를 제거한 후 문자열 식을 반환합니다. |
STARTSWITH |
이 함수는 STARTSWITH 첫 번째 문자열 식이 두 번째 문자열 식으로 시작하는지 여부를 나타내는 부울 값을 반환합니다. |
STRINGEQUALS |
함수는 STRINGEQUALS 첫 번째 문자열 식이 두 번째 문자열 식과 일치하는지 여부를 나타내는 부울을 반환합니다. |
STRINGJOIN |
이 함수는 STRINGJOIN 각 요소 사이에 지정된 구분 기호를 사용하여 지정된 배열의 요소를 연결하는 문자열을 반환합니다. |
STRINGSPLIT |
이 함수는 STRINGSPLIT 원본 문자열을 지정된 구분 기호로 구분하여 가져온 부분 문자열 배열을 반환합니다. |
STRINGTOARRAY |
이 함수는 STRINGTOARRAY 문자열 식을 배열로 변환합니다. |
STRINGTOBOOLEAN |
이 함수는 STRINGTOBOOLEAN 문자열 식을 부울로 변환합니다. |
SUBSTRING |
이 함수는 SUBSTRING 지정된 위치와 지정된 길이 또는 문자열의 끝에서 시작하는 문자열 식의 일부를 반환합니다. |
TOSTRING |
함수는 TOSTRING 값의 문자열 표현을 반환합니다. |
TRIM |
이 함수는 TRIM 선행 및 후행 공백 또는 사용자 지정 문자를 제거한 후 문자열 식을 반환합니다. |
UPPER |
이 함수는 UPPER 소문자 데이터를 대문자로 변환한 후 문자열 식을 반환합니다. |
날짜 및 시간 함수
| Description | |
|---|---|
DATETIMEADD |
이 함수는 DATETIMEADD 지정된 숫자 값을 제공된 날짜 및 시간 문자열에 추가한 결과인 날짜 및 시간 문자열 값을 반환합니다. |
DATETIMEBIN |
이 함수는 DATETIMEBIN 제공된 날짜 및 시간 문자열의 일부를 범주화(또는 반올림)한 결과인 날짜 및 시간 문자열 값을 반환합니다. |
DATETIMEDIFF |
이 함수는 DATETIMEDIFF 두 날짜 및 시간 값 사이의 지정된 날짜 및 시간 부분의 차이를 부인 정수로 반환합니다. |
DATETIMEFROMPARTS |
이 함수는 DATETIMEFROMPARTS 다양한 날짜 및 시간 부분에 대한 입력 숫자 값으로 생성된 날짜 및 시간 문자열 값을 반환합니다. |
DATETIMEPART |
이 함수는 DATETIMEPART 제공된 날짜 및 시간에 대해 지정된 날짜 및 시간 부분의 값을 반환합니다. |
DATETIMETOTICKS |
이 함수는 DATETIMETOTICKS 지정된 DateTime을 틱으로 변환합니다. 단일 틱은 100나노초 또는 초당 0.00000001을 나타냅니다. |
DATETIMETOTIMESTAMP |
이 함수는 DATETIMETOTIMESTAMP 지정된 날짜와 시간을 숫자 타임스탬프로 변환합니다. 타임스탬프는 Unix epoch 이후 밀리초를 측정하는 부호 있는 숫자 정수입니다. |
GETCURRENTDATETIME |
이 함수는 GETCURRENTDATETIME 현재 UTC(협정 세계시) 날짜 및 시간을 ISO 8601 문자열로 반환합니다. |
GETCURRENTDATETIMESTATIC |
이 함수는 GETCURRENTDATETIMESTATIC 쿼리의 모든 항목에 대해 ISO 8601 문자열과 동일한 UTC 날짜 및 시간 값을 반환합니다. 이는 쿼리 결과에서 일관된 타임스탬프에 유용합니다. |
GETCURRENTTICKS |
이 함수는 GETCURRENTTICKS 현재 UTC 시간을 0001-01-01T00:00:00.0000000Z 이후 경과된 100나노초 간격(틱)의 수로 반환합니다. |
GETCURRENTTICKSSTATIC |
이 함수는 GETCURRENTTICKSSTATIC 동일한 파티션의 모든 항목에 대해 정적 나노초 틱 값(Unix epoch 이후 100나노초 간격)을 반환합니다. |
GETCURRENTTIMESTAMP |
이 함수는 GETCURRENTTIMESTAMP Unix epoch 이후 현재 타임스탬프를 밀리초 단위로 반환합니다. |
GETCURRENTTIMESTAMPSTATIC |
이 함수는 GETCURRENTTIMESTAMPSTATIC 동일한 파티션의 모든 항목에 대해 정적 타임스탬프 값(Unix epoch 이후 밀리초)을 반환합니다. |
TICKSTODATETIME |
이 함수는 TICKSTODATETIME 지정된 틱 수를 날짜 및 시간 값으로 변환합니다. |
TIMESTAMPTODATETIME |
이 함수는 TIMESTAMPTODATETIME 지정된 타임스탬프를 날짜 및 시간 값으로 변환합니다. |
항목 함수
| Description | |
|---|---|
DOCUMENTID |
이 함수는 DOCUMENTID 컨테이너의 지정된 항목에 대한 고유한 문서 ID를 반환합니다. |
전체 텍스트 검색 함수
| Description | |
|---|---|
FULLTEXTCONTAINS |
이 함수는 FULLTEXTCONTAINS 키워드 문자열 식이 지정된 속성 경로에 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
FULLTEXTCONTAINSALL |
이 함수는 FULLTEXTCONTAINSALL 제공된 모든 문자열 식이 지정된 속성 경로에 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
FULLTEXTCONTAINSANY |
이 함수는 FULLTEXTCONTAINSANY 제공된 문자열 식이 지정된 속성 경로에 포함되어 있는지 여부를 나타내는 부울을 반환합니다. |
FULLTEXTSCORE |
이 함수는 FULLTEXTSCORE 절에서만 사용할 수 있는 ORDER BY RANK BM25 점수 값을 반환하여 가장 높은 관련성에서 지정된 용어의 가장 낮은 관련성으로 결과를 정렬합니다. |
RRF |
이 함수는 RRF 다른 함수에서 제공하는 둘 이상의 점수를 결합하여 융합 점수를 반환합니다. |
조건부 함수
| Description | |
|---|---|
IIF |
이 함수는 IIF 부울 식이 true 또는 false로 평가되는지 여부에 따라 두 값 중 하나를 반환합니다. |
형식 검사 함수
| Description | |
|---|---|
IS_ARRAY |
이 함수는 IS_ARRAY 지정된 식의 형식이 배열인지 여부를 나타내는 부울 값을 반환합니다. |
IS_BOOL |
이 함수는 IS_BOOL 지정된 식의 형식이 부울인지 여부를 나타내는 부울 값을 반환합니다. |
IS_DEFINED |
이 함수는 IS_DEFINED 속성에 값이 할당되었는지 여부를 나타내는 부울을 반환합니다. |
IS_FINITE_NUMBER |
이 함수는 IS_FINITE_NUMBER 숫자가 유한한 숫자(무한이 아님)인지를 나타내는 부울을 반환합니다. |
IS_INTEGER |
이 함수는 IS_INTEGER 숫자가 부호 있는 64비트 정수인지 여부를 나타내는 부울을 반환합니다. 부가된 64비트 정수 범위는 64비트입니다 -9,223,372,036,854,775,8089,223,372,036,854,775,807. 자세한 내용은 __int64 참조하세요. |
IS_NULL |
이 함수는 IS_NULL 지정된 식 null의 형식이 있는지 여부를 나타내는 부울 값을 반환합니다. |
IS_NUMBER |
이 함수는 IS_NUMBER 지정된 식의 형식이 숫자인지 여부를 나타내는 부울 값을 반환합니다. |
IS_OBJECT |
이 함수는 IS_OBJECT 지정된 식의 형식이 JSON 개체인지 여부를 나타내는 부울 값을 반환합니다. |
IS_PRIMITIVE |
이 함수는 IS_PRIMITIVE 지정된 식의 형식이 기본 형식(문자열, 부울, 숫자 또는 null)인지 여부를 나타내는 부울 값을 반환합니다. |
IS_STRING |
이 함수는 IS_STRING 지정된 식의 형식이 문자열인지 여부를 나타내는 부울 값을 반환합니다. |
STRINGTONULL |
이 함수는 STRINGTONULL 문자열 식을 null.로 변환합니다. |
STRINGTONUMBER |
함수는 STRINGTONUMBER 문자열 식을 숫자로 변환합니다. |
STRINGTOOBJECT |
이 함수는 STRINGTOOBJECT 문자열 식을 개체로 변환합니다. |
공간 함수
| Description | |
|---|---|
ST_AREA |
이 함수는 ST_AREA GeoJSON 다각형 또는 MultiPolygon 식의 총 영역을 반환합니다. |
ST_DISTANCE |
이 함수는 ST_DISTANCE 두 GeoJSON Point, Polygon, MultiPolygon 또는 LineString 식 사이의 거리를 반환합니다. |
ST_INTERSECTS |
함수는 ST_INTERSECTS 첫 번째 인수에 지정된 GeoJSON 개체가 두 번째 인수의 GeoJSON 개체와 교차하는지 여부를 나타내는 부울을 반환합니다. |
ST_ISVALID |
이 함수는 ST_ISVALID 지정된 GeoJSON Point, Polygon, MultiPolygon 또는 LineString 식이 유효한지 여부를 나타내는 부울 값을 반환합니다. |
ST_ISVALIDDETAILED |
이 함수는 ST_ISVALIDDETAILED 지정된 GeoJSON Point, Polygon 또는 LineString 식이 유효한 경우 부울 값이 포함된 JSON 값을 반환하고 유효하지 않은 경우 그 이유를 반환합니다. |
ST_WITHIN |
함수는 ST_WITHIN 첫 번째 인수에 지정된 GeoJSON 개체가 두 번째 인수의 GeoJSON 개체 내에 있는지 여부를 나타내는 부울 식을 반환합니다. |
VECTORDISTANCE |
이 함수는 VECTORDISTANCE 지정된 두 벡터 사이의 유사성 점수를 반환합니다. |