tPaloRule - 6.3

Talend Open Studio for Big Data Components Reference Guide

EnrichVersion
6.3
EnrichProdName
Talend Open Studio for Big Data
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Function

This component creates or modifies rules in a given cube.

Purpose

This component allows you to manage rules in a given cube.

tPaloRule Properties

Component family

Business Intelligence/Cube OLAP/Palo

 

Basic settings

Use an existing connection

Select this check box and in the Component List click the relevant connection component to reuse the connection details you already defined.

Note that when a Job contains the parent Job and the child Job, Component List presents only the connection components in the same Job level.

Connection configuration

Note

Unavailable when using an existing connection.

Host Name

Enter the host name or the IP address of the host server.

 

Server Port

Type in the listening port number of the Palo server.

 

Username and Password

Enter the Palo user authentication data.

To enter the password, click the [...] button next to the password field, and then in the pop-up dialog box enter the password between double quotes and click OK to save the settings.

 

Database

Type in the name of the database where the dimensions applying the rules of interest reside.

 

Cube

Type in the name of the cube whose dimension information is retrieved.

 

Cube rules

Complete this table to perform various actions on specific rules.

Definition: type in the rule to be applied.

 

 

External Id: type in the user-defined external ID.

 

 

Comment: type in comment for this rule.

 

 

Activated: select this check box to activate this rule.

 

 

Action: select the action to be performed from the drop-down list.

- Create: create this rule.

- Delete: delete this rule.

- Update: update this rule.

Advanced settings

tStat Catcher Statistics

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

Connections

Outgoing links (from this component to another):

Trigger: Run if; On Subjob Ok; On Subjob Error; On Component Ok; On Component Error.

Incoming links (from one component to this one):

Row: Iterate

Trigger: Run if; On Subjob Ok; On Subjob Error; On Component Ok; On Component Error.

For further information regarding connections, see Talend Studio User Guide.

Global Variables

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

This component can be used in standalone for rule creation, deletion or update.

Log4j

If you are using a subscription-based version of the Studio, the activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

Update or deletion of a rule is available only when this rule has been created with external ID.

Due to license incompatibility, one or more JARs required to use this component are not provided. You can install the missing JARs for this particular component by clicking the Install button on the Component tab view. You can also find out and add all missing JARs easily on the Modules tab in the Integration perspective of your studio. For details, see the article Installing External Modules on Talend Help Center (https://help.talend.com) how to configure the Studio in the Talend Installation and Upgrade Guide.

Scenario: Creating a rule in a given cube

The Job in this scenario creates a rule applied on dimensions of a given cube.

To replicate this scenario, proceed as follows:

Setting up the DB connection

  1. Drop tPaloRule from the component Palette onto the design workspace.

  2. Double-click the tPaloRule component to open its Component view.

  3. In the Host name field, type in the host name or the IP address of the host server, localhost for this example.

  4. In the Server Port field, type in the listening port number of the Palo server. In this scenario, it is 7777.

  5. In the Username field and the Password field, type in the authentication information. In this example, both of them are admin.

  6. In the Database field, type in the database name in which the dimensions applying the created rules reside, Biker in this example.

  7. In the Cube field, type in the name of the cube which the dimensions applying the created rules belong to, for example, Orders.

Setting the Cube rules

  1. Under the Cube rules table, click the plus button to add a new row.

  2. In the Cube rules table, type in ['2009'] = 123 in the Definition column, OrderRule1 in the External Id column and Palo Demo Rules in the Comment column.

  3. In the Activated column, select the check box.

  4. In the Action column, select Create from the drop-down list.

Job execution

Press F6 to run the Job.

The new rule has been created and the value of every 2009 element is 123.