All Products
Search
Document Center

DataWorks:Data classification and grading

Last Updated:Jul 11, 2026

Data classification and grading is a fundamental prerequisite for data security. This feature identifies and categorizes sensitive data types and their security levels. It allows you to detect sensitive information within your organization's data assets and grade it by sensitivity. This process helps you understand the sensitive content in your data assets and lays the foundation for subsequent data management and protection. A clear inventory of sensitive data enables you to manage access permissions, apply data masking, and audit data access, which enhances overall data security.

Introduction

Data classification and grading is the foundation for all data protection capabilities in DataWorks Security Center. It helps you automatically discover and tag sensitive data across various data sources and answers the key questions: "What sensitive data do I have?" and "Where is it?"

  1. Step 1: Configure data classification and grading rules

    First, define standards for identifying sensitive data. This includes:

    • Data classification: Assign sensitivity labels to your data, such as S1 (Public) and S2 (Internal).

    • Data classification: Group data into business categories, such as Personal Information and Financial Data.

    • Data Type: Define specific kinds of sensitive data, such as Phone Number or ID Card Number. When you create a data type, you must assign it to a Data classification and specify a data grading.

    • Identification rules: This is the core of automated discovery. You can set powerful identification rules for each data type. The following methods are supported:

      • Identification by content: Match data content by using a regular expression or a built-in algorithm, such as ID card validation.

      • Identification by field name/comment: Match a field's name or comment by using a regular expression.

  2. Step 2: Create an identification task

    Create an identification task to apply your defined rules and scan specified data sources like MaxCompute and Hologres. Tasks can be run immediately as a one-time scan or scheduled as a periodic (daily, weekly, or monthly) scan for continuous monitoring.

  3. Step 3: Generate identification results

    After a task is complete, the system generates a detailed list of identification results, which serves as your sensitive data asset catalog. For a periodic task, the results are available on the next day (T+1). This catalog lists which field in each table is identified as a specific type of sensitive data. If you find discrepancies, you can manually revise the results to ensure the catalog's accuracy.

This identified and confirmed catalog of sensitive data assets serves as the precise input for all downstream security policies, such as data masking, risk monitoring, and access auditing.

Limitations

  • Applicable users: This feature is available in DataWorks Standard, Professional, and Enterprise editions for users with the new data security features enabled in Security Center.

  • Supported regions: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Singapore, and Indonesia (Jakarta).

  • Supported compute engines: MaxCompute and Hologres.

Prerequisites

  • The Alibaba Cloud account or a RAM user that you use must meet one of the following conditions:

    • The Alibaba Cloud account or RAM user is attached with the AliyunDataWorksFullAccess policy.

    • The Alibaba Cloud account or RAM user is assigned the tenant security administrator role of DataWorks.

    • The Alibaba Cloud account or RAM user is assigned the tenant administrator role of DataWorks.

  • You have completed the New user guide. If you have not completed the initial setup, accessing the Data Classification and Grading page automatically redirects you to the New user guide page. Complete the initialization first, and then return to this page.

Feature page

  1. Log on to the DataWorks console. In the target region, click Data Governance > Security Center in the left-side navigation pane. On the page that appears, click Go to Security Center.

  2. In the left-side navigation pane, choose Sensitive Data Protection > Data classification grading.

Configuration Data classification

  1. Go to the Data Classification page.

    1. On the Data Classification and Grading page, click the Data classification tab.

    2. The Data classification tree is displayed on the left, and the Data Type that belong to the selected Data classification are on the right. Click a branch in the classification tree to view its associated Data Type. You can then View, Edit, or Delete a data type from the Actions column.

  2. Add a data type.

    Important

    The system provides built-in templates for Data classification and Data Type. You can edit them as needed.

    1. On the Data classification tab, click New Data Type in the upper-left corner.

      Configure the following parameters:

      Parameter

      Description

      Data Type

      Enter a name for the data type. The name must be globally unique. DataWorks tags the data (fields) that meet the identification rule with this data type.

      Data classification

      Specify the data classification to which the data type belongs.

      Data Level

      Specify the security level for this data type. DataWorks tags the data (fields) that meet the identification rule with this data grading.

      Identification rules

      When an identification rule is met, DataWorks marks the data (field) as identified.

      Three types of identification rules are supported: Data Content Identification, Field Name Identification, and Field Annotation Identification. Each rule type must be configured and validated independently.

      • Satisfy any rule: The condition is met if any of the three rules is matched.

      • Also meet the following rules: The condition is met only if all three rules are matched.

      Data Type Description

      Enter a custom description for the data type based on your business scenario.

    2. After completing the configuration, choose to apply the rule immediately or only save it.

      1. Effective immediately: Saves the configuration and applies the identification rule immediately. When an identification task runs, it tags data (fields) that match the rule with this data type.

      2. Save Only: Saves the configuration, but the identification rule does not take effect. When an identification task runs, it will not tag data with this data type.

  3. Delete a data type: You can delete only custom data types, not built-in ones.

    Important

    Deleting a Data Type has the following effects:

    • Historical Identification results are deleted, and new Identify Tasks will no longer identify this data type.

    • Masking rules for this Data Type are removed from Desensitization strategy policies.

    • Access records for sensitive data of this Data Type are deleted.

    • Related rules for this type are deleted from Security risk identification rules.

    The confirmation dialog box that appears when you delete a data type provides a Reset MaxCompute field Label option. You can choose whether to also reset the Label of the corresponding fields in MaxCompute to a specific level. The default value is 0, which clears the Label from the field. For batch deletion, the default value is the highest security level number among the selected items. This capability is independent of the Write to MaxCompute Label switch. Even when the switch is off, you can still choose whether to reset the MaxCompute Label during deletion.

