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 는 상태 줄의 편집 옵션 버튼에서 행 식별 컬럼 칸을 직접 선택해야 수정하거나 삭제할 수 있습니다. 비교할 수 있는 일반 타입의 컬럼만 선택할 수 있습니다.
셀 수정하기
- 셀을 두 번 클릭하거나, 셀을 선택하고
Enter,F2를 누르거나 바로 글자를 입력합니다. 셀이 편집 상태가 됩니다. - 값을 적고
Enter를 누릅니다. 셀의 색이 변경되고 상태 줄에 변경 요약이 생깁니다. - 긴 값은 오른쪽 Value 패널에서 수정하고 적용 버튼을 클릭합니다.
- 셀 편집기와 값 패널에서 값의 종류를 Value 항목(적은 값), Expression 항목(
now()같은 식을 그대로), NULL 항목 가운데 선택합니다. 추가한 행에는 DB 기본값에 맡기는 Not Set 항목도 있습니다. - 열거형(
ENUM, PostgreSQL 사용자 정의 열거형)과SET컬럼은 목록에서 선택합니다. 공간 데이터는 WKT 로 수정하는 창이 열립니다. - 외래 키 컬럼의 눈 아이콘을 클릭하면 참조 데이터 창이 참조하는 행을 보여 줍니다.
행 추가, 복제, 삭제
새 행: Add 버튼을 클릭합니다. 선택한 행 바로 아래(선택한 행이 없으면 맨 위)에 빈 행이 생기고 첫 셀이 편집 상태가 됩니다.
복제: 행을 선택하고 Duplicate 버튼을 클릭하거나, 우클릭하고 행 복제하기 항목을 선택합니다. 선택한 행 아래에 복사본이 생깁니다. 기본 키와 생성 컬럼은 새 행처럼 비워 둡니다.
삭제: 행을 선택하고 삭제 버튼을 클릭하거나, 우클릭하고 삭제 대상으로 표시 항목을 선택합니다. 삭제 표시가 붙습니다. 삭제 표시한 행에 다시 하면 표시가 해제됩니다.
여러 행을 함께 선택해(
Ctrl,Cmd,Shift를 누른 채 클릭) 한 번에 복제하거나 삭제 표시할 수 있습니다.아직 실행하지 않은 추가 행을 삭제하면 표시 없이 바로 없어집니다.
결과가 0행이어도 Add 버튼으로 행을 넣을 수 있습니다.
미리 보고 실행하기
- Preview Changes 버튼을 클릭합니다. 데이터 변경사항 미리보기 창이 만들어질 SQL 과 삭제한, 수정한, 더한 건수를 보여 줍니다.
- 필요하면 스키마명 포함 항목을 활성화하고 비활성화합니다. SQL 에
스키마.테이블로 적을지입니다. - 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문으로 삭제하세요. - 계정 프로젝트에서 마스킹된 컬럼의 셀을 수정하면 편집기가 빈 값으로 시작합니다. 새 값을 적지 않고 닫으면 변경되지 않습니다. 마스킹된 컬럼은 행 식별 컬럼 칸으로 선택할 수 없습니다.
관련 화면
- 결과 그리드: 결과 탭, 필터, 값 패널, 복사입니다.
- SQL 실행과 트랜잭션: Auto Commit 스위치와 커밋 시점입니다.
- 운영 DB 안전장치: 보호 모드와 위험 SQL 확인이 걸리는 곳입니다.
- 테이블 탭: 테이블 하나의 데이터를 조회하고 수정하는 Data 탭입니다.