설명서Campaign Standard 설명서

함수 목록 list-of-functions

Last update: Fri Dec 29 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Experienced
  • Developer

함수 기본 정보 about-functions

쿼리 편집 도구를 사용하면 고급 함수를 사용하여 복잡한 필터링을 수행할 수 있습니다. 이를 위해 도구 팔레트에는 작업 영역에서 사용할 수 있는 Expression 요소가 포함되어 있습니다. 이 요소에 대한 자세한 내용은 특정 섹션에 자세히 설명되어 있습니다.

이 요소를 사용하면 조건을 수동으로 입력할 수 있습니다. 여기에서 다음 섹션에 정의된 함수를 사용할 수 있습니다.

원하는 결과 및 조작된 데이터의 유형에 따라 다양한 함수 유형을 사용할 수 있습니다.

  • 날짜
  • 지오마케팅
  • 숫자 값
  • 기타 함수
  • 집계
  • 문자열 조작
  • 정렬
NOTE
외부 매개 변수로 워크플로우를 호출한 후 이벤트 변수를 사용할 수 있는 모든 활동에서 추가 함수를 사용할 수 있습니다. 자세한 내용은 다음과 같습니다 이 섹션.

날짜 dates

날짜 함수는 날짜 또는 시간 값을 조작하는 데 사용됩니다.

이름
설명
구문
AddDays
날짜에 일자 숫자 추가
AddDays(<날짜>, <숫자>)
AddHours
날짜에 시간(시) 숫자 추가
AddHours(<날짜>, <숫자>)
AddMinutes
날짜에 시간(분) 숫자 추가
AddMinutes(<날짜>, <숫자>)
AddMonths
날짜에 개월 숫자 추가
AddMonths(<날짜>, <숫자>)
AddSeconds
날짜에 시간(초) 숫자 추가
AddSeconds(<날짜>, <숫자>)
AddYears
날짜에 연도 숫자 추가
AddYears(<날짜>, <숫자>)
DateOnly
날짜만 반환(00:00 시간 포함)
DateOnly(<날짜>)
Day
날짜의 일자를 나타내는 숫자 반환
Day(<날짜>)
DayOfYear
날짜의 연도를 나타내는 숫자 반환
DayOfYear(<날짜>)
DaysAgo
현재 날짜에서 n일을 뺀 숫자 반환
DaysAgo(<숫자>)
DaysAgoInt
현재 날짜에서 n일을 뺀 숫자 반환(정수 yyyymmdd)
DaysAgoInt(<숫자>)
DaysDiff
두 날짜 사이의 일자 수
DaysDiff(<종료 날짜>, <시작 날짜>)
DaysOld
날짜를 일 단위로 반환
DaysOld(<날짜>)
GetDate
서버의 현재 시스템 날짜 반환
GetDate()
Hour
날짜의 시간 반환
Hour(<날짜>)
HoursDiff
두 날짜 사이의 시간(시) 숫자 반환
HoursDiff(<종료 날짜>, <시작 날짜>)
LocalToUTC
로컬 날짜 및 시간을 UTC로 변환
LocalToUTC(<날짜>, <시간대>)
Minute
날짜의 시간(분) 반환
Minute(<날짜>)
MinutesDiff
두 날짜 사이의 시간(분) 숫자 반환
MinutesDiff(<종료 날짜>, <시작 날짜>)
Month
날짜의 월을 나타내는 숫자 반환
Month(<날짜>)
MonthsAgo
현재 날짜에서 n개월을 뺀 날짜 반환
MonthsAgo(<숫자>)
MonthsDiff
두 날짜 사이의 개월 숫자 반환
MonthsDiff(<종료 날짜>, <시작 날짜>)
MonthsOld
날짜를 월 단위로 반환
MonthsOld(<날짜>)
Second
날짜의 시간(초) 반환
Second(<날짜>)
Oldest
가장 오래된 날짜 반환
Oldest(<날짜>, <날짜>)
SecondsDiff
두 날짜 사이의 시간(초) 숫자 반환
SecondsDiff(<종료 날짜>, <시작 날짜>)
SubDays
날짜에서 일자 숫자 빼기
SubDays(<날짜>, <숫자>)
SubHours
날짜에서 시간(시) 숫자 빼기
SubHours(<날짜>, <숫자>)
SubMinutes
날짜에서 시간(분) 숫자 빼기
SubMinutes(<날짜>, <숫자>)
SubMonths
날짜에서 개월 숫자 빼기
SubMonths(<날짜>, <숫자>)
SubSeconds
날짜에서 시간(초) 숫자 빼기
SubSeconds(<날짜>, <숫자>)
SubYears
날짜에서 연도 숫자 빼기
SubYears(<날짜>, <숫자>)
ToDate
날짜 + 시간을 날짜로 변환
ToDate(<날짜 + 시간>)
ToDateTime
문자열을 날짜 + 시간으로 변환
ToDateTime(<문자열>)
ToDateTimeWithTimezone
문자열을 날짜 + 시간대로 변환.
예: ToDateTimeWithTimezone("2019-02-19 08:09:00", "아시아/테헤란")
ToDateTimeWithTimezone(<문자열>)
TruncDate
날짜+시간을 가장 가까운 시간(초)으로 반올림
TruncDate(@lastModified, <시간(초) 숫자>)
TruncDateTZ
날짜 + 시간을 초 단위의 특정 정밀도로 반올림
TruncDateTZ(<날짜>, <시간(초) 숫자>, <시간대>)
TruncQuarter
날짜를 분기로 반올림
TruncQuarter(<날짜>)
TruncTime
시간 부분을 가장 가까운 시간(초)으로 반올림
TruncTime(<날짜>, <시간(초) 숫자>)
TruncWeek
날짜를 요일로 반올림
TruncWeek(<날짜>)
TruncYear
날짜 + 시간을 연도의 1월 1일로 반올림
TruncYear(<날짜>)
WeekDay
날짜의 요일을 나타내는 숫자 반환
WeekDay(<날짜>)
Year
날짜의 연도를 나타내는 숫자 반환
Year(<날짜>)
YearAnd Month
날짜의 연도 및 월을 나타내는 숫자 반환
YearAndMonth(<날짜>)
YearsDiff
두 날짜 사이의 연도 숫자 반환
YearsDiff(<종료 날짜>, <시작 날짜>)
YearsOld
날짜를 연 단위로 반환
YearsOld(<날짜>)

