변경사항 미리보기 및 실행 창은 ERD 와 탐색기에서 변경한 테이블 설계를 실제 DB 에 반영합니다. 바로 실행하지 않고 만들 DDL 을 먼저 보여 주며, 선택한 테이블의 DDL 만 실행합니다. 저장과 DB 반영이 왜 다른 단계인지는 ERD 와 실제 DB 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 대상 | DDL 을 실행할 커넥션의 DBMS, 이름, 스키마입니다. |
| 2 | 스키마명 포함 항목 | 활성화하면 DDL 의 테이블 이름 앞에 스키마 이름을 붙입니다. 아래 '미리보기의 옵션' 에서 설명합니다. |
| 3 | 테이블 목록 | 반영할 테이블입니다. 표시는 만들 테이블(CREATE), 수정할 테이블(ALTER), 삭제할 테이블(DROP)입니다. 체크를 비활성화한 테이블의 DDL 은 실행하지 않습니다. 전체 선택 항목으로 한꺼번에 활성화하고 비활성화합니다. |
| 4 | DDL 미리보기 | 체크한 테이블의 DDL 을 실행할 순서대로 보여 줍니다. 읽기 전용입니다. |
| 5 | SQL 복사 버튼 | 미리보기의 DDL 을 복사합니다. 다른 도구로 실행하거나 검토를 맡길 때 사용합니다. |
| 6 | DDL 실행 버튼 | 체크한 테이블의 DDL 을 실행합니다. |
변경사항을 DB 에 반영하기
- 창을 엽니다. 여는 곳에 따라 반영할 테이블이 다릅니다(아래 '여는 곳마다 다른 대상').
- 테이블 목록(3)에서 이번에 반영하지 않을 테이블의 체크를 비활성화합니다.
- DDL 미리보기(4)에서 실행될 문장을 확인합니다. 컬럼을 삭제하거나 타입을 변경하면 주의 상자가 아래에 나옵니다.
- DDL 실행 버튼(6)을 클릭합니다. 확인 창이 실행할 내용(여러 테이블이면 테이블 수와 DDL 수)을 보여 주면 확인합니다.
- 모두 성공하면 3개의 DDL이 성공적으로 실행되었습니다. 알림이 표시되고 창이 닫힙니다. 반영한 테이블은 DB 에서 다시 읽어 저장하므로, 테이블 안의 변경 색이 사라집니다.
여는 곳마다 다른 대상
| 여는 곳 | 반영할 테이블 | 클릭할 수 있을 때 |
|---|---|---|
| 테이블을 선택하면 위에 나타나는 도구 모음의 변경사항 DB 반영... 버튼 | 선택한 테이블 | DB 접속 정보가 있는 커넥션이고 선택한 테이블에 반영하지 않은 변경이 있을 때 |
| 정보 패널의 변경사항 DB 반영... 버튼 | ERD 에서 반영하지 않은 변경이 있는 테이블 전부 | 커넥션이 있는 ERD 에서 보이고, DB 접속 정보가 있는 커넥션이며 변경된 테이블이 하나라도 있을 때 |
| ERD 의 테이블 우클릭 › 메뉴 | 우클릭한 테이블. 여러 테이블을 선택했으면 선택한 테이블 가운데 변경된 테이블 전부 | 우클릭한 테이블에 반영하지 않은 변경이 있을 때 보입니다 |
| 탐색기의 메뉴 | 우클릭한 테이블, 또는 커넥션, 스키마, 테이블 묶음 안의 변경된 테이블 전부 | 묶음 안에 변경된 테이블이 있을 때. DB 접속 정보가 없는 커넥션에서는 보이지 않습니다 |
여러 테이블을 반영하면 메뉴 이름에 테이블 수가 붙습니다(변경사항 DB 반영 (3건)...).
미리보기의 옵션
- 스키마명 포함 항목은 처음에는 비활성화되어 있고, 테이블이 여러 스키마에 걸쳐 있으면 활성화된 채 열립니다. SQL Server 는 세션의 스키마를 변경할 수 없어 항상 활성화되어 있고 비활성화할 수 없습니다. 그래야 기본 스키마가 아닌 스키마에 테이블이 정확히 만들어집니다.
- 삭제할 테이블이 있고 DBMS 가 지원하면 CASCADE 적용 항목이 보입니다. 활성화하면
DROP TABLE에CASCADE를 붙여, 삭제할 테이블에 기대는 다른 객체도 함께 삭제합니다. - 어디에서 열든 부모 테이블의 기본 키를 변경했으면, 기본 키를 참조하는 자식 테이블이 자동 동행 표시와 함께 목록에 들어옵니다. 자식의 외래 키를 함께 수정해야 하므로 체크를 비활성화할 수 없습니다.
- 자동으로 DDL 을 만들 수 없는 변경은 정보 아이콘과 함께 자동 적용할 수 없는 변경 상자에 이유가 나옵니다. 그런 변경은 SQL 편집기에서 직접 처리하세요.
- 외래 키가 참조하는 테이블이 아직 DB 에 없고 이번 반영에도 들어 있지 않으면, 창이 열리기 전에 참조 테이블 미생성 창이 먼저 묻습니다. 참조 테이블도 함께 생성 (1개) 버튼은 참조할 테이블도 함께 만들고(함께 만들 수 있는 테이블이 있을 때만 보입니다), FK 제외하고 반영 버튼은 외래 키만 제외하고 반영합니다. 제외한 외래 키는 반영하지 않은 변경으로 남습니다.
실행 중에 오류가 나면
- 문장 하나가 실패하면 SQL 실행 오류 창이 몇 번째 문장인지와 DB 의 오류를 보여 줍니다.
- 재시도 버튼은 실패한 문장을 다시 보내고, 중지 버튼은 남은 문장을 실행하지 않습니다. 남은 문장이 있으면 건너뛰기 버튼(실패한 문장만 제외하고 이어서 실행)과 모두 건너뛰기 버튼(이후의 오류도 모두 건너뜀)이 함께 보입니다.
- 일부만 반영되면 부분 성공 알림이 반영된 문장 수를 알려 주고, 창은 닫히지 않습니다. 미리보기에서 실패한 문장과 성공한 문장에 표시가 붙고, 테이블 목록에도 실패와 완료 아이콘이 붙습니다.
- 반영된 부분은 DB 에서 다시 읽어 설계에 반영됩니다. 남은 변경을 수정한 뒤 다시 실행하세요.
승인을 거쳐 반영하기
계정 프로젝트에서 역할에 DDL 제한 권한이 활성화된 멤버는 DDL 을 직접 실행할 수 없고, 승인을 요청합니다. 로컬 프로젝트에는 DDL 실행 제한이 없습니다. 권한을 정하는 방법은 협업과 권한 에서 설명합니다.
- 정보 패널의 변경사항 DB 반영... 버튼이 주황색으로 보입니다. 클릭하면 내가 변경한 테이블만 목록에 들어옵니다.
- DDL 실행 버튼(1)은 클릭할 수 없습니다. 반영할 테이블을 선택하고 DB 반영 요청 버튼(2)을 클릭합니다.
- DB 반영 요청 창의 반영 사유 칸에 이유를 적고 요청 버튼을 클릭합니다. 이유를 적어야 보낼 수 있습니다.
- 승인할 수 있는 멤버가 패널에서 검토하고 실행합니다. DDL 승인 에서 설명합니다.
주의할 점
- DDL 실행에는 커넥션 프로파일의 보호 모드가 걸립니다. 보호 모드가 읽기 전용이면 실행하지 않고, 확인이면 실행 전에 한 번 더 묻습니다. 위험 SQL 확인은 걸리지 않으니 미리보기의 DDL 을 반드시 읽으세요. 실행 경로마다 걸리는 장치는 운영 DB 안전장치 에서 설명합니다.
- 체크는 테이블 단위입니다. 한 테이블의 문장 가운데 일부만 실행하려면 SQL 복사 버튼으로 복사해 SQL 편집기에서 실행하세요.
- 실패했을 때 앞 문장이 DB 에 남는지는 DBMS 에 따라 다릅니다. DDL 을 실행하면 곧바로 커밋하는 DBMS(MySQL, MariaDB, Oracle 등)는 실패한 문장 앞까지 반영된 채 남고, DDL 을 트랜잭션으로 묶는 DBMS(PostgreSQL, SQL Server, SQLite 등)는 함께 보낸 문장이 모두 되돌려집니다. 어디까지 반영됐는지는 알림과 미리보기의 표시로 확인합니다.
- 테이블 삭제를 반영하면 DB 의 테이블과 데이터가 삭제되고 되돌릴 수 없습니다. CASCADE 적용 항목을 활성화하면 다른 객체도 함께 삭제됩니다.
관련 화면
- ERD 캔버스: 테이블을 놓고 관계를 긋는 화면입니다.
- DDL 로 테이블 가져오기: DDL 문으로 가상 테이블을 만듭니다.
- DDL 승인: 승인 요청을 검토하고 실행합니다.
- ERD 와 실제 DB: 저장과 DB 반영의 차이, 테이블 삭제의 두 방법을 설명합니다.