// 무료 도구

SQL Server 연결 문자열 생성기

하나의 양식에서 ADO.NET(Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go 및 SQLAlchemy용 SQL Server 또는 Azure SQL 연결 문자열을 만들거나, 하나를 붙여넣어 각 키워드의 기능과 위험성을 확인할 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.

이 연결을 SQLly에서 열기

필드가 채워진 상태로 SQLly의 연결 편집기를 엽니다.

설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.

SQL Server 연결 문자열 형식

SQL Server 드라이버는 keyword=value 스타일은 같지만 키워드는 서로 다릅니다. 예를 들어 ADO.NET은 User ID 그리고 Connect Timeout, ODBC는 다음과 같이 말합니다 Uid 그리고 ConnectTimeout, JDBC는 다음과 같이 말합니다 user 그리고 loginTimeout, 그리고 Go는 URL을 씁니다. 둘은 한 가지 함정도 공유합니다: 포트는 쉼표 뒤에 옵니다(host,1433), JDBC와 Go를 제외한 모든 곳에서는 콜론이 아닌 다음을 씁니다.

사람들을 혼란스럽게 하는 또 다른 것은 암호화입니다. Microsoft.Data.SqlClient 4.0, ODBC 드라이버 18 및 JDBC 드라이버 10.2는 모두 기본적으로 암호화를 수행하고 서버 인증서를 검증하므로, 수년 동안 작동하던 문자열이 업그레이드 후에 실패하기 시작했습니다. 빌더는 다음과 같이 명시합니다 Encrypt 명시적으로 설정할 수 있으며, 디코더는 설정되지 않은 Encrypt 드라이버별로 무엇을 의미하는지입니다.

ADO.NET Microsoft.Data.SqlClient, System.Data.SqlClient, Entity Framework, Dapper

Server=sql01.example.com;Database=Sales;User ID=app_user;Password=your_password;Encrypt=True;

ODBC SQL Server용 ODBC 드라이버 18, pyodbc

Driver={ODBC Driver 18 for SQL Server};Server=sql01.example.com;Database=Sales;Uid=app_user;Pwd=your_password;Encrypt=yes;

JDBC SQL Server용 Microsoft JDBC 드라이버

jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;

Go URL github.com/microsoft/go-mssqldb

sqlserver://app_user:[email protected]?database=Sales&encrypt=true

SQLAlchemy URL Python SQLAlchemy와 pyodbc

mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes

Windows 인증(ADO.NET) 통합 보안

Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;

Microsoft Entra ID를 사용하는 Azure SQL(ADO.NET) 관리 ID, Azure CLI 또는 Visual Studio 로그인

Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;

다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 SQL Server에 연결하는 방법 더 알아보기: SQL Server용 SQLly.

Microsoft.Data.SqlClient (ADO.NET) 키워드

키워드는 대소문자를 구분하지 않으며 주변 공백은 무시되고, 키워드(또는 그 동의어)가 두 번 나오면 마지막 값이 적용됩니다. 알 수 없는 키워드가 있으면 다음 오류가 발생합니다 Keyword not supported값에 " 또는 ' 다음을 포함하는 경우 ;, 또는 공백이나 따옴표로 시작하거나 끝나는 값은 따옴표로 감싸세요; 따옴표 안에서는 따옴표 문자를 두 번 씁니다.

키워드동의어기본값기능
Server Data Source, Address, Addr, Network Address - host, host\instance, host,port, 또는 tcp:host,port. . 그리고 (local) 이 컴퓨터를 의미합니다; (localdb)\MSSQLLocalDB LocalDB입니다. 명명된 인스턴스는 UDP 1434의 SQL Server Browser를 통해 찾을 수 있습니다.
Database 초기 카탈로그 로그인의 기본 데이터베이스 연결되면 사용할 데이터베이스.
User ID UID, 사용자 - SQL 로그인, 또는 다음의 Entra 사용자 이름 Active Directory Password / Interactive.
Password PWD - 무시되는 경우 Integrated Security 이(가) 켜져 있습니다.
Integrated Security Trusted_Connection 거짓 true, yes 또는 sspi 프로세스를 실행하는 Windows 계정으로 로그인합니다 (Kerberos 또는 NTLM).
Authentication - 설정되지 않음 Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (별칭 Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (지원 중단됨). 7.0부터 Entra 방식은 다음이 필요합니다 Microsoft.Data.SqlClient.Extensions.Azure 패키지.
Encrypt - true (필수) 4.0 이상; false ADO.NET에서는 다음 대신 true/yes/Mandatory, false/no/Optional, 또는 Strict (5.x 이상, TDS 8.0: SQL Server 2022 이상 및 Azure SQL). 다음과 함께 Optional 로그인 패킷만 암호화된 채이고 나머지는 그렇지 않습니다.
TrustServerCertificate 서버 인증서 신뢰 거짓 true 인증서 검증을 건너뜁니다. 다음과 함께 쓰면 무시됩니다(거짓으로 취급) Encrypt=Strict.
HostNameInCertificate 인증서의 호스트 이름 - 5.0+. 서버 인증서에서 기대하는 이름. 다음과 다를 때 사용 Server, 예를 들어 별칭이나 IP 주소로 연결할 때.
ServerCertificate 서버 인증서 - 5.1 이상. 서버 인증서와 정확히 일치해야 하는 인증서 파일의 경로.
Connect Timeout 연결 시간 초과, 시간 초과 15 실패하기 전에 연결을 기다리는 시간(초).
Command Timeout - 30 2.1+. 기본 SqlCommand.CommandTimeout 초 단위이며, 0이면 무한히 기다립니다.
Application Name 앱 Core Microsoft SqlClient Data Provider (.NET) 로 표시됩니다 program_name in sys.dm_exec_sessions 그리고 Profiler / Extended Events에서도 확인할 수 있습니다.
ApplicationIntent 애플리케이션 의도 ReadWrite ReadOnly 가용성 그룹의 읽기 가능한 보조 복제본이나 Azure SQL의 읽기 복제본으로 라우팅합니다.
MultiSubnetFailover 다중 서브넷 장애 조치 거짓 다음으로 설정 true 여러 서브넷에 걸친 가용성 그룹 리스너에 연결할 때 더 빠른 장애 조치를 위해 사용합니다.
MultipleActiveResultSets 복수 활성 결과 집합 거짓 MARS: 하나의 연결에서 열려 있는 여러 리더.
Pooling - 참 연결 풀링.
Max Pool Size - 100 각기 다른 연결 문자열당 풀링된 연결의 최대 수.
Min Pool Size - 0 풀에 열려 있는 연결 수.
ConnectRetryCount 연결 재시도 횟수 1 유휴 연결이 끊긴 후 0~255회 재연결을 시도합니다.
ConnectRetryInterval 연결 재시도 간격 10 시도 사이의 간격은 1~60초입니다.
Persist Security Info PersistSecurityInfo 거짓 true 는 연결을 연 뒤 다음에서 비밀번호를 읽을 수 있는 상태로 남겨 둡니다 ConnectionString 열고 난 후. 끄고 두세요.

ODBC Driver 18 for SQL Server 키워드

pyodbc, R, PHP, Excel 및 ODBC를 쓰는 다른 모든 것에서 사용됩니다. 특수 문자가 포함된 값은 감싸 주세요 ([]{}(),;?*=!@) 중괄호 안에 있습니다. ADO.NET과 달리 키워드가 반복되면 먼저 나온 것이 우선합니다.

키워드동의어기본값기능
Driver - - {ODBC Driver 18 for SQL Server} (또는 17). 드라이버 관리자가 나열한 이름과 일치해야 합니다.
Server 주소, Addr - [tcp:]host[\instance][,port].
Database - 로그인 기본값 데이터베이스 이름.
UID / PWD - - SQL 로그인과 비밀번호.
Trusted_Connection - 아니요 yes Windows 인증을 사용합니다.
Authentication - - SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (지원 중단됨). 다음에 해당하는 것은 없습니다 ActiveDirectoryDefault ODBC에서.
Encrypt - 예 (드라이버 18), 아니오 (17 이하) yes/mandatory, no/optional, strict (18.1.2.1+).
TrustServerCertificate - 아니요 yes 인증서 검증을 건너뜁니다. 다음과 함께 쓰면 무시됨 Encrypt=strict.
HostnameInCertificate - - 18.0+. 서버 인증서에서 기대하는 호스트 이름.
ServerCertificate - - 18.1+. 서버 인증서와 일치해야 하는 인증서 파일.
ConnectTimeout - 15 18.7+. 로그인 제한 시간(초). 0이면 무제한. 구버전 드라이버는 다음을 코드로만 받습니다 SQL_ATTR_LOGIN_TIMEOUT 코드에서.
APP - - 애플리케이션 이름.
ApplicationIntent - ReadWrite ReadOnly 읽기 가능한 보조 복제본에는.
MultiSubnetFailover - 아니요 Yes 다중 서브넷 가용성 그룹에는.

SQL Server용 Microsoft JDBC 드라이버 속성

URL 형식: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. 속성 이름은 대소문자를 구분하지 않습니다. 다음을 포함하는 값은 ; 중괄호로 감싸고, 드라이버 8.4부터는 중괄호 안의 닫는 중괄호를 두 번 씁니다: password={pass;}}word}.

