화면: 연결과 탐색기

테이블 탭

테이블 탭은 테이블 하나를 작업 문서 탭 하나로 여는 화면입니다. 넓은 화면에서 컬럼, 외래 키, 인덱스, 제약을 수정하고, 테이블의 데이터와 DDL 을 봅니다. 테이블 탭에서 수정한 내용은 ERD 의 같은 테이블과 같은 설계이고, 저장해도 DB 는 변경되지 않습니다. 저장과 DB 반영이 어떻게 다른지는 ERD 와 실제 DB 에서 설명합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1내부 탭왼쪽 세로 탭입니다. 아래 '내부 탭' 에서 설명합니다. 저장하지 않은 변경이 있으면 Schema Editor 탭 이름 옆에 점이 보입니다.
2테이블 이름스키마 : 테이블 로 보입니다. PostgreSQL 에서 행 수준 보안(RLS)이 활성화된 테이블에는 방패 아이콘, Publication 에 들어 있는 테이블에는 방송 아이콘이 붙습니다.
3테이블 버튼테이블 삭제... 버튼, 변경사항 DB 반영... 버튼, 새로고침 버튼입니다. 어느 내부 탭을 열었는지에 따라 변경됩니다. 아래 '도구 모음' 에서 설명합니다.
4저장, 복원 버튼저장 버튼은 설계를 프로젝트에 저장하고, 복원... 버튼은 저장하지 않은 변경을 버립니다. 저장하지 않은 변경이 있을 때만 클릭할 수 있습니다.
5데이터베이스 테이블 정보데이터베이스, 스키마, 테이블 이름, 설명, 논리명, DBMS 별 옵션입니다.
6Table Columns컬럼 그리드입니다. 칸은 ERD 의 테이블 노드 와 같고, 테이블 탭에만 있는 칸은 아래 '컬럼 그리드' 에서 설명합니다.
7Foreign Keys, Indexes, Constraints외래 키, 인덱스, 제약의 표입니다. 영역 머리의 버튼으로 더하고, 줄 끝의 버튼으로 삭제합니다.
  • 영역의 제목을 클릭하면 영역으로 스크롤합니다.
  • 오른쪽 아래 상태바에는 테이블의 커넥션, 데이터베이스, 스키마가 보이고, Data 탭에서는 읽어 온 행 수도 보입니다.

내부 탭

탭보이는 때하는 일
Schema Editor항상테이블 정의를 수정합니다. 처음 열면 먼저 보입니다.
Code Generator프로젝트에 템플릿 팩을 지정했을 때테이블로 소스코드를 만드는 엔티티 설정입니다. 소스코드 생성 에서 설명합니다.
Data항상테이블의 데이터를 조회하고 수정합니다(아래 '데이터 조회하고 수정하기').
속성Databricks 의 DB 에 있는 테이블Delta 테이블의 속성을 보고, 지원하는 속성을 수정합니다.
DDL항상테이블의 CREATE 문을 봅니다(아래 'DDL 보기').
버전 이력Databricks 의 Delta 테이블테이블의 버전 이력을 보고, 지난 버전의 데이터를 미리 보거나 복원합니다.
메타데이터Databricks, Snowflake, BigQuery 처럼 DB 가 테이블 메타데이터를 주는 DBMS소유자, 생성 시각, 저장 형식 같은 메타데이터를 읽기 전용으로 봅니다.

도구 모음

열린 탭버튼하는 일
Schema Editor테이블 삭제...테이블을 삭제합니다(아래 '테이블 삭제하기'). 삭제 표시한 테이블에서는 테이블 삭제 취소 버튼으로 변경됩니다.
Schema Editor변경사항 DB 반영...테이블의 변경으로 DDL 을 만들어 보여 주고 실행합니다. DB 반영 과 같은 창입니다.
Schema Editor새로고침DB 에서 테이블의 지금 정보를 다시 읽습니다. 아직 DB 에 없는 가상 테이블에서는 누를 수 없습니다.
Code Generator소스코드 생성..., Entity 설정 초기화...소스코드를 만들고, 엔티티 설정을 처음 상태로 되돌립니다. 소스코드 생성 에서 설명합니다.
Data새로고침데이터를 다시 조회합니다.
  • 변경사항 DB 반영... 버튼과 새로고침 버튼은 DB 접속 정보가 있는 커넥션에서만 클릭할 수 있습니다. 변경사항 DB 반영... 버튼은 DB 에 반영하지 않은 변경이 있을 때만 클릭할 수 있습니다.
  • 저장, 복원 버튼(4)은 Data 탭, DDL 탭, Databricks 의 세 탭에서는 보이지 않습니다.

