Version

    Auto-propagated Metadata

    Introduction to Auto-propagated Metadata

    Sources of Auto-Propagated Metadata

    Explicitly Propagated Metadata

    Priorities of Metadata

    Jobflow

    Introduction to Auto-propagated Metadata

    In many cases, CloverDX is able to detect metadata on edges automatically via metadata propagation. Metadata propagation is a process which propagates metadata through the graph based on a set of rules. The metadata to propagate is taken from sources such as edges with manually assigned metadata and from components that can inject metadata into the graph.

    auto detected metadata 04
    Figure 153. Metadata propagation: metadata is propagated from the first edge on the left side to all connected edges.

    You do not have to assign metadata manually to each edge in graph as metadata is propagated by default. You can override metadata on edges by manually selecting propagated metadata or by user-defined metadata.

    auto detected metadata 005
    Figure 154. Changing auto-propagated metadata to user-defined.
    auto detected metadata 007
    Figure 155. Changing user-defined metadata to auto-propagated.
    Principles of Propagation

    Metadata propagation depends on a graph layout, priorities of metadata propagation of particular component and manually assigned metadata. Metadata is propagated through directly or indirectly connected components and edges. To propagate metadata to an edge in a separated part of graph, an action from the user is needed.

    Components may have different priorities of metadata propagation from both sides or can propagate one way only (e.g. Map).

    auto detected metadata 120
    Figure 156. Different priorities of metadata propagation

    At least some metadata must be known: assigned by the user or propagated from a template on a port of a component.

    Sources of Auto-Propagated Metadata

    Component

    Edge

    Component

    Some components have metadata templates assigned to their ports. The metadata from templates propagates from the component to the connected edge.

    For example, metadata for error records are auto-propagated on the second output port of SpreadsheetDataReader. Another example of a component having metadata assigned on port is ListFiles. A Subgraph component can propagate metadata from itself too.

    auto detected metadata 01
    Figure 157. Metadata propagated from the component
    auto detected metadata 015
    Figure 158. Metadata propagated from the component II.
    auto detected metadata 017
    Figure 159. Metadata propagated from the component, metadata template is defined within the component.
    Edge

    Some components (e.g. SimpleCopy) propagate metadata from input to output ports. Thus metadata can be auto-propagated on an edge as coming from a different edge, even several components away.

    auto detected metadata 02
    Figure 160. Metadata propagated from the another edge
    auto detected metadata 04
    Figure 161. Metadata propagated from a distant edge
    auto detected metadata 045
    Figure 162. Advanced metadata propagation - DataIntersection

    Metadata can be propagated from left to right or from right to left. Some components can propagate metadata between ports at the same side of the component using the port on the other side. Components not changing the metadata structure (e.g. Filter, SimpleCopy, etc.) usually propagate metadata from both sides.

    The component-specific metadata propagation details can be found in the reference of particular components.

    auto detected metadata 06
    Figure 163. Overview of directions of metadata propagation

    Explicitly Propagated Metadata

    An edge can have explicitly assigned metadata of another edge of the graph. Both edges do not have to be connected through any other components and edges. The user has to define an edge from which the metadata is propagated.

    auto detected metadata 05
    Figure 164. Metadata propagated from an unconnected distant edge

    Let us explain the figure above: the metadata orders assigned to the edge between FlatFileReader and Filter are propagated through Filter.

    We need the same metadata to read records using CloverDataReader as CloverDataWriter uses; therefore, we define that the edge between CloverDataReader and ExtSort takes metadata (see the green symbol) from the edge (the blue symbol) between Filter and CloverDataWriter.

    Assigning Explicitly Propagated Metadata

    Right click the edge to which you need to assign metadata and choose Select Metadata  Select Metadata from Edge

    The message informs you about activation of a selection tool.

    auto detected metadata 080

    The cursor has changed and the graph editor pane is now transparent.

    auto detected metadata 090

    Click the edge you need to take metadata from.

    auto detected metadata 100

    The metadata has been propagated. The blue symbol denotes the source edge of metadata, the green one denotes the target edge.

    auto detected metadata 110

    Priorities of Metadata

    Auto-propagated metadata has lower priority than explicitly defined metadata. You are free to override metadata assigned to the edge with different metadata. The auto-propagated metadata can be overridden in the same way as assigning new metadata to the edge: either by dragging and dropping from outline or by right clicking on the edge and choosing Select Metadata or New metadata.

    metadata propagation flowchart 1

    Propagation of SQL Query Metadata

    SQL query metadata can be propagated; however, editing is done in the editor for user defined metadata and any changes must be saved as a new non-SQL query metadata. This limitation also applies to editing SQL query metadata in Transformation editor output (e.g. Map).

    Jobflow

    Auto-propagated metadata work also with jobflow components.

    auto detected metadata 03
    Figure 165. Metadata propagated from the another edge
    COMPATIBILITY NOTICE

    Auto-propagated metadata is available since version 4.0.0.

    To propagate metadata, you must also open the context menu by right-clicking the edge, then selecting the Propagate metadata item. The metadata will be propagated until it reaches a component in which metadata can be changed (e.g. Map, Joiners, etc.).