터미널에서 열기
정상 동작연결 정보가 미리 채워진 상태로 psql, mysql, sqlcmd, redis-cli 등으로 바로 진입.
다음을 마우스 오른쪽 버튼으로 클릭하고 서버 개체 탐색기에서 다음을 고릅니다 터미널에서 열기, 또는 다음을 실행하세요 터미널에서 연결 열기 활성 연결을 사용하려면 명령 팔레트에서 선택합니다. SQLly는 이미 연결된 상태로 엔진 자체의 명령줄 클라이언트를 실행하는 새 터미널 창을 엽니다: 호스트, 포트, 데이터베이스, 사용자 및 TLS 모드는 연결 프로필에서 채워집니다.
| 엔진 | 클라이언트 | 비밀번호 전달 방법 |
|---|---|---|
| PostgreSQL 및 호환 DB | psql | PGPASSWORD 환경 변수로 전달합니다. TLS 모드는 PGSSLMODE에 넣고, 프로필의 CA 파일, 클라이언트 인증서 및 키는 PGSSLROOTCERT, PGSSLCERT, 그리고 PGSSLKEY에 넣습니다. CA 파일이 없는 검증 프로필은 PGSSLROOTCERT=system, 시스템 신뢰 저장소(psql 16 이상)를 사용합니다. |
| MySQL / MariaDB | mysql | MYSQL_PWD 환경 변수로 전달합니다. CA 파일과 클라이언트 인증서는 --ssl-ca, --ssl-cert, 그리고 --ssl-key. MySQL 클라이언트는 인증서를 CA 파일 대조로만 검증할 수 있으므로, CA 파일이 없는 검증 프로필은 시스템 CA 번들을 사용합니다. 그것도 없으면(Windows) 세션은 암호화되지만 검증은 안 되고, SQLly가 그 사실을 알려 줍니다. |
| SQL Server | sqlcmd | SQLCMDPASSWORD 환경 변수로 전달합니다. 통합 인증은 -E. SQLly는 설치된 sqlcmd의 -? 배너로 go-sqlcmd와 Microsoft의 ODBC sqlcmd를 구분하고, 해당 버전이 받아들이는 방식으로 암호화를 표기합니다: -Nm (필수, 추가로 -C 서버 인증서를 신뢰하기 위해) 또는 -No (선택 사항, 암호화되지 않은 프로필의 경우, 그렇지 않으면 sqlcmd 18이 암호화를 요구함) go-sqlcmd 1.4 이상 및 ODBC sqlcmd 18 이상용; -Ntrue / -Nfalse 구버전 go-sqlcmd용이고, 맨 -N ODBC sqlcmd 17 이하에서 쓰는 것인데, 이 버전은 기본적으로 암호화되지 않습니다. |
| Redis | redis-cli | REDISCLI_AUTH 환경 변수로 전달합니다. 유닉스 소켓 프로필은 -s. CA 파일과 클라이언트 인증서는 다음에 넣습니다 --cacert, --cert, 그리고 --key. |
| ClickHouse | clickhouse-client | CLICKHOUSE_PASSWORD 환경 변수. clickhouse-client ClickHouse의 네이티브 프로토콜을 사용하며, SQLly가 사용하는 HTTP 프로토콜은 사용하지 않으므로 연결의 네이티브 포트 (연결 편집기의 ClickHouse 전용 필드)가 설정되어 있을 때입니다. 설정되어 있지 않으면 프로필의 HTTP 포트를 네이티브 포트로 매핑합니다: 8123은 9000으로, 8443은 9440으로. 그 외 포트는 SQLly가 9000(TLS면 9440)으로 가정하고 실행 후 그렇게 알려 줍니다. 사용자 지정 CA나 클라이언트 인증서는 clickhouse-client의 자체 설정 파일에 설정해야 합니다. |
| DuckDB / SQLite | duckdb / sqlite3 | 비밀번호가 필요하지 않습니다. 데이터베이스 파일이 직접 열립니다. |
| Oracle | sqlplus또는 SQL*Plus가 설치되어 있지 않은 경우 SQLcl | 두 클라이언트 모두 환경 변수에서 비밀번호를 읽지 않고, 대신 터미널에서 비밀번호를 묻습니다. |

