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.User Id - The SQL Server login account.
3.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 'Devart Excel Add-in for SQL Server' if no application name is provided.

Asynchronous Processing

Enables asynchronous operation support when set to true. 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

Indicates, when set to true, that an in-process connection to SQL Server should be made.

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

Uses SSL encryption for all data sent between the client and server, when set to true and the server has a certificate installed. Recognized values are true, false, yes, and no.

Enlist

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

Failover Partner

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

Initial Catalog

Specifies the name of the database.

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.

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

Allows an application to maintain multiple active result sets (MARS), when set to true; when false, an 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

Attempts connections in parallel for multi-subnet failover, or aggressively retries 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

Prevents security-sensitive information, such as the password, from being returned as part of the connection when set to false or no (strongly recommended), 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. 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, when set to true, that replication is supported using the connection.

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 will try to connect to all others in parallel and will establish the connection with the first IP address that answered.

TrustServerCertificate

Uses SSL to encrypt the channel but bypasses walking the certificate chain to validate trust, 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

Indicates, as a string value, the type system the Excel add-in expects. Possible values are:

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

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.