데이터 집합을 변환하는 규칙 만들기

복제, 랜딩, 저장소, 변환, 및 데이터 마트 데이터 작업에서 데이터 집합에 대한 전역 변환을 수행하기 위해 재사용 가능한 변환 규칙을 만들 수 있습니다.

스키마 진화로 인해 작업에 추가된 데이터 집합 및 열에는 전역 변환이 지원되지 않습니다.

데이터 집합를 선택하고 변환 규칙을 클릭한 다음 변환 규칙 추가를 클릭하여 새 변환 규칙을 만듭니다.

변환 유형을 선택하고 다음을 클릭합니다.

다음 변환을 수행할 수 있습니다.
- 데이터 집합 이름 바꾸기
- 데이터 메시지 게시 재정의
  정보 메모
  - Kafka 대상에만 사용 가능합니다.
  - Data Movement gateway(온프레미스 Kafka와 함께 필요함)를 사용하는 경우, 버전 2025.5.40 이상이 필요합니다.
- 열 이름 바꾸기
- 열 추가
- 열 삭제
- 데이터 유형 변환
- 열 값 바꾸기
변환 범위를 선택하고 다음을 클릭합니다.
수행할 변환 작업을 선택하고 다음을 클릭합니다.
규칙에 대한 이름과 설명을 추가하고 마침을 클릭합니다.

데이터 작업을 실행할 때 규칙이 적용됩니다. 규칙을 두 개 이상 추가하면 나열된 순서대로 규칙이 실행됩니다.

규칙의 표현식에서 열 이름과 같은 변수를 사용할 수 있습니다. 자세한 내용은 표현식에 메타데이터 포함하기을 참조하십시오.

변환 범위

여러 변환이 동일한 데이터 집합 또는 열에 적용되는 경우 범위는 항상 원본 소스 이름에 있지만 작업은 이전 규칙이 적용된 후의 값과 관련됩니다. 예를 들어, 다음 규칙이 있는 경우:

Abc_(Abc_%)로 시작하는 모든 데이터 집합의 이름을 바꿔 접두사를 ABC_로 변경합니다.
ABC_ (ABC_%)로 시작하는 데이터 집합에 접미사 _zzz를 추가합니다.

이러한 데이터 집합에 규칙을 적용하면 이러한 결과가 제공됩니다. 두 번째 규칙 이후에는 범위가 항상 원본 이름(Abc_customers)에 있으므로 _zzz 접미사가 ABC_customers에 추가되지 않습니다.

원본 데이터 집합 이름	규칙 1 뒤의 데이터 집합 이름	규칙 2 뒤의 데이터 집합 이름
Abc_customers	ABC_customers	ABC_customers
ABC_Suppliers	ABC_Suppliers	ABC_Suppliers_zzz

데이터 집합 이름 바꾸기

데이터 집합 이름 바꾸기를 선택하고 다음을 클릭합니다.
변환 범위, 즉 이름을 바꿀 데이터 집합을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 자산에서 여러 데이터 집합을 선택할 수 있습니다.

다음을 클릭합니다.
변환 작업을 설정합니다. 다음 작업을 수행할 수 있습니다.
- 데이터 집합의 이름을 고정 이름으로 바꿉니다.
- 접두사 또는 접미사를 추가합니다.
- 접두사 또는 접미사를 제거합니다.
- 접두사 또는 접미사를 바꿉니다.
- 대/소문자를 소문자 또는 대문자로 변경합니다.
- 표현식을 사용하여 데이터 집합 이름을 바꿉니다.
- 사전을 사용하여 데이터 집합 이름을 바꿉니다.
  
  자세한 내용은 사전을 사용하여 데이터 집합 또는 열 이름 바꾸기을 참조하십시오.
준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

데이터 메시지 게시 사용자 지정

Kafka 대상에만 사용 가능합니다.

데이터 메시지 게시 사용자 지정을(를) 선택한 다음 다음을(를) 클릭합니다.
변환 범위를 설정합니다. 즉, 데이터 메시지 게시 설정을 재정의할 데이터 세트를 지정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 자산에서 여러 데이터 집합을 선택할 수 있습니다.

다음을 클릭합니다.
변환 작업을 설정합니다.

각 설정에 대해 현재 작업 설정은 작업 설정: <설정> 필드에 표시됩니다(예: 작업 설정: 특정 토픽).

이러한 설정에 대한 설명은 데이터 메시지 게시을(를) 참조하십시오.

작업 설정을 유지하거나 표현식 빌더를 사용하여 사용자 지정 토픽, 메시지 키 또는 파티션 키를 지정할 수 있습니다.

정보 메모이러한 설정은 작업 설정을 재정의하지만 개별 데이터 집합에 대해 구성된 설정을 재정의하지 않습니다.

표현식 빌더를 사용하려면:
1. 적절하게 사용자 지정 토픽, 사용자 지정 메시지 키 또는 사용자 지정 파티션 키 필드를 선택하고 을(를) 클릭합니다.
  
  정보 메모사용자 지정 토픽은 이미 존재해야 하거나 브로커가 토픽을 만들도록 구성되어 있어야 합니다.
  
  표현식 작성기가 열립니다.
