July 30, 2023

tIntervalMatch – Docs for ESB 7.x

  2. Talend for ESB Docs
  3. Docs 7.x
  4. tIntervalMatch – Docs for ESB 7.x

tIntervalMatch

Returns a value based on a Join relation.

tIntervalMatch receives a main flow
and aggregates it based on join to a lookup flow. Then it matches a specified value to a range
of values and returns related information.

tIntervalMatch Standard properties

These properties are used to configure tIntervalMatch running in the Standard Job framework.

The Standard
tIntervalMatch component belongs to the Data Quality family.

The component in this framework is available in all Talend
products.

Basic settings

Schema and Edit
schema

A schema is a row description. It defines the number of fields
(columns) to be processed and passed on to the next component. When you create a Spark
Job, avoid the reserved word line when naming the
fields.

 

Built-in: The schema will be
created and stored locally for this component only. Related topic:
see
Talend Studio User Guide.

 

Repository: The schema already
exists and is stored in the Repository, hence can be reused in
various projects and job flowcharts. Related topic: see

Talend Studio User
Guide.
 

Click Edit
schema to make changes to the schema. If the current schema is of the Repository type, three options are available:

  • View schema: choose this
    option to view the schema only.

  • Change to built-in property:
    choose this option to change the schema to Built-in for local changes.

  • Update repository connection:
    choose this option to change the schema stored in the repository and decide whether
    to propagate the changes to all the Jobs upon completion. If you just want to
    propagate the changes to the current Job, you can select No upon completion and choose this schema metadata
    again in the Repository Content
    window.

Search Column

Select the main flow column containing the values to be matched
with a range of values

Column (LOOKUP)

Select the lookup flow column containing the values to be returned
when the Join is ok.

Lookup Column (min) / Include the bound
(min)

Select the column containing the minimum value of the range.
Select the check box to include the minimum value of the range in
the match.

Lookup Column (max) / Include the bound
(max)

Select the column containing the maximum value of the range.
Select the check box to include the maximum value of the range in
the match.

Advanced settings

tStat
Catcher
Statistics

Select this check box to collect log data at the component
level.

Global Variables

Global Variables

NB_LINE: the number of rows read by an input component or
transferred to an output component. This is an After variable and it returns an
integer.

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.

Usage

Usage rule

This component handles flow of data therefore it requires input
and output, hence is defined as an intermediary step.

Identifying server locations based on their IP addresses

This scenario describes a four-component Job that checks the server IP addresses
listed in the main input file against a list of IP ranges given in a lookup file to
identify the hosting country for each server.

tIntervalMatch_1.png

Setting up the Job

The Job requires two tFileInputDelimited
components, a tIntervalMatch component and a
tLogRow component.

  1. Drop the components onto the design workspace.
  2. Connect the components using Row >
    Main connection.

    Note that the connection from the second tFileInputDelimited component to the tIntervalMatch component will appear as a Lookup
    connection.

Configuring the components

  1. Double-click the first tFileInputDelimited component to open its Basic settings view.

    tIntervalMatch_2.png

  2. Browse to the file to be used as the main input, which provides a list of
    servers and their IP addresses:

  3. Click the […] button next to Edit schema to open the Schema dialog box and define the input schema. According
    to the input file structure, the schema is made of two columns, respectively
    Server and IP, both of type
    String. Then click OK to close the dialog box.

    tIntervalMatch_3.png

  4. Define the number of header rows to be skipped, and keep the other
    settings as they are.
  5. Define the properties of the second tFileInputDelimited component similarly.

    tIntervalMatch_4.png

    The file to be used as the input to the lookup flow in this example lists
    some IP address ranges and the corresponding countries:
    Accordingly, the schema of the lookup flow should have the following
    structure:
    tIntervalMatch_5.png

  6. Double-click the tIntervalMatch component
    to open its Basic settings view.

    tIntervalMatch_6.png

  7. From the Search Column list, select the
    main flow column containing the values to be matched with the range values.
    In this example, we want to match the servers’ IP addresses with the range
    values from the lookup flow.
  8. From the Column (LOOKUP) list, select the
    lookup column that holds the values to be returned. In this example, we want
    to get the names of countries where the servers are hosted.
  9. Set the min and max lookup columns corresponding to the range bounds
    defined in the lookup schema, StartIP and
    EndIP respectively in this
    example.

Executing the Job

Press Ctrl+S to save your Job and press
F6 to run it.

The name of the country where each server is hosted is displayed next to
the IP address.
tIntervalMatch_7.png

Document get from Talend https://help.talend.com
Thank you for watching.
Docs 7.x
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x