콘텐츠로 이동

일치 키로 지정한 하나 이상의 열을 기준으로 삽입과 업데이트를 하나의 작업으로 결합합니다. 소스의 각 행에 대해 대상에 일치하는 행(키 값이 같은 행)이 있으면 업데이트하고, 없으면 새 행을 삽입합니다.

신규 레코드와 기존 레코드의 수정 사항이 모두 포함된 증분 데이터 스트림(판매 업데이트, 직원 레코드 변경 등 “항상 최신 상태를 반영”해야 하는 시나리오)이 있을 때 사용하십시오. 일치 열은 신중하게 지정하십시오. 키 값은 같지만 다른 값이 다른 행은 덮어쓰이므로, 키를 잘못 선택하면 데이터가 조용히 손상될 수 있습니다.

대상(기존)id 1 · Aid 2 · B소스(증분)id 2 · B′id 3 · Cid로 일치결과id 1 · A유지됨id 2 · B′업데이트됨id 3 · C삽입됨
업서트는 일치 키를 기준으로 소스를 대상에 병합합니다. 기존 키는 업데이트되고(id 2 → B′), 새 키는 삽입됩니다(id 3). 키를 신중하게 선택하십시오. 키를 공유하는 행은 덮어쓰입니다.

소스와 대상

소스 테이블과 대상 테이블을 설정하려면 먼저 소스 테이블 드롭다운 메뉴에서 추출할 데이터 테이블을 선택합니다. 다음으로 대상 테이블 드롭다운에서 기존 테이블을 대상 테이블로 선택합니다.

단계 실행 시

Table Extract, Table Lookup, Table Inner Join, Table Cross Join, Table Outer Join, Table Anti Join, 다중 테이블 조인, Table Union Distinct, Table Union All, Table Pivot, Table Melt, Table In-Place Delete, Table Upsert, Table Append 단계는 실행할 때 아무것도 기록하기 전에 소스 테이블을 검사합니다. 이 검사는 단계가 만든 쿼리를 그 시점의 각 소스 테이블과 비교합니다.

  • 단계가 읽는 열이 테이블에 없거나, 조인 키가 테이블에 없거나 단계의 소스 열에 없거나, 단계가 읽는 소스 테이블이 아직 만들어지지 않았으면 단계가 중지됩니다. 하나의 오류가 모든 문제를 각각의 해결 방법과 함께 알려 줍니다. 이미 있던 대상 테이블은 그대로 유지되고, 단계가 새로 만들어야 했던 대상 테이블은 비어 있는 상태로 남습니다.
  • 단계가 나열했지만 읽지 않는 열이 테이블에 더 이상 없으면 경고가 추가됩니다. 단계는 해당 열 없이 실행됩니다.
  • Table Union Distinct와 Table Union All 단계는 아직 만들어지지 않은 소스 테이블에 대해서는 예외입니다. 이전과 마찬가지로 해당 테이블을 경고 없이 제외하고 나머지를 합칩니다. 소스 테이블이 하나도 만들어지지 않았으면 실패하는 대신 경고와 함께 종료됩니다.

대상이 뷰인 단계는 뷰만 만들기 때문에, 단계가 나열한 열과 조인 키는 웨어하우스가 어차피 해당 뷰 만들기를 거부하는 경우에만 테이블과 대조하여 검사합니다. 그 외의 경우에는 아직 만들어지지 않은 소스 테이블이나 단계에 나열되지 않은 조인 키만 단계를 중지시키며, 경고는 추가되지 않습니다.

가능한 경우 오류에는 테이블을 만드는 단계의 이름이 표시되며, 누락된 열과 이름이 비슷한 열(예: 대소문자만 다른 열)이 테이블에 있으면 그 열의 이름도 표시됩니다.

Table Upsert

데이터 매퍼는 소스 데이터의 열을 대상 데이터 테이블에 매핑하는 데 사용합니다.

소스 검사 메뉴 버튼을 사용하면 소스에서 대상으로 열을 매핑하는 추가 방법을 사용할 수 있습니다.

  • 두 매핑 테이블 모두 채우기: 소스 데이터 테이블의 모든 값을 대상 데이터 테이블로 전파합니다. 기본적으로 이렇게 수행됩니다.
  • 소스 매핑 테이블만 채우기: 소스 데이터 테이블의 모든 값만 매핑합니다. 소스 열 구조가 변경되었을 때 기존 워크플로를 수정하는 경우에 유용합니다.
  • 대상 매핑 테이블만 채우기: 모든 값을 대상 데이터 테이블에만 전파합니다.

