SqlConnection.ConnectionString 속성

정의

SQL Server 데이터베이스를 여는 데 사용되는 문자열을 가져오거나 설정합니다.Gets or sets the string used to open a SQL Server database.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionString { get; set; }
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String
Public Property ConnectionString As String

속성 값

초기 연결을 설정하는 데 필요한 소스 데이터베이스 이름 및 다른 매개 변수를 포함하는 연결 문자열입니다.The connection string that includes the source database name, and other parameters needed to establish the initial connection. 기본값은 빈 문자열입니다.The default value is an empty string.

구현

특성

예외

잘못된 연결 문자열 인수를 제공했거나 필요한 연결 문자열 인수를 제공하지 않았습니다.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

예제

다음 예에서는 SqlConnection을 만들고 연결을 열기 전에 ConnectionString 속성을 설정 합니다.The following example creates a SqlConnection and sets the ConnectionString property before opening the connection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

설명

ConnectionString는 OLE DB 연결 문자열과 유사 하지만 동일 하지는 않습니다.The ConnectionString is similar to an OLE DB connection string, but is not identical. OLE DB 또는 ADO와 달리, 반환 되는 연결 문자열은 사용자 집합 ConnectionString와 동일 하며 보안 정보 유지 값이 false (기본값)로 설정 된 경우 보안 정보를 제외 합니다.Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString, minus security information if the Persist Security Info value is set to false (default). 보안 정보 유지를 true로 설정 하지 않으면 SQL Server에 대 한 .NET Framework Data Provider는 연결 문자열에 암호를 유지 하거나 반환 하지 않습니다.The .NET Framework Data Provider for SQL Server does not persist or return the password in a connection string unless you set Persist Security Info to true.

ConnectionString 속성을 사용 하 여 데이터베이스에 연결할 수 있습니다.You can use the ConnectionString property to connect to a database. 다음 예제에서는 일반적인 연결 문자열을 보여 줍니다.The following example illustrates a typical connection string.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

SqlConnectionStringBuilder를 사용 하 여 런타임에 유효한 연결 문자열을 생성 합니다.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. 자세한 내용은 연결 문자열 작성기를 참조하세요.For more information, see Connection String Builders.

연결이 닫힌 경우에만 ConnectionString 속성을 설정할 수 있습니다.The ConnectionString property can be set only when the connection is closed. 대부분의 연결 문자열 값에 해당 읽기 전용 속성이 있습니다.Many of the connection string values have corresponding read-only properties. 연결 문자열을 설정 하면 오류가 발견 된 경우를 제외 하 고 이러한 속성 업데이트 됩니다.When the connection string is set, these properties are updated, except when an error is detected. 이 경우 어떤 속성도 업데이트 됩니다.In this case, none of the properties are updated. SqlConnection 속성은 ConnectionString에 포함 된 설정만 반환 합니다.SqlConnection properties return only those settings that are contained in the ConnectionString.

로컬 컴퓨터에 연결 하려면 서버에 대 한 "(local)"을 지정 합니다.To connect to a local computer, specify "(local)" for the server. 서버 이름을 지정 하지 않으면 경우 로컬 컴퓨터의 기본 인스턴스에 연결을 시도 합니다.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

닫힌 연결에서 ConnectionString를 다시 설정 하면 암호를 포함 하 여 모든 연결 문자열 값과 관련 속성이 다시 설정 됩니다.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. 예를 들어 "Database = AdventureWorks"를 포함 하는 연결 문자열을 설정 하 고 연결 문자열을 "Data Source = myserver; Integrated Security = true"로 다시 설정 하는 경우 Database 속성은 더 이상 "AdventureWorks"로 설정 되지 않습니다.For example, if you set a connection string that includes "Database= AdventureWorks", and then reset the connection string to "Data Source=myserver;Integrated Security=true", the Database property is no longer set to "AdventureWorks".

연결 문자열 설정 된 후에 즉시 구문 분석 됩니다.The connection string is parsed immediately after being set. 구문 분석 시 구문에 오류가 발견 되 면 ArgumentException와 같은 런타임 예외가 생성 됩니다.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. 연결 설정 하려고 시도 하는 경우에 다른 오류를 찾을 수 있습니다.Other errors can be found only when an attempt is made to open the connection.

연결 문자열의 기본 형식은 일련의 세미콜론으로 구분 된 키워드/값 쌍을 포함 합니다.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. 각 키워드와 해당 값은 등호(=)로 연결됩니다.The equal sign (=) connects each keyword and its value. 세미콜론, 작은따옴표, 또는 큰따옴표 문자를 포함 하는 값에 포함 하려면 값을 큰따옴표로 묶어야 합니다.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. 값을 세미콜론 및 큰따옴표 문자를 포함 하는 경우 값을 따옴표로 묶을 수 있습니다.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. 작은따옴표 값 큰따옴표 문자로 시작 하는 경우에 유용 이기도 합니다.The single quotation mark is also useful if the value starts with a double-quote character. 반대로, 값은 작은따옴표를 사용 하 여 시작 하는 경우 큰따옴표를 사용할 수 있습니다.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. 작은따옴표 및 큰따옴표 문자를 포함 하는 값, 값 내에서 발생 될 때마다 값을 묶을 때 사용 하는 인용 부호 문자를 배가 되어야 합니다.If the value contains both single-quote and double-quote characters, the quotation mark character used to enclose the value must be doubled every time it occurs within the value.