Configuration data grading

DataWorks supports up to 10 grading levels. You can modify the description for each level based on your business needs. A higher number indicates a higher security level.

  1. Go to the Data Grading page: On the Data Classification and Grading page, click the Data classification tab.

  2. Edit data grading: Click Edit in the upper-left corner to modify the Detailed description for different data grading levels.

  3. Save data grading: After modifying the detailed descriptions, click Save in the upper-left corner.

Write to MaxCompute Label (MC Label Sync)

The upper part of the Data Grading tab provides the Write to MaxCompute Label capability. This feature synchronizes the data security levels identified in DataWorks to the Labels of the corresponding fields in MaxCompute, thereby integrating the data security control chain between DataWorks and MaxCompute.

Important

This capability applies only to the MaxCompute engine. Fields of other engine types are not synchronized. If Label Security is enabled for a MaxCompute project, Label changes directly affect access control permissions for data in that project. Operate with caution.

  • Write to MaxCompute Label switch: When enabled, DataWorks automatically writes a field's security level to the Label of the corresponding field in MaxCompute after an identification task completes or a user revises an identification result. When disabled, DataWorks does not write Labels to MaxCompute.

  • Sync Now: Click this button to trigger a one-time full Label synchronization task that writes all current identification results to MaxCompute at once. This button is disabled when the switch is off or when a synchronization task is already in progress. Clicking it opens a confirmation dialog box that explicitly warns you that if Label Security is enabled for MaxCompute, this synchronization affects data access control permissions. Synchronization proceeds only after you confirm.

  • Last synchronization time: The card's right side displays the execution time of the last Label synchronization task and the number of fields synchronized. If no synchronization has ever been performed, No records is displayed. During synchronization, the progress refreshes automatically. You do not need to refresh the page manually.

Manage data Identify Tasks

  1. Go to the Identification Tasks page: On the Data Classification and Grading page, click the Identify Tasks tab.

  2. Create an identification task.

    1. On the Identify Tasks tab, click New Task in the upper-left corner.

      Configure the following parameters:

      Parameter

      Description

      Task Name

      A custom name for the data classification and grading identification task.

      Data Source Type

      Select a data source type. MaxCompute and Hologres are supported.

      Task Type

      • Single Task: Runs only once and is not repeated.

      • Periodic Tasks: Runs repeatedly at a scheduled time.

      Important
      • A periodic task scans only new data (fields). You can use a one-time task to re-evaluate historical identification results.

      • DataWorks supports only one periodic task.

      Identification range

      Specify the data scope for the identification task. The minimum scope is a data table.

      If you set Data Source Type to MaxCompute, you can select a project or a data table.

      If you set Data Source Type to Hologres, you can select a database or a data table. You must select an instance that has been bound as a Data source within a specific Workspace, and then select a Resource Group to verify network connectivity.

      Sampling quantity

      The amount of data to sample from each field when the identification task runs.

      A larger sample size improves identification accuracy but increases task duration. The maximum value is 200.

      Data sampling using

      During an identification task, DataWorks uses the specified account to access data. If the specified account lacks the required permissions, sampling and identification fail.

      Important

      Ensure that the account you specify has permission to access table names, field names, field comments, and field data within the specified identification scope.

    2. After configuring the parameters, click Confirm to save the task.

  3. Edit an identification task.

    To reconfigure a periodic identification task, on the Identify Tasks tab, click Edit in the Operation column for the target task.

    Important

    One-time tasks cannot be edited. You must delete the task and create a new one.

  4. View an identification task.

    1. On the Identify Tasks tab, find the task that you want to view and click View in the Operation column to open the task details page.

    2. On the task details page, click the number next to Running records to view the Start execution time and End execution time for each run.

  5. Delete identification tasks.

    On the Identify Tasks tab, you can delete tasks individually or in batches.

    • Delete a single task:

      Find the task you want to delete and click Delete in the Operation column.

    • Delete tasks in batches:

      Select the checkboxes of the tasks you want to delete and click Batch Delete in the lower-left corner.

    Important
    • Deleting an identification task does not stop a running task.

    • After a periodic task is deleted, it will no longer run.

    • The identification results from previous runs of a deleted task are retained.