소스 및 대상 열 옵션으로 충분하지 않으면 다른 열을 여러 방법으로 대상 데이터 테이블에 추가할 수 있습니다.

  • 모두 전파는 이미 있는지 여부와 관계없이 모든 소스 열을 대상 데이터 테이블에 삽입합니다.
  • 선택 항목 전파는 선택한 소스 열만 삽입합니다.
  • 대상 쪽에서 마우스 오른쪽 버튼을 클릭하고 행 삽입을 선택하면 현재 선택한 행 바로 위에 행이 삽입됩니다.
  • 대상 쪽에서 마우스 오른쪽 버튼을 클릭하고 행 추가를 선택하면 대상 데이터 테이블의 맨 아래(맨 오른쪽)에 행이 삽입됩니다.

대상 데이터 테이블에서 열을 삭제하려면 원하는 열을 선택한 다음 마우스 오른쪽 버튼을 클릭하고 삭제를 선택합니다.

대상 데이터 테이블에서 열을 재정렬하려면 원하는 열을 선택합니다. 다음 중 하나를 사용할 수 있습니다.

  • 일괄 이동 화살표: 오른쪽 위의 화살표에서 원하는 이동 옵션을 선택합니다.
  • 컨텍스트 메뉴: 마우스 오른쪽 버튼을 클릭하고 맨 위로 이동, 위로 이동, 아래로 이동 또는 맨 아래로 이동을 선택합니다.

결과를 고유한 레코드로만 줄이기

섹션 제목: “결과를 고유한 레코드로만 줄이기”

고유한 옵션만 반환하려면 고유 메뉴 옵션을 선택합니다. 그러면 소스의 각 열에 대한 확인란 집합이 전환됩니다. 해당 열 옆의 확인란을 선택하면 해당 열 기준으로 고유한 결과만 반환됩니다.

상황에 따라 요약 사용을 대신 고려할 수도 있습니다.

고유 처리는 처음 발견한 고유 레코드를 유지하고 나머지는 버립니다. 실행 간 일관성이 중요하다면 데이터에 정렬을 적용하는 것이 좋습니다.

대상 열 그리드에는 대상 열 이름 바로 다음에 업데이트 키 열이 있습니다. 행을 함께 식별하는 열에 이 항목을 선택하십시오. 키 값이 대상에 이미 있는 행과 일치하는 소스 행은 해당 행을 업데이트하고, 그 밖의 소스 행은 삽입됩니다.

모든 열은 처음에 선택되어 있으므로, 키에 속하지 않는 열은 선택을 해제하십시오. 업데이트 키 설정이 없는 열(채우기로 방금 추가된 열이나 API로 설정 없이 저장된 열)은 키로 간주됩니다. 적어도 하나의 열은 선택된 상태로 남아 있어야 합니다.

업서트는 대상 테이블의 현재 상태 그대로 행을 업데이트하고 삽입하며 테이블에 열을 추가하지 않으므로, 테이블에 없는 대상 열이 있으면 실행이 실패합니다. 단계가 열릴 때와 다른 대상 테이블을 선택할 때마다 양식은 대상 테이블의 열을 읽으며, 이때 테이블 이름에 포함된 변수는 워크플로의 변수 값으로 채웁니다. 테이블에 없는 각 대상 열은 ⚠ 경고 표시 뒤에 빨간색으로 표시되며, 마우스를 올리면 열 “region”이(가) 대상 테이블에 없습니다. 메시지가 나타납니다. 이름은 대소문자를 구분하지 않고 비교하므로 Region과 region은 일치합니다. 소스 열 목록에 더 이상 없는 소스 열(예: 소스를 다시 검사한 후)에도 같은 표시가 나타나며, 이때는 열 “region”이(가) 소스 열에 없습니다. 메시지가 나타납니다.