지오마케팅 geomarketing

지오마케팅 함수는 지리적 값을 조작하는 데 사용됩니다.

이름
설명
구문
Distance
경도 및 위도로 정의된 두 지점 사이의 거리(도 단위)를 킬로미터 단위로 반환
Distance(<경도 A>, <위도 A>, <경도 B>, <위도 B>)

숫자 numerical

숫자 값 함수는 텍스트를 숫자로 변환하는 데 사용됩니다.

이름
설명
구문
Abs
숫자의 절대값 반환
Abs(<숫자>)
Ceil
숫자보다 크거나 같은 최소 정수 반환
Ceil(<숫자>)
Floor
숫자보다 작거나 같은 최대 정수 반환
Floor(<숫자>)
Greatest
두 숫자 중 큰 숫자 반환
Greatest(<숫자 1>, <숫자 2>)
Least
두 숫자 중 작은 숫자 반환
Least(<숫자 1>, <숫자 2>)
Mod
n1에서 n2까지 정수 분기의 나머지 반환
Mod(<숫자 1>, <숫자 2>)
Percent
백분율로 표현된 두 수의 비율 반환
Percent(<숫자 1>, <숫자 2>)
Random
임의 값 반환
Random()
Round
숫자를 n개의 소수로 반올림
Round(<숫자>, <소수 자리수>)
Sign
숫자 기호 반환
Sign(<숫자>)
ToDouble
정수를 실수로 변환
ToDouble(<숫자>)
ToInt64
실수를 64비트 정수로 변환
ToInt64(<숫자>)
ToInteger
실수를 정수로 변환
ToInteger(<숫자>)
Trunc
n1에서 n2까지의 소수점 자르기
Trunc(<n1>, <n2>)

기타 others

이 표에는 사용 가능한 나머지 함수가 포함되어 있습니다.

