본문으로 건너뛰기

워크시트

최근 업데이트 2026. 10. 03.

워크시트는 BI 대시보드에서 프로젝트 내 데이터를 사용하여 만든 테이블로, 이후 차트와 필터를 설계하고 개발하는 기반이 됩니다.

워크시트에 대한 보기, 편집, 삭제, 이름 변경 작업은 편집 모드에서만 할 수 있습니다.

워크시트 생성​

BI 대시보드의 편집 모드로 들어가면 아래쪽에 워크시트 페이지가 표시됩니다.

워크시트 생성을 클릭하면 워크시트의 SQL 편집기 영역이 열립니다.

워크시트를 생성할 때 오른쪽 데이터베이스 테이블 사전에 있는 테이블을 사용할 수 있습니다.

SQL을 작성한 후 디버깅을 클릭하면 SQL 실행 결과를 확인할 수 있습니다.

디버깅에 성공하면 워크시트가 사용 가능 상태로 바뀝니다. 디버깅하지 않았거나 디버깅에 실패하면 워크시트는 사용 불가 상태가 됩니다. 사용 가능 상태인 워크시트만 차트와 필터 제작에 사용할 수 있습니다.

필드 및 로직 설정​

디버깅에 성공한 워크시트는 아래쪽에서 테이블의 모든 필드를 확인할 수 있습니다. 필드 이름과 필드 타입은 SQL 실행 결과에 따라 정해지며, 이후 차트 설정 시 사용하기 편하도록 필드의 표시 이름을 추가로 설정할 수 있습니다.

디버깅에 성공하면 워크시트의 데이터 1000건을 미리 볼 수 있으며, 다운로드 버튼을 클릭하면 미리보기 데이터를 csv로 다운로드하여 로컬에 저장하고 확인할 수 있습니다.

공통 지표​

기존 필드를 기반으로 워크시트에 공통 지표를 설정할 수도 있으며, 단순 집계와 커스텀의 두 가지 구성 방식을 지원합니다

설정한 후에는 차트 컴포넌트에서 바로 사용할 수 있으며, 구성 로직과 지표 이름을 반복해서 설정할 필요 없이 정의 기준을 일관되게 유지할 수 있습니다

워크시트 작업​

워크시트 편집​

상태가 사용 가능인 워크시트에서는 SQL 영역의 모든 변경(공백, 줄바꿈 등 문자 변경 포함)이 워크시트 편집으로 간주됩니다.

SQL을 편집하면 워크시트는 사용 불가 상태로 바뀌며, 다시 디버깅에 성공해야 합니다.

워크시트 삭제​

워크시트 옆의 설정 버튼을 클릭하여 워크시트를 삭제할 수 있습니다.

차트 또는 필터 컴포넌트에 적용된 워크시트를 삭제하면 해당 컴포넌트도 함께 삭제됩니다. 컴포넌트를 유지해야 한다면 먼저 컴포넌트를 편집하여 컴포넌트에서 사용하는 워크시트를 변경한 후 워크시트를 삭제하십시오.

워크시트 복사​

워크시트 옆의 설정 버튼을 클릭하여 워크시트를 복사할 수 있습니다.

워크시트를 복사하면 워크시트의 SQL 내용, 필드 정보 등이 함께 복사됩니다.

워크시트 이름 변경​

워크시트를 연 후 워크시트 이름을 더블클릭하면 바로 이름을 변경할 수 있습니다.

워크시트 이름에는 문자열 길이 제한이 있습니다.

워크시트 활용​

워크시트를 생성하는 주된 목적은 차트와 필터에서 사용하기 위해서입니다.

디버깅에 성공하여 상태가 사용 가능인 워크시트만 차트와 필터에 적용할 수 있습니다.

차트 컴포넌트와 필터 컴포넌트에 이미 사용된 워크시트를 편집하거나 수정하여 워크시트가 사용 불가 상태가 되면, 워크시트가 다시 디버깅에 성공할 때까지 해당 컴포넌트는 손상 상태가 됩니다.

차트 컴포넌트와 필터 컴포넌트에 이미 사용된 워크시트 필드를 삭제해도 컴포넌트가 손상됩니다.

편집 모드에서는 차트와 필터가 워크시트의 미리보기 데이터(1000건)를 사용하며, 전체 데이터가 아닙니다. 보기 모드에서는 워크시트의 전체 데이터를 사용하여 차트와 필터를 계산하고 렌더링합니다.

이 문서가 도움이 되었나요?