SQL 편집기는 SQL 탭마다 DB 에 따로 연결을 열고, 연결 안에서 트랜잭션을 다룹니다. 변경된 내용이 언제 DB 에 확정되는지, 버튼을 클릭하면 무엇이 실행되는지, 결과를 언제 수정할 수 있는지를 알아 두면 운영 DB 에서 되돌릴 수 없는 실수를 줄일 수 있습니다. SQL 탭이 어느 커넥션과 스키마에서 실행되는지는 연결과 실행 대상 에서 설명합니다.
SQL 탭 하나가 DB 세션 하나입니다
SQL 탭은 저마다 DB 세션(연결) 하나를 사용합니다. 같은 커넥션의 SQL 탭을 두 개 열면 DB 에는 연결이 두 개 생깁니다.
- 한 탭에서 커밋하지 않은 변경은 탭의 세션 안에만 있습니다. 다른 탭, 다른 사용자, 애플리케이션에는 커밋하기 전까지 보이지 않습니다. DBMS 에 따라 그동안 잡힌 잠금 때문에 다른 쪽의 작업이 기다릴 수 있습니다.
- 결과 그리드에서 수정한 데이터와 결과의 값 필터도 탭의 세션에서 실행합니다.
- 외부 MCP 클라이언트가 보낸 SQL 은 MCP 용 SQL 탭이 따로 열려 탭의 세션에서 실행합니다.
- 탭의 실행 대상(커넥션, 데이터베이스, 스키마)을 변경하면 이전 세션을 닫고 새 세션을 엽니다.
- 세션은 데스크톱에서는 기기의 로컬 서버가, 웹에서는 NeoSQL 서버가 엽니다.
오래 사용하지 않은 세션은 닫힙니다. 데스크톱에서는 탭에서 커넥션 프로파일의 환경마다 시간을 30분에서 720분 사이로 정합니다. 웹에는 항목이 없고 연결이 30분 동안 사용되지 않으면 닫는 것으로 고정됩니다. 프로파일이 없는 커넥션은 사용자 지정 환경의 값을 사용합니다.
| 환경 | 연결 유휴 시간 제한 처음 값 | 트랜잭션 유휴 시간 제한 처음 값 |
|---|---|---|
| 로컬 | 240분 | 120분 |
| 개발 | 180분 | 90분 |
| 스테이징 | 120분 | 60분 |
| 운영 | 60분 | 30분 |
| 사용자 지정 | 60분 | 30분 |
Auto Commit 과 트랜잭션
SQL 탭은 Auto Commit 스위치가 활성화된 채로 열립니다.
| Auto Commit 켬(처음 상태) | Auto Commit 끔 | |
|---|---|---|
| 문장을 실행하면 | 바로 DB 에 확정됩니다 | 트랜잭션 안에 남습니다 |
| 되돌리기 | 할 수 없습니다 | Rollback 버튼으로 되돌립니다 |
| 확정하기 | 따로 할 일이 없습니다 | Commit 버튼을 클릭해야 확정됩니다 |
- Auto Commit 스위치(1)를 비활성화하면 Commit 버튼과 Rollback 버튼(2)이 나타납니다.
- 확정하지 않은 변경이 있으면 도구 모음에 Uncommitted 표시(3)가, 작업 탭에 TX 표시(4)가 붙습니다.
- 확정하지 않은 변경이 있는 채로 스위치를 다시 활성화하면, 먼저 커밋하고 전환할지 묻습니다.
- 트랜잭션을 연 채 정해진 시간(위 표의 트랜잭션 유휴 시간 제한 항목) 동안 아무것도 하지 않으면 NeoSQL 이 트랜잭션을 롤백합니다. 연결이 끊겨 확정하지 않은 변경이 롤백되면 편집기 위에 안내가 표시됩니다.
- BigQuery 의 일반 모드 커넥션은 문장마다 자동으로 커밋하므로 스위치를 비활성화할 수 없습니다.
DDL 은 트랜잭션을 확정할 수 있습니다
CREATE, ALTER, DROP 같은 DDL 은 DBMS 에 따라 트랜잭션과 다르게 움직입니다. Auto Commit 스위치를 비활성화해 두었어도 마찬가지입니다.
| DBMS | DDL 을 실행하면 |
|---|---|
| MySQL, MariaDB, Oracle, Snowflake | 그때까지 커밋하지 않은 변경까지 함께 확정됩니다. DDL 도 되돌릴 수 없습니다 |
| Databricks, BigQuery | DDL 은 문장마다 바로 확정되어 되돌릴 수 없습니다 |
| PostgreSQL, SQL Server, SQLite | 대부분의 DDL 도 트랜잭션 안에 들어가, 커밋하기 전에는 되돌릴 수 있습니다 |
탭을 닫거나 실행 대상을 변경할 때
NeoSQL 은 확정하지 않은 트랜잭션을 저절로 커밋하거나 롤백하지 않습니다. 트랜잭션이 남은 채로 아래 일을 하면 어떻게 할지 묻습니다.
| 하는 일 | 묻는 창 | 선택할 수 있는 것 |
|---|---|---|
| SQL 탭 닫기 | 커밋되지 않은 트랜잭션 창 | 취소 버튼, Rollback 버튼, Commit 버튼 |
| 탭의 실행 대상 변경하기 | 접속 대상 변경 전 트랜잭션 처리 창 | 취소 버튼, Rollback 후 변경 버튼, Commit 후 변경 버튼 |
- 저장하지 않은 SQL 이 있으면 탭을 닫기 전에 저장할지도 묻습니다. SQL 문서는
Ctrl+S(macOS 는Cmd+S)로 저장합니다.
무엇이 실행되는가
| 버튼 | 단축키 | 실행하는 것 |
|---|---|---|
| Execute 버튼 | Ctrl+Enter(macOS 는 Cmd+Enter) | 선택 영역이 있으면 선택한 부분, 없으면 커서가 있는 문장 하나 |
| Run Script 버튼 | Ctrl+Shift+Enter(macOS 는 Cmd+Shift+Enter) | 선택 영역이 있으면 선택한 문장들, 없으면 탭의 모든 문장을 차례로 |
- 문장은
;로 나눕니다. DBMS 에 따라 SQL Server 의GO, Oracle 의/, MySQL, MariaDB 의DELIMITER도 구분자로 읽고, 프로시저 본문 안의;에서는 나누지 않습니다. - 여러 문장을 선택하고 Execute 버튼을 클릭하면 선택한 글자를 한 번에 보냅니다. 여러 문장을 차례로 실행하려면 Run Script 버튼을 사용하세요.
- Run Script 버튼은 문장마다 결과 탭을 만듭니다. 오류가 나면 거기서 멈추고 SQL 실행 오류 창에서 중지 버튼, 재시도 버튼, 건너뛰기 버튼 가운데 선택하게 합니다. 이미 실행한 앞 문장은 Auto Commit 스위치가 활성화되어 있으면 확정되어 있고, 비활성화되어 있으면 트랜잭션 안에 남아 한꺼번에 되돌릴 수 있습니다.
바인드 파라미터
SQL 에 값 자리를 두면 실행할 때 바인드 파라미터 입력 창이 열려 값을 묻습니다. 같은 SQL 을 값만 변경해 여러 번 실행할 때 사용합니다.
| 문법 | 예 | 값이 들어가는 방법 |
|---|---|---|
? | WHERE customer_id = ? | 바인딩 |
:이름 | WHERE status = :status | 바인딩. 같은 이름은 한 번만 입력합니다 |
MyBatis #{이름} | WHERE order_id = #{orderId} | 바인딩 |
MyBatis ${이름} | ORDER BY ${column} | SQL 글자에 그대로 넣습니다 |
- 창의 미리보기는 값을 SQL 에 넣어 보여 주기만 합니다. 실제 실행은 SQL 과 값을 따로 보내는 PreparedStatement 바인딩이므로, 값 안의 따옴표가 SQL 을 깨지 않습니다.
${}자리와, 타입을 Expression 타입으로 선택한 값은 SQL 글자에 그대로 들어갑니다. 창에는 직접 치환 표시가 붙습니다.now()처럼 DB 의 식을 넣을 때 사용하고, 넣은 값이 올바른 SQL 인지는 직접 확인해야 합니다. Expression 타입은?와:이름에서만 선택할 수 있습니다.- 결과 탭과 위험 SQL 확인은 값을 넣은 미리보기 문장을 사용합니다.
- 입력한 값은 같은 SQL 탭 안에서만 기억합니다. 탭을 닫으면 사라집니다.
결과 집합과 행 수
SELECT 의 결과는 한 번에 정해진 행 수까지만 가져옵니다. 결과 탭 줄의 행 수 칸에서 200(처음 값), 500, 1000, 5000 가운데 선택합니다.
- 결과가 더 있으면 결과 아래에 (truncated) 표시와 Load More 버튼이 나옵니다. Load More 버튼은 SQL 을 처음부터 다시 실행해 더 많은 행을 가져옵니다. 그사이 데이터가 변경되었으면 결과도 달라집니다.
- 필터와 정렬은 두 방식이 있습니다.
| 클라이언트 모드 | 서버 모드 | |
|---|---|---|
| 대상 | 이미 받아 온 행 | DB 에 있는 전체 결과 |
| 방법 | 화면 안에서 거르고 정렬합니다 | 조건(WHERE, ORDER BY)을 붙여 SQL 을 다시 실행합니다 |
직접 입력한 WHERE | 사용하지 않습니다 | 적용합니다 |
- 결과가 잘린 상태에서 클라이언트 모드로 거르면 받아 온 행 안에서만 거릅니다.
- SQL 을 다시 실행해야 하는 기능(서버 모드, Load More 버튼, 결과 편집)은 다시 실행해도 데이터가 변경되지 않는다고 확인된 SELECT 에서만 사용할 수 있습니다. 함수로 시퀀스를 올리거나 잠금을 거는 조회, SELECT 가 아닌 문장의 결과에서는 잠기고 클라이언트 모드만 사용합니다. NeoSQL 이 문법을 알아보지 못한 문장은
SELECT,WITH,VALUES,TABLE로 시작할 때만 다시 실행합니다(CALL,EXEC처럼 다른 낱말로 시작하면 잠깁니다).
결과를 수정할 수 있는 조건
결과 그리드는 아래 조건을 모두 만족하면 처음부터 수정할 수 있는 상태로 열립니다. 셀을 두 번 클릭해 수정합니다.
| 조건 | 이유 |
|---|---|
| 컬럼의 원본 테이블을 알 수 있습니다 | 식이나 함수로 만든 컬럼처럼 원본 테이블을 알 수 없는 컬럼은 읽기 전용입니다. 조인한 결과도 셀은 컬럼마다 원본 테이블을 수정합니다. 행 추가, 복제, 삭제는 결과가 테이블 하나에서 왔을 때만 할 수 있습니다 |
| 수정할 행을 가리킬 수 있습니다 | 수정, 삭제 문장은 WHERE 로 행을 찾습니다. 수정할 테이블의 기본 키가 결과에 들어 있어야 합니다 |
| 다시 실행해도 안전한 조회입니다 | 변경을 반영한 뒤 결과를 다시 조회합니다 |
- Snowflake, Databricks, BigQuery 처럼 기본 키를 강제하지 않는 DBMS 는 편집 옵션 버튼에서 행 식별 컬럼 항목을 직접 선택합니다.
- 수정한 내용은 바로 DB 로 가지 않습니다. Preview Changes 버튼을 클릭하면 데이터 변경사항 미리보기 창이 만들 SQL 을 보여 주고, 실행 버튼을 클릭해야 실행합니다. 삭제, 수정, 추가 순서로 실행합니다.
- 변경은 탭의 세션에서 실행되므로, Auto Commit 스위치를 비활성화한 탭에서는 Commit 버튼을 클릭해야 확정됩니다.
- 화면 설명은 결과 데이터 편집 에서 합니다.
날짜와 시간대
결과의 날짜와 시간은 탭의 시간대 항목과 TIMESTAMP 표시 형식 칸, DATE 표시 형식 칸, TIME 표시 형식 칸으로 보여 줍니다. 개인 설정이라 팀원에게 영향을 주지 않고, 처음 값은 기기의 시간대입니다.
| 컬럼 타입 | 예 | 표시 |
|---|---|---|
| 시간대가 있는 타입 | PostgreSQL TIMESTAMPTZ, SQL Server DATETIMEOFFSET, Oracle TIMESTAMP WITH TIME ZONE | 선택한 시간대의 시각으로 변환해 보여 줍니다 |
| 시간대가 없는 타입 | DATE, DATETIME, TIMESTAMP | DB 에 저장된 값을 그대로 보여 줍니다. 시간대를 변경해도 달라지지 않습니다 |
- 결과를 수정할 때 시간대가 있는 컬럼의 값은 선택한 시간대의 오프셋을 붙인 값으로 SQL 을 만듭니다.
주의할 점
- Auto Commit 스위치가 활성화된 탭에서 실행한 UPDATE 와 DELETE 는 되돌릴 수 없습니다. 운영 DB 의 데이터를 수정할 때는 스위치를 비활성화하고 실행한 뒤, 결과를 확인하고 커밋하세요.
- 확정하지 않은 트랜잭션을 오래 두면 잠금이 다른 사용자의 작업을 차단할 수 있고, 트랜잭션 유휴 시간 제한 항목에 정한 시간이 지나면 롤백됩니다.
- 결과 그리드의 변경은 커넥션 프로파일의 보호 모드를 거치지만 위험 SQL 확인은 거치지 않습니다. 운영 DB 에서는 미리보기 SQL 을 꼭 확인하세요. 보호 장치의 범위는 운영 DB 안전장치 에서 설명합니다.
- 결과에 수정할 테이블의 기본 키 컬럼이 없으면 수정, 삭제할 수 없습니다. 기본 키 컬럼을 함께 조회하세요.
관련 페이지
- SQL 편집기: 편집기와 도구 모음, 단축키입니다.
- 바인드 파라미터: 값을 입력하는 창입니다.
- 결과 그리드: 결과 탭, 필터, 행 수를 다룹니다.
- 첫 쿼리를 실행하고 결과 수정하기: 쿼리를 실행하고 결과를 수정해 커밋하는 순서입니다.