Description:
Fetches a row from an HBase table. The Destination property controls whether the cells are added as flow file attributes, or the row is written to the flow file content as JSON. This processor may be used to fetch a fixed row on a interval by specifying the table and row id directly in the processor, or it may be used to dynamically fetch rows by referencing the table and row id from incoming flow files.
Tags:
hbase, scan, fetch, get, enrich
Properties:
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
Name | Default Value | Allowable Values | Description |
HBase Client Service |
Controller Service API: HBaseClientService Implementations: HBase_1_1_2_ClientService |
Specifies the Controller Service to use for accessing HBase. | |
Table Name | The name of the HBase Table to fetch from.</br> Supports Expression Language: true | ||
Row Identifier | The identifier of the row to fetch.</br> Supports Expression Language: true | ||
Columns | An optional comma-separated list of "colFamily:colQualifier" pairs to fetch. To return all columns for a given family, leave off the qualifier such as "colFamily1,colFamily2".</br> Supports Expression Language: true | ||
Destination | flowfile-attributes |
*flowfile-attributes *flowfile-content |
Indicates whether the row fetched from HBase is written to FlowFile content or FlowFile Attributes. |
JSON Format | full-row |
*full-row *col-qual-and-val |
Specifies how to represent the HBase row as a JSON document. |
JSON Value Encoding | none |
*none *base64 |
Specifies how to represent row ids, column families, column qualifiers, and values when stored in FlowFile attributes, or written to JSON. |
Encode Character Set | UTF-8 | The character set used to encode the JSON representation of the row. | |
Decode Character Set | UTF-8 | The character set used to decode data from HBase. |
Relationships:
Name | Description |
success | All successful fetches are routed to this relationship. |
failure | All failed fetches are routed to this relationship. |
not found | All fetches where the row id is not found are routed to this relationship. |
Reads Attributes:
None specified.
Writes Attributes:
Name | Description |
hbase.table | The name of the HBase table that the row was fetched from |
hbase.row | A JSON document representing the row. This property is only written when a Destination of flowfile-attributes is selected. |
mime.type | Set to application/json when using a Destination of flowfile-content, not set or modified otherwise |
State management:
This component does not store state.
Restricted:
This component is not restricted.
Input requirement:
This component requires an incoming relationship.