탐색기

탐색기는 ERD 캔버스의 왼쪽 가장자리에 도킹되는 패널로, 다이어그램을 트리로 나열합니다. 테이블과 각 테이블의 컬럼, 인덱스, foreign key가 먼저 나열되고, 이어서 테이블 그룹, 그다음 메모가 나열됩니다. 행을 클릭하면 캔버스에서 그 행이 나타내는 대상으로 이동합니다.
탐색기는 캔버스를 덮지 않고 캔버스의 너비를 줄입니다. 탐색기는 다이어그램 에디터의 일부이며, VS Code의 탐색기 뷰나 Obsidian의 파일 탐색기와는 다릅니다.

탐색기 맨 위, 제목 표시줄과 트리 사이에는 찾기와 바꾸기가 있습니다. Find 입력란에 텍스트가 있는 동안에는 트리에 일치하는 항목만 표시됩니다. 검색 결과 문서를 참고하세요.
트리 자체는 다이어그램을 바꾸지 않으며, 이름 바꾸기, 드래그, 삭제, 표시와 숨기기 기능이 없습니다. 패널이 하는 편집은 바꾸기뿐입니다.

탐색기 자체의 상태는 사용자 한 사람만의 것입니다. 열려 있는지 여부, 너비, 접힌 상태, 키보드 포커스가 있는 행, 스크롤 위치, 검색이 여기에 해당합니다.
이 중 어느 것도 파일에 저장되거나, Undo 히스토리에 기록되거나, 공동 편집자와 공유되거나, 브라우저에 저장되지 않습니다. 에디터가 열려 있는 동안에는 탭을 전환해도, 같은 에디터에 다른 문서를 불러와도 유지됩니다. 새로 연 에디터는 탐색기가 닫힌 상태로 시작합니다.

열기와 닫기

다음 중 하나로 엽니다.

• 툴바에서 Search 바로 다음에 있는 트리 아이콘의 Explorer 버튼. 툴팁에 Explorer (Ctrl + F) (Windows/Linux) or Explorer (⌘ + F) (Mac)가 표시됩니다.
• Ctrl + F (Windows/Linux) or ⌘ + F (Mac). 설정의 단축키 탭에는 Toggle Explorer라는 이름으로 표시됩니다.
• 빠른 검색의 Toggle Explorer. 모든 탭의 목록에 표시되며, find, replace, rename, tree, outline, objects를 입력해도 찾을 수 있습니다.
• 캔버스 컨텍스트 메뉴의 Toggle Explorer. ERD 캔버스에서 테이블 그룹 바깥의 빈 곳을 마우스 오른쪽 클릭하면 나타나는 메뉴에서 New Table, New Memo, New Table Group 다음, Relationship 앞에 있습니다.

두 Toggle Explorer 항목은 오른쪽에 단축키를 표시합니다.
툴바 버튼, 단축키, 빠른 검색의 항목은 모든 탭에서 동작합니다. 탐색기는 ERD 탭에만 표시되므로, Visualization, Schema SQL, Code Generator, 설정 탭에서 사용하면 먼저 ERD 탭으로 전환됩니다.

툴바 버튼은 패널을 열고 닫기만 합니다. 커서를 Find 입력란에 두지 않으며, 테이블 속성, 테마 빌더, Display Language 선택기를 열린 채로 둡니다.
단축키와 두 Toggle Explorer 항목은 탐색기를 검색 상태로 엽니다. Find 입력란의 텍스트를 선택한 채로 커서를 그 입력란에 두며, 탐색기 옆의 대화 상자 항목에서 설명하는 다섯 가지 대화 상자 중 열려 있는 것을 닫습니다. 다시 열 때 검색에 유지되는 내용은 찾기와 바꾸기의 열기와 닫기 문서를 참고하세요.
테이블 셀, 메모, 테이블 그룹 이름을 편집하는 중에는 단축키가 아무 동작도 하지 않습니다.