비밀번호는 명령줄에 절대 전달되지 않습니다
명령줄에 넣은 내용은 다른 사용자가 ps, 그래서 SQLly가 만드는 인자에는 비밀 값이 전혀 들어가지 않습니다. 비밀번호는 클라이언트 프로세스의 환경으로만 전달됩니다. Linux와 Windows의 터미널은 그 환경을 그대로 물려받으므로 비밀번호가 디스크에 기록되지 않습니다. macOS의 Terminal.app은 환경을 물려받지 않기 때문에 SQLly가 대신 짧은 실행 스크립트를 만들어 줍니다. 이 스크립트는 본인만 읽을 수 있고 본인만 열 수 있는 폴더에 있습니다. 첫 줄이 자기 자신을 지운 뒤 클라이언트를 시작합니다. Terminal이 그 스크립트를 실행하지 않으면 SQLly가 5분 후에 지웁니다.
호스트, 사용자, 데이터베이스 이름은 어떤 문자가 들어 있든 절대 셸 명령으로 읽히지 않습니다: Linux는 클라이언트에 별도 인수로 전달하고, macOS는 셸용으로 따옴표로 감싸고, Windows는 명령 프롬프트 특수 문자를 모두 이스케이프해 작은 런처 스크립트에 적습니다. Windows 스크립트에는 비밀번호가 들어 있지 않습니다.
클라우드 IAM 로그인(AWS RDS 및 Google Cloud SQL)은 SQLly가 연결할 때 토큰을 발급하며, 이 토큰은 터미널로 전달되지 않으므로 클라이언트가 비밀번호를 묻습니다. 거기에 새 토큰을 붙여넣으세요.
SSH 터널 및 릴레이
SSH 터널 연결은 터널의 로컬 포트로 접속합니다. 클라이언트가 이어서 127.0.0.1로 접속하기 때문에 서버 이름에 대한 인증서 확인에는 도움이 필요합니다: psql은 터널에 접속할 때 PGHOSTADDR 실제 호스트 이름은 계속 검증하면서 redis-cli는 실제 이름을 SNI로 보냅니다. sqlcmd에는 다음이 전달됩니다 -F 설치된 버전이 해당 스위치를 지원할 때(go-sqlcmd 1.9 이상, ODBC sqlcmd 18 이상) 실제 호스트 이름(인증서가 기대하는 호스트 이름)을 넘깁니다. mysql 클라이언트는 인증서 체인만 확인하고(MariaDB 클라이언트는 확인 없이 암호화해 연결), 구버전 sqlcmd는 인증서를 거부할 수 있습니다. SQLly는 실행 후 이런 점들을 알려줍니다. ClickHouse는 터널이 SQLly가 쓰는 HTTP 포트를 담당하므로, 터미널에서 열기가 같은 SSH 홉(또는 프록시)을 거쳐 네이티브 포트(연결의 네이티브 포트, 또는 9000 / 9440)로 두 번째 포워딩을 열고 clickhouse-client를 거기로 향합니다. 이 포워딩은 연결을 끊거나 SQLly를 종료할 때까지 열려 있고, 연결을 끊으면 닫히며 터미널 세션도 끝납니다. 터널 너머에서 clickhouse-client는 검증된 인증서를 127.0.0.1과 대조하므로 거부될 수 있다고 SQLly가 알려줍니다. Kubernetes 포트 포워딩은 연결 자체의 포트만 전달하므로 Kubernetes 위의 ClickHouse는 터미널을 열 수 없습니다. 릴레이 브리지를 거치는 연결은 아예 터미널을 열 수 없습니다. 클라이언트가 이 머신에서 데이터베이스로 직접 접속해야 하기 때문입니다.

어떤 터미널이 열리는지
- macOS: Launch Services를 통해 열리는 Terminal.app. 자동화 권한 프롬프트 없음.
- Linux:
$TERMINAL직접 설정한 경우에는x-terminal-emulator, GNOME Terminal, Konsole, Xfce Terminal, kitty, Alacritty, WezTerm, 그리고xterm. SQLly는 시작할 수 있는 첫 번째 터미널을 사용합니다.$TERMINAL그중 하나의 이름을 지정하면 해당 터미널 고유의 방식으로 명령을 실행합니다. 클라이언트가 끝난 뒤에도 창이 열려 있으니 오류를 읽을 수 있고, 닫으려면 Enter를 누르세요. - Windows: 클라이언트 종료 후에도 열려 있는 새 콘솔 창; 닫으려면 아무 키나 누르십시오.
SQLly는 덤프 도구를 찾는 것과 같은 방식으로 클라이언트를 찾습니다. 환경설정에서 정한 경로 재정의도 여기에 적용됩니다. 클라이언트가 설치되어 있지 않으면 메뉴 항목이 비활성화되고 무엇을 설치할지 알려줍니다. 터미널 클라이언트가 인계받을 수 없는 연결에서도 이유와 함께 비활성화됩니다: 메모리 전용 DuckDB와 SQLite, HTTP를 거치는 libSQL/Turso, SQL Server의 Entra 로그인, 릴레이 연결. DuckDB는 한 번에 한 프로그램만 파일을 쓸 수 있으므로, SQLly가 DuckDB 파일을 열어 두는 동안 Open in Terminal은 먼저 연결 해제를 요청합니다. 비밀번호가 아직 키링에 저장된 프로필은 먼저 키링에서 풀어 냅니다. 비밀번호가 없으면 클라이언트가 물어봅니다. 브라우저 버전은 터미널을 열 수 없습니다.