The odpscmd client allows you to access MaxCompute projects and features. This topic describes how to install, configure, and run the odpscmd client.


  • The odpscmd client is developed based on the Java language. Make sure that your device has Java 8 or a later version of Java.
  • A MaxCompute project is created. For more information, see Create a project.


Install the odpscmd client
  1. Download the installation package of the odpscmd client.
  2. Decompress the installation package to obtain the bin, conf, lib, and plugins folders.
Configure the odpscmd client
  1. Edit the odps_config.ini file in the conf folder to configure the odpscmd client. The following configurations show an example:
    # Specify the name of the project that you want to access.
    # Specify the AccessKey ID and AccessKey secret of your Alibaba Cloud account. To obtain the AccessKey ID and AccessKey secret, log on to the Alibaba Cloud Management Console and view the AccessKey pair on the AccessKey Management page. Remove the angle brackets <> when you enter the AccessKey ID and AccessKey secret.
    # Specify the endpoint of MaxCompute. The endpoint is determined based on the region and network environment of your MaxCompute project. For more information, see Configure endpoints.
    # Specify the Logview URL that the odpscmd client returns after a job is run. After you access the Logview URL, you can view detailed operational logs of the job.
    # Specify whether to enable HTTPS access.
    # Specify the maximum size of input data. Unit: GB.
    # Specify the URL for updating the odpscmd client.
    # Specify whether to download SQL running results by using InstanceTunnel.
    # Specify the maximum number of records in the SQL running results downloaded by using InstanceTunnel.
    # Specify the endpoint of MaxCompute Tunnel. The endpoint is determined based on the region and network environment of your MaxCompute project. For more information, see Configure endpoints.
    • We recommend that you set end_point and tunnel_endpoint based on the region you selected when you created the project. Otherwise, errors such as access failure may be thrown. For more information, see Configure endpoints.
    • If your MaxCompute project is created when you create a DataWorks workspace in standard mode in the DataWorks console, pay attention to the name difference between the projects in the production environment and the development environment when you specify project_name. The name of a project in the development environment ends with the _dev suffix. For more information, see Basic mode and standard mode.
    • A number sign (#) is used to comment out a line in the odps_config.ini file. Two consecutive minus signs (--) are used to comment out a command line on the odpscmd client.
    • MaxCompute is accessible over the Internet, the classic network, and a virtual private cloud (VPC). Your download costs are subject to the connection method that you use. If you do not specify the endpoint of MaxCompute Tunnel, MaxCompute Tunnel may be automatically routed to the Internet and you may be charged for downloads over the Internet. For more information, see Configure endpoints.
Run the odpscmd client
  1. Run ./bin/odpscmd in Linux or ./bin/odpscmd.bat in Windows. If the following interface appears, the odpscmd client runs properly.Run the odpscmd client.png

What to do next

For more information about how to use the odpscmd client, see Client.
  • We recommend that you use MaxCompute Studio for big data development. MaxCompute Studio integrates with Java. You can use MaxCompute Studio to develop and run MaxCompute SQL scripts, manage data, and analyze logs in a visualized manner. MaxCompute Studio also allows you to develop Java programs, such as user defined functions (UDFs) and MapReduce programs. In addition, the odpscmd client is integrated in MaxCompute Studio.
  • To use MaxCompute in the DataWorks console, create a workspace and click Data Analytics in the Actions column of the workspace on the Workspaces page. For more information, see What is DataWorks? and Create a workspace.
  • You can add workspace members and grant permissions to them in the DataWorks console. For more information, see Add workspace members.