데모 상점의 설계를 세 사람이 함께 하는 순서를 따라 합니다. 나는 프로젝트 소유자이고, DBA 팀원은 스키마 변경을 검토해 DB 에 반영하며, 개발자 팀원은 ERD 에서 테이블을 수정하되 운영 DB 에 직접 DDL 을 실행하지는 못하게 합니다. 끝나면 셋이 같은 팀 ERD 를 보며 수정하고, 개발자 팀원의 변경은 DBA 팀원의 승인을 거쳐 DB 에 반영됩니다. 무엇을 함께 사용하고 무엇이 나만의 것인지, 권한이 어떻게 정해지는지는 협업과 권한 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
준비
- 로그인하세요. 팀원과 함께 사용하는 기능은 계정 프로젝트에만 있습니다. 로컬 프로젝트는 공유할 수 없고, 나중에 계정 프로젝트로 변경할 수도 없습니다(로그인과 프로젝트 종류).
- 플랜의 공유 인원을 확인하세요. 공유 인원이 1명인 플랜(Free 플랜)에서는 헤더에 협업 버튼이 보이지 않아 초대할 수 없습니다. 팀 ERD 를 저장하면 팀원 화면에 바로 반영되는 공동 편집도 함께 사용할 사람이 있어야 의미가 있습니다 (플랜과 기능 차이).
- 워크스페이스와 프로젝트 초대 가운데 무엇이 필요한지 정하세요. 프로젝트 하나에 팀원을 들이는 프로젝트 초대를 따라 합니다.
| 필요한 것 | 사용할 것 |
|---|---|
| 팀원이 이 프로젝트에 들어와 함께 설계한다 | 프로젝트 초대(이 페이지). 인원은 프로젝트 플랜의 공유 인원을 사용합니다 |
| 팀원이 결제 없이 내 플랜으로 자기 프로젝트를 만든다 | 워크스페이스. 인원은 워크스페이스 좌석을 사용합니다 |
| 둘 다 | 둘 다 따로 초대합니다. 워크스페이스에 초대해도 프로젝트는 공유되지 않습니다 |
- 팀원은 NeoSQL 회원이 아니어도 이메일로 초대할 수 있습니다. 초대받은 이메일로 가입한 뒤 받아들입니다.
계정 프로젝트 만들기
- 헤더 왼쪽 앱 메뉴의 항목을 클릭합니다. 결과: 새 프로젝트 창이 열립니다. 웹 앱에서는 늘 계정 프로젝트를 만듭니다.
- 데스크톱 앱이면 계정 버튼(1)이 선택되어 있는지 확인합니다. 다른 사람의 워크스페이스에 소속되어 있으면 소속 (플랜) 칸에서 프로젝트를 둘 플랜을 선택합니다. 결과: 프로젝트의 공유 인원이 선택한 플랜으로 정해집니다. 나중에 소유권을 넘기기 전에는 변경되지 않습니다.
- 이름을 적고 생성 버튼을 클릭합니다. 결과: 프로젝트가 NeoSQL 서버에 만들어지고 열립니다. 창의 항목은 새 프로젝트 에서 설명합니다.
- 팀이 함께 사용할 DB 의 커넥션을 만듭니다. 호스트는 팀원 모두가 접속할 수 있는 서버 주소로 적습니다. 결과: 공개 커넥션으로 저장되어 팀원에게도 보입니다.
localhost나 SQLite 파일을 가리키면 나에게만 보이는 개인 커넥션이 되고, 커넥션의 ERD 는 팀 ERD 로 변경할 수 없습니다(연결과 실행 대상).
팀원 초대하기
- 헤더의 협업 버튼을 클릭합니다. 결과: 프로젝트 공유 설정 창이 열립니다.
- 팀원 초대 칸(1)에 DBA 팀원의 닉네임이나 이메일을 넣고, 초대 버튼(5) 오른쪽 화살표에서 DBA 역할을 선택해 초대합니다. 결과: 초대가 대기중인 초대 목록(4)에 들어가고 DBA 팀원에게 초대 메일이 갑니다. 이미 회원이면 앱의 알림에도 옵니다.
- 개발자 팀원은 초대 버튼(5)을 그대로 클릭해 멤버 역할로 초대합니다. 결과: 가장 권한이 적은 역할로 들어옵니다. 나중에 소유자가 역할을 올릴 수 있습니다.
- 팀원은 초대 메일의 링크를 열거나, 앱의 알림에서 초대를 선택해 수락 버튼을 클릭합니다. 결과: 팀원이 팀원 목록 목록(2)에 역할과 함께 나타나고, 홈에서 프로젝트를 엽니다.
- 초대는 7일 동안 받을 수 있습니다. 초대받은 이메일과 같은 이메일의 계정으로 로그인해야 받을 수 있습니다.
- 역할마다 초대, 내보내기, 소유권 넘기기를 할 수 있는지는 공유와 멤버 에서 설명합니다.
역할별 권한 정하기
DB 반영을 누가 하는지 팀원이 ERD 를 수정하기 전에 정합니다. DDL 제한을 활성화하기 전에 저장한 변경은 팀과 바로 공유되어, 제한을 활성화한 뒤의 변경과 다르게 다뤄지기 때문입니다.
- 소유자 계정으로 헤더의 프로젝트 설정 버튼을 클릭하고 탭을 엽니다. 결과: 소유자를 제외한 역할마다 탭이 있고, 탭마다 권한 항목이 보입니다. 탭은 소유자만 변경합니다.
- 멤버 역할 탭에서 DDL 제한 항목을 선택하고, 승인자 역할 칸에서 DBA 역할을 선택합니다. 결과: 멤버는 DDL 을 직접 실행하지 못하고, 요청은 DBA 이상의 역할과 소유자만 승인합니다. 멤버의 Connection 권한 항목은 비활성화됩니다.
- 개발자 팀원이 고객 정보를 보면 안 되면 같은 탭에서 민감정보 마스킹 처리 항목도 선택합니다. 결과: 멤버 역할의 팀원에게 민감 컬럼으로 지정한 값이 마스킹되어 보입니다. 컬럼 지정은 컬럼 마스킹 에서 합니다.
- 프로젝트 설정 창을 저장합니다. 결과: 개발자 팀원이 프로젝트를 다시 열 때부터 위 제한이 걸립니다. 지금 프로젝트를 열어 둔 팀원이 있으면 다시 열어 달라고 하세요.
팀 ERD 로 함께 설계하기
계정 프로젝트에서 새로 만든 ERD 는 나만 보는 개인 ERD 로 시작합니다. 함께 볼 ERD 는 팀 ERD 로 변경합니다.
- 팀이 함께 사용하는 커넥션으로 ERD 를 만들고
customer,orders,order_item,product테이블을 넣습니다(ERD 와 SQL 목록). 결과: 개인 ERD 가 만들어집니다. 정보 패널의 유형 칸(1)에 개인 ERD 라고 보입니다. - 정보 패널의 더보기 메뉴에서 팀 공유 및 협업 시작... 항목(2)을 선택합니다. 결과: 팀 ERD 가 되어 프로젝트 멤버 모두에게 보입니다. 되돌릴 수 없습니다. 나만의 사본이 필요하면 내 ERD로 복사 항목으로 만듭니다.
- DBA 팀원이 ERD 에서
product테이블에discontinued_at컬럼을 더하고 저장합니다. 결과: 저장한 변경이 다른 팀원의 화면에 바로 반영됩니다. 아직 DB 에 반영하지 않은 변경이라 팀원 모두에게 변경 표시로 보입니다. - 개발자 팀원이
orders테이블에memo컬럼을 더하고 저장합니다. 결과: 개발자 팀원은 DDL 이 제한되어 있으므로 테이블 변경은 승인될 때까지 따로 보관되고, 다른 팀원의 화면에는 보이지 않습니다.
- 두 사람이 서로 다른 곳을 수정했으면 묻지 않고 합칩니다. 같은 테이블을 서로 다르게 수정했을 때만 ERD 동기화 충돌 창이 표시되어 어느 쪽을 남길지 묻습니다. 저장하지 않은 변경이 없는 화면에는 팀원의 변경이 묻지 않고 반영되므로, 오래 수정할 때는 자주 저장하세요.
- 팀 ERD 는 모든 권한 권한이나 팀 ERD 삭제 권한 권한이 있는 사람만 삭제합니다. 만든 사람이라도 권한이 없으면 삭제하지 못합니다.
승인을 거쳐 DB 에 반영하기
- 개발자 팀원이 정보 패널의 변경사항 DB 반영... 버튼을 클릭합니다. DDL 실행 버튼은 클릭할 수 없으므로 DB 반영 요청 버튼을 클릭하고 반영 사유를 적어 보냅니다. 결과: 요청이 패널의 대기 중 탭에 들어갑니다. 승인할 사람에게 알림은 가지 않으니 팀에 미리 알려 두세요.
- DBA 팀원이 오른쪽 레일의 패널에서 요청을 클릭합니다. 결과: DDL 승인 검토 창이 열리고 누가 어느 DB 에 왜 반영하려는지 보입니다.
- DBA 팀원이 DDL 내용 칸(2)의 DDL 을 읽고 필요하면 수정한 뒤 승인 및 DDL 실행 버튼(6)을 클릭하고 확인합니다. 결과: DBA 팀원의 앱이 커넥션으로 DDL 을 실행하고, 성공해야 승인으로 기록됩니다. 실패하면 요청은 대기 중으로 남습니다.
- 개발자 팀원이 알림을 받습니다. 결과: 승인이면 개발자 팀원의 화면에서 반영된 변경 표시가 사라지고,
memo컬럼은 DB 에 있는 컬럼이 됩니다. 거부되었으면 변경은 그대로 남아 수정해서 다시 요청합니다.
- DDL 은 승인한 사람의 앱이 실행합니다. DBA 팀원이 DB 에 접속할 수 있어야 합니다. 데스크톱 앱이면 DBA 팀원의 기기에서, 웹 앱이면 NeoSQL 서버에서 접속합니다(DDL 승인).
- DDL 제한은 NeoSQL 화면에서의 실행을 차단하는 장치이고 완전하지 않습니다. 공개 커넥션의 DB 사용자와 비밀번호는 팀이 함께 사용하고, 승인한 DDL 도 같은 계정으로 실행됩니다. 그래서 계정에 DDL 권한이 있으면 DDL 이 제한된 팀원의 앱도 같은 계정으로 DB 에 접속합니다. 운영 DB 의 계정 권한은 이 점을 알고 정하세요(운영 DB 를 안전하게 연결하기).
다음에 할 일
- 협업과 권한: 권한 항목과 동시에 수정했을 때의 처리를 자세히 봅니다.
- 워크스페이스: 팀원이 내 플랜으로 자기 프로젝트를 만들게 합니다.
- 컬럼 마스킹: 멤버 역할에게 마스킹할 컬럼과 패턴을 정합니다.
- 운영 DB 를 안전하게 연결하기: 팀원 각자가 운영 DB 커넥션에 프로파일을 겁니다.