화면: SQL 편집기

SQL 편집기

SQL 편집기는 SQL 문서 하나를 작업 문서 탭 하나(문서 탭SQL 에디터)로 열어 SQL 을 작성하고 실행하는 화면입니다. 탭마다 실행 대상(커넥션, 데이터베이스, 스키마)이 정해져 있고, 탭마다 DB 세션을 따로 사용합니다. 세션과 트랜잭션이 어떻게 움직이는지는 SQL 실행과 트랜잭션 에서, 실행 대상은 연결과 실행 대상 에서 설명합니다.

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

화면 구성

번호이름설명
1작업 탭SQL 문서의 제목입니다. 앞의 표시는 커넥션 프로파일의 색으로 칠해집니다. 저장하지 않은 변경이 있으면 닫기 버튼 자리에 점이, 커밋하지 않은 트랜잭션이 있으면 TX 표시가 보입니다.
2실행 버튼Execute 버튼, Run Script 버튼, 취소 버튼, Plan 버튼입니다. 아래 '쿼리 실행하기' 에서 설명합니다.
3대시보드 버튼지금 문장을 대시보드의 타일로 보냅니다. 대시보드 에서 설명합니다.
4Auto Commit 스위치비활성화하면 Commit 버튼과 Rollback 버튼이 나타납니다. 아래 '트랜잭션 다루기' 에서 설명합니다.
5Format 버튼SQL 의 줄바꿈과 들여쓰기를 정리합니다. 아래 '포맷' 에서 설명합니다.
6실행 대상커넥션 / 데이터베이스 / 스키마 로 보입니다. 데이터베이스는 PostgreSQL, SQL Server 처럼 데이터베이스 계층이 있는 DBMS 에서만 보이고, 스키마를 정하지 않았으면 All 표시가 보입니다. 클릭하면 SQL 편집기 설정 창이 열립니다.
7단축키 버튼키보드 아이콘입니다. 편집기의 단축키 목록을 보여 줍니다.
8편집기SQL 을 작성합니다. 커서가 있는 문장은 왼쪽에 초록 막대가 붙어, Execute 버튼이 무엇을 실행할지 보여 줍니다.
9결과 영역결과 탭과 History 탭입니다. 아래 '결과 탭' 에서 설명합니다. 편집기와 결과 영역 사이의 경계선을 드래그해 높이를 변경합니다.
10상태바앱 맨 아래 줄입니다. 탭의 커넥션, 데이터베이스, 스키마와 SQL 문서 제목, 커서 위치(행, 열), 선택한 글자 수를 보여 줍니다. Auto Commit 스위치를 비활성화하면 트랜잭션 칸이 앞에 붙습니다.

도구 모음에는 커넥션과 상태에 따라 다음 항목이 더 보입니다.

보이는 때버튼, 표시하는 일
Auto Commit 스위치를 껐을 때Commit 버튼, Rollback 버튼탭의 트랜잭션을 확정하거나 되돌립니다.
커밋하지 않은 변경이 있을 때Uncommitted 표시실행 대상 옆에 붙습니다.
PostgreSQL 에서 행 수준 보안(RLS)이 활성화된 테이블이 있을 때Test with RLS... 버튼다른 역할로 SQL 을 실행해 봅니다. RLS 권한 매트릭스와 시뮬레이터 에서 설명합니다.
Databricks 커넥션SQL Warehouse 칸, 세션 버튼탭이 사용할 SQL Warehouse 를 선택하고, 세션을 새로 열거나(새 세션) 닫습니다(세션 종료). 커밋하지 않은 변경이 있거나 쿼리가 실행되는 동안은 변경할 수 없습니다.
  • Execute 버튼, Run Script 버튼, Plan 버튼은 실행 대상의 커넥션에 접속 정보가 있을 때만 클릭할 수 있습니다.
  • Plan 버튼은 실행 계획을 SQL 로 주지 않는 DBMS 에서는 클릭할 수 없습니다. 실행 계획 에서 설명합니다.

SQL 탭을 여는 방법

