Assigning Nodes to Data Groups Using User Labels
Overview
The User Label feature allows you to assign nodes to Data Groups using custom labels. This feature is available only on cluster installations. By adding a persistent label to a node, you can define its role within a Data Group as either a "build node" or a "query node". Nodes cannot have both roles simultaneously.
Prerequisites
-
A Sisense cluster installation.
-
Kubernetes (k8s) compliant label names.
-
Persistent labels that remain after node rotation.
-
Nodes labeled with either
build
orquery
values.
Assigning Nodes to Data Groups Using User Labels
Adding a Label to a Node
-
Assign a label to the node using your preferred method (e.g., Kubernetes CLI, node management tools).
-
Ensure the label name follows Kubernetes naming conventions.
-
Set the label’s value to either
build
orquery
.
Example:
-
To assign a node as a build node, add the label
user_label_2=build
. -
To assign a node as a query node, add the label
user_label_2=query
.
Configuring the Data Group
-
Open the Edit Data Group window.
-
Click More to display more settings.
-
Add the name of the label (e.g.,
user_label_2
) in the designated field. -
Click Apply to apply and save the changes.
After a few minutes, the node will be assigned the appropriate role within the Data Group.
Combining User Labels with Drop-down Node Selection
The User Label feature and the drop-down node selection can be used within the same Data Group, but it is not recommended.
-
If a node is manually added via the Data Group drop-down while a user label is assigned to the group, Sisense will automatically apply the user label to the selected node.
-
If Sisense does not have permission to assign persistent labels, the assignment may be temporary or fail entirely.
Example Scenario:
-
A Data Group is configured with the user label
user_label_2
. -
A query node is manually added via the drop-down menu.
-
Sisense assigns
user_label_2=query
to the node. -
The node is now associated with the Data Group based on this label.
Note:
-
Label updates take several minutes to reflect in the Data Group.
-
Nodes can only be assigned one of two roles: build or query.
-
In Sisense-managed cloud (EKS) installations, labels should be created using EKS node group management.