연결 옵션

PHP 드라이버 다운로드

이 항목에는 결합형 배열에 허용되는 옵션(SQLSRV 드라이버에서 sqlsrv_connect를 사용하는 경우) 또는 데이터 원본 이름(dsn)에 허용되는 키워드(PDO_SQLSRV 드라이버에서 PDO::__construct를 사용하는 경우)가 나열되어 있습니다.

연결 옵션 표

키	값	설명	기본값
AccessToken	문자열	OAuth JSON 응답에서 추출된 Microsoft Entra 액세스 토큰의 바이트 문자열입니다. 연결 문자열에는 사용자 ID, 비밀번호 또는 Authentication 키워드가 포함되지 않아야 합니다. 자세한 내용은 Microsoft Entra 인증을 사용하여 연결을 참조하세요.	설정 안 됨.
APP	문자열	추적에 사용되는 애플리케이션 이름을 지정합니다.	설정 안 됨.
ApplicationIntent	문자열	서버에 연결할 때 애플리케이션 작업 유형을 선언합니다. 가능한 값은 ReadOnly 및 ReadWrite입니다. Always On 가용성 그룹에 대한 Microsoft Drivers for PHP for SQL Server 지원에 대한 자세한 내용은 고가용성, 재해 복구 지원을 참조하세요.	ReadWrite
AttachDBFileName	문자열	서버에서 연결해야 하는 데이터베이스 파일을 지정합니다.	설정 안 됨.
인증	다음의 문자열 중 하나입니다. SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal	인증 모드를 지정합니다. 자세한 내용은 Microsoft Entra 인증을 사용하여 연결을 참조하세요.	설정 안 됨.
CharacterSet (PDO_SQLSRV 드라이버에서 지원되지 않음)	문자열	데이터를 서버로 전송하기 위해 사용되는 문자 집합을 지정합니다. 가능한 값은 SQLSRV_ENC_CHAR 및 UTF-8입니다. 자세한 내용은 기본 제공 UTF-8 지원을 사용하여 UTF-8 데이터 보내기 및 검색을 참조하세요.	SQLSRV_ENC_CHAR
ColumnEncryption	다음의 문자열 중 하나입니다. 활성화 사용 안 함 Enclave 증명을 위한 증명 프로토콜 및 URL을 식별하는 문자열입니다.	Always Encrypted 기능을 사용할지 여부를 지정합니다. 증명 프로토콜 및 URL이 지정된 경우 여기의 설명과 같이다른 요구 사항을 충족하면 보안 Enclave를 사용한 Always Encrypted가 활성화됩니다.	사용 안 함
ConnectionPooling	연결 풀링이 활성화된 경우 1 또는 true입니다. 연결 풀링이 비활성화된 경우 0 또는 false입니다.	연결 풀에서 연결을 할당할지(1 또는 true) 또는 할당하지 않을지(0 또는 false) 여부를 지정합니다.1	true(1)
ConnectRetryCount	0과 255(포함) 사이의 정수	포기하기 전에 끊어진 연결을 다시 설정하는 최대 시도 횟수입니다. 기본적으로 끊어진 연결을 다시 설정하기 위해 한 번 시도합니다. 값이 0이면 다시 연결이 시도되지 않습니다.	1
ConnectRetryInterval	1과 60(포함) 사이의 정수	연결 다시 설정 시도 사이의 시간(초)입니다. 애플리케이션은 끊어진 연결을 검색하는 즉시 다시 연결을 시도하고 다시 시도하기 전에 ConnectRetryInterval초 동안 대기합니다. ConnectRetryCount가 0이면 이 키워드는 무시됩니다.	10
데이터베이스	문자열	설정 중인 연결에 대해 사용 중인 데이터베이스 이름을 지정합니다2.	사용 중인 로그인의 기본 데이터베이스입니다.
DecimalPlaces (PDO_SQLSRV 드라이버에서 지원되지 않음)	0과 4(포함) 사이의 정수	가져온 Money 값의 형식을 지정할 때 소수점 이하 자릿수를 지정합니다. 이 옵션은 FormatDecimals가 true로 설정된 경우에만 적용됩니다. 음수 정수 또는 4보다 큰 값은 무시됩니다.	기본 전체 자릿수 및 소수 자릿수
드라이버	문자열	SQL Server와 통신하는 데 사용되는 Microsoft ODBC 드라이버를 지정합니다. 가능한 값은 다음과 같습니다. ODBC Driver 18 for SQL Server ODBC Driver 17 for SQL Server ODBC Driver 13 for SQL Server ODBC Driver 11 for SQL Server(Windows만 해당)	Driver 키워드를 지정하지 않으면 Microsoft Drivers for PHP for SQL Server는 최신 버전의 ODBC부터 시작하여 시스템에서 지원되는 Microsoft ODBC 드라이버를 찾으려고 시도합니다.
Encrypt	암호화 사용의 경우 1 또는 true입니다. 암호화 사용 안 함의 경우 0 또는 false입니다.	SQL Server와의 통신이 암호화되는지(1 또는 true) 암호화되지 않는지(0 또는 false)를 지정합니다 3.	false(0)
Failover_Partner	문자열	주 서버를 사용할 수 없을 때 사용할 데이터베이스 미러의 인스턴스 및 서버(사용하도록 설정되고 구성된 경우)를 지정합니다. Failover_Partner과 함께 MultiSubnetFailover를 사용하는 것에는 제한이 있습니다. 자세한 내용은 고가용성, 재해 복구를 위한 JDBC 드라이브 지원을 참조하세요. ODBC 드라이버가 Linux 또는 macOS에서 데이터베이스 미러링을 지원하지 않으므로 Linux 또는macOS에서는 이 옵션이 지원되지 않습니다. 대신 Always On 가용성 그룹을 사용하고 MultiSubnetFailover 및 TransparentNetworkIPResolution 옵션을 설정합니다.	설정 안 됨.
FormatDecimals (PDO_SQLSRV 드라이버에서 지원되지 않음)	가져온 10진수 문자열의 형식을 지정하려면 1 또는 true. 0 또는 false 기본 10진수 서식 지정 동작입니다.	해당하는 경우 10진수 문자열에 앞에 오는 0을 추가할지 여부를 지정하고 Money 형식의 형식을 지정하기 위한 DecimalPlaces 옵션을 사용하도록 설정합니다. false를 유지하면 정확한 정밀도를 반환하고 1보다 작은 값에 대해 선행 0을 생략하는 기본 동작이 사용됩니다. 자세한 내용은 10진수 문자열 및 Money 값 형식 지정을 참조하세요.	false(0)
KeyStoreAuthentication	KeyVaultPassword KeyVaultClientSecret	Azure Key Vault에 액세스하기 위한 인증 방법입니다. KeyStorePrincipalId 및 KeyStoreSecret과 함께 사용되는 자격 증명의 종류를 제어합니다. 자세한 내용은 Azure Key Vault 사용을 참조하세요.	설정 안 됨.
KeyStorePrincipalId	문자열	Azure Key Vault에 액세스할 계정의 식별자입니다. KeyStoreAuthentication이 KeyVaultPassword인 경우 이 값은 Microsoft Entra 사용자 이름이어야 합니다. KeyStoreAuthentication이 KeyVaultClientSecret인 경우 이 값은 애플리케이션 클라이언트 ID여야 합니다.	설정 안 됨.
KeyStoreSecret	문자열	Azure Key Vault에 액세스할 계정에 대한 자격 증명 비밀입니다. KeyStoreAuthentication이 KeyVaultPassword인 경우 이 값은 Microsoft Entra 비밀번호여야 합니다. KeyStoreAuthentication이 KeyVaultClientSecret인 경우 이 값은 애플리케이션 클라이언트 암호여야 합니다.	설정 안 됨.
언어	문자열	서버에서 반환된 메시지의 언어를 지정합니다. 사용 가능한 언어가 sys.syslanguages 테이블에 나열됩니다. 이 옵션은 현재 영어로만 제공되므로 드라이버 자체에서 사용하는 언어에는 영향을 주지 않으며, 클라이언트 시스템에 설치된 지역화 버전에 따라 언어가 결정되는 기본 ODBC 드라이버의 언어에는 영향을 주지 않습니다. 따라서 이 설정을 변경하면 메시지가 PHP 드라이버, ODBC 드라이버 또는 SQL Server에서 나왔는지에 따라 다른 언어로 반환될 수 있습니다.	기본값은 SQL Server에 설정된 언어입니다.
LoginTimeout	정수(SQLSRV 드라이버) 문자열(PDO_SQLSRV 드라이버)	연결 시도가 실패할 때까지 기다리는 시간(초)을 지정합니다.	시간 제한이 없습니다.
MultipleActiveResultSets	MARS(Multiple Active Result Set)를 사용하도록 설정하려면 1 또는 true. MARS(Multiple Active Result Set)를 사용하지 않도록 설정하려면 0 또는 false.	MARS(Multiple Active Result Set)에 대한 지원을 사용하지 않도록 설정하거나 명시적으로 사용하도록 설정합니다. 자세한 내용은 방법: MARS(Multiple Active Result Sets) 비활성화를 참조하세요.	true(1)
MultiSubnetFailover	문자열	SQL Server 2012(11.x) 가용성 그룹 또는 SQL Server 2012(11.x) 장애 조치(failover) 클러스터 인스턴스의 가용성 그룹 수신기에 연결할 때는 항상 multiSubnetFailover=yes를 지정합니다. multiSubnetFailover=yes는 현재 활성 상태인 서버를 더 빠르게 검색하고 연결할 수 있도록 Microsoft Drivers for PHP for SQL Server를 구성합니다. 가능한 값은 Yes 및 No입니다. Always On 가용성 그룹에 대한 Microsoft Drivers for PHP for SQL Server 지원에 대한 자세한 내용은 고가용성, 재해 복구 지원을 참조하세요.	아니요
PWD (PDO_SQLSRV 드라이버에서 지원되지 않음)	문자열	SQL Server 인증4에 연결될 때 사용할 사용자 ID와 연결된 암호를 지정합니다.	설정 안 됨.
QuotedId	SQL-92 규칙을 사용하려면 1 또는 true. 레거시 규칙을 사용하려면 0 또는 false.	따옴표 붙은 식별자에 SQL-92 규칙을 사용할지(1 또는 true) 또는 레거시 Transact-SQL 규칙을 사용할지(0 또는 false) 지정합니다.	true(1)
ReturnDatesAsStrings (PDO_SQLSRV 드라이버에서 지원되지 않음)	날짜 및 시간 형식을 문자열로 반환하려면 1 또는 true. PHP DateTime 형식으로 날짜 및 시간 형식을 반환하려면 0 또는 false.	날짜 및 시간 형식(datetime, smalldatetime, date, time, datetime2 및 datetimeoffset)을 문자열 또는 PHP 형식으로 검색합니다. 자세한 내용은 방법: SQLSRV 드라이버를 사용하여 날짜 및 시간 형식을 문자열로 검색을 참조하세요. PDO_SQLSRV 드라이버를 사용하는 경우 별도로 지정하지 않는 한 날짜는 문자열로 반환됩니다. 자세한 내용은 방법: PDO_SQLSRV 드라이버를 사용하여 날짜 및 시간 형식을 PHP 날짜/시간 개체로 검색을 참조하세요.	false
스크롤 가능	문자열	"버퍼링됨"은 전체 결과 집합을 메모리에 캐시할 수 있는 클라이언트 쪽(버퍼링됨) 커서를 사용할 것임을 나타냅니다. 자세한 내용은 커서 유형(SQLSRV 드라이버)을 참조하세요.	정방향 전용 커서
서버 (SQLSRV 드라이버에서 지원되지 않음)	문자열	연결할 SQL Server 인스턴스입니다. 또한 Always On 가용성 그룹에 연결하기 위해 가상 네트워크 이름을 지정할 수 있습니다. Always On 가용성 그룹에 대한 Microsoft Drivers for PHP for SQL Server 지원에 대한 자세한 내용은 고가용성, 재해 복구 지원을 참조하세요.	서버는 필수 키워드입니다(연결 문자열의 첫 번째 키워드일 필요는 없음). 서버 이름이 키워드에 전달되지 않으면 로컬 인스턴스에 연결을 시도합니다. 서버에 전달되는 값은 SQL Server 인스턴스의 이름 또는 인스턴스의 IP 주소일 수 있습니다. 선택 사항으로 포트 번호(예: sqlsrv:server=(local),1033)를 지정할 수 있습니다. Microsoft Drivers for PHP for SQL Server의 버전 3.0부터는 server=(localdb)\instancename을 사용하여 LocalDB 인스턴스를 지정할 수도 있습니다. 자세한 내용은 LocalDB 지원을 참조하세요.
TraceFile	문자열	추적 데이터에 사용되는 파일에 대한 경로를 지정합니다.	설정 안 됨.
TraceOn	추적을 사용하도록 설정하려면 1 또는 true. 추적을 사용하지 않도록 설정하려면 0 또는 false 입니다.	설정되는 연결에 대해 ODBC 추적이 사용하도록 설정되는지(1 또는 true) 사용하지 않도록 설정되는지(0 또는 false) 지정합니다.	false(0)
TransactionIsolation	SQLSRV 드라이버는 다음 값을 사용합니다. SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE PDO_SQLSRV 드라이버는 다음 값을 사용합니다. PDO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	트랜잭션 격리 수준을 지정합니다. 트랜잭션 격리 수준에 대한 자세한 내용은 SQL Server 설명서에서 트랜잭션 격리 수준 설정을 참조하세요.	SQLSRV_TXN_READ_COMMITTED 또는 PDO::SQLSRV_TXN_READ_COMMITTED
TransparentNetworkIPResolution	사용 또는 사용 안 함	호스트 이름의 첫 번째 확인된 IP가 응답하지 않고 호스트 이름과 연결된 여러 IP가 있는 경우 연결 시퀀스에 영향을 미칩니다. 이는 MultiSubnetFailover와 상호 작용하여 다른 연결 시퀀스를 제공합니다. 자세한 내용은 투명 네트워크 IP 확인 또는 투명 네트워크 IP 확인 사용을 참조하세요.	활성화
TrustServerCertificate	인증서를 신뢰하려면 1 또는 true. 인증서를 신뢰하지 않으려면 0 또는 false.	클라이언트가 자체 서명된 서버 인증서를 신뢰(1 또는 true) 또는 거부(0 또는 false)해야 하는지 여부를 지정합니다.	false(0)
UID (PDO_SQLSRV 드라이버에서 지원되지 않음)	문자열	SQL Server 인증으로 연결할 때 사용할 사용자 ID를 지정합니다4.	설정 안 됨.
WSID	문자열	추적용 컴퓨터의 이름을 지정합니다.	설정 안 됨.