SQL 탭은 접속 정보가 있는 커넥션이 프로젝트에 하나라도 있어야 만들 수 있습니다. 없으면 만드는 버튼과 메뉴를 클릭할 수 없고, SQL 편집기를 만들려면 먼저 connection 을 DB 에 연결하세요. 안내가 보입니다.

  1. 아래 가운데 한 곳에서 새 SQL 문서를 만듭니다.
    • 탐색기에서 커넥션, 데이터베이스, 스키마, 테이블 같은 노드를 우클릭하고 탐색기 우클릭새 SQL 편집기... 메뉴를 클릭합니다. 우클릭한 노드의 위치가 실행 대상으로 미리 채워집니다.
    • 왼쪽 아래 ERD 와 SQL 목록 의 SQL 버튼을 클릭합니다. 목록의 커넥션, 스키마 줄에 마우스를 올리면 표시되는 + 버튼에서 새 SQL 항목을 클릭하면 줄의 위치가 미리 채워집니다.
    • 작업 탭 줄 끝의 + 버튼을 클릭하고 SQL 편집기 추가... 항목을 클릭합니다. 열린 탭이 없을 때는 가운데의 새 SQL 편집기 생성 버튼을 클릭합니다.
  2. SQL 편집기 생성 창에서 제목을 적고, Connection 칸과 Schema 칸을 선택합니다. 데이터베이스 계층이 있는 DBMS 이면 Database 칸도 선택합니다.
  3. 확인 버튼을 클릭합니다. SQL 문서가 프로젝트에 만들어지고 SQL 탭이 열립니다.
  • 이미 만든 SQL 문서는 ERD, SQL 목록에서 클릭하면 열립니다.
  • 탐색기에서 우클릭한 위치와 실행 대상이 같은 SQL 문서가 이미 있으면 메뉴가 SQL 편집기 하위 메뉴로 변경됩니다. 하위 메뉴에서 새로 만들거나, 최근에 수정한 문서 다섯 개 가운데 하나를 엽니다.
  • .sql 파일을 작업 탭 줄에 드래그 앤 드롭하면 파일마다 SQL 문서를 만들어 엽니다. 파일 이름이 제목이 됩니다. 커넥션과 스키마가 하나뿐이면 묻지 않고, 여럿이면 실행 대상을 한 번 선택하게 합니다.

쿼리 실행하기

버튼단축키실행하는 것
ExecuteCtrl+Enter(macOS 는 Cmd+Enter)선택 영역이 있으면 선택한 부분, 없으면 커서가 있는 문장 하나
Run ScriptCtrl+Shift+Enter(macOS 는 Cmd+Shift+Enter)선택 영역이 있으면 선택 영역 안의 문장들, 없으면 탭의 모든 문장을 차례로
취소Esc실행 중인 쿼리를 취소합니다. 찾기 막대가 열려 있으면 Esc 는 먼저 찾기 막대를 닫습니다
  1. 실행할 문장 안에 커서를 둡니다. 왼쪽의 초록 막대가 문장에 붙었는지 확인합니다.
  2. Execute 버튼을 클릭하거나 Ctrl+Enter(macOS 는 Cmd+Enter)를 누릅니다. 실행하는 동안 막대가 주황색으로 깜빡입니다.
  3. 결과 영역에서 결과를 확인합니다. 실패하면 결과 탭에 오류가 보이고, 실패한 문장은 빨간 막대와 줄 번호 옆의 표시가 붙습니다.
  • 문장은 ; 로 나눕니다. DBMS 에 따라 GO, /, DELIMITER 도 구분자로 읽습니다. 자세한 규칙과 Run Script 버튼이 오류에서 멈출 때 선택하는 방법은 SQL 실행과 트랜잭션 에서 설명합니다.
  • 실행하기 전에 확인이 필요하면 창이 먼저 열립니다. 값 자리(?, :이름)가 있으면 바인드 파라미터 창이, DROP, TRUNCATE, WHERE 없는 UPDATE/DELETE 이면 위험 SQL 확인 창이, 커넥션 프로파일의 보호 모드가 확인을 요구하면 확인 창이 열립니다.
  • 결과 그리드에서 수정하고 적용하지 않은 데이터가 있으면, 다시 실행하기 전에 변경을 버릴지 묻습니다.
  • 편집기를 우클릭해도 현재 문 실행 메뉴, 스크립트 실행 메뉴, 쿼리 취소 메뉴, 실행 계획 메뉴를 선택할 수 있습니다.

