NeoSQL 은 프로젝트에서 실행한 SQL 을 실행 기록으로 남깁니다. 오른쪽 레일의 패널은 프로젝트 전체의 기록을, SQL 편집기 결과 영역의 History 탭은 SQL 문서의 기록을 보여 줍니다. 실행 기록은 SQL 을 실행할 때마다 저절로 쌓이는 것이고, 내가 저장해 두고 다시 여는 SQL 은 ERD, SQL 목록의 SQL 문서입니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 버튼 | 오른쪽 레일의 버튼입니다. 패널을 열고 닫습니다. |
| 2 | 머리 버튼 | 새로고침, 크게 보기(아래 '기록 찾기'), 고정, 닫기 버튼입니다. 고정 버튼으로 고정하면 패널이 가운데 화면의 폭을 줄이지 않고 위에 표시되어 있습니다. |
| 3 | 사용자 칸 | 실행한 사람으로 거릅니다. 로컬 프로젝트와, 계정 프로젝트의 소유자, 관리자, DBA 역할에게만 보입니다. |
| 4 | AI 스위치 | 활성화하면 AI Assistant 패널과 외부 MCP 클라이언트가 실행한 기록만 남습니다. |
| 5 | 기록 카드 | 실행 한 번이 카드 하나이고, 최근 것이 위에 옵니다. 문장 종류(SELECT, DML, DDL) 표시, AI 가 실행했으면 AI 표시, 실행한 사람, SQL 의 앞부분, 실행 시각, 성공 여부, 걸린 시간이 보입니다. 클릭하면 SQL 실행 기록 상세 창이 열립니다. |
- 한 번에 100개씩 불러오고, 더 있으면 목록 끝의 더 불러오기 버튼으로 이어서 불러옵니다.
- SQL 의 글자로 찾을 때는 크게 보기 버튼으로 여는 SQL History 창을 사용하세요.
무엇이 기록되나
| 실행한 곳 | 기록되는 문장 |
|---|---|
| SQL 편집기의 Execute 버튼과 Run Script 버튼 | 모든 문장(조회 포함). 실패한 문장도 오류 문구와 함께 남습니다 |
| 결과 그리드 편집의 반영 | 반영할 때 실행한 INSERT, UPDATE, DELETE |
| AI Assistant 패널이 실행한 SQL, 외부 MCP 클라이언트가 보낸 SQL | 실행한 문장. AI 표시가 붙습니다 |
| 나머지 화면(ERD 의 DB 반영, 테이블 저장, DDL 승인의 실행, 데이터 가져오기... 등) | 스키마나 데이터를 변경한 문장(DDL, DML) |
- Plan 버튼으로 가져온 실행 계획 은 기록하지 않습니다.
- SQL 원문은 64KB 까지만 저장합니다. 더 긴 SQL 은 앞부분만 남습니다.
- 기록에는 실행 대상(커넥션, 데이터베이스, 스키마), 행 수(조회는 가져온 행 수, 변경은 변경된 행 수), 걸린 시간이 함께 남습니다. 결과 데이터는 남지 않습니다.
기록 찾기
- 패널 머리의 크게 보기 버튼을 클릭합니다. SQL History 창이 열립니다.
- SQL 검색 칸에 SQL 의 일부를 적습니다. 적는 동안 적은 글자가 포함된 기록만 남습니다.
- 필요하면 사용자 칸과 AI 스위치로 더 거릅니다.
- 아래 페이지 번호로 넘기고, 한 페이지에 보일 수를 50, 100, 200 가운데 선택합니다.
- 표의 열은 Type, AI, Status, SQL, User, Executed At, Connection, Database, Schema, Rows, Time, 오류 문구입니다. 열 머리를 클릭하면 지금 페이지 안에서 정렬합니다.
- 줄을 클릭하면 SQL 실행 기록 상세 창이 열립니다.
기록을 다시 사용하기
카드나 표의 줄을 클릭하면 SQL 실행 기록 상세 창이 열립니다. 실행 대상, 행 수, 걸린 시간과 SQL 전문이 보입니다.
- 복사 버튼을 클릭해 SQL 을 복사합니다.
- SQL 탭을 열고 붙여 넣은 뒤 실행 대상을 확인하고 실행합니다.
- 실행 대상이 기록과 같은지 직접 확인하고 실행하세요.
- 실패한 기록은 오류 문구 아래에서 AI 의 도움을 받을 수 있습니다. 64KB 를 넘어 잘린 SQL 에서는 AI 의 도움을 사용할 수 없습니다 (편집기와 ERD 의 AI 기능).
SQL 편집기의 History 탭
SQL 편집기 결과 영역 오른쪽 끝의 History 탭은 SQL 문서에서 실행한 기록만 보여 줍니다.
- 기록 검색... 칸(1)에 적은 글자가 SQL 에 포함된 기록만 남깁니다.
- 기록 줄(2)을 두 번 클릭하면 SQL 이 편집기의 커서 위치에 들어갑니다. 실행은 하지 않습니다.
- 실패한 기록은 문장 종류 표시가 빨간색이고(3), 아래에 오류 문구가 보입니다.
- 기록은 문서에 묶입니다. 탭을 닫았다가 다시 열어도 문서의 기록이 보입니다. 아직 저장하지 않은 새 SQL 탭의 기록은 처음 저장할 때 저장한 문서로 옮겨 갑니다.
저장된 SQL 문서
실행 기록과 달리 SQL 문서는 내가 만들고 이름을 붙여 저장한 SQL 입니다. 프로젝트 화면 왼쪽 아래의 ERD 와 SQL 목록 에 커넥션, 데이터베이스, 스키마별로 모여 있고, 클릭하면 SQL 탭으로 열립니다. 만드는 방법과 편집은 SQL 편집기 에서 설명합니다.
| 실행 기록 | SQL 문서 | |
|---|---|---|
| 생기는 때 | SQL 을 실행할 때마다 저절로 | 내가 만들고 저장할 때 |
| 삭제하는 때 | 보존 기간이 지나면 저절로. 직접 삭제할 수 없습니다 | 내가 삭제할 때까지 남습니다 |
| 계정 프로젝트에서 보는 사람 | 역할에 따라 다른 멤버의 기록도 봅니다(아래 표) | 만든 사람만 봅니다. 팀 ERD 와 달리 멤버와 함께 사용하지 않습니다 |
저장 위치와 보존 기간
| 로컬 프로젝트(데스크톱) | 계정 프로젝트 | |
|---|---|---|
| 실행 기록이 있는 곳 | 기기 | NeoSQL 서버 |
| 보존 기간 | 7일. 플랜과 상관없습니다 | 프로젝트의 플랜에 따라 다릅니다(플랜과 기능 차이) |
| SQL 문서가 있는 곳 | 기기의 프로젝트 | NeoSQL 서버 |
| 실행한 사람 | 구분하지 않습니다. 기기의 사용자 하나로 남습니다 | 실행한 계정 |
계정 프로젝트의 실행 기록은 역할에 따라 보이는 범위가 다릅니다. 범위는 서버가 정하고, 사용자 칸으로는 범위 안에서 좁히기만 합니다.
| 역할 | 보이는 기록 |
|---|---|
| 소유자, 관리자 | 프로젝트의 모든 기록 |
| DBA | 내 기록과 멤버 역할 멤버의 기록 |
| 멤버 | 내 기록 |
주의할 점
- 실행 기록에는 SQL 원문이 그대로 남습니다. SQL 안에 비밀번호나 개인정보 같은 값을 적어 실행하면, 계정 프로젝트에서는 기록이 서버에 남고 위 표의 역할들이 SQL 을 볼 수 있습니다.
- 보존 기간이 지난 기록은 삭제되어 되살릴 수 없습니다. 오래 둘 SQL 은 SQL 문서로 저장하세요. 계정 프로젝트의 플랜을 낮추면 새 보존 기간을 지난 기록이 삭제됩니다.
- 로컬 프로젝트의 기록은 기기에만 있어 다른 기기에서 볼 수 없습니다.
- 편집기의 회색 제안 글자 가운데 일부는 탭의 커넥션에서 내가 실행한 기록에서 나옵니다(SQL 편집기).
관련 화면
- SQL 편집기: SQL 문서를 만들고 실행하는 화면입니다.
- ERD 와 SQL 목록: 저장된 SQL 문서를 찾고 삭제합니다.
- 플랜과 기능 차이: 계정 프로젝트의 실행 기록 보존 기간을 정하는 플랜입니다.
- 협업과 권한: 계정 프로젝트의 역할입니다.