ERD 탭에서 탐색기가 열려 있고 Zen 모드로 숨겨져 있지 않은 동안에는 툴바 버튼이 눌린 상태로 표시됩니다. 이 동안에는 버튼, 단축키, 두 Toggle Explorer 항목 중 어느 것으로든 탐색기가 닫히며, 패널에 있던 키보드 포커스는 에디터로 돌아갑니다.
빠른 검색이나 다섯 가지 대화 상자 중 하나가 열려 있는 동안에는 단축키가 탐색기를 닫지 않습니다. 대신 팔레트나 대화 상자를 닫고 키보드 포커스를 Find 입력란으로 옮기며, 입력란의 텍스트가 선택되고, 탐색기가 이미 표시되어 있었다면 현재 일치 항목도 그대로 유지됩니다. 빠른 검색의 Toggle Explorer 항목에는 이런 예외가 없으므로, 실행하면 팔레트가 닫힌 뒤 열려 있는 탐색기도 닫힙니다.

툴팁에 Close가 표시되는 제목 표시줄의 x 버튼으로도 탐색기를 닫을 수 있으며, 이때 키보드 포커스는 캔버스로 갑니다. Escape로는 닫히지 않습니다. 탐색기의 키 항목을 참고하세요.
다시 열면 탐색기는 같은 너비로 돌아오며, 트리의 접힌 상태와 스크롤 위치, 검색어도 그대로입니다. 단축키나 Toggle Explorer 항목으로 열면 그 검색어로 다시 검색하며 모든 결과가 펼쳐집니다. 검색 결과 문서를 참고하세요.

단축키나 Toggle Explorer 항목으로 탐색기를 열 때 에디터가 너무 좁으면 Widen the window to show the Explorer 토스트가 표시되며, 키보드 포커스는 원래 있던 곳에 그대로 있습니다. 캔버스 옆 항목을 참고하세요.
그래도 탐색기는 열린 상태이며 툴바 버튼도 눌린 상태로 표시되고, 에디터가 충분히 넓어지면 이미 검색된 상태로 나타나되 키보드 포커스를 가져가지 않습니다. 툴바 버튼으로 열 때는 토스트가 표시되지 않습니다.

캔버스 옆

탐색기는 툴바 아래, ERD 탭의 왼쪽 가장자리를 따라 캔버스 높이 전체에 걸쳐 놓입니다.
캔버스는 탐색기가 들어갈 자리만큼 좁아지므로 다이어그램의 어느 부분도 패널 아래에 가려지지 않으며, 캔버스 툴바, 미니맵, 시작 화면도 모두 탐색기 옆의 캔버스 안에 놓입니다.
탐색기를 열거나 닫거나 크기를 조절해도 다이어그램은 스크롤되지 않으며, Undo 히스토리에 아무것도 기록되지 않습니다.

새로 연 에디터에서는 너비 260px로 시작합니다. 오른쪽 가장자리를 드래그해 200px부터 480px까지 원하는 너비로 정하거나, 가장자리를 더블 클릭해 260px로 되돌립니다.

캔버스는 탐색기 옆에 항상 320px 이상의 너비를 남깁니다.

• 에디터가 탐색기의 너비에 320px를 더한 것보다 좁으면, 탐색기는 그에 맞춰 200px까지 좁게 그려집니다.
• 에디터가 520px보다 좁으면 탐색기는 비켜납니다. 그려지지는 않지만 열린 상태로 남으므로, 툴바 버튼은 여전히 눌린 상태로 표시되며 버튼을 누르면 탐색기가 닫힙니다. 에디터가 충분히 넓어지면 원래 너비로 돌아옵니다.

열기와 닫기 항목의 토스트는 창을 언급하지만, 기준이 되는 것은 브라우저 창이 아니라 에디터 자체의 너비입니다.

오른쪽에서 왼쪽으로 쓰는 표시 언어에서도 캔버스는 좌우로 뒤집히지 않으므로, 탐색기는 캔버스 왼쪽에 그대로 있습니다.
탐색기의 내용은 오른쪽에서 왼쪽으로 읽힙니다. 제목 표시줄, 검색, 행이 좌우로 뒤집히고, 행은 오른쪽부터 들여쓰기됩니다. 드래그하는 가장자리는 캔버스와 맞닿은 오른쪽에 그대로 있습니다. 데이터 타입, 인덱스 컬럼, foreign key 텍스트는 왼쪽에서 오른쪽 순서를 유지합니다.

