- \n
- The default ‘Connect Timeout’ for SSIS packages is 15 seconds, and when left unspecified, it can lead to package failures due to network hiccups.<\/li>\n\n\n\n
- Directly setting the timeout to 0 in the connection manager initially registers falsely as null unless a non-zero value is specified first.<\/li>\n\n\n\n
- The Connection Manager workaround requires setting the \u2018Connect Timeout\u2019 to a non-zero value (e.g., 60), saving, and then re-opening and changing the value to 0 to correctly embed
Connect Timeout=0<\/code> in the connection string.<\/li>\n\n\n\n- Alternatively, the Configuration File Workaround<\/strong> involves creating an XML configuration file through the Package Configuration Organizer and manually editing the XML to set the
Connect Timeout<\/code> to 0.<\/li>\n<\/ul>\n\n\n\nDespite the utility of these methods for achieving an unlimited timeout, IT professionals are warned that setting the ‘Connect Timeout’ to 0 can cause SSIS packages to continue consuming server resources indefinitely if the target SQL Server is unavailable for an extended duration.<\/p>\n\n\n\n
Table of contents<\/h2>
- SUMMARY:<\/a><\/li>
- The Connection Manager Workaround<\/a>
- Step 1: Set the ‘Connect Timeout’ Setting to Any Value<\/a><\/li>
- Step 2: Change the ‘Connect Timeout’ Setting to 0<\/a><\/li><\/ul><\/li>
- The Configuration File Workaround<\/a>
- Step 1: Create a Connection Manager<\/a><\/li>
- Step 2: Open Package Configuration Organizer<\/a><\/li>
- Step 3: Ensure the Package Configuration is Enabled & Click Add<\/a><\/li>
- Step 4: Follow the Package Configuration Wizard Instructions<\/a><\/li>
- Step 5: Open and Edit the XML File<\/a><\/li><\/ul><\/li><\/ul><\/div>\n\n\n\n
A challenge arose with a client’s SSIS packages occasionally failing. They received the following error:<\/p>\n\n\n\n
Description: “Login timeout expired”.<\/strong><\/p>\n\n\n\n
An OLE DB record is available. Source: “Microsoft SQL Server Native Client 11.0” Hresult: 0x80004005 Description: “A network-related or instance-specific error has occurred while establishing a connection to SQL Server. Server is not found or not accessible. Check if instance name is correct and if SQL Server is configured to allow remote connections. For more information, see SQL Server Books Online.”<\/p>\n\n\n\n
After reviewing possible reasons for this occurrence, we determined the issue was network-related. I checked for a ‘Connect Timeout’ setting in the connection string and noticed that it was not specified. This means that it was set to the default setting, 15 seconds. We recommended they set the ‘Connect Timeout’ high enough to account for any network hiccups. To my surprise, the client responded that they initially set the ‘Connect Timeout’ in the Visual Studio’s connection manager to 0 per their documentation. Setting the ‘Connect Timeout’ to 0 gives the SSIS package an unlimited amount of time to attempt connection. This should have displayed in the connection string and prevented the error they received. This was not the case. I decided to attempt to duplicate their problem.<\/p>\n\n\n\n
All testing was done in Microsoft Visual Studio 2015 Update 3. The instances and databases used are on XTIVIA test servers.<\/p>\n\n\n\n
I started by creating a simple OLE DB connection through the connection manager. So far, no problems.<\/p>\n\n\n\n
![\"SSIS](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/ssis-package-message.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
The issue occurred when I went to the ‘All’ tab. Though ‘Connect Timeout’ was set to 15 seconds by default, there was a 0 in the space next to it.<\/p>\n\n\n\n
![\"connection](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/connection-manager-ssis.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
It registered as being null when saved, and ‘Connect Timeout’ was not specified in the connection string.<\/p>\n\n\n\n
In this example, the resulting connection string was as followed:<\/p>\n\n\n\n
Data Source=;Initial Catalog=Test;Provider=SQLNCLI11.1;Integrated Security=SSPI;Auto Translate=False;<\/code><\/pre>\n\n\n\n![\"package](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/package-utility.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
I ran the test SSIS package I created and duplicated the timeout error they received.<\/p>\n\n\n\n
The setting falsely registers as null if a number higher than 0 is not specified. Because of this, it only presents a problem if the goal is to set the ‘Connect Timeout’ setting to unlimited.<\/p>\n\n\n\n
The Connection Manager Workaround<\/h2>\n\n\n\n
Our team does not usually recommend having the connection timeout set to unlimited. This causes the SSIS package to continue to use resources until the command can complete. If there are multiple SSIS package jobs and the server is unavailable for an extended period, this could cause the SSIS package jobs to pile up until the server becomes available. Nonetheless, I wanted to find a way to set it 0 in case it was necessary. After numerous tests, I identified a workaround which did not involve manually setting the connection string or setting up a configuration file.<\/p>\n\n\n\n
Step 1: Set the ‘Connect Timeout’ Setting to Any Value<\/h3>\n\n\n\n
As shown in the image below, I set the timeout to 1 minute, in seconds.<\/p>\n\n\n\n
![\"connection](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/connection-timeout-ssis.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
Once I clicked ‘OK’, it generated two following connection strings, as predicted:<\/p>\n\n\n\n
\nData Source=;Initial Catalog=Test;Provider=SQLNCLI11.1;Integrated Security=SSPI;Connect Timeout=60;Auto Translate=False;\n<\/code><\/pre>\n\n\n\n![\"connection](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/connection-string.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
Step 2: Change the ‘Connect Timeout’ Setting to 0<\/h3>\n\n\n\n
I re-opened the connection manager for. Test and changed the ‘Connect Timeout’ setting to 0.<\/p>\n\n\n\n
![\"connection](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/connection-timeout-0.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
I again clicked ‘OK’ and saved the package. The following was the new connection string:<\/p>\n\n\n\n
Data Source=;Initial Catalog=Test;Provider=SQLNCLI11.1; Integrated Security=SSPI;Connect Timeout=0;Auto Translate=False;<\/code><\/pre>\n\n\n\n![\"connection](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/connection-string-false.png\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
I re-ran the test SSIS package and confirmed it was no longer failing due to the “Login timeout expired” error.<\/p>\n\n\n\n
In summary, a few extra steps are needed to set ‘Connect Timeout’ through the configuration manager:<\/p>\n\n\n\n
- \n
- Set “Connection Timeout” to any number<\/li>\n\n\n\n
- Save the connection manager<\/li>\n\n\n\n
- Reopen configuration manager<\/li>\n\n\n\n
- Set the “Connection Timeout” to 0<\/li>\n\n\n\n
- Save the package<\/li>\n<\/ol>\n\n\n\n
Now ‘Connect Timeout’ should be set to “Unlimited” in the connection string.<\/p>\n\n\n\n
The Configuration File Workaround<\/h2>\n\n\n\n
The connection string is overridden when a configuration file is added. This also allows \u2018Connect Timeout\u2019 to be set to 0 by altering an XML file.<\/p>\n\n\n\n
Step 1: Create a Connection Manager<\/h3>\n\n\n\n
- Step 2: Open Package Configuration Organizer<\/a><\/li>
- Step 2: Change the ‘Connect Timeout’ Setting to 0<\/a><\/li><\/ul><\/li>
- The Connection Manager Workaround<\/a>
- Alternatively, the Configuration File Workaround<\/strong> involves creating an XML configuration file through the Package Configuration Organizer and manually editing the XML to set the
![\"package](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/package-config.png\")
<\/figure>\n\n\n\n![\"package](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/package-check-ssis.png\")
<\/figure>\n\n\n\n![\"config](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/config-wizard.png\")
<\/figure>\n\n\n\n![\"config](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/config-wizard-2.png\")
<\/figure>\n\n\n\n![\"ssis](\"https:\/\/virtual-dba.com\/wp-content\/uploads\/ssis-xml-code.png\")
<\/figure>\n\n\n\n