테이블 탭을 여는 방법

  1. 탐색기에서 테이블을 두 번 클릭합니다. 클릭한 테이블의 테이블 탭(문서 탭테이블)이 열립니다. 이미 열려 있으면 열린 탭으로 옮겨 갑니다.
  2. ERD 에서 열려면 테이블 노드를 선택하고 노드 도구 모음의 상세 탭에서 보기 버튼을 클릭합니다.
  • 처음 열 때 DB 에서 테이블의 컬럼, 키, 인덱스를 읽습니다. 읽지 못하면 오류와 다시 시도 버튼이 보입니다.
  • 뷰를 두 번 클릭하면 테이블 탭이 아니라 객체 탭 이 열립니다.

새 테이블 만들기

  1. 탐색기에서 스키마나 스키마 아래의 Tables 항목을 우클릭하고 탐색기 우클릭새 테이블 메뉴를 클릭합니다.
  2. table1 처럼 겹치지 않는 이름의 가상 테이블이 생기고 테이블 탭이 열립니다. 테이블 이름 칸에 이름을 적습니다.
  3. 컬럼, 외래 키, 인덱스를 정하고 저장 버튼을 클릭합니다.
  4. DB 에 만들려면 변경사항 DB 반영... 버튼을 클릭하고 CREATE TABLE 문을 확인해 실행합니다.
  • 새 테이블은 만든 즉시 프로젝트에 저장되지만 DB 에는 없습니다. DB 에 반영하기 전까지 가상 테이블입니다.
  • 커넥션에 새 테이블 템플릿을 정해 두었으면 템플릿의 컬럼으로 시작합니다. 템플릿은 커넥션 만들기와 수정 에서 정합니다.
  • PostgreSQL, Oracle 처럼 이름의 대소문자를 변경해 저장하는 DBMS 에서는 기본 이름도 변경한 대소문자로 만듭니다(Oracle 은 TABLE1).
  • 시스템 스키마에서는 메뉴가 흐리게 보이고 클릭할 수 없습니다.

컬럼과 키 수정하기

  1. Table Columns 영역(6)의 new column 버튼이나 그리드 머리 오른쪽의 + 버튼을 클릭해 컬럼을 더합니다.
  2. 칸을 클릭하거나 두 번 클릭해 이름, 타입, PK, N/N, 기본값, 설명을 정합니다.
  3. 외래 키, 인덱스, 제약은 각 영역(7)의 Foreign Key 추가... 버튼, Index 추가... 버튼, Constraint 추가... 버튼으로 더합니다.
  4. 저장 버튼을 클릭해 저장합니다.

새로 더한 컬럼, 수정한 칸, 순서를 변경한 컬럼은 색으로 표시됩니다. 컬럼 순서를 변경하면 Table Columns 영역 제목 옆에 Order Changed 표시가 붙습니다. 칸마다 하는 일, 기본값 넣기, 가상 컬럼, 대소문자 보존은 테이블 노드 에서, 외래 키, 인덱스, 제약을 더하는 창은 테이블 상세 패널 에서 설명합니다. 같은 창입니다.

컬럼 그리드

컬럼 그리드는 ERD 의 노드와 같은 칸을 사용하고, 테이블 탭에서는 다음 칸이 더 보입니다.

칸보이는 때
Logical Name항상 보입니다. ERD 의 노드에서는 표시 설정을 따릅니다.
Domain커넥션에 데이터 사전의 도메인이 지정되어 있을 때
Charset, CollationMySQL, MariaDB. 컬럼마다 문자셋과 콜레이션을 정합니다. ERD 에는 없는 칸입니다.

테이블 정보의 칸

칸설명
Database데이터베이스와 스키마를 따로 두는 DBMS 에서만 보입니다. 읽기 전용입니다.
Schema읽기 전용입니다.
Table Name테이블 이름입니다. DB 에 있는 테이블의 이름을 변경하면 DB 반영 때 이름 변경 문장이 됩니다. 대소문자를 변경해 저장하는 DBMS 의 가상 테이블에는 아래에 대소문자 보존 항목이 보입니다.
Description테이블 설명입니다. DB 에는 테이블 주석으로 반영됩니다.
논리명사람이 읽는 이름입니다. 데이터 사전이 지정된 커넥션에서는 논리명으로 테이블 이름을 만들어 줍니다. 데이터 사전 에서 설명합니다.
DBMS 별 옵션MySQL, MariaDB 의 엔진, 문자셋, 콜레이션, PostgreSQL, Oracle 의 테이블스페이스처럼 DBMS 가 주는 칸입니다.

