화면: SQL 편집기

결과 데이터 편집

SQL 결과 그리드에서 셀의 값을 수정하고, 행을 더하거나 삭제합니다. 수정한 내용은 바로 DB 로 가지 않고, NeoSQL 이 만든 UPDATE, INSERT, DELETE 문을 확인한 뒤 실행해야 반영됩니다. 실행한 문장이 언제 확정되는지는 SQL 실행과 트랜잭션 에서 설명합니다.

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

화면 구성

번호이름설명
1수정한 셀값을 변경한 셀은 색이 변경됩니다.
2추가한 행초록 배경입니다. 기본값이 있는 컬럼은 기본값이, 자동 증가 컬럼은 Not Set 이 회색으로 보이고, 두 컬럼은 비워 두면 INSERT 문에서 빠져 DB 가 채웁니다. 나머지는 null 로 시작합니다.
3삭제 표시한 행붉은 배경에 취소선입니다. 실행하기 전까지는 표에 남아 있습니다.
4행 버튼Add 버튼, Duplicate 버튼, 삭제 버튼입니다. 결과가 테이블 하나에서 왔을 때만 보입니다.
5변경 버튼Preview Changes 버튼과 Discard 버튼입니다. 수정한 내용이 있을 때만 보입니다.
6변경 요약1 deleted, 1 modified, 1 added 처럼 삭제한, 수정한, 더한 행 수입니다.
  • 수정할 수 없는 컬럼의 머리에 마우스를 올리면 이유가 보입니다. 원본 컬럼을 알 수 없는 컬럼은 원본 테이블 컬럼을 확인할 수 없어 편집할 수 없습니다. 안내입니다. 생성 컬럼은 머리에 계산 아이콘이 붙고 읽기 전용입니다.

편집이 활성화되는 조건

결과 그리드에는 편집 스위치가 없습니다. 아래 조건을 만족하는 결과는 처음부터 수정할 수 있습니다.

NeoSQL 은 실행한 SQL 을 분석해 결과의 컬럼마다 어느 테이블의 어느 컬럼에서 왔는지 확인합니다. 원본이 확인된 컬럼만 수정할 수 있습니다.

하는 일조건
셀 수정하기컬럼의 원본 테이블이 확인되고, 원본 테이블의 기본 키 컬럼이 결과에 들어 있어야 합니다. 조인한 결과도 컬럼마다 원본 테이블로 UPDATE 합니다
행 추가, 복제결과의 모든 원본 컬럼이 같은 테이블 하나에서 와야 합니다
행 삭제위에 더해 원본 테이블의 기본 키 컬럼이 결과에 들어 있어야 합니다

수정할 수 없는 경우:

  • 식, 함수, 집계로 만든 컬럼(count(*), price * qty 등)은 원본이 없어 읽기 전용입니다. 서브쿼리나 WITH 로 만든 컬럼도 원본을 확인하지 못하면 읽기 전용입니다.
  • 다시 실행해도 데이터가 변경되지 않는다고 확인되지 않은 SQL 의 결과는 읽기 전용입니다(SQL 재실행 제한). 변경을 반영한 뒤 결과를 다시 조회하기 때문입니다.
  • SQL 탭의 실행 대상을 변경한 뒤의 이전 결과는 읽기 전용입니다(다른 대상에서 조회한 결과라 편집할 수 없습니다.).
  • 기본 키를 강제하지 않는 Snowflake, Databricks, BigQuery 는 상태 줄의 편집 옵션 버튼에서 행 식별 컬럼 칸을 직접 선택해야 수정하거나 삭제할 수 있습니다. 비교할 수 있는 일반 타입의 컬럼만 선택할 수 있습니다.

셀 수정하기

  1. 셀을 두 번 클릭하거나, 셀을 선택하고 Enter, F2 를 누르거나 바로 글자를 입력합니다. 셀이 편집 상태가 됩니다.
  2. 값을 적고 Enter 를 누릅니다. 셀의 색이 변경되고 상태 줄에 변경 요약이 생깁니다.
  3. 긴 값은 오른쪽 Value 패널에서 수정하고 적용 버튼을 클릭합니다.
  • 셀 편집기와 값 패널에서 값의 종류를 Value 항목(적은 값), Expression 항목(now() 같은 식을 그대로), NULL 항목 가운데 선택합니다. 추가한 행에는 DB 기본값에 맡기는 Not Set 항목도 있습니다.
  • 열거형(ENUM, PostgreSQL 사용자 정의 열거형)과 SET 컬럼은 목록에서 선택합니다. 공간 데이터는 WKT 로 수정하는 창이 열립니다.
  • 외래 키 컬럼의 눈 아이콘을 클릭하면 참조 데이터 창이 참조하는 행을 보여 줍니다.

행 추가, 복제, 삭제

  • 새 행: Add 버튼을 클릭합니다. 선택한 행 바로 아래(선택한 행이 없으면 맨 위)에 빈 행이 생기고 첫 셀이 편집 상태가 됩니다.

  • 복제: 행을 선택하고 Duplicate 버튼을 클릭하거나, 우클릭하고 행 복제하기 항목을 선택합니다. 선택한 행 아래에 복사본이 생깁니다. 기본 키와 생성 컬럼은 새 행처럼 비워 둡니다.

  • 삭제: 행을 선택하고 삭제 버튼을 클릭하거나, 우클릭하고 삭제 대상으로 표시 항목을 선택합니다. 삭제 표시가 붙습니다. 삭제 표시한 행에 다시 하면 표시가 해제됩니다.

  • 여러 행을 함께 선택해(Ctrl, Cmd, Shift 를 누른 채 클릭) 한 번에 복제하거나 삭제 표시할 수 있습니다.

  • 아직 실행하지 않은 추가 행을 삭제하면 표시 없이 바로 없어집니다.

  • 결과가 0행이어도 Add 버튼으로 행을 넣을 수 있습니다.

