화면: ERD

DB 반영

변경사항 미리보기 및 실행 창은 ERD 와 탐색기에서 변경한 테이블 설계를 실제 DB 에 반영합니다. 바로 실행하지 않고 만들 DDL 을 먼저 보여 주며, 선택한 테이블의 DDL 만 실행합니다. 저장과 DB 반영이 왜 다른 단계인지는 ERD 와 실제 DB 에서 설명합니다.

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

화면 구성

번호이름설명
1대상DDL 을 실행할 커넥션의 DBMS, 이름, 스키마입니다.
2스키마명 포함 항목활성화하면 DDL 의 테이블 이름 앞에 스키마 이름을 붙입니다. 아래 '미리보기의 옵션' 에서 설명합니다.
3테이블 목록반영할 테이블입니다. 표시는 만들 테이블(CREATE), 수정할 테이블(ALTER), 삭제할 테이블(DROP)입니다. 체크를 비활성화한 테이블의 DDL 은 실행하지 않습니다. 전체 선택 항목으로 한꺼번에 활성화하고 비활성화합니다.
4DDL 미리보기체크한 테이블의 DDL 을 실행할 순서대로 보여 줍니다. 읽기 전용입니다.
5SQL 복사 버튼미리보기의 DDL 을 복사합니다. 다른 도구로 실행하거나 검토를 맡길 때 사용합니다.
6DDL 실행 버튼체크한 테이블의 DDL 을 실행합니다.

변경사항을 DB 에 반영하기

  1. 창을 엽니다. 여는 곳에 따라 반영할 테이블이 다릅니다(아래 '여는 곳마다 다른 대상').
  2. 테이블 목록(3)에서 이번에 반영하지 않을 테이블의 체크를 비활성화합니다.
  3. DDL 미리보기(4)에서 실행될 문장을 확인합니다. 컬럼을 삭제하거나 타입을 변경하면 주의 상자가 아래에 나옵니다.
  4. DDL 실행 버튼(6)을 클릭합니다. 확인 창이 실행할 내용(여러 테이블이면 테이블 수와 DDL 수)을 보여 주면 확인합니다.
  5. 모두 성공하면 3개의 DDL이 성공적으로 실행되었습니다. 알림이 표시되고 창이 닫힙니다. 반영한 테이블은 DB 에서 다시 읽어 저장하므로, 테이블 안의 변경 색이 사라집니다.

여는 곳마다 다른 대상

여는 곳반영할 테이블클릭할 수 있을 때
테이블을 선택하면 위에 나타나는 도구 모음의 변경사항 DB 반영... 버튼선택한 테이블DB 접속 정보가 있는 커넥션이고 선택한 테이블에 반영하지 않은 변경이 있을 때
정보 패널의 변경사항 DB 반영... 버튼ERD 에서 반영하지 않은 변경이 있는 테이블 전부커넥션이 있는 ERD 에서 보이고, DB 접속 정보가 있는 커넥션이며 변경된 테이블이 하나라도 있을 때
ERD 의 테이블 우클릭 › ERD 테이블 우클릭변경사항 DB 반영... 메뉴우클릭한 테이블. 여러 테이블을 선택했으면 선택한 테이블 가운데 변경된 테이블 전부우클릭한 테이블에 반영하지 않은 변경이 있을 때 보입니다
탐색기의 탐색기 우클릭변경사항 DB 반영... 메뉴우클릭한 테이블, 또는 커넥션, 스키마, 테이블 묶음 안의 변경된 테이블 전부묶음 안에 변경된 테이블이 있을 때. DB 접속 정보가 없는 커넥션에서는 보이지 않습니다

여러 테이블을 반영하면 메뉴 이름에 테이블 수가 붙습니다(변경사항 DB 반영 (3건)...).

