Contents
This topic describes how to run the HBase Operator sample applications, which illustrates how to use the HBase operators when connecting a StreamBase application to an HBase server. For more information on these operators, see Using Global Java Operators.
There are two samples included with the HBase sample package. The first sample, Demo.sbapp
, demonstrates a complete process of creating a table, inserting data, updating data, getting data, and deleting rows all
in a single flow. The second sample, DemoSteps.sbapp
, breaks this process down to allow you to see how each HBase operator works, one at a time.
This section describes the second sample, DemoSteps.sbapp
, that shows how each HBase operator is used individually.
The DemoSteps.sbapp
sample includes a number of HBase operators, which by default connect to the HBase server defined in the project's sbd.sbconf
file when the application starts. Before running this demo, you must edit this file to provide the communication details
to connect to your currently running HBase server.
The steps to run this sample in Studio are as follows:
-
Before running, you must configure the sample project with the your site's HBase server information. In the Package Explorer, locate the
sbd.sbconf
file and open it for editing. Be sure to edit the following settings:-
hbase.master
— Change the val attribute to point to the HBase server and port you want to use. -
hbase.zookeeper.quorum
— Change the val attribute to point to the Zookeeper server you want to use. -
hbase.zookeeper.property.clientPort
— Change the val attribute to point to the Zookeeper server's client port.
-
-
In the Package Explorer view, double-click to open the
DemoSteps.sbapp
application. -
Make sure the application is the currently active tab in the EventFlow editor, then click the Run button. This opens the SB Test/Debug perspective and starts the application.
-
In the Manual Input view, select the
InAdminCreateTable
input stream.Click
. This causes a tuple to be sent to an HBase Admin operator that in turn causes a table to be created in the database. Now, observe that theAdminCreateTableStatus
output stream receives a tuple with status information indicating the table was created. -
In the Manual Input view, select the
InGenerateRows
input stream.Click
. This causes a list of generated tuples to be sent to an HBase Put operator, which causes data to the inserted into the HBase table. Observe that thePutOut
output stream shows the values inserted. -
In the Manual Input view, select the
InUpdateRow
input stream.Click
. This sends a tuple to an HBase Put operator, which causes the previously sent data's first row to be updated with new values. Observe that theUpdateOut
output stream shows the values updated. -
In the Manual Input view, select the
InGet
input stream.Enter a rowId value of either 1, 2, 3, 4, or 5 into the rowId field.
Click
. This triggers trigger the HBase Get operator to fetch the row updated in the previous step from HBase. Observe that theGetOut
output stream shows the values received. -
In the Manual Input view, select the
InScan
input stream.Click
. This causes an HBase Scan operator to fetch all rows from HBase. Observe in theScanOut
output stream that these row values are received. -
In the Manual Input view, select the
InScanWithFilter
input stream.Enter the following values:
-
In the family field enter:
Family1
-
In the column field, enter:
Column4
-
In the matchSubString field, enter:
1
Click
. This triggers the HBase Scan operator to fetch a filtered set of rows from HBase. Observe that theScanWithFilterOut
output stream shows a single row received. -
-
In the Manual Input view, select the
InDelete
input stream.Click
. This causes the HBase Scan operator to fetch all rows, then feed the rowIds of those rows into the HBase Delete operator to delete those rows from HBase. Observe that theDeleteOut
output stream shows the rows deleted. -
When done, press F9 or click the Stop Running Application button.
The steps to run this sample in Studio are as follows:
-
Before running, you must configure the sample project with the your site's HBase server information. In the Package Explorer, locate the
sbd.sbconf
file and open it for editing. Be sure to edit the following settings:-
hbase.master
— Change the val attribute to point to the HBase server and port you want to use. -
hbase.zookeeper.quorum
— Change the val attribute to point to the Zookeeper server you want to use. -
hbase.zookeeper.property.clientPort
— Change the val attribute to point to the Zookeeper server's client port.
-
-
In the Package Explorer view, double-click to open the
DemoSerialize.sbapp
application. -
Make sure the application is the currently active tab in the EventFlow editor, then click the Run button. This opens the SB Test/Debug perspective and starts the application.
-
In the Manual Input view, select the
InAdminCreateTable
input stream.Click
. This causes a tuple to be sent to an HBase Admin operator that in turn causes a table to be created in the database. Now, observe that theAdminCreateTableStatus
output stream receives a tuple with status information indicating the table was created. -
In the Manual Input view, select the
InGenerateRows
input stream.Click
. This causes a list of generated tuples to be sent to an HBase Put operator, which causes data to the inserted into the HBase table. Observe that thePutOut
output stream shows the values inserted. -
In the Manual Input view, select the
InUpdateRow
input stream.Click
. This sends a tuple to an HBase Put operator, which causes the previously sent data's first row to be updated with new values. Observe that theUpdateOut
output stream shows the values updated. -
In the Manual Input view, select the
InGet
input stream.Enter a rowId value of either 1, 2, 3, 4, or 5 into the rowId field.
Click
. This triggers trigger the HBase Get operator to fetch the row updated in the previous step from HBase. Observe that theGetOut
output stream shows the values received. -
In the Manual Input view, select the
InScan
input stream.Click
. This causes an HBase Scan operator to fetch all rows from HBase. Observe in theScanOut
output stream that these row values are received. -
In the Manual Input view, select the
InScanWithFilter
input stream.Enter the following values:
-
In the family field enter:
Family1
-
In the column field, enter:
Column4
-
In the matchSubString field, enter:
1
Click
. This triggers the HBase Scan operator to fetch a filtered set of rows from HBase. Observe that theScanWithFilterOut
output stream shows a single row received. -
-
In the Manual Input view, select the
InDelete
input stream.Click
. This causes the HBase Scan operator to fetch all rows, then feed the rowIds of those rows into the HBase Delete operator to delete those rows from HBase. Observe that theDeleteOut
output stream shows the rows deleted. -
When done, press F9 or click the Stop Running Application button.
The Demo.sbapp
sample includes a number of HBase adapters, which by default connect to the HBase server identified in the project's sbd.sbconf
file. Before running this demo, you must edit this file with the configuration details to connect to your currently running
HBase server. Once connected, the sample automatically creates a table and starts to send and receive data. When the sample
finishes running, the table it created is deleted.
The steps to run the Demo.sbapp
sample in Studio are as follows:
-
Before running, you must configure the sample project with the your site's HBase server information. In the Package Explorer, locate the
sbd.sbconf
file and open it for editing. Be sure to edit the following settings:-
hbase.master
— Change the val attribute to point to the HBase server and port you want to use. -
hbase.zookeeper.quorum
— Change the val attribute to point to the Zookeeper server you want to use. -
hbase.zookeeper.property.clientPort
— Change the val attribute to point to the Zookeeper server's client port.
-
-
In the Package Explorer view, double-click to open the
Demo.sbapp
application. -
Make sure the application is the currently active tab in the EventFlow editor, then click the Run button. This opens the SB Test/Debug perspective and starts the application.
-
Observe the results in the output views.
-
When done, press F9 or click the Stop Running Application button.
In StreamBase Studio, import this sample with the following steps:
-
From the top-level menu, select
→ . -
Type
hbase
to narrow the list of options. -
Select Apache HBase operators from the Data Constructs and Operators category.
-
Click OK.
StreamBase Studio creates a single project for the HBase operator samples in your current Studio workspace.
When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.
Important
Load this sample in StreamBase Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.
Using the workspace copy of the sample avoids permission problems. The default workspace location for this sample is:
studio-workspace
/sample_adapter_embedded_hbase
See Default Installation Directories for the default location of studio-workspace
on your system.
In the default TIBCO StreamBase installation, this sample's files are initially installed in:
streambase-install-dir
/sample/adapter/embedded/hbase
See Default Installation Directories for the default location of studio-workspace
on your system.