프로젝트를 열면() 왼쪽에 커넥션과 문서 목록, 가운데에 ERD, SQL 편집기 같은 작업 문서, 오른쪽에 AI Assistant 패널 같은 도우미 패널이 놓입니다. 각 부분이 무엇이고 어느 페이지에서 자세히 설명하는지 안내합니다. 프로젝트를 만드는 방법은 새 프로젝트 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 프로젝트 탭 | 데스크톱에서는 연 프로젝트가 헤더의 작업 탭 줄에 탭으로 놓이고, 보이는 프로젝트의 탭 안에 아래 버튼들이 들어갑니다. 탭을 우클릭하면 닫기 항목과 프로젝트 설정 항목이 나옵니다. 웹 앱에는 작업 탭 줄이 없고, 헤더에 프로젝트 이름과 버튼들이 놓입니다. 작업 탭 에서 설명합니다. |
| 2 | 프로젝트 설정 버튼 | 톱니 버튼입니다. 프로젝트 설정 창을 엽니다. |
| 3 | AI 설정 버튼 | 커넥션마다 AI 를 어디까지 허용할지 정하는 창을 엽니다. 프로젝트 AI 설정 에서 설명합니다. |
| 4 | 왼쪽 레일 | 왼쪽 패널에 무엇을 보일지 선택하는 버튼 세 개입니다. 아래 '레일 버튼' 에서 설명합니다. |
| 5 | 왼쪽 패널 | 처음에는 객체 탐색기가 보입니다. 패널의 오른쪽 가장자리를 드래그해 너비를 변경합니다. |
| 6 | ERD, SQL 목록 | 탐색기 아래에 프로젝트의 ERD 와 SQL 문서가 있습니다. 위쪽 가장자리를 드래그해 높이를 변경합니다. ERD 와 SQL 목록 에서 설명합니다. |
| 7 | 작업 문서 탭 | ERD, SQL 편집기, 대시보드, 테이블과 객체의 상세 화면이 탭으로 열립니다. 아래 '작업 문서 탭' 에서 설명합니다. |
| 8 | 탭 추가 버튼 | ERD 추가... 항목, SQL 편집기 추가... 항목, 대시보드 추가... 항목이 있습니다. DB 접속 정보가 있는 커넥션이 없으면 SQL 편집기는 만들 수 없습니다. |
| 9 | 오른쪽 레일 | 오른쪽 패널을 여닫는 버튼입니다. 아래 '레일 버튼' 에서 설명합니다. |
| 10 | 상태바 | 실행 중인 백그라운드 작업, 선택한 트리 항목이나 탭의 위치, 탭의 정보가 보입니다. 앱 메뉴, 상단 바와 상태바 에서 설명합니다. |
- 계정 프로젝트에서 플랜이 함께 사용하는 인원을 허락하면 설정 버튼 앞에 협업 버튼이 있습니다. 로컬 프로젝트에는 없습니다. 공유와 멤버 에서 설명합니다.
- 헤더의 버튼들은 프로젝트를 다 읽을 때까지 흐리게 보이고 클릭할 수 없습니다.
레일 버튼
왼쪽 레일 버튼은 왼쪽 패널의 내용을 변경합니다. 이미 보이는 패널의 버튼을 다시 클릭하면 왼쪽 패널을 접습니다.
| 버튼 | 여는 것 | 설명하는 페이지 |
|---|---|---|
| 버튼 | 객체 탐색기와 ERD, SQL 목록 | 객체 탐색기 |
| 버튼 | DB 에 반영하지 않은 변경 목록. 버튼의 숫자는 변경된 테이블 수입니다 | 아래 '스키마 변경사항 패널' |
| 버튼 | 대시보드 목록 | 대시보드 |
오른쪽 레일 버튼은 오른쪽 패널을 엽니다. 열린 패널의 버튼을 다시 클릭하면 닫습니다.
| 버튼 | 여는 것 | 있는 곳 | 설명하는 페이지 |
|---|---|---|---|
| 버튼 | AI 와 대화하는 패널 | 모든 프로젝트 | AI Assistant |
| 버튼 | DDL 승인 요청 목록. 숫자는 기다리는 요청 수입니다 | 계정 프로젝트 | DDL 승인 |
| 버튼 | 지금 탭의 커넥션에 지정한 도메인과 사전 | 모든 프로젝트 | 커넥션에 지정 |
| 버튼 | 실행한 SQL 의 기록 | 모든 프로젝트 | SQL 이력과 저장된 SQL |
- 오른쪽 패널은 왼쪽 가장자리를 드래그해 너비를 변경합니다.
- 패널 머리의 고정 버튼(콘텐츠 위에 띄워 고정)을 클릭하면 패널이 작업 문서 위에 표시된 창이 됩니다. 위쪽 손잡이를 드래그해 옮기고, 가장자리와 모서리를 드래그해 크기를 변경합니다. 다시 클릭하면(고정 해제 (영역 차지)) 오른쪽에 붙습니다.
작업 문서 탭
- 왼쪽 목록에서 ERD 나 SQL 문서를 클릭하거나, 탐색기에서 테이블을 두 번 클릭하거나, 탭 추가 버튼(8)으로 새 문서를 만들면 탭이 열립니다.
- 탭을 드래그해 순서를 변경합니다.
- 탭 이름을 두 번 클릭하면 왼쪽과 오른쪽 패널이 접혀 탭이 화면을 넓게 사용합니다. 다시 두 번 클릭하면 패널이 돌아옵니다.
- 열린 탭이 없으면 열린 탭이 없습니다 안내와 새 ERD 생성 버튼, 새 SQL 편집기 생성 버튼, 새 대시보드 생성 버튼이 보입니다.
- 탭을 우클릭하면 닫기 항목, 다른 탭 닫기 항목, 왼쪽 탭 닫기 항목, 오른쪽 탭 닫기 항목, 모든 탭 닫기 항목이 나옵니다. ERD 와 SQL 문서 탭에는 이름 변경... 항목과 삭제 항목도 있습니다.
- 탭 이름 끝의 점은 저장하지 않은 변경이 있다는 표시입니다. TX 표시는 SQL 탭에 커밋하지 않은 트랜잭션이 있다는 뜻입니다 (SQL 실행과 트랜잭션).
.sql파일을 탭 줄로 드래그 앤 드롭하면 커넥션을 선택한 뒤 파일마다 SQL 편집기 탭으로 엽니다(SQL 편집기).- 프로젝트를 닫았다가 다시 열면 열어 두었던 탭이 돌아옵니다.
스키마 변경사항 패널
버튼은 ERD 와 테이블 탭에서 변경하고 저장했지만 아직 DB 에 반영하지 않은 테이블을 프로젝트 전체에서 모아 보여 줍니다. 여러 ERD 에 흩어진 변경을 한곳에서 선택해 반영하거나 되돌릴 때 사용합니다. 저장과 DB 반영이 왜 다른 단계인지는 [ERD 와 실제 DB](/ko/docs/concepts/erd-and-database) 에서 설명합니다.| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 버튼 | 숫자는 반영하지 않은 테이블 수입니다. |
| 2 | 변경 수 | 목록에 있는 테이블 수입니다. 하나도 없으면 변경사항 없음 안내가 보입니다. |
| 3 | 전체 선택 체크 상자 | 모든 항목을 선택하거나 해제합니다. 커넥션, 데이터베이스, 스키마 줄의 체크 상자는 줄 안의 항목을 함께 선택합니다. 처음에는 모두 선택되어 있습니다. |
| 4 | 변경 항목 | 테이블 이름과 추가, 수정, 삭제 표시입니다. 인덱스 변경도 테이블의 변경으로 셉니다. 클릭하면 테이블의 탭이 열립니다. |
| 5 | 초기화 버튼 | 선택한 테이블의 변경을 버리고 DB 의 상태로 되돌립니다. |
| 6 | 적용 버튼 | 선택한 테이블을 검토하는 변경 검토 창을 엽니다. |
선택한 변경을 DB 에 반영하기
- 반영할 테이블만 체크합니다.
- 적용 버튼을 클릭합니다. 변경 검토 창이 열립니다.
- 왼쪽 목록에서 테이블을 클릭하면 오른쪽에 컬럼, 인덱스, 외래 키, 테이블 속성의 변경된 점과 테이블의 DDL 이 보입니다. 반영하지 않을 테이블은 체크를 해제합니다.
- DDL 미리보기 & 실행 (2) 버튼을 클릭합니다. DDL 을 미리 보고 실행하는 창이 열립니다. 실행은 DB 반영 과 같습니다.
- 선택한 테이블과 함께 반영해야 하는 테이블(변경한 기본 키를 참조하는 테이블 등)은 검토 창에 자동으로 더해지고 체크를 해제할 수 없습니다.
- 외래 키가 참조하는 테이블이 아직 DB 에 없으면, 참조 테이블도 함께 만들지 외래 키를 이번에 제외하고 반영할지 묻습니다.
변경 되돌리기
- 되돌릴 테이블만 체크합니다.
- 초기화 버튼을 클릭합니다. 스키마 변경사항 초기화 창이 표시됩니다.
- 초기화 버튼을 클릭하면 선택한 변경을 버립니다.
주의할 점
- 초기화 버튼으로 버린 변경은 되돌릴 수 없습니다. 아직 DB 에 없는 새 테이블은 프로젝트에서 삭제됩니다.
- 스키마 변경사항 패널에는 DB 접속 정보가 있는 커넥션의 테이블만 나옵니다. DBMS 만 정한 커넥션과 비활성화된 커넥션의 테이블은 나오지 않습니다.
- 계정 프로젝트에서 내 역할에 DDL 제한 권한이 걸려 있으면 내가 만든 변경만 나옵니다. 반영은 승인을 거칩니다(DDL 승인).
- 계정 프로젝트에서 다른 멤버가 같은 테이블을 먼저 변경하면 내 변경이 버려지고 변경사항 폐기됨 알림이 표시됩니다.
- 데스크톱에서 여러 프로젝트를 탭으로 열어 두면 보이지 않는 프로젝트도 열린 채 남아 있습니다. 작업 탭을 오가는 방법은 작업 탭 에서 설명합니다.
- 프로젝트를 읽지 못하면 화면 대신 프로젝트 정보를 불러오지 못했습니다. 다시 시도하시겠습니까? 안내와 다시 시도 버튼이 보입니다.
관련 화면
- 작업 탭: 여러 프로젝트를 탭으로 열어 두고 오가는 방법입니다.
- 프로젝트 설정: 톱니 버튼이 여는 창입니다.
- 객체 탐색기: 왼쪽 패널의 커넥션 트리입니다.
- ERD 와 SQL 목록: 탐색기 아래의 문서 목록입니다.
- DB 반영: 검토 창 다음에 열리는 DDL 미리보기와 실행 창입니다.
- 앱 메뉴, 상단 바와 상태바: 헤더와 상태바입니다.