탐색기가 숨겨질 때

탐색기는 ERD 탭에만 표시됩니다.
다른 탭으로 전환하면 탐색기가 숨겨지고, 툴바 버튼도 더 이상 눌린 상태로 표시되지 않습니다. ERD 탭으로 돌아오면 접힌 상태와 스크롤 위치까지 떠나기 전 그대로 다시 나타납니다.

Diff Viewer, Time Travel, 자동 배치 미리보기가 열려 있는 동안에는 어떤 방법으로도 탐색기를 열거나 닫을 수 없습니다.

• 열려 있던 탐색기는 숨겨지며, 그것들이 닫히면 다시 나타납니다.
• 툴바 버튼은 흐리게 표시되고 아무 동작도 하지 않습니다.
• 빠른 검색에 Toggle Explorer가 표시되지 않습니다.
• 단축키는 브라우저나 호스트로 넘어갑니다. 브라우저의 찾기 막대 문서를 참고하세요.

Diff Viewer는 같은 종류의 트리에 변경 사항을 나열합니다. Diff Viewer 문서를 참고하세요.

Alt + Z (Windows/Linux) or ⌥ + Z (Mac)로 Zen 모드를 켜면 열려 있는 탐색기가 닫히지 않고 숨겨지며, Zen 모드를 끄면 탐색기가 다시 나타납니다.
Zen 모드에서도 단축키와 두 Toggle Explorer 항목은 탐색기를 검색 상태로 열며, Zen 모드는 켜진 채로 유지됩니다. 이때는 상단 툴바가 없으므로 탐색기가 에디터 높이 전체에 걸쳐 놓이며, Zen 모드를 꺼도 계속 표시됩니다. Zen 모드를 다시 켜면 다시 숨겨집니다.

닫히든, 숨겨지든, 비켜나든 키보드 포커스가 패널에 있는 채로 패널이 사라지면 키보드 포커스는 에디터로 돌아갑니다.

트리

제목 표시줄에는 Explorer가 표시되며, Collapse All과 탐색기를 닫는 x, 두 버튼이 있습니다. 그 아래에는 검색이, 다시 그 아래에는 트리가 있습니다. 검색은 찾기와 바꾸기 문서를 참고하세요.

최상위 단계에는 Tables, Table Groups, Memos 세 폴더가 이 순서대로 있습니다. 각 테이블 아래에는 그 테이블의 Columns, Indexes, Foreign Keys 폴더가 있습니다.
비어 있는 폴더는 표시되지 않으므로, 빈 다이어그램에는 행이 하나도 표시되지 않습니다. 또한 View Option → Table Groups로 그룹을 숨긴 동안에는 Table Groups가, View Option → Memos로 메모를 숨긴 동안에는 Memos가 표시되지 않습니다.
폴더 행에는 폴더 아이콘과 이름, 그리고 맨 끝에 바로 아래에 있는 행의 개수가 표시되므로, Tables 옆의 개수는 다이어그램의 테이블 수입니다.

테이블은 대소문자를 무시하고 이름순으로 나열되며, 이름이 같은 테이블은 문서의 순서를 따릅니다. 테이블 그룹과 각 그룹 아래의 테이블도 같은 방식으로 나열됩니다. 테이블의 컬럼은 그 테이블 자체의 순서를 따르며, 인덱스, foreign key, 메모는 문서의 순서를 따릅니다.
트리는 캔버스에서의 편집, Undo나 Redo, 가져오기, 공동 편집자나 코딩 에이전트의 편집 등으로 다이어그램이 바뀔 때마다 그 변경을 따라가므로, 테이블 이름을 바꾸면 그 행의 위치도 바뀝니다.

각 종류의 행에는 다음이 표시됩니다.

