3

我有很多容器都遵循相同的基本前提:

在此处输入图像描述

当我从远程数据库中提取数据时,我首先清空一个收集器表,将数据从远程数据库复制到收集器,计算收集器中的行数,如果有足够的行,则合并到真实表中。如果没有,我会发送一封包含错误消息的电子邮件。

我不想一遍又一遍地重复这个,我想制作一个自定义组件。我认为这只是我会制作的一个过滤器组件,但我不太确定如何复制这Data Flow Task件作品。有没有人可以指出我的好例子,或者只是让我知道我想做的事情是不可能的?

4

1 回答 1

2

当我看到这样的问题时,Biml往往会为创建简单、可重复的解决方案提供最低的障碍。Biml 是免费的,您只需发送一封注册电子邮件,然后将BimlExpress安装到您正在使用的任何版本的 Visual Studio/SSDT 中。

我假设我要从 AdventureWorks2014 Sales.Currency 表中收集数据并将其传输到 tempdb 中名为 dbo.SalesCurrency 的表中。

我将其定义为

CREATE TABLE dbo.SalesCurrency
(
    CurrencyCode nchar(3) NOT NULL
,   Name nvarchar(50) NOT NULL
,   ModifiedDate datetime NOT NULL
);

鉴于此,让我们看一些 Biml 概念。Biml 是一种基于 XML 的方言,用于描述商业智能工件(以及一些)。如果您曾经使用混合脚本和标签进行过经典的 ASP 开发,这是一个类似的概念,但由于 .NET 集成而更好。

  • <# #>这是一个多行块
  • <#= #>是单行表达式

太好了,怎么用?假设您已经安装了 BimlExpress,打开一个 SSIS 项目并右键单击项目部分并选择Add New Biml File. 这样做两次,我们将重命名第二个。第一个是司机,第二个是工人。

脑筋急转弯

<Biml xmlns="http://schemas.varigence.com/biml.xsd">
    <Connections>
        <OleDbConnection Name="Source" ConnectionString="Data Source=localhost\dev2017;Initial Catalog=AdventureWorks2014;Provider=SQLNCLI11.0;Integrated Security=SSPI;" />        
        <OleDbConnection Name="Target" ConnectionString="Data Source=localhost\dev2017;Initial Catalog=tempdb;Provider=SQLNCLI11.0;Integrated Security=SSPI;" />        
    </Connections>
<#
string sourceQuery = "SELECT * FROM Sales.Currency;";
string targetSchemaTable = "[dbo].[SalesCurrency]";
string templateName = "so_56050574_include.biml";
dynamic customOutput;
#>
    <Packages>
        <#= CallBimlScriptWithOutput(templateName, out customOutput, sourceQuery, targetSchemaTable) #>
    </Packages>
</Biml>

第一行只是 xml 命名空间。

下一个块,我定义我的源和目标连接的连接集合。我很有创意,给他们起了Source名字Target

下一行看起来很像 C#,因为它们是。我定义了我的源查询、完全限定的目标表名称、包含的方括号和我的模板文件的名称。最后一个变量 customOutput 在这里没有使用,但它是一个允许我从模板文件传回信息的包 - 即它构建的 SSIS 包的名称。

然后我定义一个 Packages 集合并制作一个单独的包。我制作的包由我发送到的任何内容定义,CallBimlScriptWithOutput然后我使用刚刚定义的变量。

它看起来很复杂,但事实并非如此。我喜欢这种方法的原因是,它不是将这些值硬编码到我的驱动程序中,而是允许我采用元数据驱动的方法进行开发。我可以从电子表格、Sharepoint 列表、网络服务中查找这些值,无论我喜欢什么(或我的客户提供的存储库)。

工人 biml

我将此文件命名为 so_56050574_include.biml,虽然其中有很多文本,但它相当简单。

第一行在 Biml 设计体验期间帮助 Intellisense。接下来的两行指定这些变量将被传入 - 就像函数调用一样。我将能够在此文件的范围内像使用 .NET 变量一样使用它们。

接下来的几行有点古怪,但 SSIS 不喜欢重复的名称,也不喜欢名称中的“坏”字符。我指定包名称将是 Populate Collector,然后我使目标表对 SSIS 安全。一直到文件的底部,您会看到我创建了一个名为的小方法MakeSsisSafeName,我用它来清理包名称。

我创建了一个包并给它起一个好名字。该包有一个容器。在容器中,我创建了一些我工作所需的 SSIS 变量。该容器具有执行 SQL 任务 -> 数据流任务 -> 执行 SQL 任务 -> 执行 SQL 任务 -> 发送邮件任务的任务

<#@ template designerbimlpath="/Biml/Packages" #>
<#@ property name="SourceQuery" type="string" #>
<#@ property name="TargetSchemaTable" type="string" #>