이름
설명
구문
Case
조건이 확인되면 값 1 반환 그렇지 않으면 값 2 반환
Case(When(<조건>, <값 1>), Else(<값 2>))
ClearBit
값에서 플래그 삭제
ClearBit(<식별자>, <플래그>)
Coalesce
값 1이 0이거나 null이면 값 2 반환, 그렇지 않으면 값 1 반환
Coalesce(<값 1>, <값 2>)
Decode
반환 값 3은 값 1 = 값 2이고, 그렇지 않으면 4 반환
Decode(<값 1>, <값 2>, <값 3>, <값 4>)
Else
값 1 반환(case 함수의 매개 변수로만 사용할 수 있음)
Else(<값 1>)
GetEmailDomain
이메일 주소에서 도메인 추출
GetEmailDomain(<값>)
GetMirrorURL
미러 페이지 서버의 URL 검색
GetMirrorURL(<값>)
Iif
표현식이 true면 값 1 반환, 그렇지 않으면 값 2 반환
Iif(<조건>, <값 1>, <값 2>)
IsBitSet
플래그가 값에 있는지 표시
IsBitSet(<식별자>, <플래그>)
IsEmptyString
문자열이 비어 있으면 값 2 반환, 그렇지 않으면 값 3 반환
IsEmptyString(<문자열>, <값 2>, <값 3>)
NoNull
인수가 NULL이면 빈 문자열 반환
NoNull(<값>)
RowId
행 번호 반환
RowId
SetBit
값에 플래그 강제 적용
SetBit(<식별자>, <플래그>)
ToBoolean
숫자를 부울로 변환
ToBoolean(<숫자>)
When
표현식이 확인되면 값 1 반환 그렇지 않으면 값 2 반환(case 함수의 매개 변수로만 사용할 수 있음)
When(<조건>, <값 1>)
newUUID
새 UUID 반환
newUUID

문자열 string

문자열 함수는 문자열 집합을 조작하는 데 사용됩니다.

이름
설명
구문
AllNonNull2
모든 매개 변수가 null이 아니고 비어 있지 않은지 표시
AllNonNull2(<문자열>, <문자열>)
AllNonNull3
모든 매개 변수가 null이 아니고 비어 있지 않은지 표시
AllNonNull3(<문자열>, <문자열>, <문자열>)
ASCII
문자열에서 첫 번째 문자의 ASCII 값 반환
Ascii(<문자열>)
Char
'n' ASCII 코드에 해당하는 문자 반환
Char(<숫자>)
Charindex
문자열 1에서 문자열 2의 위치 반환
Charindex(<문자열>, <문자열>)
DataLength
문자열의 문자 수 반환
DataLength(<문자열>)
GetLine
문자열의 n번째(1에서 n까지) 행 반환
GetLine(<문자열>)
IfEquals
처음 두 매개 변수가 동일하면 세 번째 매개 변수 반환, 그렇지 않으면 마지막 매개 변수 반환
IfEquals(<문자열>, <문자열>, <문자열>, <문자열>)
IsMemoNull
매개 변수로 전달된 메모가 null인지 표시
IsMemoNull(<메모>)
JuxtWords
매개 변수로 전달된 두 문자열을 연결합니다. 반환된 값의 각 문자열 사이에 공백이 추가됩니다.
JuxtWords(<문자열>, <문자열>)
JuxtWords3
매개 변수로 전달된 세 개의 문자열을 연결합니다. 반환된 값의 각 문자열 사이에 공백이 추가됩니다.
JuxtWords3(<문자열>, <문자열>, <문자열>)
LPad
왼쪽에서 완성된 문자열 반환
LPad(<문자열>, <숫자>, <문자>)
Left
문자열의 처음 n자 반환
Left(<문자열>, <숫자>)
Length
문자열 길이 반환
Length(<문자열>)
Lower
문자열을 소문자로 반환
Lower(<문자열>)
Ltrim
문자열 왼쪽의 공백 제거
Ltrim(<문자열>)
Md5Digest
문자열의 MD5 키를 16진수로 반환
Md5Digest(<문자열>)
MemoContains
메모에 매개 변수로 전달된 문자열이 포함되어 있는지 지정
MemoContains(<메모>, <문자열>)
RPad
오른쪽에 완성된 문자열 반환
RPad(<문자열>, <숫자>, <문자>)
Replace
지정된 문자열(2번째 매개 변수) 값의 모든 발생 항목을 문자열(1번째 매개 변수)의 다른 문자열 값(3번째 매개 변수)으로 변환
Replace(<문자열>, <문자열>, <문자열>)
Right
문자열의 마지막 n자 반환
Right(<문자열>)
Rtrim
문자열 오른쪽의 공백 제거
Rtrim(<문자열>)
Sha256Digest
지정된 UTF8 문자열에 대한 표준 SHA256 해시 계산
Sha256Digest(<문자열>)
Sha384Digest
지정된 UTF8 문자열에 대한 표준 SHA384 해시 계산
Sha384Digest(<문자열>)
Sha512Digest
지정된 UTF8 문자열에 대한 표준 SHA512 해시 계산
Sha512Digest(<문자열>)
Smart
각 단어의 첫 번째 문자가 대문자로 표시된 문자열 반환
Smart(<문자열>)
Substring
문자열의 문자 n1에서 시작하여 길이가 n2인 하위 문자열 추출
Substring(<문자열>, <오프셋>, <길이>)
ToIntlString
숫자를 문자열로 변환
ToIntlString(<숫자>)
ToString
숫자를 문자열로 변환
ToString(<숫자>)
Upper
문자열을 대문자로 반환
Upper(<문자열>)
VirtualLink
다른 두 매개 변수가 동일한 경우 매개 변수로 전달된 링크의 외부 키 반환
VirtualLink(<숫자>, <<숫자>, <숫자>)
VirtualLinkStr
다른 두 매개 변수가 동일한 경우 매개 변수로 전달된 링크의 외부(텍스트) 키 반환
VirtualLinkStr(<문자열>, <숫자>, <숫자>)
encryption_aescbcDecrypt
HEX 포맷(2번째 매개 변수)의 키 및 HEX 포맷(3번째 매개 변수)의 초기화 벡터를 사용하여 "x" 접두사가 있는 HEX 포맷(1번째 매개 변수)의 암호화된 값 해독
encryption_aescbcDecrypt(<문자열>, <문자열>, <문자열>)
encryption_aescbcEncrypt
AES 알고리즘(CBC 블록 모드)을 사용하여 키(2번째 매개 변수)와 초기화 벡터(3번째 매개 변수)가 있는 문자열(1번째 매개 변수) 암호화. 키 및 초기화 벡터는 (\x 로 시작하는) 16진수로 제공되어야 합니다. 결과는 \x 없이 16진수로 표시됩니다.
키 크기는 128비트, 192비트, 256비트(16, 24, 32개의 16진수 문자)가 될 수 있지만 키와 동일한 길이의 임의 IV 및 256비트를 사용하는 것이 좋습니다.
encryption_aescbcEncrypt(<string>, <string>, <string>)
예: encryption_aescbcEncrypt(johndoe@example.com, "\\x0123456789ABCDEF0123456789ABCDEF", "\\x0123456789ABCDEFFEDCBA9876543210")