문자열 값에 선행 또는 후행 공백을 포함 하려면 값을 작은따옴표 또는 큰따옴표로 묶어야 합니다.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. 따옴표로 묶은 경우에 정수, 부울, 또는 열거형된 값 주위의 모든 선행 또는 후행 공백이 무시 됩니다.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. 그러나 문자열 리터럴 키워드 또는 값을 내부에 공백 유지 됩니다.However, spaces within a string literal keyword or value are preserved. 구분 기호를 사용 하지 않고 연결 문자열에서 작은따옴표 또는 큰따옴표를 사용할 수 있습니다 (예를 들어, 데이터 원본 = my'Server 또는 데이터 원본 내 "Server =)는 인용 부호 문자 값의 첫 번째 또는 마지막 문자가 아닌 경우.Single or double quotation marks may be used within a connection string without using delimiters (for example, Data Source= my'Server or Data Source= my"Server), unless a quotation mark character is the first or last character in the value.

키워드는 대/소문자 구분 하지 않습니다.Keywords are not case sensitive.

다음 표에서는 ConnectionString내의 키워드 값에 대 한 유효한 이름을 나열 합니다.The following table lists the valid names for keyword values within the ConnectionString.

키워드Keyword 기본값Default DescriptionDescription
AddrAddr 해당 없음N/A 동의어 데이터 원본입니다.Synonym of Data Source.
주소Address 해당 없음N/A 동의어 데이터 원본입니다.Synonym of Data Source.
App 해당 없음N/A 동의어 애플리케이션 이름입니다.Synonym of Application Name.
애플리케이션 이름Application Name 해당 없음N/A '.NET SQLClient Data Provider' 없는 애플리케이션 이름을 제공 하는 경우 애플리케이션의 이름입니다.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

애플리케이션 이름은 128 자를 사용할 수 있습니다 또는 작습니다.An application name can be 128 characters or less.
ApplicationIntent ReadWrite 서버에 연결할 때 애플리케이션 작업 유형을 선언합니다.Declares the application workload type when connecting to a server. 가능한 값은 ReadOnlyReadWrite입니다.Possible values are ReadOnly and ReadWrite. 다음은 그 예입니다.For example:

ApplicationIntent=ReadOnly

Always On 가용성 그룹의 SqlClient 지원에 대한 자세한 내용은 고가용성 및 재해 복구에 대한 SqlClient 지원을 참조하십시오.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Asynchronous ProcessingAsynchronous Processing

또는-or-

AsyncAsync
'false''false' true하면에서 비동기 작업을 지원할 수 있습니다.When true, enables asynchronous operation support. 인식되는 값은 true, false, yesno입니다.Recognized values are true, false, yes, and no.

이 속성은 .NET Framework 4.5.NET Framework 4.5부터 무시됩니다.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. 비동기 프로그래밍에 대 한 SqlClient 지원에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

또는-or-

Extended PropertiesExtended Properties

또는-or-

초기 파일 이름Initial File Name
해당 없음N/A 연결할 수 있는 데이터베이스의 전체 경로 이름을 포함 하는 주 데이터베이스 파일의 이름입니다.The name of the primary database file, including the full path name of an attachable database. AttachDBFilename는 확장명이.mdf 인 주 데이터 파일 에서만 지원 됩니다.AttachDBFilename is only supported for primary data files with an .mdf extension.

AttachDBFileName 키의 값을 연결 문자열에 지정 하는 경우 데이터베이스 연결 및 연결에 대 한 기본 데이터베이스가 됩니다.If the value of the AttachDBFileName key is specified in the connection string, the database is attached and becomes the default database for the connection.

이 키를 지정 하지 고 이전에 연결 된 데이터베이스는 데이터베이스 다시 연결할 수 됩니다.If this key is not specified and if the database was previously attached, the database will not be reattached. 이전에 연결된 된 데이터베이스 연결에 대 한 기본 데이터베이스로 사용 됩니다.The previously attached database will be used as the default database for the connection.

AttachDBFileName 키와 함께이 키를 지정 하는 경우이 키의 값을 별칭으로 사용 됩니다.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. 그러나 다른 연결 된 데이터베이스의 이름을 이미 사용 하는 경우 연결이 실패 합니다.However, if the name is already used in another attached database, the connection will fail.

DataDirectory 대체 문자열을 사용 하 여 절대 또는 상대 경로 수. 있습니다The path may be absolute or relative by using the DataDirectory substitution string. DataDirectory를 사용 하는 경우는 대체 문자열이 가리키는 디렉터리의 하위 디렉터리 내의 데이터베이스 파일 존재 해야 합니다.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. 참고: 원격 서버, HTTP 및 UNC 경로 이름은 지원 되지 않습니다.Note: Remote server, HTTP, and UNC path names are not supported.

데이터베이스 이름은 'database' 키워드 (또는 해당 별칭 중 하나)를 사용 하 여 다음과 같이 지정 해야 합니다.The database name must be specified with the keyword 'database' (or one of its aliases) as in the following:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

로그 파일이 데이터 파일과 같은 디렉터리에 있고 주 데이터 파일을 연결할 때 'database' 키워드가 사용되면 오류가 생성됩니다.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. 이 경우에는 로그 파일을 제거해야 합니다.In this case, remove the log file. 데이터베이스가 연결되면 새 로그 파일이 실제 경로에 따라 자동으로 생성됩니다.Once the database is attached, a new log file will be automatically generated based on the physical path.
인증Authentication 해당 없음N/A 에 사용 되는 인증 방법을 SQL Database에서 사용 하 여 Azure Active Directory 인증을 연결할합니다.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

유효한 값은 다음과 같습니다.Valid values are:

Active Directory 통합, Active Directory 암호를 Sql 암호입니다.Active Directory Integrated, Active Directory Password, Sql Password.
열 암호화 설정Column Encryption Setting 해당 없음N/A 연결에 대 한 Always Encrypted 기능을 사용 하거나 사용 하지 않도록 설정 합니다.Enables or disables Always Encrypted functionality for the connection.
연결 제한 시간Connect Timeout

또는-or-

연결 제한 시간Connection Timeout

또는-or-

시간 제한Timeout
1515 시간 (초)의 길이를 종료 하 고 오류를 생성 하기 전에 서버에 연결 될 때까지 기다립니다.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Connection LifeTime유효한 값은 0 보다 크거나 2147483647 작거나 같습니다.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Azure SQL Database에 대 한 연결을 열 때 연결 제한 시간을 30 초로 설정 합니다.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
에서 지정한 값을 초과하면 연결이 제거됩니다Connection LifetimeConnection Lifetime

또는-or-

Load Balance TimeoutLoad Balance Timeout
00 연결이 풀로 반환되면 연결을 만든 시간을 현재 시간과 비교하여 이 시간 간격(초)이 Connection Lifetime에서 지정한 값을 초과하는 경우 연결이 제거됩니다.When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. 이는 클러스터링된 구성에서 실행 중인 서버와 방금 온라인 상태가 된 서버 사이에 로드 균형 조정을 강제로 조정하는 데 유용합니다.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

값 영(0)은 최대 연결 제한 시간이 풀링된 연결입니다.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 컨트롤 클라이언트 유휴 연결 실패가 식별 한 후 다시 연결 수가 시도 합니다.Controls the number of reconnection attempts after the client identifies an idle connection failure. 유효한 값은 0에서 255입니다.Valid values are 0 to 255. 기본값은 1입니다.The default is 1. 0 이면 (사용 안 함 연결 복원 력)를 다시 연결 하지 마십시오.0 means do not attempt to reconnect (disable connection resiliency).

유휴 연결 복원력에 대한 자세한 내용은 Technical Article - Idle Connection Resiliency(기술 문서 - 유휴 연결 복원력)를 참조하세요.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 각 연결 다시 시도 (ConnectRetryCount) 사이의 시간을 지정 합니다.Specifies the time between each connection retry attempt (ConnectRetryCount). 유효한 값은 1 ~ 60 초 (기본값 = 10), 첫 번째 다시 시도 후 적용 합니다.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. 연결이 끊어진된 감지 되 면 클라이언트는 즉시; 다시 연결 하려고 시도 첫 번째 다시 연결을 시도 이며 ConnectRetryCount가 0 보다 큰 경우에 발생 합니다.When a broken connection is detected, the client immediately attempts to reconnect; this is the first reconnection attempt and only occurs if ConnectRetryCount is greater than 0. 첫 번째 다시 연결 시도가 실패할 경우 ConnectRetryCount 1 보다 크면 클라이언트는 두 번째 및 후속 재연결 시도 하려는 ConnectRetryInterval 대기 합니다.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

유휴 연결 복원력에 대한 자세한 내용은 Technical Article - Idle Connection Resiliency(기술 문서 - 유휴 연결 복원력)를 참조하세요.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
컨텍스트 연결Context Connection 'false''false' SQL Server에 대 한 in-process 연결을 설정 해야 하는지 여부를 true 합니다.true if an in-process connection to SQL Server should be made.
현재 언어Current Language

또는-or-

언어Language
해당 없음N/A 데이터베이스 서버 경고 또는 오류 메시지에 사용 된 언어를 설정 합니다.Sets the language used for database server warning or error messages.

언어 이름은 128 자를 사용할 수 미만입니다.The language name can be 128 characters or less.
데이터 원본Data Source

또는-or-

서버Server

또는-or-

주소Address

또는-or-

AddrAddr

또는-or-

네트워크 주소Network Address
해당 없음N/A 연결할 SQL Server 인스턴스의 이름 또는 네트워크 주소입니다.The name or network address of the instance of SQL Server to which to connect. 서버 이름 뒤의 포트 번호를 지정할 수 있습니다.The port number can be specified after the server name:

server=tcp:servername, portnumber

로컬 인스턴스를 지정할 때 항상 (local) 사용 합니다.When specifying a local instance, always use (local). 프로토콜을 강제 적용 하려면 다음 접두사 중 하나를 추가 합니다.To force a protocol, add one of the following prefixes:

np:(local), tcp:(local), lpc:(local)

.NET Framework 4.5.NET Framework 4.5부터 다음과 같이 LocalDB 데이터베이스에 연결할 수도 있습니다.Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

LocalDB에 대 한 자세한 내용은 localdb에 대 한 SqlClient 지원을 참조 하세요.For more information about LocalDB, see SqlClient Support for LocalDB.

데이터 원본은 TCP 형식이 나 명명 된 파이프 형식을 사용 해야 합니다.Data Source must use the TCP format or the Named Pipes format.

TCP 형식은 아래와 같습니다.TCP format is as follows:

-tcp:\< 인스턴스 이름 > 호스트 이름<>- tcp:<host name>\<instance name>
-tcp:<호스트 이름 >,<TCP/IP 포트 번호 >- tcp:<host name>,<TCP/IP port number>

TCP 형식 접두사로 시작 해야 합니다 "tcp:" 데이터베이스 인스턴스의 호스트 이름 및 인스턴스 이름에 지정 된 대로 그 합니다.The TCP format must start with the prefix "tcp:" and is followed by the database instance, as specified by a host name and an instance name. Azure SQL Database에 연결할 때이 형식이 적용 되었습니다.This format is not applicable when connecting to Azure SQL Database. TCP은 프로토콜 없음이 지정 된 경우 Azure SQL Database에 대 한 연결에 대 한 자동으로 선택 됩니다.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

다음 방법 중 하나에 호스트 이름을 지정 해야 합니다.The host name MUST be specified in one of the following ways:

-Netbios 이름- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

데이터베이스 인스턴스에 호스팅되어 있는 특정 TCP/IP 포트 번호를 확인 하도록 인스턴스 이름이 사용 됩니다.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. 또는 TCP/IP 포트 번호를 직접 지정도 허용 됩니다.Alternatively, specifying a TCP/IP port number directly is also allowed. 인스턴스 이름을 모두 포트 번호 없는 경우 기본 데이터베이스 인스턴스가 사용 됩니다.If both instance name and port number are not present, the default database instance is used.

명명 된 파이프 형식은 다음과 같습니다.The Named Pipes format is as follows:

-np:\\< 호스트 이름>\pipe\파이프 이름 <>- np:\\<host name>\pipe\<pipe name>

명명 된 파이프 형식 접두사로 시작 해야 합니다 "np:" 뒤에 명명 된 파이프 이름이 고 합니다.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

다음 방법 중 하나에 호스트 이름을 지정 해야 합니다.The host name MUST be specified in one of the following ways:

-Netbios 이름- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

.NET Framework 애플리케이션을 연결 된 데이터베이스 인스턴스를 식별 하는 파이프 이름을 사용 됩니다.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

네트워크 키 값이 지정 된 경우 "tcp:" 및 "np:" 접두사를 지정 하면 안 됩니다.If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. 참고: Tcp: 를 연결 문자열의 서버 이름에 접두사로 사용 하거나 localhost를 사용 하 여 공유 메모리 대신 tcp를 강제로 사용 하도록 설정할 수 있습니다.Note: You can force the use of TCP instead of shared memory, either by prefixing tcp: to the server name in the connection string, or by using localhost.
EncryptEncrypt 'false''false' true때는 서버에 인증서가 설치 되어 있는 경우 SQL Server 클라이언트와 서버 간에 전송 되는 모든 데이터에 대해 SSL 암호화를 사용 합니다.When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. 인식되는 값은 true, false, yesno입니다.Recognized values are true, false, yes, and no. 자세한 내용은 연결 문자열 구문을 참조 하세요.For more information, see Connection String Syntax.

.NET Framework 4.5.NET Framework 4.5부터 TrustServerCertificate가 false이 고 Encrypt true 이면 SQL Server SSL 인증서의 서버 이름 (또는 IP 주소)이 연결 문자열에 지정 된 서버 이름 (또는 IP 주소)과 정확 하 게 일치 해야 합니다.Beginning in .NET Framework 4.5.NET Framework 4.5, when TrustServerCertificate is false and Encrypt is true, the server name (or IP address) in a SQL Server SSL certificate must exactly match the server name (or IP address) specified in the connection string. 그렇지 않으면 연결을 시도할 경우 실패합니다.Otherwise, the connection attempt will fail. 주체가 와일드 카드 문자 (*)로 시작 하는 인증서 지원에 대 한 자세한 내용은 서버 인증서에서 서버 인증에 사용 하는 허용 되는 와일드 카드를 참조 하십시오.For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
EnlistEnlist 'true''true' true SQL Server 연결 풀러는 생성 스레드의 현재 트랜잭션 컨텍스트에 연결을 자동으로 참여 함을 나타냅니다.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
장애 조치(failover) 파트너Failover Partner 해당 없음N/A 데이터베이스 미러링이 구성 되어 장애 조치 파트너 서버의 이름입니다.The name of the failover partner server where database mirroring is configured.

이 키의 값이 "" 이면 초기 카탈로그가 있어야 하 고 해당 값은 ""이 아니어야 합니다.If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

서버 이름은 128 자를 사용할 수 있습니다 또는 작습니다.The server name can be 128 characters or less.

지정 하는 경우 데이터베이스 미러링에 대 한 장애 조치 파트너 하지만 장애 조치 파트너 서버 구성 되지 않았습니다 고 주 서버 (Server 키워드를 사용 하 여 지정 됨)를 사용할 수 없는 다음 연결이 실패 합니다.If you specify a failover partner but the failover partner server is not configured for database mirroring and the primary server (specified with the Server keyword) is not available, then the connection will fail.

데이터베이스 미러링에 대 한 장애 조치 파트너가 되 고 주 서버를 구성 되지 않았습니다 지정 하는 경우 주 서버를 사용할 수 있는 경우 주 서버 (Server 키워드를 사용 하 여 지정 됨)에 연결 성공 합니다.If you specify a failover partner and the primary server is not configured for database mirroring, the connection to the primary server (specified with the Server keyword) will succeed if the primary server is available.
초기 카탈로그Initial Catalog

또는-or-

데이터베이스Database
해당 없음N/A 데이터베이스의 이름입니다.The name of the database.

데이터베이스 이름은 128 자를 사용할 수 있습니다 또는 작습니다.The database name can be 128 characters or less.
Integrated SecurityIntegrated Security

또는-or-

Trusted_ConnectionTrusted_Connection
'false''false' false하면 연결에 사용자 ID와 암호가 지정 됩니다.When false, User ID and Password are specified in the connection. true하면 현재 Windows 계정 자격 증명이 인증에 사용 됩니다.When true, the current Windows account credentials are used for authentication.

인식 되는 값은 true, false, yes, nosspi (강력히 권장 됨) 이며,이는 true에 해당 합니다.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

사용자 ID 및 암호 지정 되 고 통합 하는 경우 보안이 true를 사용자 ID로 설정 하 고 암호 무시 되 고 통합 보안이 사용 됩니다.If User ID and Password are specified and Integrated Security is set to true, the User ID and Password will be ignored and Integrated Security will be used.

SqlCredentialIntegrated Security=false(SQL Server 인증)를 사용 하는 연결에 대 한 자격 증명을 지정 하는 보다 안전한 방법입니다.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication (Integrated Security=false).
최대 풀 크기Max Pool Size 100100 풀에 허용 되는 연결의 최대 수입니다.The maximum number of connections that are allowed in the pool.

유효한 값 이며 1 보다 크거나 같은 경우Valid values are greater than or equal to 1. 최소 풀 크기 보다 작은 값은 오류를 생성 합니다.Values that are less than Min Pool Size generate an error.
최소 풀 크기Min Pool Size 00 연결 풀에 허용 되는 최소 수입니다.The minimum number of connections that are allowed in the pool.

유효한 값을 0 보다 크거나 됩니다.Valid values are greater than or equal to 0. 이 필드에 영 (0) 최소 연결이 없는 처음에 열린 것을 의미 합니다.Zero (0) in this field means no minimum connections are initially opened.

최대 풀 크기 보다 큰 값은 오류를 생성 합니다.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets 'false''false' true, 애플리케이션에서 여러 활성 결과 집합 (MARS)를 유지할 수 있습니다.When true, an application can maintain multiple active result sets (MARS). false, 애플리케이션을 처리 하거나 해당 연결에서 다른 일괄 작업을 실행할 수 있습니다 하나의 일괄 처리에서 모든 결과 집합을 취소 해야 합니다.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

인식 되는 값은 truefalse입니다.Recognized values are true and false.

자세한 내용은 MARS(여러 활성 결과 집합)를 참조하세요.For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover FALSEFALSE SQL Server 2012 이상 가용성 그룹 또는 SQL Server 2012 이상 장애 조치 (Failover) 클러스터 인스턴스의 가용성 그룹 수신기에 연결할 때는 항상 multiSubnetFailover=True를 지정 합니다.Always specify multiSubnetFailover=True when connecting to the availability group listener of a SQL Server 2012 (or later) availability group or a SQL Server 2012 (or later) Failover Cluster Instance. multiSubnetFailover=True는 현재 활성 서버를 빠르게 검색 하 고 연결할 수 있도록 SqlClient를 구성 합니다.multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. 가능한 값은 YesNo, True, False 또는 10입니다.Possible values are Yes and No, True and False or 1 and 0. 다음은 그 예입니다.For example:

MultiSubnetFailover=True

기본값은 False입니다.The default is False. SqlClient의 Always On Ag 지원에 대 한 자세한 내용은 고가용성, 재해 복구에 대 한 Sqlclient 지원을 참조 하세요.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Network LibraryNetwork Library

또는-or-

네트워크Network

또는-or-

NetNet
해당 없음N/A SQL Server 인스턴스에 연결 하는 데 사용 되는 네트워크 라이브러리입니다.The network library used to establish a connection to an instance of SQL Server. 지원되는 값은 다음과 같습니다.Supported values include:

dbnmpntw (명명 된 파이프)dbnmpntw (Named Pipes)

dbmsrpcn (멀티 프로토콜, Windows RPC)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple 설명)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (공유 메모리)dbmslpcn (Shared Memory)