Classification and grading results

Important

Data identification retrieves the latest table schema information daily after midnight. Therefore, new fields, tables, or databases are classified and graded on the following day.

  1. On the Data Classification and Grading page, click the Identification results tab. On this tab, you can view the identification results for table fields after a task has run.

  2. View data classification and grading results.

    On the Identification Results page, you can view the classification and grading information for your data assets. The following table describes the information.

    Parameter

    Description

    Data Source Type

    The data engine to which the data asset belongs.

    Instance/Project/Database

    The name of the instance, project, or database to which the data asset belongs.

    Table

    The name of the data table to which the data asset belongs.

    Field

    The name of the field in the data asset.

    Data classification

    The data classification directory corresponding to the data type, or the directory revised by a user. The path is displayed in the Level-1 directory/Level-2 directory/... format.

    Data Type

    The data type determined by the identification task, or the data type revised by a user.

    Data classification

    The security level corresponding to the data type, or the level revised by a user.

    Judgment mode

    System identification: An identification task determined the result.

    Revision: A user manually revised the result.

    Update time

    The last time the system determined or a user revised the result.

  3. Revise data classification and grading results.

    On the Identification Results page, you can delete or revise the results from the Actions column. You can revise the identification result for a data asset in one of the following two ways:

    • Rescan to overwrite: Create a new one-time task to re-evaluate the identification results for assets within a specific scope.

    • Revise manually: Manually revise the identification result for a data asset. Perform the following steps:

      1. On the Identification Results tab, use the search bar to filter for the data asset that you want to modify, and then click Revision in the Actions column.

      2. In the dialog box that appears, select a new data type to apply your changes.

    In addition to revising a single record, the identification results list supports the following batch and manual operations:

    • Batch Revise: Select multiple identification results and click the Batch Revise button at the bottom of the list to update the data classification, data grading, or data type of the selected records in one operation.

    • Batch Delete: Select multiple identification results and click the Batch Delete button at the bottom of the list to delete the selected records in batch. The Reset MaxCompute field Label option also appears during deletion. The default value is the highest security level number among the selected items.

    • Manually Add Identification Result: On the toolbar of the Identification results tab, click the Add button. In the dialog box, select the engine type, catalog (project/instance/cluster/Catalog), database/Schema, data table, field, and data type in sequence to directly create an identification result with the determination method set to Revision. This capability is suitable for fields that automatic identification tasks did not match but whose sensitivity you have confirmed.

Manage Unrecognized Fields

The Identification results tab provides two sub-tabs, Recognized and Unrecognized. The Recognized sub-tab displays the fields marked as sensitive by an automatic identification task or after a user revision. The Unrecognized sub-tab displays fields within the current tenant scope that have not been matched by any identification rule. The count is approximately equal to the total metadata fields minus the sensitive fields. This tab helps you fill gaps and perform batch manual tagging.

Note

The Unrecognized sub-tab retrieves the field list only after you select an engine type. The list is empty if no engine type is selected. This design avoids page performance issues caused by returning all fields at once.

The toolbar of the Unrecognized sub-tab provides the following three actions:

  • Import: Supports uploading only .csv files. We recommend that you first click Export to retrieve a list of unrecognized fields (in xls format) based on the current filter as a template. Fill in the target data type for each field in the xls file, save it as csv, and then upload the file. The file is uploaded to OSS, and manual tagging is executed asynchronously in the background. You can view the progress and results in the Task List.

  • Export: Exports the list of unrecognized fields (in xls format, which can be saved locally as csv to serve as an import template) based on the current filter conditions. The Export button is disabled when the current filter returns no data.

  • Task List: Click to open a drawer panel from the right that displays the submission time, task status, and result file download links for previous Import and Export tasks in a list format. If an import task has failed rows, you can view the error list (with row numbers indicating the cause of each error) in the drawer. The task statuses automatically refresh through polling while the drawer is open. You do not need to refresh the page manually.