집계 aggregates

집계 함수는 워크플로우 Query 활동에서 추가 데이터를 추가할 때만 사용할 수 있습니다.

집계 함수는 값 집합에 대한 계산을 수행하는 데 사용됩니다.

이름
설명
구문
Avg, 평균
숫자 열의 평균 반환.
Avg(<값>)
Count, 계산(NULL 제외)
열에서 null이 아닌 값 계산.
Count(<값>)
CountAll, 모두 계산
모든 값 계산(null 값 및 중복 포함).
CountAll()
Countdistinct, 개별 계산t
열에서 null이 아닌 개별 값 계산
Countdistinct(<값>)
Max, 최대
숫자, 문자열 또는 날짜 열의 최대값 반환
Max(<값>)
Min, 최소
숫자, 문자열 또는 날짜 열의 최소값 반환
Min(<값>)
문자열 집계, 문자열 집계
두 번째 인수의 문자로 구분된 문자열 유형 열의 값 연결을 반환합니다(기본 구분 기호는 쉼표).
StringAg(<string values="">,<separator>)
Sum, 합계
숫자 열에 있는 값의 합계 반환
Sum(<값>)

표시 representation

표시 함수는 값을 정렬하는 데 사용됩니다.

이름
설명
구문
Desc
내림차순 정렬 적용
Desc(<값 1>)
OrderBy
파티션 내의 결과 정렬
OrderBy(<값 1>)
PartitionBy
테이블에서 쿼리 결과 분할
PartitionBy(<값 1>)
RowNum
테이블 파티션 및 정렬 시퀀스에 따라 행 번호 생성. 이 함수는 MySQL에서 지원되지 않습니다.
RowNum(PartitionBy(<값 1>), OrderBy(<값 1>))
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff