MySQL 연결 문자열 생성기
하나의 양식에서 MySQL 연결 URI, JDBC URL, ADO.NET 문자열, ODBC 문자열 또는 Go DSN을 만들거나, 하나를 붙여넣어 모든 옵션이 무엇을 하는지 확인하고 allowPublicKeyRetrieval 같은 안전하지 않은 설정을 잡아보세요. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
MySQL 연결 문자열 형식
MySQL에는 단일 연결 문자열 표준이 없습니다. Connector/J는 camelCase 속성이 포함된 JDBC URL을 사용합니다 (sslMode, connectTimeout 밀리초 단위), MySqlConnector와 Connector/NET은 ADO.NET을 씁니다 Server=...; 문자열, Connector/ODBC는 ODBC 키워드를 사용하고, Go의 드라이버는 자체 키워드를 사용합니다 user:pass@tcp(host:3306)/db DSN을 쓰고, MySQL Shell이 URI에 넣는 옵션은 ssl-mode.
TLS의 기본값은 PREFERRED 거의 모든 곳에서: 서버가 이를 지원할 때 암호화되지만, 인증서는 확인되지 않습니다. VERIFY_IDENTITY (MySqlConnector: VerifyFull)는 CA와 호스트 이름을 확인합니다.
URI MySQL Shell, mysql2, Prisma
mysql://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
JDBC MySQL Connector/J
jdbc:mysql://db.example.com/sales?user=app_user&password=your_password&sslMode=VERIFY_IDENTITY
ADO.NET MySqlConnector, MySql.Data
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
ODBC MySQL Connector/ODBC
Driver={MySQL ODBC 8.0 Unicode Driver};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SslMode=VERIFY_IDENTITY;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
SQLAlchemy URL Python SQLAlchemy와 PyMySQL
mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 MySQL에 연결하는 방법 더 알아보기: MySQL용 SQLly.
MySQL Connector/J 속성
URL 형식: jdbc:mysql://[host][:port][/database][?property=value&...]. 예약된 문자를 퍼센트 인코딩하십시오 (/ : @ ( ) [ ] & # = ? 및 공백)을 사용자와 비밀번호를 포함한 모든 곳에서 제거합니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
user / password |
- | - | 자격 증명. |
sslMode |
- | 권장 | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
useSSL / requireSSL / verifyServerCertificate |
- | - | 지원 중단됨; 여전히 변환됨 (useSSL=false = DISABLED). sslMode 가 우선합니다. |
connectTimeout |
- | 0 (없음) | 소켓 연결 대기 시간(밀리초). |
socketTimeout |
- | 0 (없음) | 읽기가 차단될 수 있는 밀리초. |
allowPublicKeyRetrieval |
- | 거짓 | 클라이언트가 서버의 RSA 키를 요청하도록 허용합니다 caching_sha2_password TLS 없이. |
connectionTimeZone |
serverTimezone | 로컬 | LOCAL, SERVER 또는 영역 ID. |
characterEncoding |
- | utf8mb4 (8.0.26 이상) | Java 문자 집합. |
trustCertificateKeyStoreUrl |
- | - | VERIFY_CA / VERIFY_IDENTITY용 서버의 CA가 포함된 신뢰 저장소. |
rewriteBatchedStatements |
- | 거짓 | 일괄로 묶인 INSERT를 다중 행 문으로 다시 씁니다. |
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 인젝션 피해 범위 확대. |
MySQL Connector/ODBC 키워드
키워드는 대소문자를 구분하지 않습니다. 드라이버 이름은 ODBC 관리자가 등록한 이름과 일치해야 하며, 해당 이름에는 버전 정보가 포함됩니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
Driver |
- | - | 예: {MySQL ODBC 8.0 Unicode Driver}. |
Server |
- | localhost | 호스트. |
Port |
- | 3306 | TCP 포트. |
Database |
- | - | 기본 스키마. |
User |
UID | - | 사용자 이름. |
Password |
PWD | - | 비밀번호. |
SSLMODE |
ssl 모드 (8.0.29+) | 권장 | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
일반적인 MySQL 연결 오류
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
이유: 오류 1045: 비밀번호가 틀렸거나, 계정이 다른 호스트 패턴으로 따로 존재합니다('app_user'@'localhost' 은(는) 다음과 다른 계정입니다 'app_user'@'%').
해결: 비밀번호를 확인하고 SELECT user, host FROM mysql.user; 연결하려는 호스트에 대한 계정을 생성하거나 권한을 부여하십시오.
Public Key Retrieval is not allowed
이유: TLS를 사용하지 않는 연결에서 Connector/J가 MySQL 8의 caching_sha2_password TLS 없는 연결에서: 드라이버는 비밀번호를 보내기 위해 서버의 RSA 키가 필요하며 이를 요청할 수 없습니다.
해결: TLS 사용 (sslMode=REQUIRED 또는 더 강한 버전). allowPublicKeyRetrieval=true 도 작동하지만, 신뢰할 수 없는 네트워크에서는 중간자 공격에 노출됩니다.
Can't connect to MySQL server on 'db.example.com:3306' (110)
이유: 오류 2003: 서버에 연결할 수 없음: 호스트 또는 포트가 잘못되었거나, bind-address 127.0.0.1로 제한되었거나, 방화벽 때문입니다. (111은 연결 거부, 110은 타임아웃을 의미합니다.)
해결: 확인 bind-address 그리고 port my.cnf와 방화벽, 클라우드 보안 그룹을 확인한 다음 다음으로 테스트합니다 nc -vz db.example.com 3306.
Host '10.0.0.7' is not allowed to connect to this MySQL server
이유: 오류 1130: 사용자 이름과 클라이언트 호스트가 모두 일치하는 계정이 없습니다.
해결: 호스트 또는 패턴에 대한 계정을 생성하십시오: CREATE USER 'app_user'@'10.0.0.%' ... 그리고 필요한 권한을 부여하세요.
Unknown database 'sales'
이유: 오류 1049: 연결 문자열의 스키마가 존재하지 않거나, 대소문자를 구분하는 테이블 이름을 쓰는 서버에서는 이름의 대소문자가 다릅니다.
해결: 확인 SHOW DATABASES; 그리고 철자가 정확한지도 확인하세요.
Communications link failure
이유: Connector/J가 서버와의 통신을 완료하지 못했습니다: 네트워크 끊김, TLS 핸드셰이크 실패, wait_timeout 유휴 풀 연결을 닫거나 중간에 있는 프록시 때문일 수 있습니다.
해결: 중첩된 원인을 확인하세요. TLS 문제라면 sslMode 그리고 신뢰 저장소를 점검하고, 유휴 연결이 끊기는 문제라면 풀의 최대 수명을 서버의 wait_timeout.
Authentication plugin 'caching_sha2_password' cannot be loaded
이유: MySQL 8의 기본 인증 플러그인보다 먼저 나온 오래된 클라이언트 라이브러리입니다.
해결: 클라이언트나 커넥터를 업그레이드하세요. 계정을 다음으로 바꾸는 것은 mysql_native_password 임시 방편입니다; 그 플러그인은 더 이상 권장되지 않습니다.
MySQL 연결 문자열 FAQ
MySQL 연결 문자열 형식은 무엇인가요?
드라이버에 따라 다릅니다. JDBC: jdbc:mysql://host:3306/db?user=...&password=.... ADO.NET: Server=host;Port=3306;Database=db;User ID=user;Password=...;. Go: user:password@tcp(host:3306)/db. MySQL Shell과 많은 Node, ORM 도구는 다음을 받습니다 mysql://user:password@host:3306/db.
MySQL 기본 포트는 무엇인가요?
클래식 프로토콜은 3306, X 프로토콜은 33060입니다 (mysqlx://).
useSSL=false를 사용해야 하나요?
아니요. useSSL Connector/J에서 지원 중단되었습니다. 대신 사용할 것은 sslMode. sslMode=DISABLED (무엇이 useSSL=false 에 매핑되는지) 쿼리와 결과를 일반 텍스트로 전송합니다. 사용하세요 VERIFY_IDENTITY 서버의 CA를 사용할 수 있는 경우 사용하거나, 최소한 REQUIRED.
allowPublicKeyRetrieval=true는 안전한가요?
TLS 또는 신뢰할 수 있는 네트워크에서만 가능합니다. MySQL 8의 기본 설정은 caching_sha2_password 비밀번호를 전송하려면 TLS 또는 서버의 RSA 공개 키가 필요합니다. 클라이언트가 인증되지 않은 상태로 키를 가져오도록 허용하면 중간에 있는 공격자가 자신의 키를 전달하고 비밀번호를 읽을 수 있습니다. TLS를 사용하는 것이 좋습니다 (sslMode=REQUIRED 또는 더 강한 버전).
Go MySQL DSN에서 비밀번호를 이스케이프해야 하나요?
아니요. go-sql-driver/mysql 문서에 따르면 비밀번호는 이스케이프 없이 어떤 문자든 포함할 수 있으며, 드라이버는 마지막 @에서 분리합니다. 쿼리 매개변수 값은 URL 인코딩되어야 하며, 매개변수 이름은 대소문자를 구분합니다.parseTime, 다른 테이블인 parsetime).
JDBC에서 connectTimeout이 왜 이렇게 큰가요?
커넥터/J의 connectTimeout 그리고 socketTimeout 단위는 밀리초이고, 둘 다 기본값은 0이며 이는 제한 없음을 뜻합니다. connectTimeout=10000 10초입니다. MySqlConnector의 Connection Timeout 초 단위입니다(기본값 15).
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, MySQL 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.