dbmsspxn (IPX/SPX)dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)dbmssocn (TCP/IP)

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

해당하는 네트워크 DLL이 연결하는 시스템에 설치되어 있어야 합니다.The corresponding network DLL must be installed on the system to which you connect. 네트워크를 지정 하지 않으면 및 로컬 서버를 사용 하는 경우 (예를 들어, "." 또는 "(local)"), 공유 메모리가 사용 됩니다.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. 이 예제에서 네트워크 라이브러리는 Win32 Winsock TCP/IP(dbmssocn)이며 사용 중인 포트는 1433입니다.In this example, the network library is Win32 Winsock TCP/IP (dbmssocn), and 1433 is the port being used.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
패킷 크기Packet Size 80008000 SQL Server의 인스턴스와 통신 하는 데 네트워크 패킷의 바이트 크기입니다.Size in bytes of the network packets used to communicate with an instance of SQL Server.

패킷 크기는 512 보다 크거나 수 및 32768입니다.The packet size can be greater than or equal to 512 and less than or equal to 32768.
암호Password

또는-or-

PWDPWD
해당 없음N/A SQL Server 계정 로그온에 대 한 암호입니다.The password for the SQL Server account logging on. 이 옵션은 사용하지 않는 것이 좋습니다.Not recommended. 높은 수준의 보안을 유지 하려면 좋습니다 사용 하 여 Integrated Security 또는 Trusted_Connection 키워드 대신 사용합니다.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential는 SQL Server 인증을 사용 하는 연결에 대 한 자격 증명을 지정 하는 보다 안전한 방법입니다.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