결과 탭

  • Execute 버튼은 결과를 지금 보고 있는 결과 탭에 덮어씁니다. 결과 탭의 이름은 조회한 테이블 이름이고, 알 수 없으면 Result 이름이 붙습니다.
  • 결과를 남겨 두려면 결과 탭(2)을 우클릭하고 탭 고정 메뉴를 클릭합니다. 고정한 탭에는 덮어쓰지 않고, 고정하지 않은 결과 탭이 없으면 새 결과 탭을 만듭니다. 같은 메뉴로 탭을 닫거나, 다른 탭, 왼쪽, 오른쪽, 모든 탭을 닫습니다.
  • Run Script 버튼은 Statistics 탭(1) 하나와 SELECT 문마다 결과 탭을 하나씩 만듭니다. UPDATE 나 DDL 은 결과 탭을 만들지 않고 Statistics 탭에 실행 문장, 반영된 행, 오류, 실행 시간 항목으로 모읍니다.
  • Run Script 버튼을 클릭할 때 이미 결과 탭이 있으면 기존 결과 탭 닫기 창이 기존 탭 닫기 버튼과 기존 탭 유지 버튼 가운데 선택하게 합니다. 고정한 탭은 닫지 않습니다. 다시 묻지 않음 항목을 활성화하면 다음부터 묻지 않습니다.
  • History 탭(3)은 SQL 문서에서 실행한 SQL 입니다. SQL 이력과 저장된 SQL 에서 설명합니다.
  • 실행 대상을 변경하기 전에 받은 결과 탭에는 경고 아이콘과 다른 대상에서 실행된 결과 안내가 붙고, 결과는 읽기 전용입니다. 현재 대상으로 재실행 버튼으로 지금 대상에서 다시 실행합니다.
  • 결과 그리드의 필터, 정렬, 복사, 행 수는 결과 그리드 에서, 결과를 수정하는 방법은 결과 데이터 편집 에서, 파일로 내보내는 방법은 결과 내보내기 에서 설명합니다.

트랜잭션 다루기

SQL 탭은 Auto Commit 스위치가 활성화된 채로 열리고, 실행한 문장은 바로 확정됩니다. 확정하기 전에 결과를 확인하려면 스위치를 비활성화합니다.

  1. Auto Commit 스위치(1)를 비활성화합니다. Commit 버튼과 Rollback 버튼(2)이 나타납니다.
  2. UPDATE 같은 문장을 실행합니다. 확정하지 않은 변경이 생기면 Uncommitted 표시(3)와 작업 탭의 TX 표시(4)가 붙습니다.
  3. 결과를 확인하고 Commit 버튼을 클릭해 확정하거나, Rollback 버튼을 클릭해 되돌립니다. 편집기를 우클릭해도 커밋 메뉴와 롤백 메뉴가 있습니다.
  • 커밋하지 않은 채 탭을 닫거나 실행 대상을 변경하면 커밋할지 롤백할지 묻습니다. NeoSQL 이 저절로 커밋하거나 롤백하지 않습니다.
  • CREATE, ALTER 같은 DDL 은 DBMS 에 따라 그때까지의 변경을 함께 확정합니다. DBMS 별 표, 트랜잭션 유휴 시간, BigQuery 의 예외는 SQL 실행과 트랜잭션 에서 설명합니다.
  • 연결이 끊겨 커밋하지 않은 변경이 롤백되면 편집기 위에 미커밋 변경사항이 롤백되었습니다. 필요한 SQL을 다시 실행해주세요. 안내가 표시됩니다.

실행 대상 변경하기

  1. 도구 모음의 실행 대상을 클릭합니다. ERD, SQL 목록에서 SQL 문서 줄의 설정 버튼을 클릭해도 됩니다.
  2. SQL 편집기 설정 창에서 제목, Connection 칸, Database 칸, Schema 칸을 변경합니다.
  3. 확인 버튼을 클릭합니다. 변경한 내용은 바로 SQL 문서에 저장됩니다.
  • 실행 대상을 변경하면 탭의 DB 세션을 닫고 새 대상으로 다시 엽니다. 커밋하지 않은 트랜잭션이 있으면 접속 대상 변경 전 트랜잭션 처리 창이 먼저 커밋할지 롤백할지 묻습니다. 쿼리가 실행되는 동안에는 변경할 수 없습니다.
  • SQL Server 는 세션의 기본 스키마를 변경할 수 없어 Schema 칸이 잠기고 SQL Server는 세션 단위 스키마 전환을 지원하지 않아 로그인 사용자의 기본 스키마로 실행됩니다. 다른 스키마의 객체는 SQL에서 스키마.테이블 형식으로 명시하세요. 안내가 보입니다. 다른 스키마의 테이블은 SQL 에 스키마.테이블 로 적으세요.
  • 외부 MCP 클라이언트가 SQL 을 실행하려고 연 SQL 탭은 실행 대상 옆에 자물쇠 아이콘이 보이고, 제목과 실행 대상을 변경할 수 없습니다.

