// 무료 도구

MariaDB 연결 문자열 생성기

하나의 양식에서 MariaDB JDBC URL, ADO.NET 문자열, Go DSN을 만들거나, 하나를 붙여넣어 모든 옵션이 무엇을 하는지, TLS가 실제로 검증되는지 확인할 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.

이 연결을 SQLly에서 열기

필드가 채워진 상태로 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를 사용할 수 있습니다.