• 테이블: 테이블 아이콘과 이름.
• 컬럼: primary key나 foreign key 컬럼은 키 아이콘으로 표시되며, 이 아이콘은 테이블 자체의 키 셀이 primary key, foreign key, 또는 둘 다를 표시하는 색으로 칠해집니다. 그 밖의 컬럼은 목록 아이콘으로 표시됩니다. 이어서 이름이 표시되고, 데이터 타입과 그 뒤의 PK, FK, 또는 둘 다가 흐리게 표시됩니다. 예를 들어 id BIGINT PK, user_id BIGINT FK입니다.
• 인덱스: 인덱스 아이콘과 이름. 이어서 unique 인덱스이면 UNIQUE가, 그리고 괄호 안에 인덱스 순서대로 컬럼이 흐리게 표시되며, 내림차순 컬럼 뒤에는 DESC가 붙습니다. 예를 들어 orders_user_idx UNIQUE (user_id DESC, total), 또는 그냥 (total)입니다.
• Foreign key: foreign key 컬럼을 가진 쪽인 자식 테이블 아래에만, 그리고 부모 테이블이 다이어그램에 있는 동안에만 나열됩니다. 키 아이콘은 연결선의 색을 따르며, 식별 관계이면 primary key이자 foreign key인 키의 색, 그렇지 않으면 foreign key의 색입니다. 자식 테이블의 키 컬럼이 쉼표로 구분되어 표시되고, 이어서 →와 부모 테이블, 그 컬럼이 흐리게 표시됩니다. 예를 들어 user_id → users(id)입니다.
• 테이블 그룹: 그룹 색상의 점과 이름. 색상이 없는 그룹의 점은 회색입니다. 그룹의 테이블이 그 아래에 이름순으로 나열되며, 각 행은 해당 테이블로 이동합니다. 테이블이 없는 그룹에는 펼칠 것이 없습니다.
• 메모: 메모지 아이콘과 메모의 첫 줄.

비어 있는 이름과 첫 줄이 비어 있는 메모는 기울임꼴의 unnamed로 표시됩니다.
패널이 좁으면 흐리게 표시되는 텍스트가 이름보다 먼저 …로 잘립니다. 이름이나 흐리게 표시되는 텍스트에 마우스를 올리면 전체를 볼 수 있습니다.

처음에는 Tables만 펼쳐져 있습니다. 폴더 행을 클릭하거나 그 행에서 Enter나 Space를 누르면 접히거나 펼쳐집니다.
행의 시작 부분에 있는 화살표는 어디로도 이동하지 않고 그 행을 접거나 펼칩니다. 아래에 아무것도 없는 테이블이라도 모든 테이블 행에 이 화살표가 있습니다. →와 ←로도 접고 펼칩니다. 탐색기의 키 항목을 참고하세요.
Collapse All은 누를 때마다 한 단계씩 접습니다. 보이는 펼쳐진 행 중 가장 깊은 단계를 접으므로, 누를 때마다 아래 단계부터 위로 접힙니다. 최상위 단계에 이르면, 그때 누를 때는 이미 접힌 행 아래의 행까지 포함해 모든 행을 접어 최상위 폴더만 남깁니다.
편집, Undo와 Redo, 공동 편집자나 코딩 에이전트의 변경은 접힌 상태를 바꾸지 않습니다.

행으로 이동

행을 클릭하거나 키보드 포커스가 행에 있을 때 Enter나 Space를 누르면 ERD 캔버스에서 그 행이 나타내는 대상으로 이동합니다. 폴더 행은 접히거나 펼쳐지기만 하며, 방향키는 트리 안에서만 이동합니다.

