Skip to content

Commit 078e0c3

Browse files
Merge pull request #36206 from chugugrace/mybranch01092026
add excel connection manager limitation
2 parents 94cfd3b + 0b88d98 commit 078e0c3

1 file changed

Lines changed: 26 additions & 1 deletion

File tree

docs/integration-services/load-data-to-from-excel-with-ssis.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ The following sections contain the information you need to use Excel successfull
3232
- Issues with [data types](#issues-types).
3333
- Issues with [importing](#issues-importing).
3434
- Issues with [exporting](#issues-exporting).
35+
- Issues in [unattended or non‑interactive environments](#issues-non‑interactive-environments).
3536

3637
<a id="tools"></a>
3738

@@ -175,8 +176,32 @@ After you select or enter the Excel objects to import or export, you can also do
175176

176177
- Preview sample data to make sure it's what you expect by selecting **Preview**.
177178

178-
<a id="issues-types"></a>
179+
<a id="issues-non‑interactive-environments"></a>
180+
## Issues in Unattended or Non‑Interactive Environments
181+
182+
When SQL Server Integration Services (SSIS) packages use Excel Connection Managers and are executed in unattended or non‑interactive environments—such as SQL Agent Jobs, the SSIS Catalog, or other server‑side automation—they may fail with connection or provider‑related errors.
183+
184+
This occurs because Microsoft Office/Excel components (including ACE/Jet providers) are not supported for automation or use in service contexts. These components require an interactive desktop session and may behave unpredictably when invoked by background processes.
185+
186+
Microsoft Office has long provided official guidance that server-side or unattended automation of Office applications is unsupported, including Excel data providers.
187+
188+
### Recommended Alternatives
189+
190+
To ensure reliability in production and automated ETL pipelines, Microsoft recommends replacing Excel Connection Managers with one of the following supported, server‑safe alternatives:
191+
192+
- **Flat file sources (CSV/TXT)** - Ideal for structured tabular data and fully supported for unattended SSIS execution.
179193

194+
- **OLE DB or ODBC connections** - Use when the source data can be placed in a supported database or exposed via an OLE DB/ODBC provider.
195+
196+
- **OpenXML or ADO.NET–based approaches** - Suitable when Excel files must be consumed directly without relying on Office automation or ACE.
197+
198+
These options do not depend on Office binaries and provide predictable, reliable behavior in server environments.
199+
200+
### Further Reference
201+
202+
For detailed information on Office automation supportability, please see [Considerations for server-side Automation of Office](https://support.microsoft.com/en-us/topic/considerations-for-server-side-automation-of-office-48bcfe93-8a89-47f1-0bce-017433ad79e2).
203+
204+
<a id="issues-types"></a>
180205
## Issues with data types
181206

182207
### Data types

0 commit comments

Comments
 (0)