대상 테이블이 아직 없는 동안에는 실행 시 매핑에 따라 테이블이 만들어지므로 아무것도 표시되지 않으며, 테이블의 열을 읽을 수 없는 동안에도 아무것도 표시되지 않습니다. 매핑에서 생략한 테이블 열은 표시되지 않지만, 저장할 때 검사하는 항목에서 설명한 대로 서버는 여전히 단계 저장을 거부합니다.

이렇게 표시된 대상 열이 있는 단계를 저장하면 오래된 열 발견 대화 상자는 다음 행은 단계에서 사용할 수 없는 열을 지정합니다: 문구 다음에 표시된 행을 열 제목 아래에 나열하고, 대상 테이블에 없는 열을 테이블에 추가하거나 해당 행을 제거할 때까지 단계를 저장할 수 없습니다. 문구로 끝납니다. 다음 두 가지 선택지가 있습니다.

  • 모두 제거 후 저장 — 표시된 행을 모두 제거하여 해당 열을 더 이상 로드하지 않도록 한 다음 저장합니다.
  • 취소 — 저장하지 않고 단계로 돌아갑니다.

서버는 기존 대상 테이블에 없는 열을 지정하는 매핑의 저장을 거부하므로 그대로 저장은 제공되지 않습니다. 행을 유지하려면 해당 열을 대상 테이블에 추가한 다음 단계를 다시 저장하십시오. 단, {year}/Customers처럼 변수로 이름을 지정한 대상 테이블은 예외입니다. 서버가 이 검사를 실행 시점으로 미루므로 대화 상자에 여전히 그대로 저장이 제공됩니다. 행이 소스 열 때문에만 표시된 경우에는 대화 상자에 모두 제거 후 저장, 그대로 저장, 취소가 제공됩니다.

Table Data Filters

최대한의 유연성을 위해 데이터 필터는 소스 데이터와 대상 데이터 모두에서 사용할 수 있습니다. 대용량 데이터 세트에서는 소스에서 행을 먼저 걸러내어 나머지 작업을 더 작은 데이터 세트에서 수행하는 것이 특히 유용할 수 있습니다.

데이터 하위 집합 선택

이 필터 유형은 지정한 조건에 따라 들어오는 소스 데이터를 필터링합니다.

결과 데이터에 보조 필터 적용

이 필터 유형은 지정한 조건에 따라 변환된 후의 결과 데이터에 필터를 적용합니다. 변환 후 결과에 필터를 적용할 수 있으므로 복잡한 계산, 요약 또는 윈도우 함수의 결과를 기준으로 제외할 수 있습니다.

최종 데이터 테이블 분할(제한)

행 분할 기능을 사용하면 범위와 시작 지점에 따라 결과 집합의 행 수를 제한할 수 있습니다.

필터 구문

필터 구문은 다른 식과 동일한 구문인 Python SQLAlchemy를 사용합니다.

예제와 식 함수는 식 영역에서 확인하십시오.

  • 업데이트 키가 하나 이상 있어야 합니다. 그렇지 않으면 저장이 거부되며 *At least one target column must be marked as Update Key.*라는 메시지가 표시됩니다.
  • 매핑이 기존 대상 테이블과 일치해야 합니다. 대상 테이블이 이미 있으면, 단계는 테이블의 모든 열을 매핑해야 하고, 테이블에 없는 열은 매핑하지 않아야 하며, 각 열에 테이블의 형식을 지정해야 합니다. 이는 업서트가 테이블 열을 데이터와 함께 삭제하거나 열의 형식을 변경하지 못하도록 하기 위한 것입니다. 숫자와 통화는 같은 형식으로 간주됩니다. 거부 메시지에는 각 차이점이 표시됩니다. 예: The target columns must match the existing target table ‘customers’. The table has columns the step doesn’t map: region. 아직 없는 대상 테이블이나 변수로 이름을 지정한 대상 테이블은 단계를 실행할 때 검사합니다. 저장하기 전에 열 탭에 테이블에 없는 열이 표시되며, 대상 테이블 이름을 변수로 지정하지 않았다면 저장할 때 해당 행을 제거하는 선택지만 제공됩니다. 대상 테이블에 없는 대상 열을 참조하십시오.
  • 빈 매핑은 자동으로 채워집니다. 소스 테이블은 선택했지만 소스 열이나 대상 열이 없는 상태로 저장하면, 두 매핑 테이블 모두 채우기를 실행한 것처럼 소스에서 빈 쪽을 채웁니다.