• 테이블 행이나 그룹 아래에 나열된 테이블은 그 테이블만 선택하고 맨 앞으로 가져옵니다. 포커스된 셀이 이미 그 테이블 안에 있지 않다면 테이블 이름에 포커스를 둡니다.
• 컬럼 행은 그 컬럼의 테이블만 선택하고, 컬럼 이름에 포커스를 둡니다.
• 인덱스 행은 테이블 행과 마찬가지로 그 테이블을 선택합니다. 인덱스 자체가 따로 선택되지는 않으며, 인덱스는 테이블 속성에서 편집합니다.
• Foreign key 행은 관계의 두 테이블이 함께 보이도록 화면을 옮기며, 두 테이블이 너무 멀리 떨어져 함께 보일 수 없으면 자식 테이블이 보이도록 옮깁니다. 자식 테이블만 그 foreign key 컬럼과 함께 선택하고 그중 첫 번째 컬럼에 포커스를 두며, 관계의 연결선을 강조합니다. 연결선 읽기 문서를 참고하세요.
• 테이블 그룹 행은 그룹의 박스가 제목 표시줄을 기준으로 보이도록 화면을 옮기고, 그 그룹만 선택한 뒤 그룹을 그 테이블과 함께 맨 앞으로 가져옵니다.
• 메모 행은 그 메모만 선택하고 맨 앞으로 가져옵니다.

화면은 모든 이동에 공통인 규칙에 따라 움직입니다. 배율은 바뀌지 않으며, 이동하는 대상이 이미 잘 보이는 상태가 아닐 때만 캔버스가 스크롤됩니다. 이동 후 화면 위치 문서를 참고하세요.
행으로 이동할 때 테이블 속성이 열려 있으면 먼저 닫으며, 그리는 중인 관계를 시작하거나 끝내지 않습니다.
Find 입력란에 텍스트가 있는 동안에는 자신의 이름에 일치 항목이 있는 행이나 코멘트 또는 메모의 일부를 보여 주는 행은 대신 그 일치 항목으로 이동합니다. 일치 항목으로 이동 문서를 참고하세요.

클릭한 뒤에도 키보드 포커스는 트리에 남으므로, Escape를 누르거나 캔버스를 클릭하기 전까지는 Delete, Backspace를 비롯한 편집 키가 새로 선택된 대상에 전달되지 않습니다. 탐색기의 키 항목을 참고하세요.

탐색기의 키

트리는 Tab 순서에서 한 자리를 차지하며, 행이 없는 동안에는 건너뜁니다.
Tab으로 트리에 들어가면 키보드 포커스가 마지막으로 있던 행에, 그런 행이 없으면 현재 일치 항목의 행에, 그것도 없으면 완전히 보이는 첫 번째 행에 놓이며, 그 행이 보이도록 스크롤됩니다. 키보드 포커스가 있는 행은 포인터가 올라간 행처럼 그려집니다.

트리에서는 다음과 같이 동작합니다.

• ↑와 ↓는 한 행씩 이동하며, 순환하지 않고 첫 번째 행과 마지막 행에서 멈춥니다. Home과 End는 첫 번째 행과 마지막 행으로 이동합니다.
• →는 접힌 행을 펼치거나, 펼쳐진 행의 첫 번째 하위 행으로 이동합니다. ←는 펼쳐진 행을 접거나, 상위 행으로 나갑니다. 오른쪽에서 왼쪽으로 쓰는 표시 언어에서는 두 키가 서로 바뀝니다.
• Enter와 Space는 클릭과 같이 동작합니다. 행으로 이동하거나, 폴더를 접거나 펼칩니다. 행으로 이동 항목을 참고하세요.
• 글자를 입력해도 행으로 이동하지 않습니다.

트리, Find나 Replace 입력란, 탐색기의 버튼 등 탐색기 안 어디에서든 Escape를 누르면 키보드 포커스가 캔버스로 돌아갑니다. 탐색기는 열린 채로, 선택은 그대로 남습니다.
IME 조합을 끝내는 Escape는 조합만 끝냅니다. Escape는 탐색기 안에서 누르든 캔버스에서 누르든 탐색기를 닫지 않습니다.

키보드 포커스가 탐색기에 있는 동안에도 몇 가지 에디터 단축키는 계속 동작합니다. 단축키 문서를 참고하세요.

