데이터 준비 매핑 함수
데이터 준비 함수를 사용하여 소스 필드에 입력된 값을 기반으로 값을 계산하고 계산할 수 있습니다.
필드
필드 이름은 문자, 달러 기호($) 또는 밑줄 문자(_)로 시작하는 유니코드 문자 및 자릿수의 무제한 길이 시퀀스로 모든 법적 식별자가 될 수 있습니다. 변수 이름은 대소문자를 구분합니다.
필드 이름이 이 규칙을 따르지 않으면 필드 이름은 ${}으로 둘러싸야 합니다. 예를 들어 필드 이름이 "이름" 또는 "이름"인 경우 이름이 각각 ${First Name} 또는 ${First.Name}과 같이 둘러싸야 합니다.
또한 필드 이름이 다음 예약 키워드의 임의의인 경우 ${}로 둘러싸야 합니다.
new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return
도트 표기법을 사용하여 하위 필드 내의 데이터에 액세스할 수 있습니다. 예를 들어 name 객체가 있는 경우 firstName 필드에 액세스하려면 name.firstName를 사용합니다.
함수 목록
다음 표는 샘플 표현식 및 결과 출력을 포함하여 지원되는 모든 매핑 함수를 나열합니다.
문자열 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| concat | 지정된 문자열을 연결합니다. |
|
concat(STRING_1, STRING_2) | concat("Hi, ", "there", "!") | "Hi, there!" |
| 분해 | regex를 기반으로 문자열을 분할하고 부분 배열을 반환합니다. 선택적으로 regex를 포함하여 문자열을 분할할 수 있습니다. 기본적으로 분할은 ","로 확인됩니다. \에서 이스케이프해야 하는 구분 기호는 다음과 같습니다.+, ?, ^, |, ., [, (, {, ), *, $, \ 구분 기호로 여러 문자를 포함하는 경우 구분 기호는 다중 문자 구분 기호로 처리됩니다. |
|
explode(STRING, REGEX) | explode("Hi, there!", ") | ["Hi,", "there"] |
| instant | 하위 문자열의 위치/인덱스를 반환합니다. |
|
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE) | instr("adobe.com", "com") | 6 |
| 교체 | 원래 문자열에 있는 경우 검색 문자열을 대체합니다. |
|
replacestor(INPUT, TO_FIND, TO_REPLACE) | replacestr("문자열 재테스트", "re", "replace") | "문자열 대체 테스트입니다." |
| substr | 주어진 길이의 하위 문자열을 반환합니다. |
|
substr(INPUT, START_INDEX, LENGTH) | substr("하위 문자열 테스트입니다", 7, 8) | " 하위 항목" |
| lcase / lcase |
문자열을 소문자로 변환합니다. |
|
lower(INPUT) | lower("HeLlO") lcase("HeLlO") |
"hello" |
| upper / uase |
문자열을 대문자로 변환합니다. |
|
upper(INPUT) | upper("HeLlO") uase("HeLlO") |
"HELLO" |
| split | 구분 기호로 입력 문자열을 분할합니다. 다음 구분 문자 에을(를) \로 이스케이프해야 합니다.\. 여러 구분 기호를 포함하는 경우 문자열이 문자열에 있는 구분 기호의 임의의에서 분할됩니다. |
|
split(INPUT, SEPARATOR) | split("Hello world", " ") | ["Hello", "world"] |
| join | 구분 기호를 사용하여 개체 목록을 연결합니다. |
|
join(SEPARATOR, [OBJECTS]) |
join(" ", to_array(true, "Hello", "world")) |
"Hello world" |
| lpad | 문자열의 왼쪽 끝에 지정된 문자열을 넣습니다. |
|
lpad(입력, 카운트, 패딩) | lpad("bat", 8, "yz") | "yzygybat" |
| rpad | 지정된 다른 문자열을 사용하여 문자열의 오른쪽에 패드를 넣습니다. |
|
rpad(입력, 카운트, 패딩) | rpad("bat", 8, "yz") | "batyzyzy" |
| left | 지정된 문자열의 첫 번째 "n" 문자를 가져옵니다. |
|
left(STRING, COUNT) | left("abcde", 2) | "ab" |
| right | 지정된 문자열의 마지막 "n" 문자를 가져옵니다. |
|
right(STRING, COUNT) | right("abcde", 2) | "de" |
| 트리밍 | 문자열 시작 부분에서 공백을 제거합니다. |
|
ltrim(STRING) | ltrim(" hello") | "hello" |
| 트리밍 | 문자열 끝에서 공백을 제거합니다. |
|
rtrim(STRING) | rtrim("hello") | "hello" |
| trim | 문자열의 시작 부분과 끝 부분에서 공백을 제거합니다. |
|
trim(STRING) | trim(" hello ") | "hello" |
| 다음과 같음 | 두 문자열을 비교하여 동일한지 확인합니다. 이 함수는 대/소문자를 구분합니다. |
|
문자열1.equals( STRING2) | "string1"을 참조하십시오.같음("STRING1") | false |
| equalsIgnoreCase | 두 문자열을 비교하여 동일한지 확인합니다. 이 함수는 대/소문자를 구분하지 않습니다. |
|
문자열1.equalsIgnoreCase(STRING2) | "string1"을 참조하십시오.equalsIgnoreCase("STRING1)) | true |
정규 표현식 함수
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| extract_regex | 정규 표현식을 기반으로 입력 문자열에서 그룹을 추출합니다. |
|
extract_regex(STRING, REGEX) | extract_regex("E259,E259B_009,1_1" , "([,]+),[,]*,([^,]+)")) | ["E259,E259B_009,1_1", "E259", "1_1"] |
| matches_regex | 문자열이 입력된 정규 표현식과 일치하는지 확인합니다. |
|
matches_regex(STRING, REGEX) | matches_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")") | true |
해시 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| sha1 | SHA-1(보안 해시 알고리즘 1)을 사용하여 입력을 받고 해시 값을 생성합니다. |
|
sha1(INPUT, CHARSET) | sha1("my text", "UTF-8") | c3599c11e47719df18a24 48690840c5dfcce3c80 |
| sha256 | 입력 내용을 가져와 보안 해시 알고리즘 256(SHA-256)을 사용하여 해시 값을 생성합니다. |
|
sha256(입력, 문자 집합) | sha256("내 텍스트", "UTF-8") | 7330d2b39ca35eaf4cb95fc846c21 ee6a39af698154a83a586ee270a0d372104 |
| sha512 | 입력 내용을 가져와 보안 해시 알고리즘 512(SHA-512)를 사용하여 해시 값을 생성합니다. |
|
sha512(입력, 문자 집합) | sha512("내 텍스트", "UTF-8") | a3d7e45a0d9be5fd4e4b3b8c9c2163c21ef 708bf11b4232bb21d2a8704ada2cdcd7b367dd078dd a89 a5c908cfe377aceb1072a7b386b7d4fd2ff68a8fd24d16 |
| md5 | MD5를 사용하여 입력을 받고 해시 값을 생성합니다. |
|
md5(입력, 문자 세트) | md5("내 텍스트", "UTF-8") | d3b96ce8c9fb4 e9bd0198d03ba6852c7 |
| crc32 | 입력은 CRC(순환 중복 검사) 알고리즘을 사용하여 32비트 순환 코드를 생성합니다. |
|
crc32(입력, 문자 집합) | crc32("내 텍스트", "UTF-8") | 8df92e80 |
URL 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| get_url_protocol | 지정된 URL에서 프로토콜을 반환합니다. 입력이 잘못된 경우 null을 반환합니다. |
|
get_url_protocol (URL) | get_url_protocol("https://platform .adobe.com/home") | https |
| get_url_host | 지정된 URL의 호스트를 반환합니다. 입력이 잘못된 경우 null을 반환합니다. |
|
get_url_host(URL) | get_url_host ("https://platform .adobe.com/home") | platform.adobe.com |
| get_url_port | 지정된 URL의 포트를 반환합니다. 입력이 잘못된 경우 null을 반환합니다. |
|
get_url_port(URL) | get_url_port ("sftp://example.com//home/ joe/employee.csv") | 22 |
| get_url_path | 지정된 URL의 경로를 반환합니다. 기본적으로 전체 경로가 반환됩니다. |
|
get_url_path(URL, FULL_PATH) | get_url_path ("sftp://example.com// home/joe/employee.csv") | "//home/joe/ employee.csv" |
| get_url_query_str | 지정된 URL의 쿼리 문자열을 반환합니다. |
|
get_url_query_str(URL, ANCHOR) | get_url_query_str("foo://example.com:8042//over/there?name=을) ferrete#nose를 ), "rette" get_url_str("foo://example.com:8042을 사용하여 //?name=을을, "제거"))<get_url_url을 get_url이_이 될 수 있습니다. #noes", "append") |
{"name": "ferret#nose"}{"name": "ferret"}{"name": "ferret", "_anchor_": "nose"} |
날짜 및 시간 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오. date 함수에 대한 자세한 내용은 데이터 형식 처리 안내서의 날짜 섹션에서 확인할 수 있습니다.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| now | 현재 시간을 검색합니다. | now() | now() | 2020-09-23T10:10:24.556-07:00[America/Los_Angeles] |
|
| timestamp | 현재 Unix 시간을 검색합니다. | timestamp() | timestamp() | 1571850624571 | |
| format | 지정된 형식에 따라 입력 날짜를 지정합니다. |
|
format(DATE, FORMAT) | format(2019-10-23T11:24:00+00:00, "yyyy-MM-dd HH:mm:ss") | "2019-10-23 11:24:35" |
| dformat | 지정된 형식에 따라 타임스탬프를 날짜 문자열로 변환합니다. |
|
형식(타임스탬프, 형식) | dformat(1571829875, "dd-MMM-yyyy hh:mm") | "2019년 10월 23일 11:24" |
| 날짜 | 날짜 문자열을 ZunkedDateTime 객체(ISO 8601 형식)로 변환합니다. |
|
date(DATE, FORMAT, DEFAULT_DATE) | date("2019-10-23 11:24", "yyyy-MM-dd HH:mm", now()) | "2019-10-23T11:24Z" |
| 날짜 | 날짜 문자열을 ZunkedDateTime 객체(ISO 8601 형식)로 변환합니다. |
|
date(날짜, 형식) | date("2019-10-23 11:24", "yyyy-MM-dd HH:mm") | "2019-10-23T11:24Z" |
| 날짜 | 날짜 문자열을 ZunkedDateTime 객체(ISO 8601 형식)로 변환합니다. |
|
date(날짜) | date("2019-10-23 11:24") | "2019-10-23T11:24Z" |
| date_part | 날짜의 부분을 검색합니다. 다음 구성 요소 값이 지원됩니다. "연도" "yyyy" "yy" "분기" "q" "월" "mm" "m" "dayofyear" "dy"<a11" 1/>"y" "day" "dd" "d" "week" "ww" "w" "평일" "dw"<20/>"w" "hour" "hh" "hh24" "hh12" "minute" "mi" "n" " "ss" "s" "millisecond" "ms" |
|
date_part(COMPONENT, DATE) | date_part("MM", date("2019-10-17") | 10 |
| set_date_part | 지정된 날짜의 구성 요소를 대체합니다. 다음 구성 요소가 허용됩니다. "연도" "yyyy" "yy" "월" "mm" "m" "일" "dd" "시간" "hh" minute" "mi" "n" "second" "ss" "s" |
|
set_date_part(COMPONENT, VALUE, DATE) | set_date_part("m", 4, date("2016-11-09T11:44:44.797") | "2016-04-09T11:44:44.797" |
| make_date_time | 부품으로부터 날짜를 만듭니다. make_timestamp를 사용하여 이 함수를 유도할 수도 있습니다. |
|
make_date_time(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, 나노초, TIMEZONE) | make_date_time(2019, 10, 17, 11, 55, 12, 999, "미국/로스앤젤레스") | 2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles] |
| zone_date_to_utc | 시간대의 날짜를 UTC의 날짜로 변환합니다. |
|
zone_date_to_utc (DATE) | zone_date_to_utc​(2019-10-17T11:55:​12.000000999-​07:00[America/Los_Angeles]) |
2019-10-17T18:55:12.000000999Z[UTC] |
| zone_date_to_zone | 한 시간대에서 다른 시간대로 날짜를 변환합니다. |
|
zone_date_to_zone (날짜, 영역) | zone_date_to_utc​(2019-10-17T11:55:12​.000000999-07:00​[America/Los_Angeles], "Europe/Paris") |
2019-10-17T20:55:12.000000999+02:00[Europe/Paris] |
{style="table-layout:auto"}
계층 - 개체
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| size_of | 입력 크기를 반환합니다. |
|
size_of(INPUT) | size_of([1, 2, 3, 4]) |
4 |
| is_empty | 객체가 비어 있는지 여부를 확인합니다. |
|
is_empty(INPUT) | is_empty([1, 2, 3]) |
false |
| array_to_object | 개체 목록을 만듭니다. |
|
array_to_object(INPUT) | 샘플 필요 | 샘플 필요 |
| to_object | 주어진 평면 키/값 쌍을 기반으로 객체를 만듭니다. |
|
to_object(INPUT) | to_object("firstName", "John", "lastName", "Doe") | {"firstName": "John", "lastName": "Doe"} |
| str_to_object | 입력 문자열에서 객체를 만듭니다. |
|
str_to_object(문자열, VALUE_DELIMITER, FIELD_DELIMITER) | str_to_object("firstName - John | lastName - |
| is_set | 개체가 소스 데이터 내에 있는지 확인합니다. |
|
is_set(INPUT) | is_set("evars.evar.field1") | true |
| 무효 | 특성 값을 null으로 설정합니다. 이 옵션은 필드를 대상 스키마에 복사하지 않으려는 경우에 사용해야 합니다. |
untrue() | untrue() | null |
계층 - 배열
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| 코알스 | 지정된 배열에서 null이 아닌 첫 번째 객체를 반환합니다. |
|
coalesce(INPUT) | coalesce(null, null, null, 첫 번째, null, "두 번째") | "first" |
| first | 지정된 배열의 첫 번째 요소를 검색합니다. |
|
first(INPUT) | first("1", "2", "3") | "1" |
| last | 지정된 배열의 마지막 요소를 검색합니다. |
|
last(INPUT) | last("1", "2", "3") | "3" |
| add_to_array | 배열 끝에 요소를 추가합니다. |
|
add_to_array(ARRAY, VALUES) | add_to_array(['a', 'b'], 'c', 'd') | ['a', 'b', 'c', 'd'] |
| join_array | 배열을 서로 결합합니다. |
|
join_array(ARRAY, VALUES) | join_arrays(['a', 'b'], ['c'], ['d', 'e']) | ['a', 'b', 'c', 'd', 'e'] |
| to_array | 입력 목록을 가져와서 배열로 변환합니다. |
|
to_array(INCLUDE_NULL, VALUES) | to_array(false, 1, null, 2, 3) | [1, 2, 3] |
논리 연산자
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| decode | 키와 배열 형태로 분리된 키 값 쌍 목록이 지정된 경우 키가 있으면 값을 반환하고 배열에 있는 경우 기본값을 반환합니다. |
|
decode(KEY, OPTIONS) | decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A") | 지정된 stateCode가 "ca", "California"인 경우. 주어진 stateCode가 "pa", "Pennsylvania"인 경우 stateCode가 다음과 일치하지 않는 경우 "N/A". |
| iif | 주어진 부울 표현식을 평가하고 결과를 기준으로 지정된 값을 반환합니다. |
|
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE) | iif("s".equalsIgnoreCase("S"), "True", "False") | "True" |
집계
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| min | 지정된 인수의 최소 개수를 반환합니다. 자연스러운 순서를 사용합니다. |
|
min(OPTIONS) | 최소(3, 1, 4) | 1 |
| max | 주어진 인수의 최대값을 반환합니다. 자연스러운 순서를 사용합니다. |
|
max(OPTIONS) | max(3, 1, 4) | 4 |
전환 입력
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| to_bigint | 문자열을 BigInteger로 변환합니다. |
|
to_bigint(STRING) | to_bigint("1000000.34") | 1000000.34 |
| to_decimal | 문자열을 Double로 변환합니다. |
|
to_decimal(STRING) | to_decimal("20.5") | 20.5 |
| to_float | 문자열을 Float로 변환합니다. |
|
to_float(STRING) | to_float("12.3456") | 12.34566 |
| to_integer | 문자열을 정수로 변환합니다. |
|
to_integer(STRING) | to_integer("12") | 12 |
JSON 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| json_to_object | 지정된 문자열에서 JSON 콘텐츠를 역직렬화합니다. |
|
json_to_object(STRING) | json_to_object({"info":{"firstName":"John","lastName" :"Doe"}) | JSON을 나타내는 객체입니다. |
특수 작업
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| uuid / guid |
의사 임의 ID를 생성합니다. | uuid() guid() |
uuid() guid() |
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4 c7016dc7-3163-43f7-afc7-2e1c9c206333 |
사용자 에이전트 함수
노트
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
| 함수 | 설명 | 매개 변수 | 구문 | 표현식 | 샘플 출력 |
|---|---|---|---|---|---|
| ua_os_name | 사용자 에이전트 문자열에서 운영 체제 이름을 추출합니다. |
|
ua_os_name(USER_AGENT) | ua_os_name ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | iOS |
| ua_os_version_major | 사용자 에이전트 문자열에서 운영 체제의 주 버전을 추출합니다. |
|
ua_os_version_major(USER_AGENT) | ua_os_version_major s("Mozilla/5.0 (iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | iOS 5 |
| ua_os_version | 사용자 에이전트 문자열에서 운영 체제의 버전을 추출합니다. |
|
ua_os_version (USER_AGENT) | ua_os_version ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | 5.1.1 |
| ua_os_name_version | 사용자 에이전트 문자열에서 운영 체제의 이름과 버전을 추출합니다. |
|
ua_os_name_version (USER_AGENT) | ua_os_name_version ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | iOS 5.1.1 |
| ua_agent_version | 사용자 에이전트 문자열에서 에이전트 버전을 추출합니다. |
|
ua_agent_version (USER_AGENT) | ua_agent_version ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | 5.1 |
| ua_agent_version_major | 사용자 에이전트 문자열에서 에이전트 이름 및 주 버전을 추출합니다. |
|
ua_agent_version_major(USER_AGENT) | ua_agent_version_major("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | Safari 5 |
| ua_agent_name | 사용자 에이전트 문자열에서 에이전트 이름을 추출합니다. |
|
ua_agent_name(USER_AGENT) | ua_agent_name ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | Safari |
| ua_device_class | 사용자 에이전트 문자열에서 장치 클래스를 추출합니다. |
|
ua_device_class (USER_AGENT) | ua_device_class ("Mozilla/5.0(iPhone;Mac OS X와 같은 CPU iPhone OS 5_1_1) AppleWebKit/534.46(KHTML, 예: Gecko) 버전/5.1 Mobile/9B206 Safari/7534.48.3") | 전화 |
Adobe.com의 리소스
지역 변경