자동 완성과 편집 도움

  • 글자를 입력하면 자동 완성 팝업이 저절로 열립니다. 별칭. 을 입력하면 별칭이 가리키는 테이블의 컬럼을 보여 주고, 언제든 Ctrl+Space 로 엽니다. macOS 는 Ctrl+Space 나 Option+I 를 누르세요(Cmd+Space 는 보통 Spotlight 가 먼저 가져갑니다). 팝업의 항목은 Enter 로 넣습니다.
  • 컬럼 후보는 커서가 있는 문장의 FROM, JOIN 에 적은 테이블의 컬럼만 보여 줍니다. 아직 테이블을 적지 않았으면 모든 테이블의 컬럼을 보여 줍니다. 테이블, 뷰, 키워드, CASE WHEN, COALESCE, EXISTS, WITH 같은 SQL 틀도 후보에 나옵니다. SQL 틀을 넣은 뒤 Tab 으로 다음 칸으로 옮겨 갑니다.
  • 문장을 작성하는 중에 이어서 작성할 내용이 흐린 글자로 보이면 Tab(줄 끝에서는 →)으로 받아들입니다. 문장의 첫 세 글자 이상을 입력하면 탭의 커넥션에서 내가 전에 실행한 SQL 가운데 같은 글자로 시작하는 것을 흐린 글자로 보여 주기도 합니다.
  • 구문 색은 실행 대상 커넥션의 DBMS 문법을 따릅니다.
  • 참조한 테이블에 없는 컬럼은 빨간 밑줄로 보입니다. 메타데이터를 읽어 온 테이블만 검사하므로 실제 DB 와 다를 수 있습니다.프로젝트 설정SQL 편집기 탭의 존재하지 않는 컬럼 강조 표시 항목으로 비활성화합니다.
  • INSERT 문에서 커서가 있는 컬럼과 대응하는 값이 함께 칠해지고, 컬럼과 값의 수가 맞지 않으면 물결 밑줄이 보입니다.
  • 들여쓰기 방식과 탭 크기는 프로젝트 설정SQL 편집기 탭에서 정합니다.
단축키하는 일
Ctrl+F / Ctrl+R(macOS 는 Cmd)찾기 / 바꾸기 막대를 엽니다. Ctrl+G, Ctrl+Shift+G 로 다음, 이전 찾은 곳으로 옮겨 갑니다
Ctrl+/(macOS 는 Cmd+/)줄 주석을 추가하거나 해제합니다
F4커서 아래의 테이블을 테이블 탭 으로 엽니다. 우클릭 메뉴의 "orders" 열기 메뉴와 같습니다
Ctrl+Shift+E(macOS 는 Cmd+Shift+E)실행 계획을 조회합니다
  • 편집기를 우클릭하면 잘라내기 메뉴, 복사 메뉴, 붙여넣기 메뉴, SQL 포맷 메뉴, 주석 토글 메뉴, 대문자 변환 메뉴, 소문자 변환 메뉴가 있습니다. AI: 쿼리 튜닝 메뉴는 편집기와 ERD 의 AI 기능 에서 설명합니다.

탐색기에서 SQL 만들기

  1. 탐색기의 테이블, 뷰, 함수, 프로시저, 시퀀스 노드를 드래그해 편집기에 드롭합니다. 여러 노드를 선택해 두었으면 함께 드래그 앤 드롭합니다.
  2. 표시되는 메뉴에서 SQL 의 종류를 선택합니다. 테이블은 SELECT, INSERT, UPDATE, DELETE, CREATE (DDL) 입니다.
  3. 드롭한 자리에 SQL 이 들어갑니다. 마지막 줄 아래에 드롭하면 끝에 새 줄로 들어갑니다.
  • 탭의 커넥션과 다른 커넥션의 노드는 드롭할 수 없고, 편집기에 다른 connection — 여기엔 놓을 수 없어요 안내가 보입니다.
  • 탐색기에서 노드를 우클릭하고 탐색기 우클릭쿼리 생성 메뉴를 클릭해도 같은 SQL 을 만들 수 있습니다. 메뉴로 만든 SQL 은 편집기에 넣지 않고 미리보기 창에 보여 주며, SQL 복사 버튼으로 복사합니다.

포맷

Format 버튼은 SQL 의 줄바꿈과 들여쓰기를 실행 대상 DBMS 의 문법에 맞춰 정리하고, 키워드를 대문자로 변환합니다.

항목단축키정리하는 것
Format Statement (버튼을 바로 클릭할 때)Ctrl+Shift+F(macOS 는 Cmd+Shift+F)선택 영역이 있으면 선택한 부분, 없으면 커서가 있는 문장
Format All (버튼 옆 화살표)없음탭의 SQL 전체
  • 들여쓰기는 프로젝트 설정SQL 편집기 탭의 들여쓰기 방식과 탭 크기를 따릅니다.
  • 포맷은 SQL 글자만 변경합니다. 변경한 뒤에도 저장해야 SQL 문서에 남습니다.