키워드동의어기본값기능
databaseName 데이터베이스 - 데이터베이스 이름.
user 사용자 이름 - 로그인 이름.
password - - 비밀번호.
integratedSecurity - 거짓 Windows 인증. Windows에서는 mssql-jdbc_auth-<version>.dll; 그 외에는 다음을 추가합니다 authenticationScheme=JavaKerberos.
authentication - 지정되지 않음 SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI 이전에).
encrypt - true (10.2 이상); false (9.4 및 이전 버전) true, false, 또는 strict (11.2+).
trustServerCertificate - 거짓 true 인증서 검증을 건너뜁니다.
hostNameInCertificate - - 인증서에 예상되는 호스트 이름.
serverCertificate - - 11.2 이상. 일치해야 하는 인증서 파일. strict와 함께 사용합니다.
loginTimeout - 30 (11.2 이상), 15 (이전 버전) 로그인 대기 시간(초).
queryTimeout - -1 (제한 없음) 기본 쿼리 제한 시간(초).
applicationName - SQL Server용 Microsoft JDBC 드라이버 애플리케이션 이름.
applicationIntent - ReadWrite ReadOnly 읽기 가능한 보조 복제본에는.
multiSubnetFailover - 거짓 다중 서브넷 가용성 그룹.
instanceName - - 명명된 인스턴스, 다음의 대안으로 host\instance URL에서.