• Ctrl + F (Windows/Linux) or ⌘ + F (Mac)는 캔버스에서와 같이 동작합니다. 탐색기를 닫거나, 탐색기 옆에 테이블 속성이 열려 있으면 테이블 속성을 닫고 커서를 Find 입력란에 둡니다. 열기와 닫기 항목을 참고하세요.
• Ctrl + K (Windows/Linux) or ⌘ + K (Mac)는 빠른 검색을 열고 닫습니다.
• Undo와 Redo는 입력란의 텍스트가 아니라 다이어그램을 되돌리고 다시 실행합니다.
• Zoom In, Zoom Out, Zoom Reset은 캔버스를 확대/축소합니다.

그 밖의 모든 에디터 단축키는 탐색기 안에 머물며, 방향키, Tab, Enter, Space, Home, End, IME가 조합 중일 때 누른 키도 마찬가지입니다.
이 키들은 캔버스에 전달되지 않습니다. Delete와 Backspace는 선택한 항목을 삭제하지 않고, Alt + N (Windows/Linux) or ⌥ + N (Mac)은 테이블을 추가하지 않으며, T 다음 G는 아무것도 그룹으로 묶지 않습니다. 입력란에서는 일반 텍스트 입력란의 키로 동작합니다. Ctrl + A (Windows/Linux) or ⌘ + A (Mac)는 입력란의 텍스트를 선택하고, Delete와 Backspace는 텍스트를 지우며, Space는 공백을 입력합니다. Tab은 탐색기의 버튼, 입력란, 트리 사이에서 포커스를 이동합니다.
Find와 Replace 입력란 자체의 키는 검색 입력란의 키 문서에서 다룹니다.
호스트 자체의 저장이나 커맨드 팔레트처럼 에디터가 지정하지 않은 키는 평소대로 호스트에 전달됩니다.

탐색기 옆의 대화 상자

테이블 속성, 테마 빌더, Display Language 선택기, Export image 대화 상자, 컬럼 매핑은 열릴 때 탐색기를 열린 채로 둡니다.

• 테이블 속성은 탐색기 옆 캔버스의 가운데에 열리며 캔버스만 어둡게 처리합니다. 탐색기는 계속 사용할 수 있으며, 행을 고르면 테이블 속성이 닫힌 뒤 그 행으로 이동합니다.
• Export image와 컬럼 매핑은 툴바와 탐색기를 포함한 에디터 전체를 어둡게 처리합니다. 탐색기는 어둡게 처리된 영역 아래에서 열린 채로 남으며, 어둡게 처리된 영역의 다른 곳과 마찬가지로 그곳을 클릭하면 대화 상자가 닫힙니다. 이때 컬럼 매핑은 아무것도 매핑하지 않은 채 닫힙니다.
• 왼쪽에서 오른쪽으로 쓰는 표시 언어에서는 테마 빌더와 Display Language 선택기가 탐색기를 덮지 않고 바로 그 옆에 열리며, 열려 있는 동안 탐색기가 열리거나 닫히면 함께 자리를 옮깁니다. 오른쪽에서 왼쪽으로 쓰는 언어에서는 오른쪽의 자리를 유지합니다. 툴바를 제외한 바깥 어디를 눌러도 닫히는 것과 마찬가지로, 탐색기 안을 눌러도 닫힙니다.

단축키나 Toggle Explorer 항목으로 검색을 열면 다섯 가지 모두 닫히며, 컬럼 매핑은 아무것도 매핑하지 않은 채 닫힙니다.
빠른 검색도 탐색기를 열린 채로 두며, 이때 Escape는 팔레트만 닫습니다.

읽기 전용 에디터

readonly 에디터에서도 탐색기는 다른 에디터에서와 똑같이 동작합니다. 같은 툴팁의 툴바 버튼, 단축키, 두 Toggle Explorer 항목, 트리, 접기와 펼치기, Collapse All, 행으로 이동이 모두 동작하며, 행으로 이동하면 평소처럼 이동한 대상이 선택됩니다. 제목에도 마찬가지로 Explorer가 표시됩니다.
검색은 찾기만 합니다. 찾기와 바꾸기의 읽기 전용 에디터 문서를 참고하세요.