암호는 128자 미만여야 합니다.The password must be 128 characters or less.
보안 정보 유지Persist Security Info

또는-or-

PersistSecurityInfoPersistSecurityInfo
'false''false' 로 설정 하면 false 또는 no (권장 사항) 연결이 열려 있거나 열린 상태에서 였 경우 암호와 같은 보안 관련 정보는 연결의 일부로 반환 되지 않습니다.When set to false or no (strongly recommended), security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. 연결 문자열을 다시 암호를 포함 한 모든 연결 문자열 값을 다시 설정 합니다.Resetting the connection string resets all connection string values including the password. 인식되는 값은 true, false, yesno입니다.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod AutoAuto 연결 풀 차단 기간 동작을 설정합니다.Sets the blocking period behavior for a connection pool. 자세한 내용은 PoolBlockingPeriod 속성을 참조하세요.See PoolBlockingPeriod property for details.
PoolingPooling 'true''true' 이 키의 값은 새로 만든 변수가 true로 설정 된 경우 연결 애플리케이션을 닫을 때 풀에 추가 됩니다.When the value of this key is set to true, any newly created connection will be added to the pool when closed by the application. 동일한 연결을 열려면 다음을 시도할 때에서 해당 연결 풀에서 그려집니다.In a next attempt to open the same connection, that connection will be drawn from the pool.

