따라 하기

첫 쿼리를 실행하고 결과 수정하기

따라 하면 SQL 편집기에서 데모 상점의 customer 테이블을 조회하고, 결과 그리드에서 고객 한 명의 등급을 수정해 DB 에 확정한 뒤, 결과를 CSV 파일로 내보내게 됩니다. 10분쯤 걸립니다. 결과를 수정하는 단계는 실제로 UPDATE 를 실행하므로 연습용 DB 에서 하세요.

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

결과를 파일로 내보내는 마지막 단계는 데스크톱 앱에서만 지원합니다. 웹 앱에서는 복사로 대신합니다.

준비

  • 접속 정보가 있는 커넥션이 하나 있어야 합니다. 없으면 데스크톱에서 첫 ERD 를 만들어 DB 에 반영하기 의 '커넥션 만들기' 를 먼저 하세요. 거기서 만든 테이블은 비어 있으니, 아래 '셀 수정하기' 대신 Add 버튼으로 행을 넣어 보세요.
  • 예의 customer 테이블은 customer_id(기본 키), email, name, grade 컬럼을 가집니다.
  • SQL 탭 하나가 DB 세션 하나라는 것과 Auto Commit 스위치가 하는 일을 알아 두면 수정하는 단계가 쉽습니다(SQL 실행과 트랜잭션).

SQL 탭 열기

  1. 탐색기에서 main 스키마를 우클릭하고 탐색기 우클릭새 SQL 편집기... 메뉴를 선택합니다. 결과: SQL 편집기 생성 창이 열립니다. Connection 칸과 Schema 칸은 우클릭한 위치로 기입되어 있습니다.
  2. 창에서 제목을 적습니다.
  3. 확인 버튼을 클릭합니다. 결과: SQL 문서가 프로젝트에 만들어지고 SQL 탭이 열립니다. 도구 모음의 실행 대상(6)에 shop-db / main 이 보이고, 탭이 사용할 DB 세션이 그 커넥션과 스키마로 정해집니다.

첫 쿼리 실행하기

  1. 편집기에 아래 SQL 을 적습니다.

    SELECT customer_id, email, name, grade
    FROM customer;
    
  2. 문장 안에 커서를 둡니다. 결과: 커서를 둔 문장 왼쪽에 초록 막대가 붙어, 실행할 문장을 보여 줍니다.

  3. Execute 버튼을 클릭하거나 Ctrl+Enter(macOS 는 Cmd+Enter)를 누릅니다. 결과: 커서가 있는 문장 하나만 탭의 세션에서 실행되고, 결과 탭이 하나 생깁니다. 탭에 여러 문장을 작성해 두어도 다른 문장은 실행되지 않습니다. 모두 실행하려면 Run Script 버튼을 사용합니다(SQL 편집기).

결과 살펴보기

  1. 상태 줄(9)에서 받아 온 행 수를 봅니다. 결과: 결과 표는 행 수 칸(3)에서 선택한 만큼만 받아 옵니다. 결과가 더 있으면 (truncated) 표시와 Load More 버튼이 보입니다.
  2. 컬럼 머리(6)에 마우스를 올려 타입과 설명을 보고, 머리를 클릭해 정렬합니다. 결과: 정렬과 거르기는 처음에는 받아 온 행 안에서만 합니다(결과 그리드).
  3. 셀을 하나 클릭합니다. 결과: 오른쪽 Value 패널(8)에 값이 크게 보입니다.

Auto Commit 비활성화하기

수정하기 전에 Auto Commit 스위치를 비활성화하세요. 활성화해 둔 채로 수정하면 실행하는 순간 확정되어 되돌릴 수 없습니다. 비활성화하면 실행한 변경이 트랜잭션 안에 남아, 결과를 보고 확정하거나 되돌릴 수 있습니다.

  1. 도구 모음의 Auto Commit 스위치(1)를 비활성화합니다. 결과: Commit 버튼과 Rollback 버튼(2)이 나타나고, 탭의 세션이 수동 커밋으로 변경됩니다. 다른 SQL 탭과 다른 사람의 세션에는 영향이 없습니다.

