SQL 변환 추가
마지막 업데이트: 2026-11-18변환 작업에 SQL 기반 테이블을 포함할 수 있습니다.SQL 변환을 사용하면 파이프라인에 SQL SELECT 쿼리를 입력하여 복잡하거나 간단한 변환을 정의할 수 있습니다.생성형 AI를 사용하여 SQL 도우미가 텍스트 프롬프트에서 쿼리를 생성하도록 할 수 있습니다.초기 로드 또는 증분 로드가 수행되는 경우 매크로를 사용하여 실행되도록 쿼리를 조정할 수도 있습니다.
변환에 SQL을 추가하기 전에 SQL 워크벤치를 사용하여 데이터를 탐색하고 읽기 전용 SQL을 검증할 수 있습니다.자세한 내용은 SQL Workbench를 사용한 데이터 탐색을(를) 참조하십시오.
변환 작업 만들기에 대한 자세한 내용은 데이터 변환을 참조하십시오.
SQL 변환 추가
변환 데이터 작업에 SQL 변환을 추가하려면 다음을 수행합니다.
-
변환에서 쿼리에 포함할 데이터 집합을 선택하고 SQL 변환 추가를 클릭합니다.
변환의 이름을 이름에 설정합니다.다른 설정에 대한 자세한 내용은 설정을(를) 참조하십시오.
SQL 변환을 만들 준비가 되면 추가를 클릭합니다.
SQL 변환 편집이 표시됩니다.
-
쿼리 창에 SQL 기반 테이블을 반환하는 쿼리를 작성합니다.
자세한 내용은 SQL 쿼리 편집을(를) 참조하십시오.
-
쿼리 실행을 클릭합니다.
이렇게 하면 메타데이터와 데이터 미리 보기를 가져옵니다.
-
매개변수에서 매개변수를 검토합니다.
자세한 내용은 매개 변수을(를) 참조하십시오.
-
메타데이터에서 기본 키를 설정합니다.
자세한 내용은 메타데이터을(를) 참조하십시오.
-
쿼리 결과에 만족하면 저장 후 닫기를 클릭합니다.이제 데이터 집합이 대상 목록에 추가되었으며 미리 볼 수 있습니다.
SQL 쿼리 편집
쿼리 창에 SQL 기반 테이블을 반환하는 쿼리를 입력합니다.쿼리는 선택한 소스 데이터 집합에서만 읽을 수 있지만 추가를 사용하면 더 많은 소스 데이터 집합을 추가할 수 있습니다.
-
데이터세트를 객체에서 로드하는 문을 생성할 수 있습니다.
를 클릭한 다음 SELECT 문 추가를 클릭합니다.
-
을(를) 클릭한 다음 복사를 클릭하여 데이터세트 이름을 클립보드에 복사할 수 있습니다.
-
데이터 세트 또는 열 이름을 편집기로 이동하려면 >을(를) 클릭합니다.
-
편집기에서 텍스트를 찾아 바꾸려면
를 클릭하세요.
증분 로드를 사용하는 경우 매크로를 사용하여 초기 로드 또는 증분 로드가 수행될 때 실행되도록 쿼리를 조정할 수 있습니다.
자세한 내용은 매크로를 사용하여 로드 유형에 맞게 쿼리 조정을(를) 참조하십시오.
키보드 바로 가기
-
Ctrl+F 검색 및 바꾸기
-
Ctrl+/ 현재 줄 주석 처리/주석 해제
-
Ctrl+Enter 쿼리 실행
-
Ctrl+Z 실행 취소
-
Ctrl+Y 다시 실행
결과 미리 보기
데이터 샘플을 사용하여 결과에서 결과를 미리 볼 수 있습니다.
데이터를 미리 보려면 다음 역할을 할당받아야 합니다.
-
연결이 있는 공간에서 데이터를 볼 수 있음 역할.
-
프로젝트가 있는 공간에서 볼 수 있음 역할.
데이터 샘플을 사용한 결과가 표시됩니다.행 수를 사용하여 샘플에 포함할 데이터 행 수를 설정할 수 있습니다.
-
마지막으로 실행된 쿼리를 클릭하여 마지막으로 실행된 쿼리의 마지막 실행 시간과 기간을 확인합니다.
결과 필터링
하나 이상의 열을 기준으로 결과를 필터링할 수 있습니다.
-
첫 번째 열에서 필터링할
을 클릭한 다음 필터를 클릭합니다.
사용할 연산자와 필터링할 값을 선택합니다.
필터 추가를 클릭하여 열 필터를 더 추가할 수 있습니다.
필터는 기존 샘플 데이터에만 영향을 미칩니다.
결과 정렬
특정 열을 기준으로 데이터 샘플을 정렬할 수 있습니다.
-
정렬할 열에서
을(를) 클릭한 다음 오름차순 정렬 또는 내림차순 정렬을(를) 클릭합니다.
정렬은 기존 샘플 데이터에만 영향을 미칩니다.을 사용하여 2024년 주문만 포함하고 역순으로 정렬한 경우 샘플 데이터에는 여전히 2024년 주문만 포함됩니다.
표시된 열 관리
결과에서 표시할 열을 선택할 수 있습니다.선택 항목은 변환을 저장할 때 저장되지 않습니다.
-
열에서
을(를) 클릭한 다음 열 숨기기를 클릭하여 열을 숨깁니다.
-
임의의 열에서
을(를) 클릭한 다음 표시된 열을 클릭하여 모든 열의 표시를 관리합니다.
매개 변수
SELECT 쿼리에서 매개 변수를 변경하려면 매개 변수를 클릭합니다.매개 변수는 소스 또는 대상 개체에 매핑되어야 합니다.
다음과 같은 경우 매개 변수가 자동으로 매핑됩니다.
-
개체에서 SELECT 문 추가를 사용합니다.
-
데이터 세트 또는 열 이름을 편집기로 이동하려면 >을(를) 클릭합니다.
-
매개 변수 이름이 개체의 테이블에 있는 테이블 이름과 일치합니다.
다음으로 매핑할 수 있습니다.
-
기록 유형 2 구조(_history)
-
현재 구조
-
대상 개체
증분 매크로 내에 매개 변수가 정의된 경우에만 대상 개체를 매핑할 수 있습니다.
메타데이터
메타데이터에서 메타데이터 설정을 편집할 수 있습니다.
-
키 열에 기본 키를 설정합니다.
키 제안 및 검증을 클릭하여 적절한 기본 키 제안을 받고 키를 검증할 수 있습니다.
-
Null 허용 열에서 해당 열이 Null을 허용하는지 여부를 설정합니다.
-
열을 선택하고 편집을 클릭하여 열 이름, 키, Null 허용 및 데이터 유형을 설정합니다.
기본 키를 변경할 때 다음 변환으로 데이터를 로드하기 전에 쿼리가 새 키에 대한 복제 값을 반환하지 않는지 확인하십시오.중복 키 처리는 대상 플랫폼에 따라 다릅니다.Snowflake는 기본적으로 복제 기본 키 값을 확인하지 않습니다.쿼리가 성공하여 복제 키 값을 가진 행을 로드할 수 있으며, 이로 인해 정의되지 않은 결과가 생성될 수 있습니다.일부 대상 플랫폼에서 데이터를 로드하지 못할 수 있습니다.
SELECT DISTINCT은(는) 선택한 모든 열에서 동일한 행을 제거하며, 다른 열에서 행이 다른 경우 새 키가 고유함을 보장하지는 않습니다.키당 하나의 행을 생성하려면 새 키로 그룹화하고 필요에 따라 나머지 열을 집계하세요.
키 제안 및 검증
키 제안 및 검증을 클릭하여 적절한 기본 키에 대한 제안을 받고 키를 검증할 수 있습니다.전체 SQL 쿼리가 적어도 한 번은 실행되었어야 합니다.
-
교차 리전 추론에 옵트인한 경우 GenAI가 키를 추천하는 데 사용됩니다.이를 통해 Qlik Cloud는 테넌트 지역 외부로 추론 요청을 보낼 수 있습니다.추론 처리 위치에 대한 세부 정보 및 최신 정보는 지역 간 추론 활성화을 참조하십시오.
정보 메모Qlik은 생성된 출력을 제어하지 않습니다.GenAI의 특성상 응답을 검토하거나 편집하지 않으면 요구 사항을 충족하는 SQL이 생성되지 않을 수 있습니다.생성된 쿼리는 Qlik 고객 계약 조건에 따라 "콘텐츠"로 간주됩니다.Qlik Cloud 정부 메모Qlik Cloud 정부에서는 GenAI 지원 키 제안을 사용할 수 없습니다.
GenAI가 활성화되지 않은 경우, 소스 테이블 데이터를 기반으로 키가 프로그래밍 방식으로 제안됩니다.
-
검증은 GenAI를 사용하지 않고 중복이나 NULL 값이 없는지 확인하는 SQL 쿼리를 실행하여 항상 수행됩니다.
정보 메모유효성 검사는 쿼리가 데이터를 반환한 경우에만 사용할 수 있습니다.
-
키 제안 및 유효성 검사
이를 통해 쿼리 및 소스 테이블 키를 검토하고 유효한 기본 키를 제안합니다.이 작업은 시간이 어느 정도 소요될 수 있습니다.
-
키 검증
이 작업은 기존 기본 키를 검증하여 해당 키가 고유하고 NULL이 아닌지 확인합니다.이 작업은 시간이 어느 정도 소요될 수 있습니다.
-
검증 없이 제안
이 작업은 쿼리 및 소스 테이블 키를 검토하고 검증 없이 기본 키를 제안합니다.키를 적용하기 전에 수동으로 검토하고 검증하세요.
쿼리 실행
개발 중 언제든지 쿼리 실행을 클릭하여 쿼리를 실행할 수 있습니다.쿼리를 처음 실행하면 메타데이터가 검색됩니다.쿼리가 실행되면 메타데이터로 이동하여 기본 키를 설정할 수 있습니다. 이는 변환을 완료하는 데 필요합니다.
매크로를 사용하여 로드 유형에 맞게 쿼리 조정
증분 로드를 사용하는 경우 매크로를 사용하여 초기 로드 또는 증분 로드가 수행될 때 실행되도록 쿼리를 조정할 수 있습니다.
매크로를 선택하고 해당 절 안에 쿼리를 추가합니다.
-
Q_RUN_INCREMENTAL은 증분 로드가 수행될 때만 실행되는 쿼리를 배치할 수 있는 절을 추가합니다.
-
Q_RUN_INITIAL_LOAD는 초기 로드가 수행될 때만 실행되는 쿼리를 배치할 수 있는 절을 추가합니다.
각 매크로에 전체 쿼리를 지정할 필요는 없습니다.사용 사례에 따라 코드를 조정하거나 추가할 수 있습니다.
사용 사례: 날짜 범위를 사용하는 증분 필터:
이 사용 사례에서는 주문 데이터 집합을 사용자 지정 SQL로 변환해야 합니다.이는 대규모 데이터 집합이므로 증분 로드가 지난 12시간 동안의 주문만 고려하도록 증분 필터링을 포함하려고 합니다.
기본 쿼리는 다음과 같습니다.
이는 지난 12시간 동안 추가된 주문만 고려하는 증분 실행 중에 적용할 필터입니다.
이는 필터 매크로를 사용하고 테이블 이름을 ${TABLE} 표기법으로 바꾼 전체 쿼리입니다.
이는 초기 로드 쿼리가 됩니다.
증분 로드 쿼리는 다음과 같습니다.
사용 사례: 대상의 데이터를 사용하는 증분 필터:
이 사용 사례에서는 주문 데이터 집합을 사용자 지정 SQL로 변환해야 합니다.주문은 대규모 데이터 집합이므로 증분 로드가 대상 테이블의 데이터보다 최신인 주문 세부 정보 레코드만 고려하도록 증분 필터링을 포함하려고 합니다.또한 행이 초기 로드 또는 증분 로드에 의해 처리되었는지 표시하려고 합니다.
기본 쿼리는 다음과 같습니다.
이는 증분 실행 중에 적용할 필터입니다."ORDERS_DERIVED"는 대상 데이터 집합의 이름입니다.
이는 필터 매크로를 사용하고 테이블 이름을 ${TABLE} 표기법으로 바꾼 전체 쿼리입니다.로드가 초기인 경우 LOADED_BY은(는) INIT로 설정되고, 증분인 경우 INCR로 설정됩니다:
이는 초기 로드 쿼리가 됩니다.
증분 로드 쿼리는 다음과 같습니다.
설정
SQL 변환 설정을 편집하려면 을(를) 클릭합니다.
이름에 대상 데이터 집합의 이름을 입력합니다.
설명에 더 긴 설명을 추가할 수도 있습니다.
구체화에서 변환된 출력을 구체화할지 여부를 선택합니다. 데이터 작업 설정에서 설정을 상속하도록 선택할 수 있습니다.
-
켜기는 테이블을 만들고 관련 ELT 처리를 처리합니다.
-
끄기를 선택하면 즉시 변환을 수행하는 보기가 만들어집니다.
기록 데이터 저장소(유형 2)에서 기록 데이터를 보관할지 여부를 선택합니다. 데이터 작업 설정에서 설정을 상속하도록 선택할 수 있습니다. 이 설정을 사용하려면 실체화가 켜져 있어야 합니다.
증분 로드를 사용하면 매크로를 사용하여 처리되는 데이터 집합을 줄이기 위해 필터나 기타 조건을 적용하여 증분 데이터 로드에 대한 쿼리를 조정할 수 있습니다. 증분 로드는 데이터가 테이블로 구체화된 경우에만 사용할 수 있습니다.
-
증분 로드가 켜기인 경우
작업을 처음 실행하면 초기 로드가 수행되어 쿼리의 모든 결과가 대상 테이블에 삽입됩니다. 후속 실행에서는 증분 처리를 위해 정의한 필터 또는 특정 조건을 활용하여 증분 로드를 실행합니다. 증분 로드 중에 작업은 데이터를 업데이트 또는 삽입으로만 처리하며 삭제는 관리되지 않습니다.
-
증분 로드가 끄기인 경우
작업을 처음 실행하면 초기 로드가 수행되어 쿼리의 모든 결과가 대상 테이블에 삽입됩니다. 후속 실행에서는 대상 테이블과 비교하고 신규, 변경 또는 삭제된 레코드를 처리하여 쿼리의 모든 결과를 처리합니다.
모범 사례
-
SQL 변환을 추가하면 기본 키가 자동으로 정의되지 않습니다.데이터 집합 탭에서 데이터 집합에 키를 추가합니다.
-
변환된 출력에 열 헤더를 수동으로 만들지 마십시오.
-
쿼리가 실행될 때마다 다른 열을 반환할 수 있으므로 *와 함께 SELECT를 사용하지 마십시오.스키마가 변경된 경우 그에 따라 쿼리를 변경하고 Describe table을 다시 수행합니다.그런 다음 열을 편집하고 테이블을 조정할 수 있습니다.