동일한 연결 문자열에 있는 경우 연결 동일한 간주 됩니다.Connections are considered the same if they have the same connection string. 다른 연결은 다른 연결 문자열을 가집니다.Different connections have different connection strings.

이 키의 값 "true"은 "false", "yes" 또는 "no"입니다.The value of this key can be "true", "false", "yes", or "no".
복제Replication 'false''false' true 복제가 연결을 사용하여 지원되는 경우true if replication is supported using the connection.
Transaction BindingTransaction Binding Implicit UnbindImplicit Unbind 등록 된 System.Transactions 트랜잭션과의 연결 연결을 제어 합니다.Controls connection association with an enlisted System.Transactions transaction.

가능한 값은 다음과 같습니다.Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

암시적 바인딩 해제 하면 종료 될 때 트랜잭션 으로부터 분리에 대 한 연결 합니다.Implicit Unbind causes the connection to detach from the transaction when it ends. 연결을 끊은 후 연결에 대한 추가 요청은 자동 커밋 모드로 수행됩니다.After detaching, additional requests on the connection are performed in autocommit mode. System.Transactions.Transaction.Current 속성은 트랜잭션이 활성화 상태인 동안 요청을 실행할 때 확인되지 않습니다.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. 트랜잭션이 종료된 후 추가 요청은 자동 커밋 모드로 수행됩니다.After the transaction has ended, additional requests are performed in autocommit mode.

