DDL 승인은 계정 프로젝트에서 DDL 제한 권한이 활성화된 역할의 멤버가 테이블 변경을 DB 에 반영할 때 거치는 단계입니다. 제한된 멤버는 DDL 을 직접 실행하지 못하고 요청을 보내며, 승인할 수 있는 멤버가 오른쪽 레일의
패널에서 요청을 검토하고 실행합니다. 역할과 권한은 [협업과 권한](/ko/docs/concepts/collaboration) 에서 설명합니다.사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 레일 버튼 | 오른쪽 레일의 버튼입니다. 내가 승인할 수 있는 대기 중인 요청이 있으면 개수가 붙습니다. |
| 2 | 대기 중 탭, 처리 완료 탭 | 대기 중인 요청과 승인, 거부, 철회된 요청입니다. 프로젝트의 모든 요청이 보입니다. |
| 3 | 새로고침 단추 | 목록을 다시 읽습니다. |
| 4 | 요청 대상 열 | 요청의 커넥션, 데이터베이스, 스키마입니다. 줄을 클릭하면 DDL 승인 검토 창이 열립니다. |
| 5 | 요청자 열 | 요청한 사람입니다. DDL 제한 항목이 활성화된 역할의 멤버에게는 보이지 않습니다. |
| 6 | 상태 열 | 승인 대기, 승인, 반려, 취소 가운데 하나입니다. |
요청하는 사람과 승인하는 사람
| 누구 | 할 수 있는 일 | |
|---|---|---|
| 요청하는 사람 | 역할에 DDL 제한 항목이 활성화된 멤버 | DDL 을 실행하지 못하고 요청을 보냅니다. 자기 요청을 철회합니다. 제한된 멤버가 저장한 테이블 변경은 팀과 공유되지 않고 따로 보관됩니다. |
| 승인하는 사람 | 소유자는 언제나 승인합니다. 그 밖에는 자기 역할에 모든 권한 항목이 활성화되었거나 DDL 제한 항목이 비활성화된 멤버이고, 요청자의 역할에 승인자 역할 항목을 정했으면 정한 역할 이상이어야 합니다. | 요청의 DDL 을 수정하고 승인과 함께 실행하거나 거부합니다. |
- 역할의 서열은 소유자, 관리자, DBA, 멤버 순입니다. 예를 들어 멤버 역할의 승인자 역할을 관리자 역할로 정하면 소유자와 관리자만 멤버 역할의 요청을 승인합니다.
- 승인자 역할 항목을 비워 두면 서열은 보지 않습니다.
- 승인할 수 있는지는 요청마다 NeoSQL 서버가 정합니다. 승인할 수 없는 요청은 DDL 승인 검토 창에서 읽기만 할 수 있습니다.
DDL 제한 활성화하기
- 소유자 계정으로 탭을 열고 제한할 역할의 탭을 엽니다.
- DDL 제한 상자(1)를 선택합니다. 제한할 역할의 Connection 권한 항목(2)이 비활성화되고 선택할 수 없게 됩니다.
- 프로젝트 설정 창을 저장합니다. 제한한 역할의 멤버는 프로젝트를 다시 열 때부터 DDL 을 직접 실행하지 못합니다.
- 제한된 멤버는 변경사항 미리보기 및 실행 창의 DDL 실행 버튼을 클릭할 수 없고, SQL 편집기에서 DDL 문을 실행하면 DDL 실행이 제한되어 있습니다. 승인자에게 DB 반영을 요청하세요. 안내가 나오고 실행되지 않습니다.
- 승인자 역할 칸(3)에서 요청을 승인할 역할을 선택합니다. 선택한 역할과 그보다 높은 역할의 멤버만 승인합니다(위 '요청하는 사람과 승인하는 사람'). 소유자와, DDL 제한 항목이 비활성화된 다른 역할을 선택할 수 있습니다.
- 승인자 역할을 변경하고 저장하면 이미 대기 중인 요청에도 바로 적용됩니다.
승인 요청하기
요청은 ERD 가 아니라 변경한 테이블 단위로 보냅니다. 개인 ERD, 팀 ERD, 테이블 탭, 탐색기 어디에서 반영하든 같은 요청이 됩니다.
- ERD 정보 패널의 변경사항 DB 반영... 버튼처럼 평소 DB 에 반영하던 곳에서 변경사항 미리보기 및 실행 창을 엽니다. 내가 변경한 테이블만 목록에 들어옵니다.
- DDL 실행 버튼(1)은 클릭할 수 없습니다. 반영할 테이블을 선택하고 DB 반영 요청 버튼(2)을 클릭합니다.
- DB 반영 요청 창의 반영 사유 칸에 이유를 500자 안으로 적고 요청 버튼을 클릭합니다. 이유를 적어야 보낼 수 있습니다.
- 요청이 패널의 대기 중 탭에 들어갑니다.
- 스키마 변경사항 패널에서 반영할 때는 변경 검토 창 다음의 DDL 미리보기 & 실행 창 아래에 적용 사유 칸이 있습니다. 이유를 적고 승인 요청 버튼이나 전체 승인 요청 버튼을 클릭합니다. 커넥션과 데이터베이스마다 요청이 하나씩 만들어집니다.
- 대기 중인 요청은 대기 중 탭의 철회 버튼으로 철회합니다. 철회한 요청은 처리 완료 탭으로 옮겨 갑니다.
검토하고 승인하기
- 패널의 대기 중 탭에서 요청 줄을 클릭합니다. DDL 승인 검토 창이 열립니다.
- 요청 정보(1)에서 누가 어느 DB 에 왜 반영하려는지 확인합니다.
- DDL 내용 칸(2)의 DDL 을 읽고, 필요하면 수정합니다. 요청을 승인할 수 있는 사람이 대기 중인 요청을 열 때만 수정할 수 있습니다.
- 승인/거부 메시지 칸(3)에 요청한 사람에게 남길 말을 적습니다. 적지 않아도 됩니다.
- 승인 및 DDL 실행 버튼(6)을 클릭하고 확인 창에서 실행 버튼을 클릭합니다. 내 앱이 요청의 커넥션으로 DDL 을 실행하고, 실행에 성공해야 승인으로 기록됩니다.
- 실행에 실패하면 승인 처리 실패 창에 오류가 나오고 요청은 승인 대기 상태로 남습니다. DDL 을 수정해 다시 승인하거나 거부하세요.
- 반영하지 않으려면 거부 버튼(5)을 클릭합니다. 요청한 사람의 변경은 그대로 남으므로, 요청한 사람이 수정해서 다시 요청하거나 변경을 되돌립니다.
- DDL 을 SQL 편집기에서 따로 실행하려면 DDL 복사 버튼(4)으로 복사합니다. 이렇게 실행하면 요청은 대기 중으로 남습니다.
처리한 뒤
- 요청한 사람에게 승인이나 거부 알림이 갑니다. 알림을 클릭하면 패널의 처리 완료 탭에서 요청이 열립니다.
- 처리한 요청의 DDL 승인 검토 창에는 처리자, 처리 메시지, 실제로 실행한 최종 실행 쿼리 항목이 보입니다.
- 승인하면 요청한 사람의 화면에서 반영된 변경 표시가 사라집니다. 요청을 보낸 뒤에 더 수정한 부분은 변경으로 남습니다. 알림을 받을 때나 프로젝트를 다시 열 때 DB 를 다시 읽어 맞춥니다.
- 승인과 함께 실행한 DDL 은 승인한 사람의 SQL 이력과 저장된 SQL 에 남습니다.
- 새 요청이 오면 그 요청을 승인할 수 있는 멤버에게 알림이 갑니다. 요청한 사람 자신은 받지 않습니다. 알림을 클릭하면 패널의 대기 중 탭에서 요청이 열립니다.
- 프로젝트를 열 때 내가 승인할 수 있는 대기 중인 요청이 있으면 DDL 승인 대기 창이 표시됩니다. 요청한 사람에게는 자기 요청 때문에 이 창이 표시되지 않습니다.
주의할 점
- DDL 은 승인한 사람의 앱이 실행합니다. 데스크톱 앱은 승인한 사람의 기기에서, 웹 앱은 NeoSQL 서버에서 DB 에 접속합니다. 승인한 사람이 대상 커넥션으로 DB 에 접속할 수 있어야 합니다(연결과 실행 대상).
- 승인하면 확인 창 하나를 거쳐 그대로 실행됩니다. 운영 DB 라면 DDL 을 끝까지 읽고 승인하세요.
- 수정한 DDL 은 SQL 편집기와 같은 기준으로 문장을 나눠 차례로 실행합니다. 문장을 더할 때는 앞 문장 끝에
;를 붙이세요. - DDL 제한 권한은 NeoSQL 화면에서의 DDL 실행을 차단할 뿐입니다. 커넥션의 DB 계정에 DDL 권한이 있으면 같은 DB 계정으로 접속하는 다른 도구에서는 차단하지 못합니다. DDL 을 반드시 차단해야 하는 운영 DB 는 DB 계정의 권한으로 차단하세요. 제한할 멤버가 사용하는 커넥션은 DDL 권한이 없는 DB 계정으로 만듭니다(운영 DB 안전장치).
- 역할의 DDL 제한 항목을 비활성화하고 설정을 저장하면 그 역할 멤버가 반영하지 않은 변경은 버려지고, 승인을 기다리던 요청은 취소됩니다. 남겨야 할 요청은 항목을 비활성화하기 전에 처리하세요.
관련 화면
- DB 반영: 승인을 요청하는 변경사항 미리보기 및 실행 창입니다.
- 공유와 멤버: 역할을 주고 역할별 권한을 정합니다.
- 협업과 권한: 역할과 권한 항목, DDL 제한 멤버의 변경이 따로 보관되는 이유입니다.
- 운영 DB 안전장치: 실행 경로마다 걸리는 장치입니다.
- SQL 이력과 저장된 SQL: 실행한 DDL 이 남는 곳입니다.