Skip to main content
Version: 8.3.0

Permission Management

Overview

Metric Center permissions are jointly determined by three types of permissions:

Permission TypeFunction
Metric Center Role PermissionControl whether users have functional operation capabilities such as view, edit, authorize, and export.
Topic PermissionControl whether users can view and manage specified metric topics and their underlying folders.
Resource PermissionControl whether users can view metric data, edit metrics, manage metric permissions, etc. Resource permissions are divided into folder batch authorization and single metric authorization.

When users access or operate metrics, they need to simultaneously meet the corresponding topic role, metric role, and Metric Center role operation permissions.

Metric Center Role Permission

Metric Center role permissions are configured in "Management Center > User Management > Role", used to control the Metric Center functions that users can use.

Common operation permissions include:

PermissionDescription
View PermissionView Metric Center related content.
Edit PermissionCreate, edit, delete, move, online/offline, or restore metric versions.
Authorize PermissionAdd or modify the owner and user of topics and metrics.
Export PermissionExport metrics.

Topic Permission

Topic permissions are used to control whether users can view and manage specified metric topics and their underlying folders.

Set Topic Permission

  1. On the metric topic page, click the "More" button in the upper right corner of the topic and select "Permission Management".

  2. Select the permission type "Owner" or "User", search and select the user or user group that needs to be authorized.

    | Topic Role | Role Description |

    | --- | --- |

    | Owner | The creator is the owner in the initial state, and multiple owners are supported. |

    | User | Multiple users are supported. |

  3. Click "Add" to complete the authorization.

Topic Operation Permission

The permissions required for operations on topics are shown in the table below. Users need to simultaneously meet the conditions of topic role and Metric Center role operation permission to perform the corresponding operations.

Topic Operation PermissionRequired Topic RoleRequired Metric Center Role Operation Permission
View TopicTopic Owner/Topic UserView Permission
New TopicNot consideredEdit Permission
Edit, Delete TopicTopic OwnerEdit Permission
Add, Modify Topic Owner/UserTopic OwnerAuthorize Permission
View Folders under TopicTopic Owner/Topic UserView Permission
New, Edit, Rename, Delete, Move Folders under TopicTopic OwnerEdit Permission
View Metrics under Topic (only metric definitions)Topic Owner/Topic UserView Permission

Resource Permission

Resource permissions are used to control operations such as viewing data, editing, and authorizing of metric resources, and are divided into folder batch authorization and single metric authorization.

Folder Batch Authorization

Folders themselves are not managed as independent resources. Users with topic permissions can view or manage folders under the topic; the view, edit, and authorization permissions of metrics under folders are determined by resource permissions.

Configure batch authorization on folders to grant owner or user to metric resources under the folder in batch. For details about batch authorization, see: Batch Authorization Based on Folders

  1. In the metric topic directory, click the "More" button on the right side of the folder and select "Batch Authorization".

  2. Add owner or user in the batch authorization page.

  3. Click "OK" to complete the authorization.

Single Metric Authorization

Single metric authorization is used to control operations such as viewing data, editing, and authorizing of a single metric. Metric permission management has the following two entries.

Entry 1: "More > Permission Management" on the right side of the metric list page

Entry 2: "More > Permission Management" on the right side of the metric detail page

Click "Permission Management" to add the metric owner or user, supporting both single user addition and batch paste user methods.

  • Owner: The creator is the owner in the initial state, and multiple owners are supported.
  • User: Multiple users are supported.

Inherit Parent

Both folders and metrics support configuring whether to "Inherit Parent". After enabling, the current folder or metric will inherit the batch authorization list of the nearest parent folder.

The effective rules of batch authorization are as follows:

  • After the folder enables "Inherit Parent", it will inherit the batch authorization list of the nearest parent folder.
  • After the metric enables "Inherit Parent", it will inherit the batch authorization list of the nearest parent folder.
  • After the metric turns off "Inherit Parent", it will not be affected by the folder batch authorization, and will only be controlled by its own independent authorization and topic permissions.

Example

Assuming the metric topic structure is as follows:

Sales Topic
└── East China Folder
└── Sales Amount Metric
  • If batch authorization is granted to User A on the "East China Folder", and "Sales Amount Metric" enables "Inherit Parent", User A can view the metric.
  • If "Sales Amount Metric" turns off "Inherit Parent", even if "East China Folder" is authorized to User A, User A cannot view the metric through folder batch authorization.

Final Permission Judgment Rules

The permissions required for operations on metrics are shown in the table below. Users need to simultaneously meet the conditions of topic role, metric role, and Metric Center role operation permission to perform the corresponding operations.

Operations That Can Be PerformedRequired Topic RoleRequired Metric RoleRequired Metric Center Role Operation Permission
View Metric DefinitionTopic Owner/Topic UserNot consideredView Permission
View Metric Data, LineageTopic Owner/Topic UserMetric Owner/Metric UserView Permission
Use Metric to Build New MetricsTopic Owner/Topic UserMetric Owner/Metric UserEdit Permission
Use Metric to Build Data Analysis - Metric Analysis CardTopic Owner/Topic UserMetric Owner/Metric UserView Permission
New MetricTopic Owner/Topic UserNot consideredEdit Permission
Edit Delete, Move, Take Metric Offline, Restore VersionTopic Owner/Topic UserMetric OwnerEdit Permission
Add, Modify Metric Owner/UserTopic Owner/Topic UserMetric OwnerAuthorize Permission
Add, Modify Metric OwnerTopic Owner/Topic UserMetric OwnerEdit Permission
Save Metric AsTopic Owner/Topic UserMetric Owner/Metric UserEdit Permission

Special case: Composite metric C is calculated from metric A and metric B. When the user has permission for metric C but not for metric A and metric B, they can still view and use metric C normally.

Data Permission

When creating or editing metrics, you can only select datasets for which the current user has permission.

If the selected dataset has row permissions configured, the calculation result of the metric is calculated according to the row permissions; if the selected dataset has column permissions configured, when a column without permission is selected, the metric calculation result is regarded as null.

Common Scenarios

Can see topic, but cannot see metric data

When users have the role of topic owner or topic user, they can view the topic and metric definitions. If users do not have the owner or user role of the metric, they cannot view the metric data and lineage.

Folder batch authorization not effective

Check whether the metric has enabled "Inherit Parent". If the metric turns off "Inherit Parent", the folder batch authorization will not affect the metric.

Can view composite metric, but no underlying metric permission

Composite metrics are controlled by their own permissions. When users have composite metric permissions, they can view and use the composite metric even if they do not have permissions for the underlying atomic metrics or composite metrics.

Cannot batch export atomic metrics

Batch export of atomic metrics needs to simultaneously meet the following conditions:

  • Users have edit permissions for the corresponding atomic metric.
  • The role to which the user belongs has enabled the "Export" permission of the Metric Center.