Ssis-948
The Case of SSIS‑948: A Data‑Pipeline Mystery
4.1 Capture the Full Error Context
- Enable Detailed Logging
- In the SSIS package, add a SSIS log provider (e.g.,
SSIS log provider for Text files). - Log at OnError and OnTaskFailed events.
- In the SSIS package, add a SSIS log provider (e.g.,
- Read the Error Message
- Note the exact component name (
ComponentName) and the inner exception (if any).
- Note the exact component name (
- Check the Execution Mode
- Is the package running in Debug (Visual Studio) or Production (SQL Agent / SSIS Catalog)?
6.2 SSISDB Dashboard (Azure)
A new “Adaptive Buffers” tile appears on the Integration Runtime > Performance page, showing: ssis-948
- Real‑time buffer size trend (line chart)
- CPU utilisation vs. TargetCPUUtilisation
- Memory headroom (free vs. allocated)
3. Common Scenarios That Trigger SSIS‑948
| Scenario | Why It Happens | |----------|----------------| | Incorrect Connection String | Typo, missing server name, wrong database, or wrong provider. | | Credential Issues | The connection uses Windows Authentication and the executing account does not have rights, or the SQL login/password is expired/disabled. | | Package Configuration Overwrites | A configuration file/environment variable replaces a working connection string with an invalid one at runtime. | | Connection Manager Set to “DelayValidation” = False | Validation occurs before runtime variables are populated, causing a temporary invalid state. | | 64‑bit vs 32‑bit Provider Mismatch | The package runs in 64‑bit mode but the required provider (e.g., Jet OLEDB for Excel) is only 32‑bit. | | Network Issues | DNS resolution failure, firewall blocks, VPN disconnects, or the remote server is down. | | Concurrent Connections Limit Exceeded | Some data sources (e.g., Oracle, SAP) limit the number of simultaneous connections; SSIS may exceed the limit during a bulk load. | | Package Deployed to SSISDB with “Project Parameters” Overridden Incorrectly | Parameters that feed connection strings are mis‑typed or left blank in the catalog. | | Run‑time User Context Change | Using Execute Process Task or Impersonation that switches to a user without the needed privileges. | The Case of SSIS‑948: A Data‑Pipeline Mystery
5.2 Step‑by‑Step Walk‑through
- Open the SSIS project in Visual Studio (or Azure Data Factory → SSIS integration runtime).
- Select the Data Flow Task you wish to optimise.
- In the Properties window, locate the Adaptive Buffer group.
- Set AdaptiveBufferMode to Auto (or keep the default).
- (Optional) Adjust MinBufferSizeKB / MaxBufferSizeKB if you have strict memory caps on the host.
- Deploy the package to the SSIS Catalog (or Azure‑IR).
- Monitor the new runtime metrics (see Section 6) to verify that buffers are being resized as expected.