Help Center/ Cloud Search Service/ User Guide/ Using OpenSearch for Data Search/ Importing Data to an OpenSearch Cluster/ Using CDM to Import Data to an OpenSearch Cluster
Updated on 2025-09-05 GMT+08:00
View PDF
Share

Using CDM to Import Data to an OpenSearch Cluster

With CSS, you can use the web user interface of the Cloud Data Migration (CDM) service to import data from an Oracle database or OBS to an OpenSearch cluster. Only JSON files are supported.

Table 1 Using CDM to import data to CSS

Scenario

Source Data

Destination Cluster

Importing data from an Oracle database to CSS

A local or third-party Oracle database

OpenSearch 1.3.6

Importing data from OBS to CSS

JSON files in OBS buckets

OpenSearch 1.3.6

Preparations

  1. Confirm the source data.

    For example, the source data can be the following JSON files:

    {"index": {"_index":"my_store"}}
{"productName":"Autumn new woman blouses 2019","size":"M"}
{"index": {"_index":"my_store"}}
{"productName":"Autumn new woman blouses 2019","size":"L"}
  2. Obtain data source information.
    • If the data source is an Oracle database, you need to obtain the IP address, database name, username, and password of the database.
    • If the data source is JSON files in an OBS bucket, you need to obtain its domain name, port, AK, and SK.
  3. If the data source is an Oracle database, make sure the Oracle database can be accessed using a public IP address, or a VPN or Direct Connect connection has been established between the customer's data center and Huawei Cloud.

Importing Data

  1. Log in to the CSS management console.
  2. In the navigation pane on the left, choose Clusters > OpenSearch.
  3. In the cluster list, obtain the target cluster's private IP address from the Private IP Address column. Generally, the IP address format is <host>:<port> or <host>:<port>,<host>:<port>.

    If the cluster has only one node, the IP address and port number of this one node are displayed, for example, 10.62.179.32:9200. If the cluster has multiple nodes, the IP addresses and port numbers of all nodes are displayed, for example, 10.62.179.32:9200,10.62.179.33:9200.

  4. In the cluster list, locate the destination cluster, and click Dashboards in the Operation column to log in to OpenSearch Dashboards.
  5. In the left navigation pane, choose Dev Tools.
  6. Run the following command on OpenSearch Dashboards to check whether the cluster has indexes: 
    GET _cat/indices?v
    • If indexes are available in the cluster to which you want to import data, you do not need to create an index. Go to 8.
    • If no indexes are available in the cluster, go to the next step to create an index.
  7. Run the following command to create an index for storing imported data and create a custom mapping to define the data type.

    For example, run the following command to create index demo:

    PUT /demo
{
  "settings": {
    "number_of_shards": 1
  },
  "mappings": {
      "properties": {
        "productName": {
          "type": "text",
          "analyzer": "ik_smart"
        },
        "size": {
          "type": "keyword"
        }
      }
    }
  }

    The command is successfully executed if the following information is displayed.

    {
  "acknowledged" : true,
  "shards_acknowledged" : true,
  "index" : "demo"
}
  8. Use CDM to import data from Oracle or OBS to the OpenSearch cluster.
  9. After the data migration is complete, go to the OpenSearch Dashboards console of the OpenSearch cluster again, and search for the imported data.

    Run the following command to search for data. If the imported data is consistent with the source data, data importing is successful.

    GET demo/_search

    demo is the name of the created index. Replace it if another index is used.

    The command is successfully executed if the following information is displayed.

    {
  "took": 18,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": 2,
    "max_score": 1,
    "hits": [
      {
        "_index": "demo",
        "_type": "products",
        "_id": "g6UepnEBuvdFwWkRmn4V",
        "_score": 1,
        "_source": {
          "size": """"size":"L"}""",
          "productName": """{"productName":"Latest art shirts for women in autumn 2019""""
        }
      },
      {
        "_index": "demo",
        "_type": "products",
        "_id": "hKUepnEBuvdFwWkRmn4V",
        "_score": 1,
        "_source": {
          "size": """"size":"M"}""",
          "productName": """{"productName":"Latest art shirts for women in autumn 2019""""
        }
      }
    ]
  }
}