<#
string packageName = string.Format("Populate Collector {0}", MakeSsisSafeName(TargetSchemaTable));
CustomOutput.PackageName = packageName;
#>
<Package Name="<#= packageName #>" ConstraintMode="Linear">
    <Tasks>
        <Container Name="SEQC Collector" ConstraintMode="Parallel">
            <Variables>
                <Variable Name="RowCount" DataType="Int64">0</Variable>
                <Variable Name="QueryEmpty" DataType="String">TRUNCATE TABLE <#=TargetSchemaTable#></Variable>
                <Variable Name="QueryCount" DataType="String">SET NOCOUNT ON; SELECT COUNT_BIG(1) AS rc FROM <#=TargetSchemaTable#></Variable>
                <Variable Name="QuerySource" DataType="String"><#=SourceQuery#></Variable>
                <Variable Name="TargetSchemaTable" DataType="String"><#=TargetSchemaTable #></Variable>
            </Variables>
            <Tasks>
                <ExecuteSQL Name="SQL Empty Collector Table" ConnectionName="Target">
                    <VariableInput VariableName="User.QueryEmpty" />
                </ExecuteSQL>
                <Dataflow Name="DFT Populate Collector Table">
                    <Transformations>
                        <OleDbSource Name="OLESRC Query" ConnectionName="Source">
                            <VariableInput VariableName="User.QuerySource" />
                        </OleDbSource>
                        <OleDbDestination Name="OLEDST Target" ConnectionName="Target">
                            <TableFromVariableOutput VariableName="User.TargetSchemaTable" />
                        </OleDbDestination>
                    </Transformations>
                    <PrecedenceConstraints>
                        <Inputs>
                            <Input OutputPathName="SQL Empty Collector Table.Output" EvaluationValue="Success" />
                        </Inputs>
                    </PrecedenceConstraints>
                </Dataflow>
                <ExecuteSQL Name="SQL Count Collector Table Rows" ConnectionName="Target" ResultSet="SingleRow">
                    <VariableInput VariableName="User.QueryCount" />
                    <Results>
                        <Result Name="0" VariableName="User.RowCount" />
                    </Results>
                    <PrecedenceConstraints>
                        <Inputs>
                            <Input OutputPathName="DFT Populate Collector Table.Output" EvaluationValue="Success" />
                        </Inputs>
                    </PrecedenceConstraints>
                </ExecuteSQL>
                <ExecuteSQL Name="SQL Merge Collector Data" ConnectionName="Target">
                    <DirectInput>SELECT 1; -- simulate merge</DirectInput>
                        <PrecedenceConstraints>
                            <Inputs>
                                <Input OutputPathName="SQL Count Collector Table Rows.Output" EvaluationOperation="ExpressionAndConstraint" EvaluationValue="Success" Expression="@[User::RowCount] &gt; 0" />
                            </Inputs>
                        </PrecedenceConstraints>
                </ExecuteSQL>
                <!--
                <SendMail Name="Send Mail" ToLine="Foo@bar.com" ConnectionName="Target" Subject="Subject line">
                    <DirectInput>Body here, I think</DirectInput>
                        <PrecedenceConstraints>
                            <Inputs>
                                <Input OutputPathName="SQL Count Collector Table Rows.Output" EvaluationOperation="ExpressionOrConstraint" EvaluationValue="Success" Expression="@[User::RowCount] == 0" />
                            </Inputs>
                        </PrecedenceConstraints>
                </SendMail>
                -->
                <ExecuteSQL Name="SQL Pretend I send mail" ConnectionName="Target">
                    <DirectInput>SELECT 2; -- simulate merge</DirectInput>
                        <PrecedenceConstraints>
                            <Inputs>
                                <Input OutputPathName="SQL Count Collector Table Rows.Output" EvaluationOperation="ExpressionAndConstraint" EvaluationValue="Success" Expression="@[User::RowCount] ==0" />
                            </Inputs>
                        </PrecedenceConstraints>
                </ExecuteSQL>
            </Tasks>
        </Container>
    </Tasks>

</Package>

<#+
private static string MakeSsisSafeName(string name)
{
    return name.Replace("/", "_").Replace("\\", "_").Replace(":", "_").Replace("[", "_").Replace("]", "_").Replace(".", "_").Replace("=", "_").Trim();
}
#>

右键单击 BimlScript 大脑文件并选择生成 SSIS 包

biml 创建包

那应该建立一个像这样的包,嘿,它有效!

结果

未涵盖的内容

我不知道你实际上是如何使用它的。也许你有一个包含很多容器的大包,你的愿景是只需按下按钮并添加另一个模板容器。Biml不会那样做。它不会合并两个 SSIS 包 - 它使用当前定义覆盖一个。但是,按照我定义所有这些的方式,您应该能够复制生成的 Container 并将其粘贴到现有的 SSIS 包中 - 假设它有两个名为 Source 和 Target 的连接。

连接也可能很棘手。如果您从 N 个源服务器收集数据,那么您可能需要一个循环机制来更改 Source 值。这并不难。但是,如果您为每个收集器拉回的源数据具有不同的签名,那么您需要每个定制的数据流任务。

发送电子邮件。我没有方便的 SMTP 连接,所以我对发送邮件的外观做了一个最好的猜测,然后将其注释掉<!-- ... -->您需要在 Brains 包中为您的 SMTP 服务器添加一个连接,然后配置 SendMail 任务使用它。然后删除我的“SQL 假装我发送邮件”任务。

最后,您会注意到名称在工作程序 Biml 中重复。这告诉引擎应该如何连接。如果你不喜欢我所说的东西,你需要在两个地方改变它。搜索和替换在这方面会很方便;)

关于自定义工作流任务的问题 - 回答它

美好的。糟透了。DataFlow 的东西进入了 COM 对象,使用起来并不愉快。当您提供查询或源表时,您需要检查元数据、添加/删除列以及许多记录不充分且需要大量工作的东西。这只是通过接口构建一个“常规”包。一旦你解决了这个问题,你就会考虑将该逻辑封装到一个自定义组件中,该组件过去曾在 Codeplex 上用足够多的样本进行记录,但现在已经死了,我不知道它是否已迁移到 github。哦,自定义任务和组件尤其依赖于版本,因此您可以针对各种二进制文件进行构建以获取每个文件的 dll。然后您可能需要构建 UI 组件来帮助人们配置您的 SSIS 任务/组件。然后您需要担心在每个开发人员的计算机上交付和安装它。和服务器安装。

或者,我可以通过 Biml 定义一次并完成。

于 2019-05-09T03:02:56.230 回答