미리보기의 옵션

  • 스키마명 포함 항목은 처음에는 비활성화되어 있고, 테이블이 여러 스키마에 걸쳐 있으면 활성화된 채 열립니다. SQL Server 는 세션의 스키마를 변경할 수 없어 항상 활성화되어 있고 비활성화할 수 없습니다. 그래야 기본 스키마가 아닌 스키마에 테이블이 정확히 만들어집니다.
  • 삭제할 테이블이 있고 DBMS 가 지원하면 CASCADE 적용 항목이 보입니다. 활성화하면 DROP TABLE 에 CASCADE 를 붙여, 삭제할 테이블에 기대는 다른 객체도 함께 삭제합니다.
  • 어디에서 열든 부모 테이블의 기본 키를 변경했으면, 기본 키를 참조하는 자식 테이블이 자동 동행 표시와 함께 목록에 들어옵니다. 자식의 외래 키를 함께 수정해야 하므로 체크를 비활성화할 수 없습니다.
  • 자동으로 DDL 을 만들 수 없는 변경은 정보 아이콘과 함께 자동 적용할 수 없는 변경 상자에 이유가 나옵니다. 그런 변경은 SQL 편집기에서 직접 처리하세요.
  • 외래 키가 참조하는 테이블이 아직 DB 에 없고 이번 반영에도 들어 있지 않으면, 창이 열리기 전에 참조 테이블 미생성 창이 먼저 묻습니다. 참조 테이블도 함께 생성 (1개) 버튼은 참조할 테이블도 함께 만들고(함께 만들 수 있는 테이블이 있을 때만 보입니다), FK 제외하고 반영 버튼은 외래 키만 제외하고 반영합니다. 제외한 외래 키는 반영하지 않은 변경으로 남습니다.

실행 중에 오류가 나면

  • 문장 하나가 실패하면 SQL 실행 오류 창이 몇 번째 문장인지와 DB 의 오류를 보여 줍니다.
  • 재시도 버튼은 실패한 문장을 다시 보내고, 중지 버튼은 남은 문장을 실행하지 않습니다. 남은 문장이 있으면 건너뛰기 버튼(실패한 문장만 제외하고 이어서 실행)과 모두 건너뛰기 버튼(이후의 오류도 모두 건너뜀)이 함께 보입니다.
  • 일부만 반영되면 부분 성공 알림이 반영된 문장 수를 알려 주고, 창은 닫히지 않습니다. 미리보기에서 실패한 문장과 성공한 문장에 표시가 붙고, 테이블 목록에도 실패와 완료 아이콘이 붙습니다.
  • 반영된 부분은 DB 에서 다시 읽어 설계에 반영됩니다. 남은 변경을 수정한 뒤 다시 실행하세요.

승인을 거쳐 반영하기

계정 프로젝트에서 역할에 DDL 제한 권한이 활성화된 멤버는 DDL 을 직접 실행할 수 없고, 승인을 요청합니다. 로컬 프로젝트에는 DDL 실행 제한이 없습니다. 권한을 정하는 방법은 협업과 권한 에서 설명합니다.

  1. 정보 패널의 변경사항 DB 반영... 버튼이 주황색으로 보입니다. 클릭하면 내가 변경한 테이블만 목록에 들어옵니다.
  2. DDL 실행 버튼(1)은 클릭할 수 없습니다. 반영할 테이블을 선택하고 DB 반영 요청 버튼(2)을 클릭합니다.
  3. DB 반영 요청 창의 반영 사유 칸에 이유를 적고 요청 버튼을 클릭합니다. 이유를 적어야 보낼 수 있습니다.
  4. 승인할 수 있는 멤버가 프로젝트 레일DDL 승인 관리 패널에서 검토하고 실행합니다. DDL 승인 에서 설명합니다.

주의할 점

  • DDL 실행에는 커넥션 프로파일의 보호 모드가 걸립니다. 보호 모드가 읽기 전용이면 실행하지 않고, 확인이면 실행 전에 한 번 더 묻습니다. 위험 SQL 확인은 걸리지 않으니 미리보기의 DDL 을 반드시 읽으세요. 실행 경로마다 걸리는 장치는 운영 DB 안전장치 에서 설명합니다.
  • 체크는 테이블 단위입니다. 한 테이블의 문장 가운데 일부만 실행하려면 SQL 복사 버튼으로 복사해 SQL 편집기에서 실행하세요.
  • 실패했을 때 앞 문장이 DB 에 남는지는 DBMS 에 따라 다릅니다. DDL 을 실행하면 곧바로 커밋하는 DBMS(MySQL, MariaDB, Oracle 등)는 실패한 문장 앞까지 반영된 채 남고, DDL 을 트랜잭션으로 묶는 DBMS(PostgreSQL, SQL Server, SQLite 등)는 함께 보낸 문장이 모두 되돌려집니다. 어디까지 반영됐는지는 알림과 미리보기의 표시로 확인합니다.
  • 테이블 삭제를 반영하면 DB 의 테이블과 데이터가 삭제되고 되돌릴 수 없습니다. CASCADE 적용 항목을 활성화하면 다른 객체도 함께 삭제됩니다.

관련 화면