PostgreSQL 과 Supabase 에서는 Constraints 영역 아래에 Logical Replication 영역과 RLS Policies 영역이 더 보입니다. 테이블 상세 패널 의 같은 영역과 같습니다.

PK 를 변경할 때

다른 테이블의 외래 키가 참조하는 기본 키를 변경하고 저장하면, 저장하기 전에 PK 변경 미리보기 — orders 창이 열립니다. 외래 키는 부모의 기본 키와 컬럼 수가 맞아야 하므로, 자식 테이블의 외래 키를 어떻게 맞출지 정합니다.

  1. 창 위에서 이전 PK 와 새 PK 를 확인합니다.
  2. 영향받는 외래키 (1건) 표에서 자식 테이블마다 처리 방법을 정합니다.
    • 기본 키에 컬럼을 더했으면 추가될 자식 컬럼명 칸에 자식 테이블에 더할 컬럼의 이름을 적습니다.
    • 기본 키의 컬럼을 제외하거나 변경했으면 FK 제약만 삭제 항목과 직접 매핑 항목 가운데 하나를 선택합니다. 직접 매핑 항목은 새 기본 키에 대응하는 자식 컬럼을 적습니다.
  3. 적용 버튼을 클릭합니다. 테이블과 함께 변경된 자식 테이블도 저장됩니다.
  • 창을 닫으면 저장하지 않습니다.
  • DB 에 반영할 때는 함께 변경된 자식 테이블이 DDL 미리보기에 자동 동행 표시로 들어가고, 제외할 수 없습니다.
  • 아직 DB 에 없는 가상 테이블의 기본 키를 DB 에 있는 테이블의 외래 키가 참조하면 적용할 수 없습니다. 부모 테이블을 먼저 DB 에 반영하세요.
  • 기존 데이터는 옮기지 않습니다. NOT NULL 로 변경되는 컬럼과 참조하는 데이터가 있는지 미리 확인하세요.

데이터 조회하고 수정하기

Data 탭을 열면 테이블의 데이터를 조회합니다. 결과 그리드는 SQL 편집기의 결과와 같습니다.

  • 처음에 200 행을 읽습니다. 그리드 끝까지 스크롤하거나 아래의 Load More 버튼을 클릭하면 200 행씩 더 읽습니다.
  • 필터, 정렬, 수정은 결과 그리드 와 결과 데이터 편집 에서 설명합니다. 수정한 내용을 적용하면 UPDATE, INSERT, DELETE 문이 바로 DB 에서 실행되고, 다시 조회합니다. 문장 하나가 실패하면 중지 버튼, 재시도 버튼, 건너뛰기 버튼 가운데 선택하게 합니다.
  • 기본 키가 없는 테이블이나 뷰도 수정할 수 있습니다. 이때는 모든 컬럼의 값으로 수정할 행을 찾으므로, 적용하기 전에 기본 키가 없어 모든 컬럼의 값으로 고칠 행을 찾습니다(orders_log). 같은 값을 가진 다른 행도 함께 바뀔 수 있습니다. 문구로 한 번 묻습니다. 커넥션 프로파일의 보호 모드 확인도 같은 창에서 함께 묻습니다.
  • 필터 줄의 Export 버튼은 테이블 전체 데이터를 파일로 내보냅니다. 결과 내보내기 에서 설명합니다.
  • DB 접속 정보가 없는 커넥션에서는 조회하지 않습니다.

DDL 보기

DDL 탭은 테이블의 CREATE 문을 읽기 전용으로 보여 줍니다.

  • DB 에 있는 테이블은 DB 의 지금 정의로 만듭니다. 저장했거나 수정하는 중인 변경은 들어가지 않고, 변경이 있으면 안내가 보입니다. 수정한 내용이 반영된 DDL 은 변경사항 DB 반영... 버튼의 미리보기에서 확인합니다.
  • 가상 테이블은 설계한 정의로 만듭니다.
  • 스키마명 포함 항목을 활성화하면 테이블 이름 앞에 스키마를 붙입니다. SQL Server 의 기본이 아닌 스키마에서는 항상 붙습니다.
  • 새로고침 버튼으로 다시 만들고, SQL 복사 버튼으로 복사합니다.
  • Databricks 는 DB 의 SHOW CREATE TABLE 결과를 그대로 보여 줍니다.