2. 표현식을 작성합니다.
  
  데이터 집합, 함수 및 연산자의 열을 사용하여 표현식을 작성할 수 있습니다.
  
  을 클릭하면 항목이 표현식으로 이동합니다.
  
  표현식에서 Kafka에서 지원하는 모든 함수를 사용할 수도 있습니다.
3. 매개 변수 추출을 클릭합니다.
  
  이제 모든 매개 변수에 대해 테스트할 값에 테스트 값을 추가할 수 있습니다.
4. 표현식 테스트를 클릭합니다.
  
  이제 테스트 값을 사용하여 표현식의 결과를 볼 수 있습니다.
5. 준비가 되면 확인을 클릭합니다.
  
  표현식이 필드에 추가됩니다.
팁 메모추가된 열을 제거하려면 해당 열을 선택하고 되돌리기를 클릭합니다.

표현식 작성

사용자 지정 값을 정의하는 표현식을 작성해야 합니다. 다음을 사용할 수 있습니다.
- 함수
  
  문자열 함수, 숫자 함수, null 확인 함수, 데이터 및 시간 함수, 논리 함수.
- 연산자
  
  수학 및 논리 연산자. 일부 연산자는 표현식 위의 도구 모음에서도 사용할 수 있습니다. 여기에서 문자열 연결 연산자인 ||도 찾을 수 있습니다.
- 메타데이터
  
  표현식에 메타데이터 포함하기을 참조하십시오.
을 클릭하면 항목이 표현식으로 이동합니다.

표현식에서 Kafka에서 지원하는 모든 함수를 사용할 수도 있습니다.

준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

열 이름 바꾸기

열 이름 바꾸기를 선택하고 다음을 클릭합니다.
변환 범위, 즉 이름을 바꿀 열을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 작업 및 데이터 집합에서 여러 열을 선택할 수 있습니다.

특정 데이터 유형으로 작업을 제한할 수도 있습니다. 데이터 유형에 관계없이 일치하는 모든 열에 대해 작업을 수행하려면 데이터 유형을 UNSPECIFIED로 설정합니다.

다음을 클릭합니다.

키인 열 또는 null을 허용하는 열로 범위를 제한할 수도 있습니다.
변환 작업을 설정합니다. 다음 작업을 수행할 수 있습니다.
- 열 이름을 고정 이름으로 바꿉니다.
- 접두사 또는 접미사를 추가합니다.
- 접두사 또는 접미사를 제거합니다.
- 접두사 또는 접미사를 바꿉니다.
- 열의 대/소문자를 소문자 또는 대문자로 변경합니다.
- 표현식을 사용하여 열 이름을 바꿉니다.
- 사전을 사용하여 열 이름을 바꿉니다.
  
  자세한 내용은 사전을 사용하여 데이터 집합 또는 열 이름 바꾸기을 참조하십시오.
준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

열 추가

열 추가를 선택하고 다음을 클릭합니다.
변환 범위, 즉 열을 추가할 데이터 집합을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 집합에 열을 추가할 수 있습니다.

다음을 클릭합니다.
새 열의 세부 정보를 설정합니다.
- 열 이름.
- 표현식 작성기를 사용하여 열의 값을 설정합니다.
- 이 열을 기본 키로 사용하려면 기본 키에 추가를 선택합니다.
- 대상 데이터 유형에서 데이터 유형을 설정합니다.
- 데이터 유형이 BYTES, STRING 또는 WSTRING인 경우 길이도 지정합니다.
  
  데이터 유형이 NUMERIC인 경우 정밀도 및 배율도 지정합니다.
준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

열 삭제

열 삭제를 선택하고 다음을 클릭합니다.
변환 범위, 즉 삭제할 열을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 자산 및 데이터 집합에서 여러 열을 선택할 수 있습니다.

특정 데이터 유형으로 작업을 제한할 수도 있습니다. 데이터 유형에 관계없이 일치하는 모든 열에 대해 작업을 수행하려면 데이터 유형을 UNSPECIFIED로 설정합니다.

다음을 클릭합니다.

키인 열 또는 null을 허용하는 열로 범위를 제한할 수도 있습니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

데이터 유형 변환

데이터 유형 변환을 선택하고 다음을 클릭합니다.
변환 범위, 즉 데이터 유형을 변환할 열을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 자산 및 데이터 집합에서 여러 열을 선택할 수 있습니다.

특정 데이터 유형으로 작업을 제한할 수도 있습니다. 데이터 유형에 관계없이 일치하는 모든 열에 대해 작업을 수행하려면 데이터 유형을 UNSPECIFIED로 설정합니다.

다음을 클릭합니다.

키인 열 또는 null을 허용하는 열로 범위를 제한할 수도 있습니다.
변환 작업을 설정합니다.
- 대상 데이터 유형을 변환할 데이터 유형으로 설정합니다.
- 데이터 유형이 BYTES, STRING 또는 WSTRING인 경우 길이도 지정합니다.
  
  데이터 유형이 NUMERIC인 경우 정밀도 및 배율도 지정합니다.
준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

관련 항목: 데이터 유형 관리