마지막 명령이 완료 되기 전에 시스템에서 사용 블록의 범위 내에 있는 트랜잭션을 종료 하면 InvalidOperationException을 throw 합니다.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

명시적 바인딩 해제를 수행 하면 연결이 닫히거나 명시적 SqlConnection.TransactionEnlist(null) 호출 될 때까지 연결이 트랜잭션에 연결 된 상태로 유지 됩니다.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. .NET Framework 4.NET Framework 4부터 암시적 바인딩 해제에 대 한 변경 내용은 사용 되지 않는 명시적 바인딩 해제를 만듭니다.Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. InvalidOperationException가 참여한 트랜잭션이 아니거나 참여한 트랜잭션이 활성화되지 않았으면 Transaction.Current이 throw됩니다.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution 설명을 참조하세요.See description. 이 키의 값이 true로 설정되면 애플리케이션은 특정 DNS 항목에 대한 모든 IP 주소를 검색하고 목록의 첫 번째 항목과 연결을 시도해야 합니다.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. 0.5초 이내에 연결되지 않으면 애플리케이션은 다른 모든 항목과 동시에 연결을 시도합니다.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. 첫 번째 항목과 연결될 경우 애플리케이션은 응답자 IP 주소로 연결을 설정합니다.When the first answers, the application will establish the connection with the respondent IP address.

