MariaDB 연결 문자열 생성기
하나의 양식에서 MariaDB JDBC URL, ADO.NET 문자열, Go DSN을 만들거나, 하나를 붙여넣어 모든 옵션이 무엇을 하는지, TLS가 실제로 검증되는지 확인할 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
MariaDB 연결 문자열 형식
MariaDB는 MySQL 프로토콜을 사용하므로 MySQL 드라이버(MySqlConnector, go-sql-driver/mysql, mysql2)는 동일한 문자열로 MariaDB에 연결됩니다. MariaDB 자체 Connector/J는 jdbc:mariadb:// 그리고 다른 sslMode MySQL의 단어보다: disable, trust, verify-ca, verify-full.
Connector/J의 기본값에 주의하세요: 버전 3.x는 다음의 경우 TLS 없이 연결합니다 sslMode 이(가) 설정되어 있지 않은데, 4.0에서 기본값이 다음으로 바뀌었습니다 verify-full, 자체 서명 인증서를 쓰는 서버에서는 실패합니다.
JDBC MariaDB Connector/J
jdbc:mariadb://db.example.com/sales?user=app_user&password=your_password&sslMode=verify-full
ADO.NET MySqlConnector
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
SQLAlchemy URL MariaDB Connector/Python
mariadb+mariadbconnector://app_user:[email protected]/sales
URI SQLly 및 URI 스타일 도구
mariadb://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 MariaDB에 연결하는 방법 더 알아보기: MariaDB용 SQLly.
MariaDB Connector/J 옵션
URL 형식: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]. Connector/J 3.x는 다음만 허용합니다 jdbc:mysql: 와 함께 permitMysqlScheme.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
user / password |
- | - | 자격 증명. |
sslMode |
- | disable (3.x); verify-full (4.0+) | disable, trust (암호화, 검사 없음), verify-ca, verify-full, 그리고 allow (3.5.11+). |
serverSslCert |
- | - | verify-ca / verify-full용 CA 또는 서버 인증서(경로 또는 PEM). |
connectTimeout |
- | 30000 | 연결 대기 시간(밀리초). |
socketTimeout |
- | 0 | 읽기가 차단될 수 있는 밀리초. |
allowPublicKeyRetrieval |
- | 거짓 | TLS 없이 서버의 RSA 키 요청. |
MySqlConnector (ADO.NET) 옵션
MySqlConnector와 Oracle의 Connector/NET (MySql.Data)는 대부분의 키워드를 공유합니다. 값은 ; 큰따옴표로 묶습니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
Server |
호스트, 데이터 소스, 주소 | localhost | 호스트, 쉼표 목록 또는 Unix 소켓 경로. |
Port |
- | 3306 | TCP 포트. |
User ID |
UID, 사용자, 사용자 이름 | - | 사용자 이름. |
Password |
PWD | - | 비밀번호. |
Database |
초기 카탈로그 | - | 기본 스키마. |
SslMode |
SSL 모드 | 선호 | None/Disabled, Preferred, Required, VerifyCA, VerifyFull. |
SslCa |
CA 인증서 파일, Ssl-Ca | - | VerifyCA / VerifyFull용 CA 파일. |
Connection Timeout |
연결 제한 시간 | 15 | 초. |
Default Command Timeout |
명령 제한 시간 | 30 | 초. 0이면 무한히 대기합니다. |
Application Name |
- | - | 다음을 설정합니다 program_name 연결 속성. |
AllowPublicKeyRetrieval |
- | 거짓 | 위의 경고를 보세요. |
AllowUserVariables |
- | 거짓 | 허용 @variables SQL에서. |
Pooling |
- | 참 | 연결 풀링. |
Maximum Pool Size |
최대 풀 크기 | 100 | 가장 큰 풀. |
Minimum Pool Size |
최소 풀 크기 | 0 | 가장 작은 풀. |
go-sql-driver/mysql DSN
양식: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]. 비밀번호는 이스케이프할 필요가 없습니다; 데이터베이스 이름은 경로 이스케이프되었습니다 (1.8 이상); 매개변수 값은 쿼리 이스케이프되었습니다; 매개변수 이름은 대소문자를 구분합니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
tcp(host:port) |
unix(/경로) | tcp(127.0.0.1:3306) | 주소. 포트는 기본값 3306입니다. |
tls |
- | 거짓 | true (검증), false, skip-verify (암호화, 검사 없음), preferred, 또는 등록된 구성 이름. |
timeout |
- | OS 기본값 | 단위를 포함한 다이얼 타임아웃: 10s. |
readTimeout / writeTimeout |
- | 0 | 단위가 있는 I/O 타임아웃. |
parseTime |
- | 거짓 | DATE 및 DATETIME 스캔하여 time.Time. |
loc |
- | UTC | 다음에 적용되는 시간대 time.Time 값 (이스케이프 / as %2F). |
collation |
- | utf8mb4_general_ci | 연결 콜레이션. |
allowCleartextPasswords |
- | 거짓 | 비밀번호를 평문으로 전송(TLS에서만). |
multiStatements |
- | 거짓 | 쿼리당 여러 문 실행; SQL 인젝션 피해 범위 확대. |
일반적인 MariaDB 연결 오류
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
이유: 잘못된 비밀번호이거나 계정이 다른 호스트 패턴에 대해 정의됨.
해결: 확인 SELECT user, host FROM mysql.user 그리고 연결하려는 호스트용 계정을 만들거나 권한을 부여합니다.
Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate
이유: Connector/J 4.0+는 기본적으로 sslMode=verify-full, 그리고 서버가 자체 서명 인증서나 다른 이름의 인증서를 내밉니다.
해결: 드라이버에 CA를 다음과 함께 전달합니다 serverSslCert=/path/ca.pem, 또는 연결하는 호스트 이름에 맞는 인증서를 사용하세요. sslMode=trust 검증 없이 암호화하며 신뢰할 수 있는 네트워크에서만 사용됩니다.
Host '10.0.0.7' is not allowed to connect to this MariaDB server
이유: 사용자 이름과 클라이언트 호스트가 일치하는 계정이 없습니다.
해결: 호스트 또는 다음과 같은 패턴에 대한 계정을 생성하십시오 'app_user'@'10.0.0.%'.
Unknown database 'sales'
이유: 연결 문자열에 지정한 데이터베이스가 존재하지 않거나 철자가 다릅니다.
해결: 확인 SHOW DATABASES;.
MariaDB 연결 문자열 FAQ
MariaDB에서 MySQL 드라이버를 사용할 수 있나요?
예, 일반적인 경우라면 가능합니다. MariaDB는 MySQL 클라이언트 프로토콜을 유지하므로 MySqlConnector, Connector/NET, go-sql-driver/mysql, mysql2, PyMySQL이 동일한 연결 문자열로 접속합니다. MariaDB 고유 기능은 MariaDB 자체 커넥터가 가장 잘 지원합니다.
sslMode=trust는 무엇을 의미하나요?
MariaDB Connector/J에서 MySQL의 REQUIRED: 연결은 암호화되지만 서버 인증서는 검증하지 않습니다. 다음을 사용하세요 verify-full 와 함께 serverSslCert 를 함께 쓰면 서버까지 검증됩니다.
기본 MariaDB 포트는 무엇인가요?
3306이며, MySQL과 동일합니다.
Connector/J를 업그레이드한 후 MariaDB JDBC 연결이 끊어지는 이유는 무엇인가요?
Connector/J 4.0에서는 sslMode 의 기본값이 disable 에게 verify-full로 변경되었습니다. TLS가 없거나 자체 서명 인증서를 쓰는 서버는 이제 연결에 실패합니다. TLS를 올바르게 구성하거나 다음을 sslMode 명시적으로 설정하세요.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, MariaDB 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.