미리 보고 실행하기

  1. Preview Changes 버튼을 클릭합니다. 데이터 변경사항 미리보기 창이 만들어질 SQL 과 삭제한, 수정한, 더한 건수를 보여 줍니다.
  2. 필요하면 스키마명 포함 항목을 활성화하고 비활성화합니다. SQL 에 스키마.테이블 로 적을지입니다.
  3. SQL 을 확인하고 실행 버튼을 클릭합니다. 실행하지 않고 SQL 만 가져가려면 SQL 복사 버튼을 클릭합니다.
  • 문장은 삭제, 수정, 추가 순서로, SQL 탭의 세션에서 하나씩 실행합니다. 한 문장이 실패하면 SQL 실행 오류 창에서 중지 버튼, 재시도 버튼, 건너뛰기 버튼 가운데 선택합니다.
  • 모두 성공하면 원래 SQL 을 다시 실행해 결과를 DB 기준으로 새로고침합니다. 실패한 문장이 있으면 결과 탭에 실행한 문장과 오류가 보입니다.
  • 만들 수 없는 변경(기본 키가 결과에 없는 테이블의 수정 등)은 창 위에 이유가 보이고 변경에서 빠집니다.
  • 한 문장이 여러 행을 변경하면 한 편집 문장이 여러 행에 영향을 주었습니다. 실행 결과의 최대 영향 행 수: 2행. 경고가 표시됩니다. 선택한 키 컬럼의 값이 여러 행에서 같을 때 생깁니다.

되돌리기와 트랜잭션

시점되돌리는 방법
실행하기 전Discard 버튼을 클릭하면 모든 변경을 버리고 받아 온 값으로 돌아갑니다
실행한 뒤, Auto Commit 스위치가 비활성화된 탭변경은 트랜잭션 안에 있습니다. 도구 모음의 Rollback 버튼으로 되돌리고, Commit 버튼을 클릭해야 확정됩니다
실행한 뒤, Auto Commit 스위치가 활성화된 탭문장마다 바로 확정되어 되돌릴 수 없습니다
  • 수정한 내용이 있는 채로 SQL 을 다시 실행하거나 SQL 탭의 실행 대상을 변경하면 수정사항 확인 창이 버릴지 묻습니다. Load More 버튼도 버릴지 먼저 묻습니다.
  • 수정한 내용이 있는 채로 SQL 탭을 닫으면 반영할지 버릴지 묻습니다. 반영을 선택하면 미리보기 창 없이 실행하지만, 커넥션 프로파일의 보호 모드는 거칩니다.

주의할 점

  • 결과 그리드의 변경은 커넥션 프로파일의 보호 모드를 거칩니다. 보호 모드가 읽기 전용인 커넥션에서는 실행하지 않고 차단합니다. 위험 SQL 확인은 하지 않으니 운영 DB 에서는 미리보기의 SQL 을 꼭 확인하세요(운영 DB 안전장치).
  • 수정과 삭제는 결과에 있는 기본 키 값으로 행을 찾습니다. 기본 키가 결과에 없는 테이블은 수정할 수 없으니 SQL 에 기본 키 컬럼을 넣으세요.
  • 테이블, 뷰의 데이터 탭에서 기본 키가 없는 테이블이나 뷰를 수정하면 모든 컬럼의 값으로 행을 찾습니다. 같은 값을 가진 다른 행도 함께 변경될 수 있어, 적용하기 전에 기본 키가 없어 모든 컬럼의 값으로 고칠 행을 찾습니다(orders_log). 같은 값을 가진 다른 행도 함께 바뀔 수 있습니다. 문구로 묻습니다. 보호 모드의 확인이 필요하면 같은 창에서 함께 묻습니다.
  • 결과를 받은 뒤 다른 사람이 같은 행을 변경했어도 NeoSQL 은 알지 못합니다. 실행하면 내가 수정한 컬럼이 다른 사람의 값을 덮어씁니다.
  • CLOB 처럼 긴 텍스트 타입은 결과에는 앞 1,000자만 담깁니다. 값이 잘린 컬럼의 셀을 수정하면 편집기가 빈 값으로 시작하고, 새 값을 적지 않고 닫으면 변경되지 않습니다. Value 패널에서는 그 컬럼을 읽기 전용입니다. 잘린 값이 그대로 저장돼 뒤의 내용이 사라지지 않게 하기 위해서입니다.
  • 행을 삭제하면 종속 행은 외래 키의 ON DELETE 설정을 따릅니다. 함께 삭제해야 하면 따로 작성한 DELETE 문으로 삭제하세요.
  • 계정 프로젝트에서 마스킹된 컬럼의 셀을 수정하면 편집기가 빈 값으로 시작합니다. 새 값을 적지 않고 닫으면 변경되지 않습니다. 마스킹된 컬럼은 행 식별 컬럼 칸으로 선택할 수 없습니다.

관련 화면