A MaxCompute project is the foundational workspace where you store data, run compute tasks, and manage security settings. Create a project before you start any MaxCompute workloads.
You can create a project using either of the following methods:
-
Method 1 (recommended): Create a project in the MaxCompute console -- the simplest path with minimal setup.
-
Method 2: Create a MaxCompute project in the DataWorks console -- best when you also need DataWorks for job scheduling, workflow management, and data governance.
-
Method 3: Create a MaxCompute project by calling an OpenAPI operation.
Create a project in the MaxCompute console
Prerequisites
-
You have activated the MaxCompute service with your Alibaba Cloud account or RAM user.
-
(RAM users only -- Alibaba Cloud account users can skip this step.) Your Alibaba Cloud account must grant you the following permissions: For more information about how to grant permissions, see Manage RAM user permissions.
-
<a href="https://ram.console.alibabacloud.com/policies/detail?policyType=System&policyName=AliyunMaxComputeFullAccess" id="1fe8c4aab98hi">AliyunMaxComputeFullAccess</a>: Grants full permissions to manage MaxCompute. -
<a href="https://ram.console.alibabacloud.com/policies/detail?policyType=System&policyName=AliyunDLFFullAccess" id="41df5141f2gf6">AliyunDLFFullAccess</a>: Grants permissions to manage Data Lake Formation APIs and console pages.
-
Procedure
-
Log on to the and select a region in the top-left corner.
-
In the left-side navigation pane, choose Manage Configurations > Projects.
-
In the Create Project dialog box, configure the following parameters and click Confirm.
Project parameters
|
Parameter |
Required |
Description |
|
Project Type |
Yes |
Automatically generated by the system. |
|
Region |
Yes |
Auto-populated based on the region selected in the upper-left corner. |
|
Project Name (Globally Unique) |
Yes |
Globally unique and immutable after creation. Must start with a letter, contain only letters, digits, and underscores (_), and be 3–28 characters long. |
|
Description |
No |
A custom description of the project. |
|
Billing Method |
Yes |
Select one of the following options: |
|
Default Quota |
Yes |
All compute jobs for which no quota is specified use the Default Quota. |
|
Max Resources Consumed by An SQL Statement |
No |
Maximum cost threshold for a single SQL query. Set this under Pay-as-you-go billing to cap per-query costs. |
|
Data Type Edition |
Yes |
Select one of the following options: |
|
Storage Type |
Yes |
Select one of the following options: |
|
AutoMV |
Yes |
AutoMV creates materialized views based on query patterns to improve computing efficiency and reduce repeated computations. Automatic Materialized View (AutoMV). |
|
Maximum Storage for AutoMV |
No |
Maximum storage for AutoMV. When exceeded, AutoMV stops writing to materialized views. Manage the AutoMV switch and set the storage resource limit. |
|
Storage Encryption |
Yes |
Specifies whether to encrypt the MaxCompute project. |
|
Key |
Yes |
MaxCompute Default Key |
|
Algorithm |
Yes |
AESCTR, AES256, or RC4 |
Full parameter reference: Appendix: Details of project configuration parameters.
Create a MaxCompute project in the DataWorks console
DataWorks provides job scheduling, workflow management, and data governance for MaxCompute.
Prerequisites
-
Your Alibaba Cloud account or RAM user has activated both MaxCompute and DataWorks in the same region.
-
(RAM users only -- Alibaba Cloud account users can skip this step.) Your Alibaba Cloud account must grant you the following permissions: For more information about how to grant permissions, see Manage RAM user permissions.
-
<a href="https://ram.console.alibabacloud.com/policies/detail?policyType=System&policyName=AliyunMaxComputeFullAccess" id="458567cd95o5e">AliyunMaxComputeFullAccess</a>: Grants full permissions to manage MaxCompute. -
<a href="https://ram.console.alibabacloud.com/policies/detail?policyType=System&policyName=AliyunDataWorksFullAccess" id="f88155167aowe">AliyunDataWorksFullAccess</a>: Grants full permissions to manage DataWorks. -
<a href="https://ram.console.alibabacloud.com/policies/detail?policyType=System&policyName=AliyunDLFFullAccess" id="3ff3ae8631e83">AliyunDLFFullAccess</a>: Grants permissions to manage Data Lake Formation APIs and console pages.
-
Step 1: Create a DataWorks workspace
For more information, see Create a workspace.
-
Go to the DataWorks workspace list and confirm that the correct region is selected at the top of the page. The region cannot be changed after the workspace is created. Click Create Workspace.
-
On the creation page, set the following key parameters:
-
Workspace Name: Enter a unique name that follows your team's naming conventions.
-
Isolate Development and Production Environments: Enable to create a standard mode workspace with isolated development and production environments.
-
Use the new Data Studio: Enable (recommended).
If this option is not visible, it is enabled by default.
-
-
Click Create Workspace.
Step 2: Associate a MaxCompute compute resource
-
Log on to the DataWorks console and select a region in the upper-left corner.
-
In the Associate MaxCompute Compute Resource dialog box, configure the parameters. For MaxCompute Project, select an existing project or click New.
-
In the Create Project dialog box, configure the parameters and click Confirm. Parameters are the same as in the Project parameters section above.
Project permissions
Permissions depend on who creates the project:
-
Alibaba Cloud account: The account becomes the project owner with full permissions. No other user has access by default.
-
RAM user: When a RAM user creates a project:
-
Both the RAM user and the parent Alibaba Cloud account become project owners with full permissions. No other user has access by default.
-
The RAM user is automatically granted the
Super_Administratorrole.
-
What's next
-
Set up your development environment: Install the tools you need to connect to your project. See Select a connection tool.
-
Add team members: Invite RAM users to your project and assign roles. See Grant permissions to other users.
-
Manage permissions: Learn about the permission differences between Alibaba Cloud accounts and RAM users. See 用户与权限.
-
Delete a project: Remove a project you no longer need. Delete MaxCompute tables and projects.