go-mssqldb URL 매개변수

URL 형식: sqlserver://user:password@host:port?database=... 또는 sqlserver://user:password@host/instance?.... 경로는 인스턴스 이름이며, 데이터베이스가 아닙니다. 사용자 이름과 비밀번호의 특수 문자는 퍼센트 인코딩해야 합니다. 매개변수 이름은 대소문자를 구분하지 않습니다.

키워드동의어기본값기능
database - - 데이터베이스 이름.
encrypt - 거짓 (로그인 패킷만) strict, disable (TLS 전혀 없음), false, true. 기본값은 Microsoft 자체 드라이버와 다릅니다.
TrustServerCertificate - 암호화가 설정되면 거짓, 설정되지 않으면 참 true 인증서 검증을 건너뜁니다.
app name - go-mssqldb 애플리케이션 이름(다음과 같이 app+name 또는 app%20name URL에서).
connection timeout - 0 (없음) 전체 연결에 허용되는 시간(초).
dial timeout - 등록된 프로토콜당 15초 TCP 접속에 허용되는 시간(초).
fedauth - - Entra 방식 (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...)와 함께 azuread 패키지 및 azuresql 드라이버 이름입니다.

일반적인 SQL Server 연결 오류

The certificate chain was issued by an authority that is not trusted.

이유: Microsoft.Data.SqlClient 4.0+, ODBC Driver 18 및 JDBC 10.2+는 기본적으로 암호화하며 서버 인증서를 검증합니다. 서버가 자동 생성된 자체 서명 인증서를 사용하거나, 이 컴퓨터가 신뢰하지 않는 사설 CA의 인증서를 사용하고 있습니다.

해결: 서버에 신뢰할 수 있는 CA의 인증서를 설치하거나, 클라이언트에서 내부 CA를 신뢰하세요. 인증서가 유효한데 이름이 다르다면 다음을 설정하세요 HostNameInCertificate를 설정하십시오. 로컬 개발 서버에 한해서 TrustServerCertificate=True 를 사용하면 시작할 수 있습니다.

Login failed for user 'app_user'. (Error 18456)

이유: 잘못된 비밀번호, Windows 인증만 허용하는 서버의 SQL 로그인, 비활성화된 로그인, 또는 로그인이 열 수 없는 기본 데이터베이스. 서버 로그는 실제 원인을 상태 번호로 기록합니다.

해결: 비밀번호를 확인하고, SQL 로그인을 사용하는 경우 SQL Server 및 Windows 인증 모드를 활성화한 뒤 다음 항목을 설정하세요 Database 로그인이 열 수 있는 데이터베이스로 설정하세요. 서버 오류 로그의 상태(예: 상태 8 = 잘못된 비밀번호, 상태 38 = 데이터베이스 사용 불가)가 원인을 정확히 찾아줍니다.