1. Linux 및 macOS에서는 ConnectionPooling 속성을 사용하여 연결 풀링을 사용/사용 안 함으로 설정할 수 없습니다. 연결 풀링(Microsoft Drivers for PHP for SQL Server)을 참조하세요.

2. 설정된 연결에서 실행되는 모든 쿼리는 Database 특성에서 지정하는 데이터베이스에 대해 만들어집니다. 그러나 사용자에게 적절한 권한이 있는 경우 정규화된 이름을 사용하여 다른 데이터베이스의 데이터에 액세스할 수 있습니다. 예를 들어, 마스터 데이터베이스가 Database 연결 특성으로 설정된 경우에도 정규화된 이름을 사용하여 AdventureWorks.HumanResources.Employee 테이블에 액세스하는 Transact-SQL 쿼리를 실행할 수 있습니다.

3. Encryption을 사용하도록 설정하면 데이터를 암호화하는 데 필요한 계산 오버헤드로 인해 일부 애플리케이션의 성능에 영향을 줄 수 있습니다.

4. UID 및 PWD 특성은 SQL Server 인증과 연결될 때 둘 다 설정되어야 합니다.

지원되는 대부분의 키는 ODBC 연결 문자열 특성입니다. ODBC 연결 문자열에 대한 내용은 SQL Native Client에서 연결 문자열 키워드 사용을 참조하세요.

참고 항목

서버에 연결