저장, 복원, DB 반영

  1. 수정한 뒤 저장 버튼을 클릭합니다. 설계가 프로젝트에 저장되고, DB 는 변경되지 않습니다.
  2. 저장하지 않은 변경을 버리려면 복원... 버튼을 클릭하고 확인합니다. 마지막으로 저장한 상태로 돌아갑니다.
  3. DB 에 만들려면 변경사항 DB 반영... 버튼을 클릭하고, 미리보기에서 문장을 확인해 실행합니다. DB 반영 에서 설명합니다.
  • 저장하지 않은 채 탭을 닫으면 저장할지 묻습니다. 저장하지 않고 닫으면 마지막으로 저장한 상태로 돌아갑니다.
  • 새로고침 버튼을 클릭하면 DB 에 반영하지 않은 변경이 있는 테이블에 대해 병합 버튼과 교체 버튼 가운데 하나를 선택하게 합니다. 탐색기의 새로고침과 같고, 테이블 노드 에서 설명합니다.
  • 로그인한 계정 프로젝트에서 DDL 실행이 제한된 멤버는 바로 실행하지 않고 승인을 요청합니다. DDL 승인 에서 설명합니다.

테이블 삭제하기

테이블 삭제... 버튼을 클릭하면 테이블의 상태에 따라 처리할 방법을 묻습니다.

테이블하는 일
아직 DB 에 없는 가상 테이블프로젝트에서 삭제합니다. 탭이 닫힙니다.
DB 에 있는 테이블플래그 처리 (실제 DB는 유지) 항목을 선택하면 삭제 표시만 하고 다음 DB 반영 때 삭제합니다. DROP TABLE 문 실행 (실제 DB에서 삭제) 항목을 선택하면 DROP TABLE 문을 미리 보여 주고 실행합니다.
삭제 표시한 테이블DROP TABLE 문을 미리 보여 주고 실행합니다.

삭제 표시한 테이블은 수정할 수 없고, Schema Editor 탭 위에 삭제된 테이블 안내가 보입니다. 테이블 삭제 취소 버튼으로 되돌립니다.

ERD 상세 패널과 다른 점

ERD 캔버스 아래의 테이블 상세 패널 도 같은 테이블을 수정합니다. 둘은 같은 설계를 수정하므로, 한쪽에서 수정한 내용이 다른 쪽에도 바로 보입니다.

테이블 탭ERD 상세 패널
여는 곳탐색기에서 테이블을 두 번 클릭할 때, ERD 노드의 상세 탭에서 보기 버튼ERD 캔버스에서 테이블 노드를 클릭할 때
컬럼탭 안의 컬럼 그리드. 컬럼별 문자셋(MySQL, MariaDB)과 논리명 칸이 있습니다캔버스의 노드에서 수정합니다
저장, DB 반영탭의 버튼노드 도구 모음과 정보 패널의 버튼
코드 생성, Databricks 탭있습니다없습니다
노드의 색과 노트없습니다NeoSQL Properties 영역에 있습니다

주의할 점

  • 저장 버튼은 DB 를 변경하지 않습니다. 탐색기와 다른 사람이 보는 DB 의 테이블은 변경사항 DB 반영... 버튼으로 실행해야 변경됩니다.
  • 반대로 Data 탭에서 적용한 데이터 수정은 저장 버튼과 상관없이 바로 DB 에서 실행됩니다.
  • DDL 탭은 DB 에 있는 테이블이면 수정한 내용을 보여 주지 않습니다. 실행될 DDL 은 반영 미리보기에서 확인하세요.
  • 새로고침 버튼에서 교체 버튼을 선택하면 DB 에 반영하지 않은 수정이 모두 사라집니다.
  • 시스템 스키마의 테이블은 읽기 전용입니다. 탭 위에 시스템 스키마의 테이블은 읽기 전용입니다. DDL 변경은 차단됩니다. 안내가 보이고, 저장과 DB 반영을 할 수 없습니다.
  • 로그인한 계정 프로젝트에서 DDL 실행이 제한된 멤버일 때, 다른 팀원이 수정하는 중인 테이블은 이 테이블은 다른 팀원이 수정 중이어서 편집할 수 없습니다. 안내와 함께 읽기 전용이 됩니다.

관련 화면