SQL Server

ExpandedToggleIcon        Connection Dialog

To connect to an SQL Server database, required connection options must be set:

1.Host - 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

2.Authentication - The SQL Server authentication mode. Two options are available:
oSQL Server - via the SQL Server User ID and password. The SQL Server authentication mode is set by default
oWindows - via the Windows account used to authenticate the user
3.User ID - The SQL Server login account.
4.Password - The password for the SQL Server login account.

In addition to the required options, Advanced connection options may be set for more fine connection tuning.

 

ExpandedToggleIcon        Advanced Connection Options

The following table describes the options that you can include in the Connection String using the Advanced Connection Editor dialog box:

 

Option

Description

ApplicationIntent

Specifies the application workload type when connecting to a database.

Application Name

Specifies the name of the application, or 'SSIS for SQL Server' if no application name is provided.

Asynchronous Processing

Determines whether to enable asynchronous operation support. Recognized values are true, false, yes, and no.

AttachDBFilename

Specifies the name of the primary database file, including the full path name of an attachable database. The path may be absolute or relative by using the DataDirectory substitution string. If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string.

Authentication

Specifies the SQL authentication method to use for connecting to SQL Azure.

Column Encryption Setting

Enables or disables Always Encrypted functionality for the connection.

Connect Timeout

Specifies the length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

ConnectRetryCount

Specifies the number of reconnect attempts after an idle connection failure.

ConnectRetryInterval

Specifies the amount of time, in seconds, from 1 to 60, between each reconnection attempt after identifying that there was an idle connection failure.

Context Connection

Determines whether to make an in-process connection to SQL Server.

Current Language

Specifies the SQL Server Language record name.

Data Source

Specifies 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

When specifying a local instance, always use (local). To force a protocol, add one of the following prefixes: np:(local), tcp:(local), lpc:(local)

Enclave Attestation Url

Specifies an endpoint of an enclave attestation service that will be used to verify whether the enclave, configured in SQL Server instance for computations on database columns encrypted using Always Encrypted, is valid and secure.

Encrypt

Determines whether SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Recognized values are true, false, yes, and no.

Enlist

Indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context when set to true.

Failover Partner

Specifies the name of the failover partner server where database mirroring is configured.

Initial Catalog

Specifies the name of the database.

Initialization Command

Specifies a data source-specific command that is executed immediately after the connection is established.

Integrated Security

Determines the authentication method: when false, User ID and Password are specified in the connection; when true, the current Windows account credentials are used for authentication. Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Keep Connected

Specifies the interval, in seconds, at which periodic ping requests are sent to SQL Server while the connection is idle to prevent the connection from being closed. The default value is 0, indicating that the calls are disabled.

Load Balance Timeout

Specifies the minimum time, in seconds, for the connection to live in the connection pool before being destroyed.

Max Pool Size

Specifies the maximum number of connections allowed in the pool. Setting the Max Pool Size value in the connection string can affect performance. The default value is 100.

Min Pool Size

Specifies the minimum number of connections allowed in the pool. The default value is 0.

MultipleActiveResultSets

Determines whether an application can maintain multiple active result sets (MARS). When true, MARS is enabled; when false, the application must process or cancel all result sets from one batch before it can execute any other batch on that connection. Recognized values are true and false.

MultiSubnetFailover

Determines whether the application must attempt connections in parallel for multi-subnet failover or aggressively retry the TCP connection for a subnet failover, when set to true. Recognized values are true and false. It is recommended to set this parameter to true when connecting to SQL Server 2012 availability group listener or SQL Server 2012 Failover Cluster Instance. Set this property to false when connecting to anything other than SQL Server 2012 availability group listener or SQL Server 2012 Failover Cluster Instance (default value).

Network Library

Specifies the network library used to establish a connection to an instance of SQL Server. Supported values include dbnmpntw (Named Pipes), dbmsrpcn (Multiprotocol), dbmsadsn (Apple Talk), dbmsgnet (VIA), dbmslpcn (Shared Memory) and dbmsspxn (IPX/SPX), and dbmssocn (TCP/IP). The corresponding network DLL must be installed on the system to which you connect. If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used.

Packet Size

Specifies the size, in bytes, of the network packets used to communicate with an instance of SQL Server. The default value is 8192.

Password

Specifies the password for the SQL Server account logging on. Not recommended. To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead.

Persist Security Info

Determines whether security-sensitive information, such as the password, is returned as part of the connection if the connection is open or has ever been in an open state. When set to false or no (strongly recommended), this information is not returned. Resetting the connection string resets all connection string values including the password. Recognized values are true, false, yes, and no.

PoolBlockingPeriod

Specifies the blocking period behavior for a connection pool.

Auto - enable blocking for SQL servers except SQL Azure;
AlwaysBlock - enable blocking for SQL servers and SQL Azure;
NeverBlock - disable blocking for SQL servers and SQL Azure.

Pooling

Draws the connection from the appropriate pool, or creates and adds it to the appropriate pool if required, when set to true. Recognized values are true, false, yes, and no. The default value is true.

Replication

Indicates whether replication is supported using the connection, when set to true.

Run Once Command

Specifies a database-specific command that is executed immediately after establishing the connection. Unlike Initialization Command, it is not executed for connections obtained from the connection pool.

SSH KeyExchange Algorithms

Specifies the algorithms to securely establish a shared encryption key between the client and the server.

SSH MAC Algorithms

Specifies the algorithms to verify the integrity and authenticity of data exchanged between the client and the server.

Target Session

Determines how the host to connect to is selected from the list when multiple hosts are specified in the Data Source connection string parameter.

Transaction Binding

Do not use this parameter.

TransparentNetworkIPResolution

Retrieves all IP addresses for the specified DNS entry and attempts to connect with the first one in the list when set to true. If the connection is not established after 0.5 seconds, it tries to connect to all others in parallel and establishes the connection with the first IP address that answered.

TrustServerCertificate

Determines whether SSL is used to encrypt the channel while bypassing the certificate chain validation, when set to true. If the connection string has TrustServerCertificate set to true but Encrypt is not set to true, the channel is not encrypted. Recognized values are true, false, yes, and no. For more information, see "Encryption Hierarchy" and "Using Encryption Without Validation" in SQL Server 2005 Books Online.

Type System Version

Specifies, as a string value, the type system the SSIS expects. Possible values are:

Type System Version=SQL Server 2000;
Type System Version=SQL Server 2005;
Type System Version=Latest;

Use Session Timezone

Determines whether the current session's time zone is used to convert requested SQL Server date/time values.

User ID

Specifies the SQL Server login account. Not recommended. To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead.

User Instance

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.

Workstation ID

Specifies the name of the workstation connecting to SQL Server. The default value is the local computer name.