MultiSubnetFailover 키가 true로 설정 된 경우 TransparentNetworkIPResolution는 무시 됩니다.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Failover Partner 키를 설정 하는 경우 TransparentNetworkIPResolution는 무시 됩니다.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

이 키의 값은 true, false, yes또는 no이어야 합니다.The value of this key must be true, false, yes, or no.

yes 값은 true값과 동일 하 게 처리 됩니다.A value of yes is treated the same as a value of true.

no 값은 false값과 동일 하 게 처리 됩니다.A value of no is treated the same as a value of false.

기본 값을 아래와 같습니다.The default values are as follows:

  • false:false when:

    • 데이터 원본으로 끝나는 Azure SQL Database에 연결 합니다.Connecting to Azure SQL Database where the data source ends with:

      • .database.chinacloudapi.cn.database.chinacloudapi.cn
      • .database.usgovcloudapi.net.database.usgovcloudapi.net
      • .database.cloudapi.de.database.cloudapi.de
      • .database.windows.net.database.windows.net
    • ' Active Directory Password ' 또는 ' Active Directory Integrated ' AuthenticationAuthentication is 'Active Directory Password' or 'Active Directory Integrated'
  • 다른 모든 경우에서는 true입니다.true in all other cases.
TrustServerCertificateTrustServerCertificate 'false''false' true로 설정 된 경우 SSL은 인증서 체인을 우회 하 여 신뢰의 유효성을 검사할 때 채널을 암호화 하는 데 사용 됩니다.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. TrustServerCertificate를 true로 설정 하 고 Encrypt를 false로 설정 하면 채널이 암호화 되지 않습니다.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. 인식되는 값은 true, false, yesno입니다.Recognized values are true, false, yes, and no. 자세한 내용은 연결 문자열 구문을 참조 하세요.For more information, see Connection String Syntax.
Type System VersionType System Version 해당 없음N/A 애플리케이션에 필요한 형식 시스템을 나타내는 문자열 값입니다.A string value that indicates the type system the application expects. 클라이언트 애플리케이션에 사용할 수 있는 기능은 SQL Server 버전과 데이터베이스 호환성 수준에 따라 달라집니다.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. 클라이언트 애플리케이션이 작성된 Type System Version을 명시적으로 설정하면 다른 버전의 SQL Server를 사용할 경우 애플리케이션이 중단되는 문제를 방지할 수 있습니다.Explicitly setting the type system version that the client application was written for avoids potential problems that could cause an application to break if a different version of SQL Server is used. 참고: SQL Server에서 in-process로 실행 되는 CLR (공용 언어 런타임) 코드에 대해 형식 시스템 버전을 설정할 수 없습니다.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. 자세한 내용은 SQL Server Common Language Runtime Integration을 참조 하세요.For more information, see SQL Server Common Language Runtime Integration.

가능한 값은 다음과 같습니다.Possible values are:

Type System Version=SQL Server 2012;

