使用BIML生成CDC Source和CDC Splitter控件失败求助

环境信息 #

• SSIS版本：3.12（对应SSIS 2019）
• Visual Studio版本：Community 2019 16.9.1

症状 #

使用BIML批量生成CDC更新数据仓库的SSIS包时，生成的CDC Source、CDC Splitter、CDC Control控件出现以下问题：

• 控件图标显示异常（空白或错误图标）
• 双击控件无任何响应

已尝试参考相关示例代码，并使用以下BIML代码配置CdcControl，但问题未解决：

<CdcControl  Name="CDC Mark Init Load Start" ConnectionName="ADO_Source" ControlOperation="GetProcessingRange" StateVariableName="User.CDC_State_<#=table.Name#>" 
    AutomaticStatePersistence="true" StateConnectionName="ADO_Source" StateName="CDC_State_<#=table.Name#>">
    <ExternalStateTable Table="dbo.CDC_States"></ExternalStateTable>        
</CdcControl>

解决方案 #

1. 确认BIML与SSIS版本兼容性 #

确保使用的BIML工具（如BIMLExpress）版本支持SSIS 2019。旧版本的BIML可能未正确适配SSIS 2019的CDC控件，导致生成的包控件异常。建议更新BIMLExpress到对应SSIS 2019的最新版本。

2. 修正CDC控件的BIML语法 #

关键属性检查与修正

• CDC Source：必须指定CDCConnectionName（连接到启用CDC的源数据库）、TableName（格式为[Schema].[Table_CaptureInstance]）、ProcessingMode（如NetChanges）等核心属性，示例：

<CdcSource Name="CDC Source - <#=table.Name#>" CDCConnectionName="CDC_Source_DB" TableName="<#=table.Schema#>.<#=table.Name#>_Capture" ProcessingMode="NetChanges">
    <Columns>
        <#=table.GetColumnNames()#>
    </Columns>
</CdcSource>

• CDC Splitter：需正确关联上游CDC Source的输出，示例：

<CdcSplitter Name="CDC Splitter - <#=table.Name#>">
    <InputPath OutputPathName="CDC Source - <#=table.Name#>.Output" />
</CdcSplitter>

• CdcControl：修正你提供的代码，确保连接名称、状态表配置正确：

<CdcControl Name="CDC Mark Init Load Start - <#=table.Name#>" 
            ConnectionName="CDC_Source_DB" 
            ControlOperation="GetProcessingRange" 
            StateVariableName="User.CDC_State_<#=table.Name#>"
            AutomaticStatePersistence="true" 
            StateConnectionName="CDC_State_DB" 
            StateName="CDC_State_<#=table.Name#>">
    <ExternalStateTable Schema="dbo" Table="CDC_States" />        
</CdcControl>

注意：ConnectionName是源CDC数据库的连接管理器，StateConnectionName是存储CDC状态表的数据库连接（可与源同库），需确保这两个连接管理器在BIML中已正确定义。

3. 检查生成包的XML结构 #

如果控件仍异常，可手动打开生成的SSIS包XML，检查CDC控件的CLSID是否正确：

• CDC Source的CLSID（SSIS 2019）：{5C0B8D21-1976-4F4D-B9C7-58B88294C9D3}
• CDC Splitter的CLSID（SSIS 2019）：{F5C597D8-5C7F-4B57-9D9F-9B5E79A67D55}
• CdcControl的CLSID（SSIS 2019）：{A8B5F5D5-4F7A-4E9D-9E6A-66B0A9F5B37F}
  若BIML生成的CLSID错误，需调整BIML代码中对应的控件定义，或更新BIML工具以生成正确的CLSID。

4. 更新VS与SSIS组件 #

将Visual Studio 2019更新至最新可用版本（16.9.x之后的版本修复了多个SSIS控件的兼容性问题），同时确保SSIS扩展组件为最新状态。

5. 验证CDC环境权限与配置 #

• 确认源数据库已启用CDC，目标表的CDC捕获实例存在且正常
• 确保SSIS连接管理器使用的账号拥有CDC操作权限（如db_owner、cdc_admin角色）

内容的提问来源于stack exchange，提问作者MSBI-Geek