Assigning Nodes to Data Groups Using User Labels
Tier: Scale
Offering: On-Prem
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
buildorqueryvalues.
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
buildorquery.
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=queryto 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.