테이블 및 뷰 관리
PlaidCloud에서는 레이블을 포함하여 테이블을 정리하고 관리할 수 있습니다. 테이블은 프로젝트 내 모든 워크플로에서 사용할 수 있으며 다양한 도구와 옵션을 제공합니다.
PlaidCloud는 테이블 외에도 테이블 데이터를 기반으로 하는 뷰를 제공합니다. 뷰를 사용하면 기반 테이블이 변경될 때 즉시 업데이트되며 데이터 스토리지 공간도 절약할 수 있습니다.
옵션은 다음과 같습니다.
- 같은 테이블이 계층의 여러 경로에 존재할 수 있습니다(대체 계층).
- 테이블에 태그를 지정하면 PlaidCloud 프로세스에서 더 쉽게 검색하고 포함할 수 있습니다.
- 테이블은 버전을 관리할 수 있습니다.
- 테이블을 게시하면 대시보드 시각화에서 사용할 수 있습니다.
PlaidCloud는 폴더 계열을 탐색하듯이 경로 기반 시스템으로 테이블을 정리하므로, 테이블을 더 유연하고 논리적으로 정리할 수 있습니다. 이 시스템에서는 테이블을 계층 안에서 이동할 수 있으며, 하나의 테이블을 계층의 여러 위치에서 참조(대체 계층)하도록 만들 수도 있습니다. 이 방식으로 테이블을 관리하면 구조에 운영, 보고, 통제의 요구 사항을 반영할 수 있습니다.
테이블 찾기
섹션 제목: “테이블 찾기”목록 하단의 행 수 옆에 있는 필터를 사용하여 테이블 이름과 레이블을 검색합니다. / 또는 Ctrl/Cmd+F를 누르면 바로 이동합니다. 같은 필터가 트리와 평면 목록에 모두 적용됩니다. 필터 옆의 모두 | 게시됨 스위치는 목록을 게시된 테이블로 좁힙니다. 기본값은 모두이며 트리와 평면 목록 모두에 적용됩니다.
워크플로별
섹션 제목: “워크플로별”테이블 탭 끝에 있는 워크플로별 폴더는 테이블을 읽거나 쓰는 각 워크플로 아래에 테이블을 그룹화합니다. 워크플로를 열면 해당 테이블이 표시됩니다. 이 폴더는 같은 테이블의 한 가지 보기이므로 여기에서 항목을 이동하거나 복사할 수 없습니다.
테이블 탭의 도구 모음에서 열 찾기를 선택하면 특정 이름의 열이 있는 테이블을 찾을 수 있습니다. 검색은 데이터가 아니라 열 이름을 읽으므로 빠르며, 빌드된 테이블만 찾습니다. 프로젝트를 연 이후 해당 프로젝트에서 검색을 실행한 적이 있으면 창이 마지막으로 실행한 검색 상태로 열립니다.
두 글자 이상을 입력하면 입력하는 동안 결과가 업데이트되며, Enter를 눌러 바로 검색할 수도 있습니다. 입력한 내용의 결과가 표시되어 있을 때 검색 상자에서 Enter를 누르면 행에서처럼 강조 표시된 테이블이 선택됩니다. 이름을 일치시키는 방식을 선택합니다.
- 정확히 일치 — 대소문자를 무시하고 열 이름 전체와 일치합니다
- 포함 — 대소문자를 무시하고 열 이름의 일부와 일치합니다. 기본값입니다.
- 유사 — 대소문자, 공백, 밑줄 및 기타 구분 기호를 무시하고 작은 오타를 허용하여 비슷한 이름과 일치합니다. 가장 가까운 일치 항목이 먼저 표시됩니다.
창은 해당 브라우저에서 마지막으로 선택한 일치 방식을 기억합니다. 검색 상자가 비어 있는 동안에는 해당 브라우저에서 해당 프로젝트의 최근 검색 다섯 개가 나열되며, 하나를 선택하면 다시 실행됩니다. 검색은 Enter를 누르거나, 목록에서 선택하거나, 결과에서 동작을 실행하면 실행된 것으로 간주되어 목록에 추가됩니다.
일치하는 각 테이블은 이름, 경로, 처음 세 개의 일치하는 열과 함께 한 행으로 표시됩니다. 결과 위의 줄에는 검색이 실행되는 동안 지금까지 찾은 테이블 수가 표시됩니다. 정확히 일치 또는 포함으로 일치하는 항목이 없으면 유사 모드를 시도해 보시겠습니까? 를 선택하여 유사로 다시 검색합니다. 검색이 실패하거나 일찍 중지되면 다시 시도를 선택합니다. 일부 테이블의 열을 읽지 못한 경우 결과가 불완전할 수 있다고 표시됩니다.
결과에 열 이름이 둘 이상 포함되면 목록 위의 칩이 가장 흔한 열 이름부터 최대 12개의 열 이름과 그 열이 있는 테이블 수를 보여 줍니다. 칩을 선택하면 해당 열이 있는 테이블만 나열되고, 다시 선택하면 모두 나열됩니다.
행을 펼치면 다음을 볼 수 있습니다.
- 일치한 열 — 일치하는 각 열과, 텍스트, 정수, 숫자, 날짜, 타임스탬프 또는 부울인 경우 그 유형. 경고 색상으로 표시된 열은 결과의 다른 테이블에서 유형이 다릅니다. 마우스를 올리면 유형을 볼 수 있습니다.
- 공급 원본 — 이 테이블에 쓰는 단계가 읽는 테이블, 각각 단계 이름과 함께 표시
- 공급 대상 — 이 테이블을 읽는 단계가 쓰는 테이블, 각각 단계 이름과 함께 표시
같은 프로젝트의 단계만 나열됩니다.
결과에서 작업하려면 다음을 사용합니다.
- 행을 두 번 클릭하거나 행에서 Enter를 누르면 창이 닫히고 테이블 탭에서 해당 테이블이 선택됩니다. 트리에 표시된 열 검색이나 모두 | 게시됨 스위치 때문에 테이블이 숨겨져 있으면 해당 설정이 해제되고 메시지로 알려 줍니다. Ctrl+Enter(Mac에서는 Cmd+Enter)를 누르면 대신 테이블 탐색기에서 테이블을 엽니다. 검색 상자에서 위쪽 및 아래쪽 화살표 키로 행 사이를 이동합니다.
- 트리에서 보기를 선택하면 트리와 평면 목록이 결과의 테이블 또는 선택한 칩의 테이블로 좁혀지고, 그 테이블이 들어 있는 트리의 폴더가 열립니다. 목록 위의 칩이 검색 이름과 테이블 수를 보여 줍니다. 칩을 선택하면 검색을 다시 열고, 칩의 ×를 선택하면 모든 테이블이 표시됩니다. 테이블 탭을 새로 고치면 검색이 다시 실행됩니다.
- 복사를 선택하면 나열된 테이블을 한 줄에 하나씩 복사하며, 각 테이블의 이름, 경로, 일치하는 열과 그 유형이 탭으로 구분됩니다.
트리에서 보기와 복사는 검색이 끝나고 테이블이 하나 이상 있으면 사용할 수 있습니다.
MCP로 연결된 AI 어시스턴트는 table_find(column=...)로 같은 테이블을 찾습니다. 이름 전체, 일부, 시작 또는 끝과 일치시키거나 column_match='fuzzy'로 비슷한 이름과 일치시킬 수 있으며, 일치하는 열의 유형과 유사 일치의 경우 가장 가까운 열이 얼마나 가까운지도 반환합니다.
값 검색
섹션 제목: “값 검색”어떤 테이블에 특정 값이 있는지 찾으려면 테이블 탭의 작업 메뉴에서 데이터에서 값 검색… (느림) 을 선택합니다. 또는 테이블을 마우스 오른쪽 버튼으로 클릭하고 이 옵션을 선택하면 해당 테이블에서만 찾습니다. 값을 입력하고, 값의 일부와 일치시키려면 포함을 선택한 다음 검색을 선택합니다. 값이 있는 각 테이블이 값이 나타나는 열과 일치하는 값 몇 개와 함께 나열됩니다. 테이블을 두 번 클릭하거나 Enter를 누르면 테이블 탐색기에서 열립니다. 열을 선택하면 일치하는 행으로 필터링된 테이블이 열립니다.
검색하기 전에 다음 사항을 알아 두십시오.
- 검색은 검색 대상인 모든 테이블의 모든 행을 읽으므로 매우 느릴 수 있고 웨어하우스 리소스를 많이 사용할 수 있습니다. 창에서 이를 경고하며 검색이 끝날 때까지 검색 버튼이 꺼져 있습니다.
- 이미 열 수 있는 행만 표시됩니다. 행 수준 보안은 모든 검색에 적용됩니다.
- 웨어하우스의 쿼리 기록에는 검색한 값이 기록됩니다.
- 검색은 테이블의 텍스트 열을 대상으로 합니다. 아직 빌드되지 않은 테이블은 건너뛰며 경고에 이름이 표시됩니다.
- 결과는 페이지 단위로 제공됩니다. 상태 표시줄에 검색이 일찍 중단되었다고 표시되면 더 검색을 선택하여 아직 검색하지 않은 테이블을 계속 검색합니다.
MCP로 연결된 AI 어시스턴트는 table_value_search를 사용합니다. 이 도구는 값이 들어 있는 테이블과 열을 반환하며 값 자체는 반환하지 않습니다. 프로젝트에서 AI 어시스턴트에게 값을 찾도록 요청하면 Weave가 일치하는 테이블과 열의 이름을 언어 모델 제공업체에 전송합니다.
CSV 파일 가져오기
섹션 제목: “CSV 파일 가져오기”CSV 파일을 이 프로젝트의 새 테이블로 만들려면 다음과 같이 합니다.
- 컴퓨터에서 파일을 프로젝트의 테이블 목록으로 끌어다 놓거나, 도구 모음에서 새로 만들기 > CSV 파일에서 테이블 만들기를 선택하고 상자에 파일을 놓거나 CSV 파일 선택을 클릭합니다.
- PlaidCloud가 파일을 Personal Temp Drive에 업로드합니다. 없으면 워크스페이스의 Temp Drive에 업로드하고, 목록 최상위에 파일 이름을 딴 새 테이블로 가져옵니다.
Sales Data.csv는sales_data가 됩니다. 프로젝트에 이미 같은 이름의 테이블이 있으면 새 테이블에는sales_data_2와 같이 번호가 붙습니다. - 목록이 새로 고쳐지면서 새 테이블이 선택되고 데이터 한눈에 보기가 해당 테이블에서 열립니다. 패널에 표시되는 내용은 내 CSV로 시작하기를 참조하십시오.
.csv로 끝나는 파일만 허용됩니다. 테이블을 만들 권한과 문서 스토리지에 쓸 권한이 필요하며, 잠긴 프로젝트는 잠금을 해제하기 전까지 CSV를 받지 않습니다. 가져오기가 실패하면 창에 이유가 표시되고 프로젝트는 이전 상태 그대로 유지됩니다. PlaidCloud는 가져오기가 끝나면 성공 여부와 관계없이 업로드된 파일을 임시 드라이브에서 삭제하며, 삭제하지 못한 경우 임시 드라이브가 하루 후에 삭제합니다.
테이블을 이동하려면 다음과 같이 합니다.
- 테이블을 배치할 폴더로 끌어다 놓습니다.
테이블을 프로젝트의 최상위로 이동하려면 마지막 행 아래의 빈 공간으로 끌어다 놓습니다. 폴더 선택기에서 /는 프로젝트의 최상위입니다.
이름 바꾸기
섹션 제목: “이름 바꾸기”테이블의 이름을 바꾸려면 다음과 같이 합니다.
- 테이블을 마우스 오른쪽 버튼으로 클릭합니다.
- 이름 바꾸기 옵션을 선택합니다.
- 새 이름을 입력하고 저장합니다.
- 테이블의 이름이 바뀌지만 원래의 고유 식별자는 그대로 유지됩니다.
지우기
섹션 제목: “지우기”테이블을 지우려면 다음과 같이 합니다.
- 계층에서 테이블을 선택합니다. ‘
- 상단 도구 모음에서 지우기 버튼을 클릭합니다.
참고: 테이블 하나 또는 여러 테이블을 지울 수 있습니다.
테이블을 삭제하려면 다음과 같이 합니다.
- 계층에서 테이블을 선택합니다.
- 상단 도구 모음에서 삭제 버튼을 클릭합니다.
- 삭제 작업은 테이블이 워크플로 단계나 뷰에서 사용 중인지 확인합니다. 사용 중이면 삭제하기 전에 해당 연결을 제거하라는 안내가 표시됩니다.
참고: 테이블을 강제로 삭제할 수도 있습니다. 강제 삭제하면 참조가 끊어진 채로 남으므로 꼭 필요한 경우에만 사용하십시오.
마지막 읽기
섹션 제목: “마지막 읽기”삭제 창에는 테이블이 마지막으로 읽힌 시점이 Last read 3 days ago by 사용자 또는 단계와 같이 표시되므로, 아무도 사용하지 않는 테이블과 여전히 사용 중인 테이블을 구별할 수 있습니다. PlaidCloud는 웨어하우스 자체의 쿼리 기록에서 이 정보를 가져오며, 자체 정리 작업에서 발생한 읽기는 제외합니다.
| 웨어하우스 | 필요한 항목 |
|---|---|
| Snowflake | 읽기는 Access History에서 가져오며, Snowflake는 최대 약 3시간 늦게 기록합니다. 연결의 역할에 SNOWFLAKE.GOVERNANCE_VIEWER 데이터베이스 역할이 필요합니다(SNOWFLAKE 데이터베이스에 대한 IMPORTED PRIVILEGES도 가능합니다). Snowflake Standard 에디션에는 Access History가 없습니다. |
| Databricks | 읽기는 리니지 테이블에서 가져오며, Databricks도 지연되어 기록하므로 최근 읽기는 아직 표시되지 않을 수 있습니다. 연결의 ID에 system에 대한 USE CATALOG, system.access에 대한 USE SCHEMA, system.access.table_lineage에 대한 SELECT가 필요합니다. |
| PlaidCloud Lakehouse | 읽기 기록은 아직 사용할 수 없습니다. 창에 Read history incomplete가 표시됩니다. |
웨어하우스를 연결하면 연결 검사에서 누락된 권한을 권장하며, 각각 실행할 문과 함께 표시합니다. 이는 필수가 아니라 권장 사항입니다. 이러한 권한이 없어도 웨어하우스는 연결되며 창에 Read history incomplete가 표시됩니다.
PlaidCloud가 전체 기록을 읽을 수 없으면 줄에 Read history incomplete라고 표시되며, 이를 “no reads”로 대신 보고하는 일은 없습니다. 웨어하우스에 직접 SQL 액세스 권한이 있는 사용자는 자신의 읽기에 붙는 레이블을 바꾸는 세션 태그를 설정할 수 있습니다.
MCP로 연결된 AI 어시스턴트는 table_describe(include=['last_read'])에서 같은 답을 얻습니다.
테이블의 열 보기
섹션 제목: “테이블의 열 보기”테이블을 선택하면 세부 정보 패널이 열립니다. 열 섹션에는 각 열이 유형, 설명과 함께 나열되며, 설명은 열 속성에서 가져옵니다. 행에 마우스를 올리면 긴 설명을 전체로 볼 수 있습니다.
데이터가 만료되었거나 이를 빌드한 단계가 없어서 현재 웨어하우스에 없는 테이블에는 나열할 열이 없습니다. 섹션에 그 사실과 테이블의 열 개수가 표시됩니다. 테이블에 쓰는 단계를 실행하면 열을 나열할 수 있습니다.
테이블이 사용되는 위치 보기
섹션 제목: “테이블이 사용되는 위치 보기”테이블을 선택하면 해당 테이블에 관련된 워크플로 단계를 나열하는 세부 정보 패널이 열립니다.
- 테이블 생성자 — 테이블에 쓰는 단계
- 테이블 기여 대상 — 테이블에서 읽는 단계
- 이 테이블을 참조할 수 있음 — 확인할 수 없는 변수를 통해 테이블에 접근하는 단계. 이러한 단계가 있을 때만 이 섹션이 표시됩니다.
다른 테이블을 선택하면 이 목록이 즉시 지워집니다. 이 프로젝트의 데이터를 공유하는 다른 프로젝트의 단계(예: 이 테이블을 읽는 가져오기: 외부 프로젝트 테이블 단계)도 나열되지만, 해당 프로젝트에 대한 액세스 권한이 없을 수 있으므로 이름이나 워크플로는 표시되지 않습니다. 이러한 단계는 나머지보다 조금 늦게 나타날 수 있습니다.
단계는 테이블을 직접 지정할 수도 있고, /Periods/{period}/Sales와 같이 변수가 포함된 경로를 통해 접근할 수도 있습니다. 변수에 현재 값이 있으면 단계가 처음 두 목록에 정보 아이콘과 함께 표시됩니다. 행에 마우스를 올리면 단계가 저장한 그대로의 경로를 볼 수 있습니다.
이러한 행은 그 자체로 신뢰도가 낮은 답으로 취급하십시오. 지금 실행을 시작하면 접근할 대상을 설명할 뿐, 테이블에 접근한 모든 이력을 설명하지는 않습니다. 변수를 바꾸면 다른 테이블을 읽습니다.
일부 변수는 확인할 수 없습니다. 변수를 설정한 곳이 아예 없거나, 실행에 사용되는 값이 저장된 값에서 오지 않는 경우입니다. 워크플로 루프는 반복하면서 데이터에서 변수를 가져오고, 변수 설정 단계는 실행 중에 값을 할당하며, 매크로는 호출하는 단계가 변수를 전달하고, 센서가 시작한 실행은 해당 센서의 자체 세부 정보를 가집니다. 이 모든 경우에 실행 사이에 저장된 값은 신뢰할 값이 아니라 마지막 실행에서 남은 값입니다. PlaidCloud는 이러한 변수를 잘못된 테이블로 확인하는 대신, 확인하지 못한 변수와 함께 단계의 이름을 이 테이블을 참조할 수 있음 아래에 나열하므로 단계를 열어 확인할 수 있습니다.
내 역할에서 볼 수 없는 단계도 테이블이 사용 중임을 알 수 있도록 나열되지만 이름이나 워크플로는 표시되지 않으며 열 수 없습니다. 이 단계도 테이블을 삭제할 때 사용 중으로 계산됩니다. 볼 수 있는 단계는 내 역할에서 숨겨진 워크플로 없이 나열됩니다. 아키텍트에게는 숨겨진 항목이 없습니다.
참고: 테이블 목록에서 테이블을 삭제할 때, 변수가 있든 없든 경로를 통해 테이블에 접근하는 단계는 변수를 확인할 수 없더라도 해당 테이블을 사용하는 것으로 계산됩니다. 삭제 창에 해당 단계가 나열되며, 강제로 삭제하는 경우에만 삭제가 진행됩니다.
새 디렉터리 구조 만들기
섹션 제목: “새 디렉터리 구조 만들기”새 폴더를 추가하려면 다음과 같이 합니다.
- 도구 모음에서 새 폴더 버튼을 클릭합니다.
기존 폴더 안에 폴더를 추가하려면 다음과 같이 합니다.
- 폴더를 마우스 오른쪽 버튼으로 클릭합니다.
- 새 폴더를 선택합니다.
선택 항목이 폴더 안에 있으면 새 폴더 이름을 입력하는 프롬프트에도 최상위에 만들기가 있습니다. 이를 선택하면 새 폴더가 프로젝트의 최상위에 만들어집니다.
데이터 보기(테이블 탐색기)
섹션 제목: “데이터 보기(테이블 탐색기)”테이블 데이터는 데이터 탐색기로 봅니다. 데이터 탐색기는 데이터의 그리드 보기와 값 및 통계의 열별 요약을 제공합니다. 가리키고 클릭하는 방식의 필터링과 익숙한 파일 형식으로의 내보내기를 모두 사용할 수 있습니다. 필터 선택 내용을 워크플로에서 사용할 수 있는 추출 단계로 저장할 수도 있습니다.
보고용 테이블 게시
섹션 제목: “보고용 테이블 게시”대시보드 시각화는 의도적으로 게시된 테이블로 제한됩니다. 테이블을 게시할 때 데이터를 구분하는 고유한 이름을 지정할 수 있습니다. 테이블을 생성한 워크플로의 일부에서는 이름이 모호하지만 대시보드를 구축하는 사용자에게는 더 명확한 이름이 필요할 때 유용합니다.
게시된 테이블에는 경로가 연결되지 않습니다. 대시보드 영역에서 사용할 테이블 목록으로 표시됩니다.
보기 역할에 맞게 테이블 표시
섹션 제목: “보기 역할에 맞게 테이블 표시”탐색기 또는 관리자 확인란을 클릭하여 여러 역할이 테이블을 볼 수 있는지 제어할 수 있습니다. 여러 테이블을 업데이트해야 하면 계층에서 테이블을 선택하고 상단 도구 모음의 작업 메뉴에서 원하는 보기 역할을 선택합니다.
테이블 내용을 설명하는 메모
섹션 제목: “테이블 내용을 설명하는 메모”테이블에 메모를 추가하면 데이터를 이해하는 데 도움이 됩니다.
테이블의 모양, 크기, 마지막 업데이트 시간 보기
섹션 제목: “테이블의 모양, 크기, 마지막 업데이트 시간 보기”각 테이블의 행 수, 열 수, 데이터 크기가 테이블 계층에 표시됩니다. 행이 수백만 개에 이르는 매우 큰 테이블은 행 수가 추정될 수 있으며, 이 경우 대략적인 행 수임을 나타내는 표시가 나타납니다.
추가 테이블 특성 보기
섹션 제목: “추가 테이블 특성 보기”다른 테이블 특성을 보고 편집하려면 다음과 같이 합니다.
- 테이블을 선택합니다.
- 오른쪽의 테이블 컨텍스트 양식 보기를 클릭합니다.
테이블 복제
섹션 제목: “테이블 복제”테이블을 복제하려면 다음과 같이 합니다.
- 테이블을 선택합니다.
- 상단 도구 모음에서 복제 버튼을 클릭합니다.
테이블에서 Panel 앱 만들기
섹션 제목: “테이블에서 Panel 앱 만들기”테이블 또는 뷰를 선택하고 새로 만들기 메뉴 또는 마우스 오른쪽 버튼 메뉴에서 Panel 앱 만들기를 선택합니다. 프로젝트와 테이블이 이미 선택된 상태로 새 Studio 앱 대화 상자가 열립니다. 앱은 테이블의 이름을 가져오며, 원하면 변경한 다음 만들기를 선택하면 Panel Studio가 앱을 열고 Weave가 첫 페이지를 빌드할 준비를 합니다. 이 명령은 테이블 또는 뷰 하나를 선택했고, 프로젝트에 대한 편집 권한이 있으며, 프로젝트가 읽기 전용이 아닐 때 사용할 수 있습니다. Panel 앱 만들기를 참조하십시오.
테이블이 저장하는 항목 보기
섹션 제목: “테이블이 저장하는 항목 보기”테이블 목록에는 각 테이블의 크기 옆에 현재 데이터, 기록, 타임 트래블 일수, 참고 열이 표시됩니다. 타임 트래블 일수는 테이블 자체 설정이며 1은 프로젝트의 기본값을 사용한다는 뜻입니다. 목록 아래의 상태 표시줄에는 프로젝트의 합계가 표시됩니다. 저장하는 양과 그중 현재 데이터와 기록이 각각 얼마인지 보여 줍니다. 추정으로 표시된 크기는 PlaidCloud가 측정하기 전까지 테이블의 모양에서 계산한 값입니다.
작업 메뉴에서 스토리지를 선택하면 공간을 확보하는 제안과 타임 트래블 설정이 있는 프로젝트의 스토리지 창이 열립니다. 스토리지 관리를 참조하십시오.
테이블에서 데이터 편집기 만들기
섹션 제목: “테이블에서 데이터 편집기 만들기”테이블을 선택하고 새로 만들기 메뉴 또는 마우스 오른쪽 버튼 메뉴에서 테이블에서 데이터 편집기 만들기를 선택하면 한 번에 테이블을 구성된 데이터 편집기로 바꿀 수 있습니다. PlaidCloud가 테이블의 열을 검사하여 편집기의 입력 컨트롤을 미리 만듭니다. 자세한 내용은 테이블에서 데이터 편집기 만들기를 참조하십시오.