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

The application workload type when connecting to a database.

Application Name

The name of the application, or 'Devart Excel Add-in for SQL Server' if no application name is provided.

Asynchronous Processing

When true, enables asynchronous operation support. Recognized values are true, false, yes, and no.

AttachDBFilename

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

SQL authentication method to use for connecting to SQL Azure.

Column Encryption Setting

Enables or disables Always Encrypted functionality for the connection.

Connect Timeout

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

ConnectRetryCount

The number of reconnect attempts after an idle connection failure.

ConnectRetryInterval

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

Context Connection

true if an in-process connection to SQL Server should be made.

Current Language

The SQL Server Language record name.

Data Source

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

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

When true, 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

true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.

Failover Partner

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

Initial Catalog

The name of the database.

Integrated Security

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

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

Max Pool Size

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

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

MultipleActiveResultSets

When true, an application can maintain multiple active result sets (MARS). 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

When true, an application a connection must attempt connections in parallel for multi-subnet failover or aggressively retry the TCP connection for a subnet failover. 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

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

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

Password

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

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

When true, the connection is drawn from the appropriate pool, or if it is required, is created and added to the appropriate pool. Recognized values are true, false, yes, and no. The default value is true.

Replication

true if replication is supported using the connection.

Transaction Binding

Do not use this parameter.

TransparentNetworkIPResolution

When set to true, the Excel add-in retrieves all IP addresses for a the specified DNS entry and attempts to connect with the first one in the list. 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

When set to true, SSL is used to encrypt the channel but to bypass walking the certificate chain to validate trust. 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

A string value that indicates 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

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

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.

Workstation ID

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