All Products
Document Center

DataWorks:Migrate JSON-formatted data from MongoDB to MaxCompute

Last Updated:Aug 21, 2023

This topic describes how to use the Data Integration service of DataWorks to migrate JSON-formatted fields from MongoDB to MaxCompute.


  • MaxCompute and DataWorks are activated. For more information, see Activate MaxCompute and DataWorks.

  • A workflow is created in DataWorks. In this example, a workflow is created in a workspace that is in basic mode. For more information, see Create a workflow.

Prepare test data in MongoDB

  1. Prepare an account.

    Create a user in your database to prepare information for creating a connection in DataWorks. In this example, run the following command:


    In this example, a user named bookuser is created and the user password is 123456.

  2. Prepare data.

    Upload the data to the MongoDB database. In this example, an ApsaraDB for MongoDB instance in a virtual private cloud (VPC) is used. You must apply for a public endpoint for the ApsaraDB for MongoDB instance to communicate with the default resource group of DataWorks. The following test data is uploaded:

        "store": {
            "book": [
                    "category": "reference",
                    "author": "Nigel Rees",
                    "title": "Sayings of the Century",
                    "price": 8.95
                    "category": "fiction",
                    "author": "Evelyn Waugh",
                    "title": "Sword of Honour",
                    "price": 12.99
                    "category": "fiction",
                    "author": "J. R. R. Tolkien",
                    "title": "The Lord of the Rings",
                    "isbn": "0-395-19395-8",
                    "price": 22.99
            "bicycle": {
                "color": "red",
                "price": 19.95
            "expensive": 10
  3. Log on to the MongoDB database in the Data Management (DMS) console. In this example, the name of the database is admin, and the name of the collection is userlog. You can run the following command to view the uploaded data.


Migrate JSON-formatted data from MongoDB to MaxCompute by using DataWorks

  1. Login DataWorks console.

  2. Create a table in DataWorks. This table is used to store the data that is migrated from MongoDB.

    1. Right-click a created workflow, Select new > MaxCompute > table.

    2. In the Create Table dialog box, select an engine type for Engine Type and enter a table name in the Name field.

    3. On the table editing page, click DDL Statement.

    4. In the DDL dialog box, enter the following CREATE TABLE statement and click Generate Table Schema:

      create table mqdata (mqdata string);
    5. Click Commit to Production Environment.

  3. Create a MongoDB connection. For more information, see Add a MongoDB data source.

  4. Create a batch synchronization node.

    1. Go to the data analytics page. Right-click the specified workflow and choose new > data integration > offline synchronization.

    2. In the Create Node dialog box, enter a node name in the Name field and click Confirm.

    3. In the top navigation bar, choose Conversion scripticon.

    4. In script mode, click **icon.

    5. In import Template dialog box SOURCE type, data source, target type and data source, and click confirm.

    6. Enter the following script:

          "type": "job",
          "steps": [
              "stepType": "mongodb",
              "parameter": {
                  "datasource": "mongodb_userlog", // The name of the connection. 
                  "column": [
                      "name": "store.bicycle.color", // The path of the JSON-formatted field. In this example, the color field is extracted. 
                      "type": "document.String" // For fields other than top-level fields, the data type of such a field is the type that is finally obtained. If the specified JSON-formatted field is a top-level field, such as the expensive field in this example, enter string. 
                  "collectionName": "userlog" // The name of the collection. 
              "name": "Reader",
              "category": "reader"
                  "stepType": "odps",
                  "parameter": {
                  "partition": "",
                  "isCompress": false,
                  "truncate": true,
                  "datasource": "odps_first",
                  "column": [
                  "mqdata" // The name of the column in the MaxCompute table. 
                  "emptyAsNull": false,
                  "table": "mqdata"
                  "name": "Writer",
                  "category": "writer"
                  "version": "2.0",
                  "order": {
                  "hops": [
                  "from": "Reader",
                  "to": "Writer"
                  "setting": {
                  "errorLimit": {
                  "record": ""
                  "speed": {
                  "concurrent": 2,
                  "throttle": false,
    7. Click **icon to run the code.

    8. You can operation Log view the results.

Verify the migration result

  1. Right-click the workflow and choose new > MaxCompute > ODPS SQL.

  2. In the Create Node dialog box, enter a node name in the Name field and click Confirm.

  3. On the configuration tab of the ODPS SQL node, enter the following statements:

    SELECT * from mqdata;
  4. Click **icon to run the code.

  5. You can operation Log view the results.