Keyword not supported: 'host'.

이유: Microsoft.Data.SqlClient는 자체 키워드만 허용합니다. Host, Username 그리고 Port 는 Npgsql/MySQL 키워드입니다; Provider= OLE DB 연결 문자열에 속하는 키이며 다음과 같은 오타도 Databse 같은 방식으로 실패합니다.

해결: 다음을 사용하세요 Server, User ID, 그리고 host,port. 위의 디코더에 문자열을 붙여 넣으세요. 모르는 키워드는 전부 표시됩니다.

Format of the initialization string does not conform to specification starting at index 42.

이유: 값에 다음이 들어 있는데 ; 또는 따옴표를 담고 있는데 묶지 않아 파서가 문자열을 잘못된 위치에서 나눕니다. 비밀번호가 단골 원인입니다.

해결: 값을 큰따옴표로 감싸고, 그 안의 큰따옴표는 두 개로 겹쳐 쓰세요: Password="p;a""ss". 빌더가 값을 자동으로 이스케이프합니다.

The target principal name is incorrect. Cannot generate SSPI context.

이유: 통합 보안은 Kerberos를 사용합니다. SQL Server 서비스의 SPN(서비스 주체 이름)이 없거나 중복되었거나 다른 계정으로 등록되어 있거나, IP 주소나 별칭으로 연결한 경우입니다.

해결: 서버의 정규화된 전체 이름(FQDN)으로 연결하고, 관리자가 SPN을 등록하도록 하십시오 (setspn -L <service account> 그들을 나열합니다). 인증서 이름 불일치가 있는 경우에도 확인하세요 HostNameInCertificate.

SQL Server 연결 문자열 FAQ

SQL Server의 기본 포트는 무엇인가요?

기본 인스턴스의 경우 1433입니다. 명명된 인스턴스는 일반적으로 SQL Server 브라우저(UDP 1434)가 클라이언트에 알려주는 동적 포트를 사용하며, 이 때문에 host\instance 포트 없이 작동합니다. ADO.NET 및 ODBC에서는 포트가 쉼표 뒤에 옵니다: Server=host,1433.

Encrypt=True를 사용할까요, 아니면 TrustServerCertificate=True를 사용할까요?

다음을 사용하세요 Encrypt=True (또는 Strict SQL Server 2022 및 Azure SQL에서) 클라이언트가 신뢰하는 인증서를 사용하는 경우. TrustServerCertificate=True 트래픽은 암호화된 상태로 유지하지만, 클라이언트가 통신 상대를 확인하지 못하게 막으므로 연결을 가로챌 수 있는 사람은 누구든 서버로 위장할 수 있습니다. 로컬 개발에서만 사용하세요.

Microsoft.Data.SqlClient 4.0에서 Encrypt에 어떤 변화가 있었나요?

기본값 Encrypt 에서 변경됨 false 에게 true, 그리고 드라이버는 기본적으로 서버 인증서를 검증합니다. ODBC Driver 18과 JDBC Driver 10.2도 같은 변화를 겪었습니다. 다음이 없는 문자열은 Encrypt 키워드로 그동안 TLS 없이 접속하던 연결은 이제 서버에 신뢰할 수 있는 인증서가 필요합니다

Microsoft Entra ID로 Azure SQL Database에 어떻게 연결하나요?

추가 Authentication=Active Directory Default (관리형 ID, 환경 자격 증명 또는 Azure CLI / Visual Studio 로그인)을 선택하고 비밀번호는 생략하십시오. 사용 Active Directory Managed Identity Azure 호스팅 앱에서와 Active Directory Interactive 브라우저 로그인에 씁니다. Azure SQL은 다음을 받지 않는데 Integrated Security=SSPI.

Data Source와 Server, 또는 Initial Catalog와 Database의 차이는 무엇인가요?

없음. Microsoft.Data.SqlClient에서는 동의어이며, 다음도 마찬가지입니다 User ID / UID / User 그리고 Password / PWD. 두 표기가 모두 있으면 마지막 것이 이깁니다.

System.Data.SqlClient도 같은 연결 문자열을 사용하나요?

대체로 그렇습니다. 오래된 키워드는 지원하지만 다음과 같은 최신 키워드는 지원하지 않습니다 Command Timeout, Encrypt=Strict, HostNameInCertificate 또는 대부분 Authentication 값이며, 기본값은 Encrypt=False. Microsoft는 Microsoft.Data.SqlClient로 이전할 것을 권장합니다.

// 연결 문자열 없이

한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.

SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, SQL Server 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.