열 값 바꾸기

열 값 바꾸기를 선택하고 다음을 클릭합니다.
변환 범위, 즉 값을 바꿀 열을 설정합니다. %를 와일드카드 문자로 사용하여 하나 이상의 데이터 자산 및 데이터 집합에서 여러 열을 선택할 수 있습니다.

특정 데이터 유형으로 작업을 제한할 수도 있습니다. 데이터 유형에 관계없이 일치하는 모든 열에 대해 작업을 수행하려면 데이터 유형을 UNSPECIFIED로 설정합니다.

다음을 클릭합니다.

키인 열 또는 null을 허용하는 열로 범위를 제한할 수도 있습니다.
변환 작업을 설정합니다.
- 대상 값에서 대체 값을 정의하는 표현식을 설정합니다.
- 대상 데이터 유형을 바꾼 열의 데이터 유형으로 설정합니다.
- 데이터 유형이 BYTES, STRING 또는 WSTRING인 경우 길이도 지정합니다.
  
  데이터 유형이 NUMERIC인 경우 정밀도 및 배율도 지정합니다.
준비가 되면 다음을 클릭합니다.
규칙의 이름을 설정하고 마침을 클릭합니다.

사전을 사용하여 데이터 집합 또는 열 이름 바꾸기

사전을 사용하여 데이터 집합 또는 열의 이름을 바꿀 수 있습니다. 이는 복잡한 명명 규칙을 사용하는 많은 수의 개체로 작업할 때 유용합니다. 사전 편집기에서 번역을 추가하거나 번역이 포함된 CSV 파일을 가져올 수 있습니다. 사전을 CSV 파일로 내보내고 다른 데이터 자산에서 재사용할 수도 있습니다.

사전으로 이름 바꾸기는 데이터 집합 이름 바꾸기 또는 열 이름 바꾸기를 선택한 경우 변환 작업에서 사용할 수 있습니다. 을 클릭하여 사전 편집기를 엽니다.

번역 추가를 클릭하고 소스 이름과 번역된 이름을 입력하여 사전에 번역을 추가합니다.

필요한 번역을 만들었으면 확인을 클릭하여 사전 편집기를 닫습니다.

이름은 사전에 있는 소스 이름과 완전히 일치하는 경우에만 바뀝니다. 부분 일치는 지원되지 않습니다.

번역 가져오기

사전이 포함된 CSV 파일에서 번역을 가져올 수 있습니다. 파일에는 행당 하나의 번역이 포함되어야 합니다. 예:

sourcename1,translatedname1 sourcename2,translatedname2 sourcename3,translatedname3

CSV에서 추가를 클릭하고 가져올 CSV 파일을 선택합니다.

가져온 사전의 번역이 사전에 추가됩니다.

번역 내보내기

다른 데이터 자산에서 재사용할 수 있도록 사전을 CSV 파일로 내보낼 수 있습니다.

CSV로 내보내기를 클릭합니다.

사전을 CSV 파일로 내보냅니다.

표현식에 메타데이터 포함하기

식 편집기의 메타데이터 탭에는 변환 규칙의 표현식에서 사용할 수 있는 다음 변수가 포함되어 있습니다.

변환 규칙에서 사용할 수 있는 변수
변수	설명
$Q_D_열_데이터	소스 테이블의 열 값입니다.
$Q_M_열_이름	수정된 열 이름입니다.
$Q_M_데이터_유형_길이	열의 수정된 데이터 유형 길이입니다.
$Q_M_데이터_유형_이름	열의 수정된 데이터 유형입니다.
$Q_M_데이터유형_정밀도	열의 수정된 데이터 유형 전체 자릿수입니다.
$Q_M_데이터유형_스케일	열의 수정된 데이터 유형 배율입니다.
$Q_M_스키마_이름	소스 스키마의 이름입니다.
$Q_M_소스_열_이름	소스 테이블의 열 이름입니다.
$Q_M_소스_데이터유형_길이	소스 테이블에 있는 열의 데이터 유형 길이입니다.
소스 데이터 타입 이름	소스 테이블에 있는 열의 데이터 유형입니다.
$Q_M_SOURCE_DATATYPE_PRECISION	소스 테이블에 있는 열의 데이터 유형 precision입니다.
$Q_M_SOURCE_DATATYPE_SCALE	소스 테이블에 있는 열의 데이터 유형 배율입니다.
$Q_M_SOURCE_TABLE_NAME	소스 테이블의 이름입니다.
$Q_M_TABLE_NAME	소스 테이블의 수정된 이름입니다.

변환 범위에 있는 모든 테이블의 이름을 변경하여 다음 표현식을 사용하여 스키마 이름을 접두사로 추가할 수 있습니다.

${Q_M_SCHEMA_NAME}||'.'||${Q_M_SOURCE_TABLE_NAME}.

예를 들어, dwprod 스키마의 products 테이블 이름을 dwprod.products로 변경합니다.

규칙 관리

Rules 창에서 규칙을 관리할 수 있습니다.

규칙을 클릭합니다.

규칙을 활성화/비활성화하고, 규칙을 삭제하고, 규칙을 편집할 수 있습니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.