연결 문자열 빌더 및 디코더
양식을 채우면 드라이버가 쓰는 모든 형식의 연결 문자열을 - ADO.NET, JDBC, ODBC, URL, libpq, Go DSN 등 - 나란히 받아 볼 수 있습니다. 또는 연결 문자열을 붙여 넣으면 각 키가 무슨 일을 하고 무엇이 위험한지 알려줍니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
데이터베이스 선택
각 엔진 페이지는 해당 엔진에서 빌더를 열고 전체 키워드 참조, 일반 연결 오류 및 그 해결 방법을 추가합니다.
SQL Server
ADO.NET, ODBC, JDBC, Go URL, SQLAlchemy URL
PostgreSQL
URI, 키워드/값, ADO.NET (Npgsql), JDBC, ODBC
MySQL
URI, JDBC, ADO.NET, ODBC, Go DSN
MariaDB
JDBC, ADO.NET, Go DSN, SQLAlchemy URL, URI
SQLite
파일 경로, URI 파일 이름(읽기 전용), ADO.NET, JDBC, SQLAlchemy URL
Oracle
Easy Connect, TLS를 통한 Easy Connect, 연결 디스크립터, JDBC Thin, ADO.NET (ODP.NET)
Redis
TLS가 있는 URI, ACL 사용자가 있는 URI(Redis 6+), StackExchange.Redis, redis-cli
ClickHouse
HTTP URL, 네이티브 DSN, JDBC, ADO.NET
DuckDB
파일 경로, JDBC, SQLAlchemy URL, CLI, 읽기 전용
libSQL
데이터베이스 URL, 인증 토큰이 있는 URL, 로컬 sqld
연결 문자열 형식 및 이스케이프 방법
연결 문자열 버그는 대부분 이스케이프 버그입니다: 비밀번호에 @, ; 또는 드라이버가 잘못된 위치에서 분할하는 따옴표가 있을 때 발생합니다. 각 형식에는 고유한 규칙이 있습니다.
| 형식 | 예시 | 특수 문자 |
|---|---|---|
| URL / URI | postgresql://user:pass@host:5432/db?sslmode=verify-full | 사용자, 비밀번호, 데이터베이스의 예약 문자는 퍼센트 인코딩하세요: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25, 공백 → %20. |
| ADO.NET | Server=host;Database=db;User ID=u;Password=p; | 값을 다음으로 감쌉니다 ;, 앞이나 뒤의 공백, 또는 다음에서 선행 따옴표 "…" (또는 '…'), 그리고 내부의 따옴표 문자는 두 번 적습니다: Password="a;b""c". |
| ODBC | Driver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w}; | 값은 중괄호로 감쌉니다. 드라이버 이름은 늘 그렇게 감싸여 있습니다. |
| JDBC | jdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=u | 벤더별로 다릅니다. Microsoft는 중괄호를 사용하며 } 는 두 번 입력합니다. PostgreSQL, MySQL, MariaDB: URL 쿼리이므로 퍼센트 인코딩 필요. |
| libpq 키워드/값 | host=h dbname=db user=u password='a b' | 값이 비어 있거나 공백을 포함하면 작은따옴표로 감쌉니다. 다음과 같이 씁니다 \' 그리고 \\ 따옴표나 백슬래시를 뜻합니다. |
| Go MySQL DSN | user:pass@tcp(host:3306)/db?tls=true | 비밀번호는 이스케이프가 필요 없고, 매개변수 값은 URL 인코딩되며, 매개변수 이름은 대소문자를 구분합니다. |
| StackExchange.Redis | host:6380,password=p,ssl=true | 옵션은 쉼표로 구분되므로, 쉼표가 포함된 비밀번호는 코드에서 설정해야 합니다. |
| Oracle 이지 커넥트 | host:1521/service_name | 자격 증명이 없음; 사용자 이름과 비밀번호를 별도로 전달하세요. |
디코더가 확인하는 것
- 인증서 확인이 꺼져 있음.
TrustServerCertificate=true,sslmode=require,tls=skip-verify,sslMode=trust그리고 pgJDBC의NonValidatingFactory전부 암호화는 하지만 응답자가 누구인지는 확인하지 않습니다. - TLS가 없거나 다운그레이드될 수 있는 TLS.
sslmode=disable또는prefer,Encrypt=False,ssl-mode=DISABLED,redis://에 비밀번호를 얹은 형태, ClickHouse로의 평문 HTTP. - 변경된 기본값. 아니요
EncryptMicrosoft.Data.SqlClient 4.0+, ODBC Driver 18, JDBC 10.2+에서는 암호화와 검증을 의미하지만, 구버전 드라이버나 go-mssqldb에서는 그렇지 않습니다. - 문자열에 있는 비밀. 평문 비밀번호와 인증 토큰,
Persist Security Info=True, 만료된 Turso 토큰들. - 오타와 다른 드라이버에서 빌려 온 키워드. 감지된 드라이버에 없는 키,
host:portSQL Server가 원하는 위치,host,port대소문자를 구분하는 Go 매개변수, 이스케이프되지 않은@URL 비밀번호 안의 문자, 서비스명이어야 할 Oracle SID. - SQLly가 이를 읽는 방식. 디코더는 또한 SQLly 앱 자체의 연결 문자열 리더와 동일한 규칙을 실행하므로, 앱이 무엇을 채울지 알 수 있습니다.
연결 문자열 FAQ
연결 문자열이 외부로 전송되나요?
아니요. 빌더와 디코더는 브라우저 탭에서 실행되는 JavaScript입니다. 입력하거나 붙여넣은 것은 업로드되거나 기록되거나 저장되지 않고 브라우저 저장소에도 남지 않으며, 페이지가 한 번 로드되면 네트워크를 꺼도 계속 동작합니다.
어떤 데이터베이스와 드라이버를 지원하나요?
SQL Server와 Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, Oracle, Redis와 Valkey, ClickHouse, DuckDB, 그리고 libSQL / Turso를 지원합니다. 엔진마다 실제로 존재하는 형식을 만들어 줍니다: URL, ADO.NET, JDBC, ODBC, libpq 키워드/값 문자열, Go DSN, SQLAlchemy URL, StackExchange.Redis 문자열, Oracle Easy Connect와 TNS 설명자, 그리고 Python과 Node.js에 바로 붙여넣을 수 있는 코드까지.
비밀번호에 특수 문자를 넣으려면 어떻게 하나요?
형식에 따라 달라집니다. URL에서는 퍼센트 인코딩을 사용하세요: @ 다음과 같이 됩니다 %40, : 다음과 같이 됩니다 %3A, / 다음과 같이 됩니다 %2F, % 다음과 같이 됩니다 %25. ADO.NET 문자열에서는 다음이 들어 있는 값을 ; 또는 큰따옴표로 묶고 안쪽의 큰따옴표는 두 번 적습니다. ODBC와 Microsoft의 JDBC 드라이버에서는 중괄호로 묶습니다 {...} 그리고 닫는 중괄호는 두 번 씁니다. libpq 키워드/값 문자열에서는 작은따옴표를 쓰고 백슬래시로 이스케이프합니다 ' 그리고 \. 빌더가 이 모든 작업을 대신 해줍니다.
디코더는 무엇을 확인하나요?
디코더는 드라이버가 읽는 방식대로 문자열을 읽고, 각 키와 그 동작을 나열하며, 문제를 표시합니다: 인증서 확인이 꺼져 있음 (TrustServerCertificate=true, sslmode=require, tls=skip-verify), TLS가 꺼져 있거나 선택 사항인 경우, 평문 비밀번호와 토큰, 잘못 적었거나 알 수 없는 키워드, host:port SQL Server가 원하는 위치, host,port, URL 비밀번호의 이스케이프되지 않은 문자, Oracle의 SID와 서비스 이름 혼동, 드라이버 버전 사이에 바뀐 기본값 Encrypt Microsoft.Data.Sqlite에서는,
드라이버를 업그레이드한 후 연결이 인증서 오류로 실패하는 이유는 무엇인가요?
Microsoft.Data.SqlClient 4.0, ODBC Driver 18, Microsoft JDBC Driver 10.2 모두 기본적으로 암호화하고 서버 인증서를 검증하도록 바뀌었습니다. 자체 서명 인증서를 그대로 쓰는 SQL Server는 "The certificate chain was issued by an authority that is not trusted" 오류로 실패합니다. 클라이언트가 신뢰하는 CA의 인증서를 설치하고 다음을 설정하세요: TrustServerCertificate=true 로컬 개발에만 사용하세요.
"SQLly에서 열기"란 무엇인가요?
SQLly는 macOS, Windows, Linux용 데스크톱 SQL 클라이언트입니다. 이 버튼은 sqlly://connection/new 링크를 만들어 주며, 호스트·포트·데이터베이스·사용자가 이미 채워진 채로 SQLly의 연결 편집기를 엽니다. 비밀번호는 체크박스를 선택한 경우에만 링크에 담기고, SQLly가 연결 파일에 비밀번호를 적어 두는 일은 없습니다. 링크는 브라우저에서 컴퓨터의 앱으로 곧장 가며 어떤 서버도 거치지 않습니다.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, 데이터베이스 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.