Operation checks

Updated at:

DataWorks supports process management at key stages of data development, allowing you to enforce validation checks that match your business requirements.

Limitations

Only DataWorks Enterprise Edition and later versions support this feature.

How it works

DataWorks workspaces operate in two modes: standard mode and basic mode. Each mode follows a different node development process, as shown in the following diagrams.

  • Node development workflow in a standard mode workspace

    image
  • Node development workflow in a basic mode workspace

    image

You can enforce process management at key stages, such as before node debugging, deploying to the development environment, or deploying to the production environment.

Stage

Check example

Before a node is run

In the Debugging Configurations panel on the right, under DataWorks Configuration, set the resource group to Serverless_Resource_Group and the computing quota to Default post-paid Quota. In the editor, enter the SQL statement SELECT * FROM test.ods_movie_basic_info WHERE ds=20250126; and click the Run button in the toolbar. The log at the bottom displays "Checking...", "Check passed", and "Submit Succeeded" in sequence, and the run status becomes Succeeded (using MaxCompute Short-running Query Acceleration mode). In the Operation Checks panel on the left, the status of the corresponding node record is displayed as Passed.

Before a node is deployed to the development environment

When you deploy a node, the system runs the Development Checker to review the SQL code. Click the Development Checker step in the deployment workflow. The Operation Checks panel on the left displays the check record and its status. Click the record to open the Check Details panel, where you can view the results of each check item, such as Full Table Scan Check and High-Cost SQL Check. For check items with a Warning status, you can click Mark as Passed to manually approve them.

Before a node is deployed to the production environment

In the Production Checker step of the deployment pipeline, you can click View Details or Initiate Code Review. The left panel lists the SQL records to be deployed, such as testSQL. Click a record to open the corresponding Check Details panel on the right. After you confirm that all checks have passed, you can proceed with the deployment.

Data Asset Governance and Open Platform let you add validation checks at key stages of the data development process.

Feature module

Pre-run check

Dev pre-deployment check

Prod pre-deployment check

Process management

Data Asset Governance

image

image

image

Data Asset Governance provides multiple built-in check items that you can enable as needed. When enabled, the corresponding operation triggers the built-in validation logic, and the process proceeds only after all checks pass.

Open Platform

image

image

image

If the built-in check items do not meet your process management requirements, use Open Platform to develop your own validation programs for specific events and integrate them into the data development workflow.

The following sections use the standard mode workspace workflow as an example to describe these process management capabilities.

Built-in checks: Data Asset Governance

Data Asset Governance provides multiple built-in check items that you can enable as needed. When you perform a relevant operation, the built-in validation logic runs automatically. The process proceeds only after all checks pass.

In the left-side navigation pane of Data Asset Governance, choose Governance Settings > Check Items to go to the Check Item Configuration page. Click the R&D tab. In the Effective Checkpoint column, identify the trigger point for a check item. In the Enable column, toggle the switch to enable or disable the corresponding check item.

  • For node debugging: Enable check items where the Effective Checkpoint is Pre-event for Code Running.

  • For node deployment to the development environment: Enable check items where the Effective Checkpoint is Pre-event for Node Commit.

  • For node deployment to the production environment: Enable check items where the Effective Checkpoint is Pre-event for Node Deployment.

Configuration

Enable check items in Data Asset Governance and specify the workspace where they take effect. For general instructions, see Configure governance items.

Customize validation logic: Open Platform

If the built-in check items do not meet your requirements, use Open Platform to develop custom validation programs for specific events and integrate them into the data development workflow.

Note

OpenEvent lets you subscribe to event messages for user operations in Data Studio. After receiving an event message, Extensions allows you to create a custom validation and approval program. You can then send the approval results back to DataWorks through an OpenAPI callback. For more information, see OpenEvent overview and Extensions overview.

When you use Open Platform to subscribe to events and validate key operations in Data Studio, performing an operation triggers the validation process. The following flowchart shows how a pre-run check works.

image

Configuration

Subscribe to Data Studio events in Open Platform, develop an extension to handle these events, publish the extension to DataWorks, and enable it in the desired workspace.

  • For node debugging: Subscribe to and process run-related events, such as pre-event for file running.

  • For node deployment to the development environment: Subscribe to and process commit-related events, such as Pre-event for Node Commit and pre-event for table commit.

  • For node deployment to the production environment: Subscribe to and process deployment-related events, such as Pre-event for Node Deployment and pre-event for table deployment.

For a list of event types supported by Open Platform, see Extensions overview.