The data catalog provides a unified interface for managing MaxCompute metadata, including tables, views, external tables, resources, and functions.
Limits
To view MaxCompute data in the data catalog with a RAM user or RAM role, obtain the required MaxCompute permissions first. If the Layer 3 model is enabled for the data source or project, also grant the RAM user or role permission to view schema metadata.
If a MaxCompute project contains multiple schemas, grant metadata permissions for all schemas to view the complete schema list on the project details page.
Grant permissions to a RAM user:
GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER RAM$<Alibaba_Cloud_Account_Name>:<RAM_User_Name>;Grant permissions to a RAM role:
GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER `RAM$<Alibaba_Cloud_Account_Name>:role/<RAM_Role_Name>`;After you enable the schema feature for a MaxCompute project, you can manage schemas and manage object tables.
Access the MaxCompute data catalog
Go to the Workspaces page in the DataWorks console. In the top navigation bar, select a desired region. Find the desired workspace and choose in the Actions column.
In the left navigation pane, click the
icon. In the DATA CATALOG tree, click MaxCompute.
Create a MaxCompute data catalog
Add existing MaxCompute projects to the data catalog.
Click the icon next to the MaxCompute data catalog.
Add a MaxCompute project using one of the following methods.
Target source
Method
A MaxCompute data source created in the current workspace
On the DataWorks Data Source tab, find the target data source and click Add. To add multiple data sources at once, select them and click Batch Add.
A MaxCompute project created in the MaxCompute console
On the MaxCompute-Project tab, find the target project and click Add. To add multiple projects at once, select them and click Batch Add. You can also click Create Project to manually add a new MaxCompute project.
Internal project settings: MaxCompute project configuration parameters. Foreign project operations: MaxCompute data lakehouse.
ImportantMetadata synchronization takes 10–20 seconds. After creating a project, wait a moment and then manually refresh the list to view the latest data.
Manage a MaxCompute data catalog
Add and manage schemas, tables, views, and other data objects in the MaxCompute data catalog.
MaxCompute object | View | Create |
Schema | ||
Table | ||
Extenal Table | ||
Object Table | ||
View | ||
Materialized View | ||
Delta Live Materialized View | ||
Resource | ||
Function |
The schema level is displayed only after you enable the schema feature for MaxCompute. Schema operations.
Manage schemas
Create a schema.
Click the
icon to the right of the MaxCompute project. In the Create Schema dialog box, enter a name and press Enter.View a schema.
After adding a schema to a MaxCompute project, click the
icon to the left of the project to view it.Delete a schema.
If you no longer need a schema, right-click it and select Delete.
ImportantThis operation cannot be undone. Proceed with caution.
Delete all data objects within a schema (such as tables and views) before deleting the schema.
Manage tables
Manage external tables
Manage object tables
Manage object tables only in MaxCompute projects with the schema feature enabled.
Manage views
Manage materialized views
Manage delta live materialized views
Manage resource data objects
View and remove a MaxCompute data catalog
View or remove a MaxCompute data catalog when it is no longer needed.
View a project.
After adding a project to the data catalog, click the
icon to the left of the catalog to view it.Hover over the MaxCompute project to view its storage usage and related information.
Remove a project.
To remove a MaxCompute project, right-click it and select Remove.