데이터베이스
정상 동작SQL Server와 PostgreSQL부터 DuckDB, ClickHouse, Oracle, Redis까지, 오늘날 SQLly가 연결하는 30개의 엔진과 엔진별로 동작하는 도구, 연결 방법.
SQLly가 이해하는 대상은 38개의 데이터베이스 엔진. 이 가운데 30개는 오늘 네이티브 Rust 드라이버를 통해 통신하며, 각 엔진이 실제로 사용하는 일곱 가지 와이어 프로토콜과 파일 형식을 중심으로 묶여 있습니다. 그중 한 엔진은 SQL 데이터베이스가 전혀 아닙니다. 나머지 여덟은 완전히 프로파일링된: SQLly는 각 엔진의 기능, 식별자 인용 방식, 행 제한, 타입 저장 방식을 파악하고 있으며, 라이브 커넥터는 아직 제공 예정입니다.
각 퍼스트파티 엔진에는 자체 페이지도 있습니다. 어떤 기능이 작동하는지, 연결 방법, 해당되지 않는 부분을 다음부터 안내합니다 SQLly가 연결하는 데이터베이스.
지금 연결, 네이티브 드라이버
와이어 호환 엔진은 드라이버를 공유합니다. PostgreSQL 프로토콜 엔진은 PostgreSQL 커넥터를, MySQL 계열은 MySQL 커넥터를, Redis 호환 스토어는 Redis 커넥터를 씁니다. 호환성은 명시적으로 유지됩니다. 호스팅형이나 분산형 엔진은 어느 공식 와이어를 따르는지, 어디가 다른지 밝힙니다.
TDS - SQL Server 계열
| 엔진 | SQL 방언 | 메모 |
|---|---|---|
| Microsoft SQL Server | T-SQL | 자체 지원. 기본 스키마 dbo, [bracket] 인용, SELECT TOP n. |
| Azure SQL Database | T-SQL | 관리형 SQL Server; Entra ID 로그인 및 Azure 검색 지원. SQL 에이전트 없음. |
PostgreSQL 와이어
| 엔진 | 호환 버전 | 메모 |
|---|---|---|
| PostgreSQL | - | 자체 지원. 기본 스키마 public, "double-quote" 인용, LIMIT, ILIKE, RETURNING, ON CONFLICT 업서트. |
| CockroachDB | PostgreSQL | pg 와이어를 통한 분산 SQL. VACUUM이 없어 유지 관리 메뉴를 사용할 수 없고, 프로시저 모드나 보안 편집기도 없습니다. |
| YugabyteDB | PostgreSQL | pg 와이어를 통한 분산 SQL (YSQL, 포트 5433). |
| Amazon Aurora PostgreSQL | PostgreSQL | AWS 관리형 pg-호환 에디션. IAM 로그인 지원. |
| Amazon RDS for PostgreSQL | PostgreSQL | AWS 관리형 PostgreSQL. IAM 로그인 지원. |
| Azure Database for PostgreSQL | PostgreSQL | Flexible Server. TLS 필요. |
| Google Cloud SQL for PostgreSQL | PostgreSQL | GCP 관리형 PostgreSQL. IAM 로그인 지원. |
| Neon | PostgreSQL | 서버리스 PostgreSQL. TLS 필요. |
| Supabase | PostgreSQL | Supabase에서 호스팅하는 PostgreSQL. |
MySQL 와이어
| 엔진 | 호환 버전 | 메모 |
|---|---|---|
| MySQL | - | 자체 지원. `backtick` 인용, LIMIT, ON DUPLICATE KEY 업서트. |
| MariaDB | MySQL | 시퀀스 및 RETURNING; 자체 플랜(ANALYZE FORMAT=JSON) 및 활동 방언. |
| Amazon Aurora MySQL | MySQL | AWS 관리형 MySQL 호환 에디션. |
| Amazon RDS for MySQL | MySQL | AWS 관리형 MySQL. |
| MySQL용 Azure Database | MySQL | Flexible Server. TLS 필요. |
| MySQL용 Google Cloud SQL | MySQL | GCP 관리형 MySQL. |
| PlanetScale | MySQL | Vitess 기반. TLS 필요. 유지 관리 메뉴나 보안 편집기가 없음. |
| TiDB | MySQL | 분산 SQL (포트 4000); 저장 프로시저 없음, OPTIMIZE TABLE. |
프로세스 내 파일
| 엔진 | SQL 방언 | 메모 |
|---|---|---|
| SQLite | SQLite | 파일 또는 인메모리 데이터베이스를 직접 엽니다. 날짜와 UUID는 텍스트 인코딩; 저장 프로시저 없음. 다음 파일을 더블클릭하거나 .sqlite, .db, 또는 .sqlite3 파일을 두 번 클릭하면 열립니다. |
| DuckDB | PostgreSQL 계열 | 번들 제공 - 설치 불필요. .duckdb 파일 또는 :memory:, 자격 증명도 필요 없습니다. 진짜 실행 계획(EXPLAIN / EXPLAIN ANALYZE), read_parquet / read_csv / read_json 오프라인. 연결 중 |
HTTP
| 엔진 | SQL 방언 | 메모 |
|---|---|---|
| ClickHouse | ClickHouse (MySQL 계열 문법) | HTTP 인터페이스 - 포트 8123, TLS 사용 시 8443. 결과는 ClickHouse가 보내는 대로 스트리밍되고, 큰 정수와 소수도 자릿수를 그대로 유지합니다. 트랜잭션이 없으므로 롤백 래핑은 애초에 거부됩니다. 연결 중 |
| libSQL / Turso | SQLite | HTTP 기반 Hrana - 자체 호스팅 sqld 포트 8080에서 또는 HTTPS를 통한 Turso 클라우드에서. 운영 체제 키체인에 저장된 인증 토큰으로 로그인합니다. 연결 중 |
Oracle Net
| 엔진 | SQL 방언 | 메모 |
|---|---|---|
| Oracle 데이터베이스 | Oracle (FETCH FIRST, MERGE, PL/SQL) | 포트 1521; 서비스 이름, 또는 SID: 를 붙이면 SID로 연결됩니다. 머신에는 무료 Oracle 인스턴트 클라이언트 컴퓨터에 설치되어 있어야 합니다 - 연결 테스트를 실행하면 없는 경우 무엇을 설치해야 하는지 정확히 알려줍니다. 연결 중 |
RESP - Redis 계열
| 엔진 | 호환 버전 | 메모 |
|---|---|---|
| Redis | - | SQL이 아님: 쿼리 탭은 redis-cli 구문으로 한 줄에 한 명령씩 실행하고, 탐색기는 접두사별로 묶인 키 브라우저입니다. 포트 6379, redis:// 또는 rediss://. 연결 중 |
| Valkey | Redis | Linux 재단 포크, 와이어 프로토콜 호환. |
| KeyDB | Redis | 멀티스레드 포크; 없음 FUNCTION LIST. |
| DragonflyDB | Redis | Redis 호환 인메모리 저장소; CLIENT LIST 는 사용자 컬럼을 생략합니다. |
| Amazon ElastiCache | Redis | Redis 또는 Valkey; 전송 중 암호화는 TLS를 의미합니다 필수 또는 전체 검증. 클러스터 모드는 구성 엔드포인트를 통해 지원됩니다(Redis Cluster). |
| Amazon MemoryDB | Redis | TLS 필요; ACL 사용자 이름은 사용자 이름 필드에 입력합니다. 항상 클러스터: 명령은 슬롯에 따라 라우팅됩니다(Redis Cluster). |
어디에서 작동하는가
엔진에 대응 기능이 있는 도구는 그 엔진 고유의 카탈로그와 시스템 뷰를 기반으로 동작합니다. 대응 기능이 없는 엔진에서는 메뉴 항목이 그대로 보이며 이유를 알려 줍니다 - “DuckDB는 SQLly 내에서 실행되며 감시할 서버 세션이 없습니다” - 클릭한 뒤에 실패하는 게 아니라 그 전에 보여 줍니다. 와이어 호환 라벨은 아래에서 기반 엔진의 열을 상속하되, 자기 행에 따로 적어 둔 경우는 그에 따릅니다.
| 도구 | SQL Server | PostgreSQL | MySQL / MariaDB | SQLite | libSQL / Turso | DuckDB | ClickHouse | Oracle | Redis |
|---|---|---|---|---|---|---|---|---|---|
| 탐색기, IntelliSense, 호버, 객체 브라우저 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | Key browser |
| 예상 계획 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - |
| 실제 실행 계획 | 예 | 예 | 예 | - | - | 예 | - | - | - |
| 행 편집기 | 예 | 예 | 예 | 예 | - | 예 | - | - | - |
| 유지 관리 메뉴 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - |
| 서버 대시보드 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 |
| 활동 모니터 | 예 | 예 | 예 | - | - | - | 예 | 예 | 예 |
| 쿼리 인사이트 | 예 | 예 | 예 | - | - | - | 예 | - | 예 |
| 디스크 사용량 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | 예 |
| 인덱스 분석기 | 예 | 예 | 예 | - | - | - | - | - | - |
| 백업 / 복원 | 예 | 예 | 예 | - | - | - | 예 | - | - |
| 스키마 비교 및 스키마 히스토리 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - | - |
| 데이터 비교 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - | - |
| 데이터 전송(대상) | 예 | 예 | 예 | 예 | - | 예 | 예 | - | - |
| 구조 편집기 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - | - |
| 테스트 데이터 생성기 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - | - |
| 종속성(종속성 보기 / 사용처 찾기) | 예 | 예 | 예 | 예 | 예 | 예 | 예 | - | - |
| 보안 편집기 | 예 | 예 | 예 | - | - | - | 읽기 전용 뷰 | - | - |
| 디자이너, 확장 이벤트, SQL 에이전트 | 예 | - | - | - | - | - | - | - | - |
| 프로시저 모드 | 예 | 예 | - | - | - | - | - | - | - |
| 수동 커밋 모드 | 예 | 예 | 예 | - | - | - | - | - | - |
| SSH 터널, 프록시, Kubernetes 포트 포워딩 | 예 | 예 | 예 | - | 예 | - | 예 | - | 예 |
대시(-)마다 붙는 이유는 앱 자신의 말입니다. SQLite, libSQL, DuckDB는 인덱스 사용 카운터를 쌓아 두지 않으므로 분석할 것이 없고, DuckDB는 SQLly 안에서 돌아가 모니터링할 서버 세션이 없으며, libSQL은 요청을 하나씩 독립적으로 처리해 세션 목록이 없습니다. ClickHouse에는 없습니다 EXPLAIN ANALYZE 행 수준 UPDATE (사용 ALTER TABLE … UPDATE 쿼리 탭에서); Oracle의 실행 계획은 EXPLAIN PLAN 실행 없이도 마찬가지입니다. 백업은 서버에서 RMAN이나 Data Pump로 진행되고, Oracle 클라이언트는 리스너에 직접 접속하므로 터널과 프록시는 아직 해당되지 않습니다. Redis는 스키마, 테이블, 인덱스, 실행 계획이 없고, 사용자 관리는 ACL SETUSER. SQL Agent, Extended Events, 가이드형 디자이너는 SQL Server 전용 기능이며 UI에도 그렇게 표시됩니다.
새로운 엔진에 연결하기
SQL Server, PostgreSQL, MySQL 및 SQLite는 예상한 대로 연결됩니다. 아래 엔진 각각은 첫 연결 전에 알아두어야 할 한 가지 사항이 있습니다.
DuckDB
DuckDB는 SQLly에 번들로 포함되어 있어 설치할 필요가 없습니다. 다음에서 선택하세요 DuckDB
연결 편집기에서 서버 필드에 파일 경로를 적습니다(없으면 새 파일이 만들어집니다). 아니면 :memory: SQLly가 실행되는 동안만 존재하는 스크래치 데이터베이스용입니다. 자격 증명도 포트도 없습니다. 다음을 두 번 클릭하거나 끌어다 놓으면
.duckdb 또는 .ddb 파일을 열면 바로 열리고, 연결 URL 입력란에서도 다음을 받습니다 duckdb:/path/to/analytics.duckdb,
duckdb::memory:, 또는 맨 .duckdb 경로.
DuckDB의 리스트, 구조체, 맵은 그리드에 JSON 텍스트로 표시됩니다. 백업은 파일 그 자체이므로, 파일을 복사하거나 다음을 실행하세요 EXPORT DATABASE - 그리고 데이터베이스 만들기 대화 상자가 없는데, 그 이유는 DuckDB 데이터베이스가 입니다 파일로 저장합니다. 유지 관리 메뉴에는 다음이 있습니다 VACUUM, VACUUM ANALYZE, ANALYZE, CHECKPOINT 그리고 FORCE CHECKPOINT.
ClickHouse
선택 ClickHouse, 호스트, HTTP 포트(8123, 또는 8443 TLS 사용), 사용자 이름과 비밀번호, 그리고 필요하면 데이터베이스 - 아니면 다음을 붙여넣습니다 clickhouse://user:password@host:8123/database URL. 아무
TLS 모드 이외의 값은 연결을 HTTPS로 전환하며, SSH 터널, 프록시, Kubernetes 포트 포워딩은 PostgreSQL과 MySQL에서와 마찬가지로 동작합니다.
선택 사항인 네이티브 포트 필드는 서버의 네이티브 프로토콜 TCP 포트입니다. SQLly 자체는 HTTP로만 통신하고, 이 필드는 다음에 쓰입니다 터미널에서 열기, 왜냐하면 clickhouse-client 네이티브 프로토콜로 통신합니다. 기본 매핑(9000, TLS 사용 시 9440)을 쓰려면 비워 두세요. SSH 터널 연결에서는 터미널이 이 포트로 자체 포워딩을 받습니다.
여러 문을 담은 스크립트는 한 번에 하나씩 실행되며 각 결과 집합이나 기록된 행을 보고하고, 취소하면 서버에서 쿼리가 중지됩니다. 쿼리 인사이트는 system.query_log (상위 쿼리와 최근 실패)를 읽고, 예상 계획에서는 각 인덱스가 걸러낸 파트와 그레인을 보여주고, 데이터 전송은 대상 테이블을 MergeTree로 만들며, 백업 / 복원 스크립트 BACKUP / RESTORE DATABASE 을 서버의 백업 디스크에 저장하고, 유지 관리 메뉴의 유일한 명령은 OPTIMIZE TABLE … FINAL입니다. 데이터베이스 생성과 삭제는 쿼리 탭에서 CREATE DATABASE / DROP DATABASE 쿼리 탭에서 말입니다.
Oracle 데이터베이스
SQLly의 Oracle 드라이버는 Oracle의 무료 인스턴트 클라이언트 (Basic 또는 Basic Light)를 연결 시 로드하므로, 먼저 다음에서 설치해야 합니다 oracle.com 그리고 SQLly를 재시작하세요. 클라이언트가 없다면 연결 테스트가 찾으려 했던 라이브러리와 그 위치를 정확히 알려줍니다:
- macOS - Apple Silicon(ARM64) DMG 설치 프로그램; SQLly가 찾는
libclntsh.dylibin~/lib,/usr/local/lib, 또는DYLD_LIBRARY_PATH. - Linux - Basic 패키지의 압축을 풀고 그 폴더를 다음에 추가합니다
LD_LIBRARY_PATH또는ldconfig디렉터리; SQLly가 찾습니다libclntsh.so. - Windows - Basic 패키지의 압축을 풀고 그 폴더를 다음에 놓습니다
PATH; SQLly가 찾는 것은oci.dll. - 어떤 플랫폼에서든,
SQLLY_ORACLE_CLIENT_DIR가 Instant Client 폴더로 설정되면 자동 탐색을 건너뜁니다.
이어서 다음을 고릅니다: Oracle 데이터베이스, 호스트, 포트 입력 (1521), 이때는 서비스 이름 데이터베이스 필드에 넣을 때는 앞에
SID: 를 붙이면 SID로 연결되고, TCPS나 월렛을 쓸 때는 서버 필드에 전체 접속 디스크립터를 넣으세요 - 사용자 이름과 비밀번호도요. 다음
AS SYSDBA 또는 AS SYSOPER 관리자 세션의 경우 사용자 이름 뒤에 입력합니다.
PL/SQL 블록은 다음으로 끝납니다 / 자신의 줄에, DBMS_OUTPUT 메시지 창에 줄이 나타나고, 탐색기에는 스키마, 테이블, 뷰, 패키지, 시퀀스, 동의어 및 유형이 표시됩니다. 유지 관리 메뉴는 통계를 수집합니다(DBMS_STATS), 구조를 검증하고 인덱스를 다시 빌드합니다. 행 편집, 보안 편집기, 백업, 비교·전송 도구는 아직 Oracle에서 쓸 수 없으며, 각 기능이 그 사실을 알려 줍니다.
libSQL과 Turso
선택 libSQL / Turso, 호스트와 …turso.io
주소 또는 sqld를 실행하는 머신 - 아니면 다음을 붙여넣습니다 sqld 포트에서 8080 - 그리고 데이터베이스의 인증 토큰 사용자 이름과 비밀번호 대신 씁니다(인증 없는 로컬 서버라면 비워 두세요). Turso에서는 토큰을 다음으로 만드세요 turso db tokens create <database> 또는 Turso 대시보드에서 만드세요. SQLly는 이를 운영 체제의 보안 저장소에 보관하며, Turso 호스트는 항상 HTTPS로 접속합니다. URL 상자는 다음을 받습니다
libsql://name-org.turso.io?authToken=…, 또는
http://127.0.0.1:8080 비워 두어도 됩니다. 인증 없는 로컬 sqld.
이는 네트워크를 통한 SQLite 방언이므로, 다음을 읽는 도구들은 sqlite_master - Schema Compare, Data Compare, Test Data Generator, 구조 편집기, 종속성 - 전부 SQLite에서와 똑같이 작동합니다. 스크립트는 하나의 단위로 실행되므로 BEGIN … COMMIT 그리고 롤백 래핑도 동작합니다. 취소는 서버를 중단시키지 않고 요청을 내려놓으며, 결과 전체가 첫 행보다 먼저 도착하므로 아주 큰 읽기는 다음으로 페이징하세요 LIMIT/OFFSET. 서버는 VACUUM 그리고 ANALYZE, 그래서 유지 관리 메뉴에서 제공되는 것은 REINDEX 그리고 무결성 검사도 지원합니다. 행 편집과 libSQL로의 데이터 전송은 아직 사용할 수 없습니다.
Redis, Valkey, KeyDB, DragonflyDB, ElastiCache 및 MemoryDB
선택 Redis (또는 서버에 맞는 호환 레이블)을 선택한 뒤 호스트, 포트(6379), 서버가 쓴다면 ACL 사용자 이름과 비밀번호, 선택적인 논리 데이터베이스 번호와 TLS 모드를 넣거나 다음을 붙여넣습니다
redis://user:password@host:6379/2 또는 rediss:// URL. 터널, 프록시, 포트 포워딩은 SQL 엔진과 똑같이 작동합니다.
- SQL이 아니라 명령입니다. 쿼리 탭은 실행됨 한 줄에 하나의 명령어 다음과 같은 문법으로
redis-cli(따옴표와 이스케이프 포함, 또는 특수한 값의 경우 JSON 인수 목록). 모든 응답은 결과 집합으로 도착합니다 - 해시는 필드/값 행으로, 정렬된 집합은 멤버/점수로,INFO섹션/키/값으로,CLIENT LIST그리고SLOWLOG테이블로 표시됩니다.SELECT스크립트가 끝날 때까지 논리 데이터베이스를 전환하며, 영원히 멈출 수 있는 명령(SUBSCRIBE,MONITOR, 타임아웃 없는 블로킹 팝)은 전송되기 전에 거부됩니다. - 키 브라우저. 탐색기는 키 개수와 함께 번호가 매겨진 데이터베이스를 나열하고, 한도를 둔 비차단 스캔으로 키를 훑으며, 정한 구분자를 기준으로 키를 폴더로 묶어 줍니다 (
:을 기본적으로 이스케이프하므로 값이 태그를 닫지 못합니다.user:42:profile다음 아래에 자리합니다user→42). 각 키에는 유형과 남은 TTL이 표시됩니다. 키를 두 번 클릭하면 그 유형에 맞는 리더가 실행됩니다 -GET,HGETALL,LRANGE,SMEMBERS,ZRANGE점수와 함께,XRANGE,JSON.GET- 그리고 키 메뉴에 키 복사, 명령 복사, TTL 설정, TTL 제거, 키 삭제가 있으며, 실행 전에 확인을 거칩니다. - 읽기 전용은 읽기 전용 명령을 의미합니다. SELECT 전용 잠금과 AI의 읽기 전용 모드는 읽기 전용 명령만 허용하며, 파괴적인 명령 -
FLUSHALL,FLUSHDB,DEL,CONFIG SET,SHUTDOWN등은 일반 확인 절차를 거칩니다. 서버 대시보드는INFO, 활동 모니터는 다음을 읽고CLIENT LIST(kill 지원), Query Insights는 슬로우 로그를 읽고, Disk Usage는 논리적 데이터베이스별 메모리를 보여줍니다.
모델링됨 - 드라이버 준비 중
이 엔진들은 기능 모델에 완전히 기술되어 있어 SQLly가 이들의 SQL, 인용 규칙, 타입 매핑을 만들어 낼 수 있습니다. 다만 아직 네이티브 커넥터가 없어 앱에서 실제 연결을 맺는 것은 지원되지 않습니다.
| 엔진 | 연결 방식 | SQL 방언 |
|---|---|---|
| IBM Db2 | DRDA | Oracle 계열 |
| IBM Informix | DRDA | Oracle 계열 (SELECT FIRST n) |
| Microsoft Access | ODBC / ACE | SQL Server 계열(일부 기능) |
| Snowflake | HTTP API | PostgreSQL 계열 (QUALIFY, MERGE) |
| Databricks SQL | HTTP API | PostgreSQL 계열 (Spark SQL) |
| Google Cloud Spanner | HTTP API | PostgreSQL 계열 (GoogleSQL, INSERT OR UPDATE) |
| Teradata | 독점 | Oracle 계열 (SELECT TOP n, QUALIFY) |
| SAP HANA | 독점 | Oracle 계열 |
의도는 하나, SQL은 엔진별로
엔진 규칙이 모델 안에 살아 있어서, 하나의 UI 동작이 어디서 실행되든 알맞은 방언으로 렌더링됩니다. 행 제한이 익숙한 예입니다. “상위 1000개 행 보기”는 이렇게 바뀝니다:
| 패턴 | 렌더링된 SQL | 엔진 |
|---|---|---|
| TOP | SELECT TOP 1000 … | SQL Server, Azure SQL, Access, Teradata |
| LIMIT | … LIMIT 1000 | PostgreSQL & MySQL 계열, SQLite, libSQL, DuckDB, ClickHouse, Snowflake |
| FETCH FIRST | … FETCH FIRST 1000 ROWS ONLY | Oracle, Db2 |
| FIRST | SELECT FIRST 1000 … | Informix |
엔진별 처리 방식은 식별자 인용, 문자열, 불리언 및 바이너리 리터럴, 업서트(ON CONFLICT, ON DUPLICATE KEY, 또는 MERGE), 그리고 15개 논리 유형 모두가 네이티브 저장소에 어떻게 매핑되는지도 담고 있습니다. 행이 없는 Redis는 모든 논리 유형을 바이너리에 안전한 문자열로 매핑하고 모든 쓰기를 키에 대한 SET으로 매핑합니다.