저장

SQL 문서는 저절로 저장되지 않습니다. Ctrl+S(macOS 는 Cmd+S)를 눌러 저장합니다.

  • 저장하지 않은 변경이 있으면 작업 탭의 닫기 버튼 자리에 점이 보입니다. 그대로 탭을 닫으면 저장되지 않은 변경사항 창이 저장 버튼, 저장 안 함 버튼, 취소 버튼 가운데 선택하게 합니다.
  • 제목과 실행 대상은 SQL 편집기 설정 창에서 확인 버튼을 클릭할 때 저장됩니다. 작성 중인 SQL 은 그때 함께 저장되지 않습니다.
  • 저장하는 곳은 프로젝트에 따라 다릅니다.
프로젝트SQL 문서를 두는 곳보는 사람
로컬 프로젝트기기의 NeoSQL 저장소기기에서만 봅니다
계정 프로젝트NeoSQL 서버내가 만든 SQL 문서는 나만 봅니다. 같은 프로젝트의 팀원에게 보이지 않습니다
  • 계정 프로젝트에서 다른 기기가 같은 SQL 문서를 먼저 저장했으면, 저장할 때 서버의 내용으로 변경할지 내 내용으로 덮어쓸지 묻습니다. 편집 중이 아니면 서버의 내용으로 저절로 변경됩니다.

운영 커넥션 구분하기

커넥션 프로파일의 환경을 정해 두면 SQL 탭이 어느 DB 를 향하는지 화면으로 구분됩니다.

  • 프로파일의 색이 작업 탭의 표시와 편집기 줄 번호 영역 오른쪽의 선에 칠해집니다.
  • 배경 워터마크를 활성화한 프로파일은 편집기 배경에 라벨이 깔립니다. 운영 환경은 처음부터 활성화되어 있습니다.
  • 보호 모드가 확인을 요구하면 실행 전에 [환경] 커넥션 이름 제목의 확인 창이 표시되고, 읽기 전용이면 SELECT 가 아닌 문장을 차단합니다.
  • 프로파일을 정하는 방법과 보호 모드의 범위는 운영 DB 안전장치 에서 설명합니다.

웹과 데스크톱

데스크톱웹
SQL 을 실행하는 곳기기의 로컬 서버가 DB 에 바로 연결합니다. 사내망이나 방화벽 안의 DB 도 사용할 수 있습니다NeoSQL 서버가 DB 에 연결합니다. 인터넷에서 접속할 수 있는 DB 만 사용할 수 있습니다
세션 유휴 시간커넥션 프로파일의 환경마다 프로젝트 설정SQL 편집기 탭에서 정합니다30분으로 고정됩니다
결과 내보내기지원합니다결과를 복사해 활용합니다. 해당 기능은 앱에서만 사용할 수 있습니다. 안내가 표시되면 데스크톱 앱에서 파일로 내보냅니다
  • 나머지 편집, 실행, 트랜잭션, 저장은 같습니다. 웹과 데스크톱의 차이 전체는 웹과 데스크톱 에서 설명합니다.

주의할 점

  • Auto Commit 스위치가 활성화되어 있으면 실행한 UPDATE, DELETE 는 되돌릴 수 없습니다. 운영 DB 에서 데이터를 수정할 때는 스위치를 비활성화하고 실행한 뒤 결과를 확인하고 커밋하세요.
  • Execute 버튼은 선택 영역이 있으면 선택한 부분만 실행합니다. 일부만 선택한 채 클릭하면 문장의 일부가 실행되거나 오류가 납니다. 실행 전에 초록 막대나 선택 영역을 확인하세요.
  • 실행 대상이 변경된 줄 모르고 실행하는 일을 차단하려면, 실행 전에 도구 모음의 실행 대상과 상태바를 확인하세요. 같은 이름의 테이블이 여러 스키마에 있으면 다른 테이블이 변경될 수 있습니다.
  • SQL 문서는 Ctrl+S 로 저장해야 보존됩니다. 앱을 닫기 전에 저장하지 않은 문서가 있으면 묻지만, 문서는 저절로 저장되지 않습니다.
  • 존재하지 않는 컬럼의 빨간 밑줄은 추정입니다. 밑줄이 없어도 실행이 성공한다는 뜻은 아닙니다.
  • 계정 프로젝트의 SQL 문서는 팀원과 공유되지 않습니다. 팀원에게 SQL 을 전하려면 SQL 을 복사해 보내세요.

관련 화면