콘텐츠로 이동

외부 데이터베이스에 대한 SQL 쿼리 결과를 PlaidCloud 프로젝트 테이블로 가져옵니다. 쿼리는 원격 데이터베이스에서 실행되며 결과 집합만 PlaidCloud로 가져옵니다.

SQL을 직접 작성한다는 점에서 외부 데이터베이스 테이블 가져오기와 다릅니다. 데이터가 PlaidCloud에 적재되기 전에 원본 데이터베이스가 수행하도록 하려는 복잡한 조인, 필터, 집계에 유용합니다.

SQL 테이블 가져오기


데이터베이스 연결을 설정하려면 PlaidCloud 데이터 연결을 참조하십시오.

대상 테이블

뷰에는 기본 데이터가 없으므로 가져오기의 대상은 테이블로만 제한됩니다.

동적 옵션

동적 옵션을 사용하면 변수를 포함한 텍스트로 테이블을 지정할 수 있습니다. 지정한 변수에 따라 테이블 및 뷰 참조가 달라지는 변수 기반 워크플로를 사용할 때 유용합니다.

current_month 변수를 사용하여 대상 테이블을 동적으로 가리키는 예는 다음과 같습니다.

legal_entity/inputs/{current_month}/ledger_values

정적 옵션

가져오기의 대상으로 특정 테이블을 사용하려면 동적 체크박스를 선택하지 않은 상태로 두고 대상 테이블을 선택합니다.

대상 테이블이 없으면 새로 만들기 버튼을 선택하여 원하는 위치에 테이블을 만듭니다.

테이블 탐색기는 모든 테이블 선택에서 항상 사용할 수 있습니다. 테이블 선택 오른쪽의 테이블 탐색기 버튼을 클릭하면 테이블 탐색기 창이 열립니다.

이 섹션에 필요한 데이터를 반환하는 SQL 쿼리를 작성합니다.

미리 보기

소스 탭에서 미리 보기를 클릭하면 단계를 실행하지 않고 단계가 읽을 내용을 최대 100개 행까지 볼 수 있습니다. 결과가 더 길면 미리 보기에 처음 몇 개 행만 표시한다는 안내와 모든 행을 읽으려면 단계를 실행해야 한다는 안내가 나타납니다.

미리 보기는 실행할 때와 같은 방식으로 프로젝트 변수와 워크플로 변수를 채웁니다. {x:>9} 같은 변수 형식은 지원하지 않으며, 트리거 값처럼 실행 중에만 값이 있는 변수는 채울 수 없습니다.

미리 보기는 데이터만 읽습니다. 무언가를 변경할 수 있는 쿼리는 거부하고 행 대신 메시지를 표시합니다.

  • 미리 보기는 표준 SQL 함수만 지원합니다. 단계를 실행하여 결과를 확인하십시오. 쿼리가 미리 보기에서 읽기 전용임을 확인할 수 없는 함수를 사용합니다. 결과를 보려면 단계를 실행하십시오.
  • 단일 SELECT가 아닌 쿼리나, 변수가 확장되어 쓰기 문이 되는 쿼리는 거부됩니다.

미리 보기는 잠긴 프로젝트, SQL Server, Oracle 또는 SQLite 연결, Agent Remote Execution of SQL처럼 에이전트를 통해 실행되는 단계에서는 사용할 수 없습니다.

SQL 가져오기는 로드하는 동안 데이터 유형을 추측하거나 모든 열을 텍스트 유형으로 설정할 수 있습니다. 데이터가 깨끗하면 데이터 유형을 동적으로 설정하는 것이 더 빠를 수 있지만, 경우에 따라 문제가 생길 수 있습니다.

예를 들어 대부분의 데이터가 숫자로 보이지만 텍스트도 섞여 있으면 숫자로 설정하려고 시도하여 데이터 유형 불일치로 로드 문제가 발생할 수 있습니다. 16자리 숫자 제품 코드가 있는 경우에도 문제가 생길 수 있습니다. 앞쪽의 0이 잘려 16자리 코드 대신 숫자가 됩니다.

그러나 데이터를 모두 텍스트로 설정하면, 텍스트가 아니어야 하는 데이터 유형(날짜나 숫자 값 등)을 적절한 유형으로 변환하기 위해 이후에 추출 단계가 필요합니다.


증상 가능한 원인
쿼리, 연결, 데이터 볼륨에는 변화가 없는데도 단계가 평소보다 눈에 띄게 오래(최대 약 30분 더) 걸렸습니다 가져오기를 실행하는 백그라운드 워커가 도중에 중단되었으며(워크플로가 아니라 플랫폼 측의 재시작 또는 제거), 플랫폼이 해당 테이블의 가져오기를 대신 재시도했습니다. 재시도는 중단이 감지된 후에야 시작되므로 추가 시간이 소요됩니다.
그 지연 후에도 단계가 성공적으로 완료되었습니다 재시도는 테이블의 내용을 전부 교체하므로 결과는 한 번 깨끗하게 실행한 것과 같습니다. 추가로 확인하거나 다시 실행할 필요가 없습니다.
단계가 “has already been attempted and cannot be safely re-run”과 함께 실패합니다 SQL 가져오기 단계에서는 이 거부가 더 이상 발생하지 않으며, 실행 도중의 중단은 재시도됩니다. 프로젝트 아카이브 복원이나 차원 로드에서는 다시 실행하면 아무것도 교체하지 않고 중복을 만들기 때문에 의도적으로 계속 나타납니다. SQL 가져오기 단계 자체에서 이 메시지가 나타나면 지원 티켓을 여십시오.