Type System Version=SQL Server 2008;

Type System Version=SQL Server 2005;

Type System Version=Latest;

Type System Version=SQL Server 2012; 애플리케이션 버전 11.0.0.0 Microsoft.SqlServer.Types.dll의 필요를 지정 합니다.Type System Version=SQL Server 2012; specifies that the application will require version 11.0.0.0 of Microsoft.SqlServer.Types.dll. 다른 Type System Version 설정에는 버전 10.0.0.0의 버전 10.0.0.0이 필요 합니다.The other Type System Version settings will require version 10.0.0.0 of Microsoft.SqlServer.Types.dll.

Latest 사용 되지 않으므로 사용 하면 안 됩니다.Latest is obsolete and should not be used. LatestType System Version=SQL Server 2008;와 동등합니다.Latest is equivalent to Type System Version=SQL Server 2008;.
사용자 IDUser ID

또는-or-

UIDUID

또는-or-
해당 없음N/A SQL Server 로그인 계정입니다.The SQL Server login account. 이 옵션은 사용하지 않는 것이 좋습니다.Not recommended. 높은 수준의 보안을 유지 하려면 좋습니다 사용 하 여 Integrated Security 또는 Trusted_Connection 키워드 대신 사용합니다.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential는 SQL Server 인증을 사용 하는 연결에 대 한 자격 증명을 지정 하는 보다 안전한 방법입니다.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

사용자 ID에 128 자 여야 합니다.이 있습니다.The user ID must be 128 characters or less.
사용자 인스턴스User Instance 'false''false' 기본 SQL Server Express 인스턴스로부터 호출자의 계정으로 실행 되는 런타임 시작 인스턴스로 연결을 리디렉션하는지 여부를 나타내는 값입니다.A value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.
워크스테이션 IDWorkstation ID

또는-or-

WSIDWSID
로컬 컴퓨터 이름The local computer name SQL Server에 연결 하는 워크스테이션의 이름입니다.The name of the workstation connecting to SQL Server.

가능 해야 하는 128 자 이하의 합니다.The ID must be 128 characters or less.

다음 목록에는 ConnectionString내의 연결 풀링 값에 대 한 유효한 이름이 포함 되어 있습니다.The following list contains the valid names for connection pooling values within the ConnectionString. 자세한 내용은 SQL Server 연결 풀링(ADO.NET)을 참조하세요.For more information, see SQL Server Connection Pooling (ADO.NET).

  • Connection Lifetime (또는 Load Balance Timeout)Connection Lifetime (or Load Balance Timeout)

  • EnlistEnlist

  • 최대 풀 크기Max Pool Size

  • 최소 풀 크기Min Pool Size

  • PoolingPooling

키워드 또는 연결 풀링 하는 부울 값을 필요로 하는 값을 설정 하는 경우 'true' 및 'no' 대신 'f a l' 대신 '예' 사용할 수 있습니다.When you are setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. 정수 값은 문자열로 표시 됩니다.Integer values are represented as strings.

참고

.NET Framework Data Provider for SQL Server는 SQL Server와 통신 하는 자체 프로토콜을 사용 합니다.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. 따라서이 지원 하지 않습니다는 ODBC 데이터 원본 이름 (DSN)의 사용은 ODBC 계층을 추가 하지 않기 때문에 SQL Server에 연결할 때.Therefore, it does not support the use of an ODBC data source name (DSN) when connecting to SQL Server because it does not add an ODBC layer.

참고

SQL Server에 대 한.NET Framework 데이터 공급자에 대 한 유니버설 데이터 링크 (UDL) 파일 지원 되지 않습니다.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

주의

이 릴리스에서 애플리케이션 (예: 연결 문자열에 추가 하는 대화 상자에서 사용자 ID와 암호 정보를 검색 하는 경우) 사용자 입력을 기반으로 연결 문자열을 생성할 때 주의 사용 해야 합니다.In this release, the application should use caution when constructing a connection string based on user input (for example when retrieving user ID and password information from a dialog box, and appending it to the connection string). 애플리케이션 해야 사용자가 이러한 값에 추가 연결 문자열 매개 변수를 포함할 수 없습니다 (예를 들어 암호를 입력 "에서는 데이터베이스 somedb =" 다른 데이터베이스에 연결 하기 위해).The application should make sure that a user cannot embed additional connection string parameters in these values (for example, entering a password as "validpassword;database=somedb" in an attempt to attach to a different database). 사용자 입력에 따라 연결 문자열을 생성 해야 하는 경우 연결 문자열의 유효성을 검사 하 고이 문제를 제거 하는 데 도움이 되는 새 SqlConnectionStringBuilder를 사용 합니다.If you need to construct connection strings based on user input, use the new SqlConnectionStringBuilder, which validates the connection string and helps to eliminate this problem. 자세한 내용은 연결 문자열 작성기 를 참조 하세요.See Connection String Builders for more information.

적용 대상

추가 정보