Biml Teil 4 – InputPath, OutPath

Im 4. Teil meiner Serie über Biml, möchte ich kurz die Ein- und Ausgängen von Komponenten und Tasks erklären. Die bisherigen Teile der Biml Serie sind hier zu finden:

Tasks und ConstraintMode

Werden mehrere Ablaufsteuerungselemente in einem SSIS Paket platziert, so kann man über das Attribut ConstraintMode definieren, das alle Tasks linear, also nacheinander, ausgeführt werden. Wird das Attribut ConstraintMode mit dem Wert Parallel versehen, so müssen/können die Beziehungen der einzelnen Tasks manuell zueinander definiert werden.

Um eine eigene Reihenfolge zwischen den Tasks zu definieren existiert das Element PrecedenceConstraints mit der dazugehörigen Collection Inputs. Innerhalb der Collection Inputs können die einzelnen Output-Pfade eines vorhergehenden Elements zugeordnet werden. Der Name eines Output-Pfades setzt sich immer aus dem Namen des Tasks mit “.Output” zusammen. Als Standard wird für die Pfade der Wert “Erfolg” verwendet. Möchte man die Pfade bei “Fehler” oder “Beendigung” setzen, so kann dies über das Attribut EvaluationValue gesetzt werden.

<Dataflow Name="Test3">
   <PrecedenceConstraints>
      <Inputs>
         <Input OutputPathName="Test1.Output" />
         <Input OutputPathName="Test2.Output" EvaluationValue="Failure" />
      </Inputs>
   </PrecedenceConstraints>
</Dataflow>

Components

Die Definition der Ein- und Ausgabepfade bei den Komponenten funktioniert genauso wie bei den Tasks, ein Unterschied an dieser Stelle ist, dass die jeweiligen Collections InputPaths und OutputPaths heißen und direkt dem Task untergeordnet sind.

Auch hier wird für den Namen eines Pfades immer der Name des Tasks gefolgt von “.Output” verwendet. Eine Ausnahme ergibt sich bei der Verwendung des Tasks Multicast. Über die Collection OutPutPaths können mehrere Ausgabepfade definiert werden, die einzeln benannt werden müssen. Die Namen der entsprechenden Ausgaben müssen bei der Zuordnung in nachgeordneten Task verwendet werden.

<Transformations>
   <OleDbSource Name="Person" ConnectionName="AdventureWorks">
      <DirectInput>SELECT * FROM Person.Address</DirectInput>
   </OleDbSource>
   <Multicast Name="Person Multicast">
      <InputPath OutputPathName="Person.Output" />
      <OutputPaths>
         <OutputPath Name="Path1" />
         <OutputPath Name="Path2" />
         <OutputPath Name="Path3" />
      </OutputPaths>
   </Multicast>
   <UnionAll Name="Path1_2">
      <InputPaths>
         <InputPath OutputPathName="Person Multicast.Path1" />
         <InputPath OutputPathName="Person Multicast.Path2" />
      </InputPaths>
   </UnionAll>
   <UnionAll Name="Path3">
      <InputPaths>
         <InputPath OutputPathName="Person Multicast.Path3" />
         <InputPath OutputPathName="Path1_2.Output" />
      </InputPaths>
   </UnionAll>
</Transformations>