셀 수정하기

  1. Demo Customer 02 행의 grade 셀을 두 번 클릭합니다.
  2. SILVER 를 적고 Enter 를 누릅니다. 결과: 셀의 색이 변경되고(1), 상태 줄에 변경 요약(6)이 생깁니다. 아직 아무것도 DB 로 가지 않았습니다. 수정한 값은 화면에만 있고, 상태 줄의 Discard 버튼(5)으로 버릴 수 있습니다.

결과를 수정할 수 있는 것은 모든 컬럼이 customer 한 테이블에서 왔고, 그 테이블의 기본 키 customer_id 가 결과에 들어 있기 때문입니다. NeoSQL 은 기본 키 값으로 수정할 행을 찾습니다. SQL 에서 customer_id 를 제외하면 셀을 읽기 전용입니다. 조건 전체는 결과 데이터 편집 에서 설명합니다.

미리 보고 실행하기

  1. 상태 줄의 Preview Changes 버튼을 클릭합니다. 결과: 데이터 변경사항 미리보기 창이 열립니다.
  2. UPDATE customer SET grade = ... WHERE customer_id = ... 문이 하나 있는지 확인합니다. WHERE 가 기본 키로 행 하나를 가리키는지 보세요.
  3. 실행 버튼을 클릭합니다. 결과: UPDATE 가 탭의 세션에서 실행되고, NeoSQL 이 원래 SQL 을 다시 실행해 결과를 새로고침합니다. Auto Commit 을 껐으므로 변경은 아직 확정되지 않았고, 도구 모음에 Uncommitted 표시가, 작업 탭에 TX 표시가 붙습니다.

커밋하기

  1. 새로고침한 결과에서 grade 가 SILVER 인지 확인합니다.
  2. 맞으면 Commit 버튼을 클릭합니다. 잘못 수정했으면 Rollback 버튼을 클릭합니다. 결과: Commit 버튼은 변경을 DB 에 확정해 다른 세션에서도 보이게 하고, Rollback 버튼은 트랜잭션의 변경을 모두 되돌립니다. 어느 쪽을 클릭하든 Uncommitted 표시가 사라집니다.

커밋하지 않은 채 오래 두면 NeoSQL 이 트랜잭션을 롤백할 수 있습니다. 탭을 닫거나 실행 대상을 변경할 때도 묻습니다 (SQL 실행과 트랜잭션).

조인한 결과에서 수정하기

여러 테이블을 조인한 결과도 셀은 수정할 수 있습니다. 컬럼마다 원래 테이블을 찾아 UPDATE 합니다.

  1. 아래 SQL 을 실행합니다.

    SELECT o.order_id, o.status, c.customer_id, c.name
    FROM orders o
    JOIN customer c ON c.customer_id = o.customer_id;
    

    결과: 조회 결과에 orders 의 기본 키 order_id 와 customer 의 기본 키 customer_id 가 모두 있어서 두 테이블의 컬럼을 수정할 수 있습니다. 행 추가, 복제, 삭제는 결과가 테이블 하나에서 왔을 때만 지원하므로 행 추가, 복제, 삭제 버튼은 보이지 않습니다.

  2. status 셀과 name 셀을 수정하고 미리보기를 엽니다. 결과: status 셀은 orders 에, name 셀은 customer 에 UPDATE 하는 문장이 되어, 문장이 두 테이블로 나뉩니다.

결과 내보내기

  1. customer 결과 탭으로 돌아가 결과 도구의 Export 버튼을 클릭합니다. 결과: 데이터 Export 창이 열립니다.
  2. 단계 표시(1)의 형식 단계에서 CSV 를 선택하고 다음 버튼으로 넘어가며 옵션과 미리보기를 확인합니다.
  3. 마지막 단계에서 다운로드 버튼을 클릭합니다. 결과: 처음 상태(클라이언트 모드)에서는 화면에 받아 온 행이 파일로 저장됩니다. 받아 오지 않은 행까지 모두 담으려면 결과의 Filter/Sort 줄에서 서버 모드를 선택한 뒤 내보냅니다(결과 내보내기).

웹 앱에서는 Export 버튼이 해당 기능은 앱에서만 사용할 수 있습니다. 안내만 띄웁니다. 행을 선택하고 우클릭해 CSV로 복사 항목이나 복사 항목으로 복사하세요.

다음에 할 일