Synchronize OpenLake-DLF data to Alibaba Cloud Elasticsearch
The multimodal data processing and synchronization feature ingests multimodal data, such as images and text, from Data Lake Formation (DLF) into Elasticsearch (ES). To run vector searches or build Retrieval-Augmented Generation (RAG) applications on this data, the feature automatically extracts text and image data from your DLF tables, invokes AI models to vectorize the data, and synchronizes the structured results to ES. This simplifies building AI applications and helps you set up multimodal search and RAG scenarios.
Applicable scope
Instance version: This feature is supported on Alibaba Cloud Elasticsearch 8.15 and later, including 8.17.
Region: The DLF and ES instances must be in the same region.
Synchronization mechanism
A synchronization task uses a full synchronization plus incremental synchronization mechanism. After a task is started, it automatically reads data in Paimon format from the DLF source table, applies data processing rules to vectorize text and images, converts the data into ES index format, and accelerates data retrieval in the data lake through ES.
Billing
No fees are charged for data synchronization tasks. After data is synchronized to ES, storage fees for node storage space are incurred. You can view billing details in the Expenses and Costs console.
AI model invocation fees: The AI models invoked during data processing (such as text vectorization and image vectorization) are provided by the AI Search Open Platform. Fees are charged based on the actual model invocation volume. No fees are charged if no models are invoked.
Create and configure a synchronization task
Complete the following phases to create a synchronization task and start data synchronization.
1. Navigate to the synchronization task creation page
Log on to the Elasticsearch console. In the top menu bar, switch to the target region.
Find the target instance and click the Cluster ID to go to the Basic Information page.
In the left-side navigation pane, click Data Processing and Sync.
In the Multimodal Data Processing Service section, select Workspace Name of Model Service, and then click Initialize Model. After initialization is complete, click Get Started.
NoteWorkspace Name of Model Service: An existing space in the AI Search Open Platform. The space named
defaultis the default space provided by the AI Search Open Platform. Other spaces (if any) are created by you.Initialize Model: Initializes the models in the selected space to make them available. If the space already shows the Activated status, you can skip Initialize Model and directly click Get Started.
On the synchronization task list page, click Create.
2. Configure basic information
This step configures the task name and establishes a connection with the DLF data source. Follow the on-screen instructions to configure Basic Information Configuration.
| Parameter | Description and recommendation |
| Task ID/Name | The name of the synchronization task. Use a name that is easy to identify. |
| API Key | You must create an API key in the AI Search Open Platform in advance. |
| Data Source | Select Data Lake Formation (DLF). |
| Table Type | The DLF data source supports only data tables in Paimon format. This option is selected by default and does not require manual selection. |
| Data Catalog | Set based on your actual requirements. |
| Database | |
| Data Table | |
| RAM Role | Authorize ES to use AI Search Open Platform Default Role. When you perform this operation, a service-linked role is automatically created to enable the corresponding feature. Role name: AliyunServiceRoleForSearchPlat. Role permission policy: AliyunServiceRolePolicyForSearchPlat. Description: Allows the AI Search Open Platform service to access your resources. |
After you complete the configuration, click Next.
3. Configure data processing information
If a source field is mapped to an ES dense_vector field, you must configure a vectorization processing rule for the field in this step before the field can be synchronized. Direct mapping by name is not supported.
In the Original Field section, select the fields that you want to synchronize to ES.
In the Data Processing Configurations section, select fields and configure processing rules. For example, you can specify vector models for text and image fields. The system automatically generates vector data and synchronizes the data to ES.
4. Configure field mappings
This step establishes the mapping between source fields and ES target index fields.
ES information configuration: Enter the Username, Password, and Target Index for connecting to ES.
The system automatically loads all indexes under the current ES instance. If the target index does not appear in the Target Index drop-down list, manually create the index. The following example creates an index:
PUT /your_index_name
{
"settings": {
"index": {
"number_of_shards": 1, // Number of primary shards
"number_of_replicas": 1, // Number of replicas for each primary shard
"refresh_interval": "30s", // Data refresh interval (delay before written data becomes searchable)
"analysis": { // Analyzer configuration (example)
"analyzer": {
"default": {
"type": "standard"
}
}
}
}
},
"mappings": {
"properties": {
"id": {
"type": "keyword"
},
"name": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"url": {
"type": "keyword"
},
"source": {
"type": "keyword"
},
"embedding": {
"type": "dense_vector",
"dims": 768
}
}
}
}The source field types must be compatible with the ES target field types. Otherwise, an error (error code 3005) is returned when you submit the task. The following describes common compatibility relationships:
Source scalar types (STRING, INT, FLOAT, etc.): Can be directly mapped to ES scalar fields such as keyword, text, long, and float.
Synchronizing source scalar fields to ES
dense_vectorfields: You must first configure a vectorization processing rule for the field in the Configure data processing information step (the AI model generates a vector array). Direct mapping by name is not supported.Source ARRAY type: When mapped to an ES
On the Field Mapping Configuration tab, complete the following configurations:dense_vectorfield, the array dimensions must match thedimsdefined in the ES index.
Configure field mapping relationships
The system automatically matches fields based on the same-name principle. You can also manually adjust the mappings.
Fields to Sync: The original fields from the data source that need to be synchronized.
Target Index Field: The target fields in the ES index that receive the data.
Primary Key: Select a field as the unique identifier (
Only a single primary key is supported. If your source table uses a composite primary key, create a new column in the source to concatenate the composite primary key into a unique string ID, and use that column as the synchronization primary key._id) of documents in ES.
After you confirm that all fields to be synchronized are correctly mapped, click Next.
5. Configure and start the synchronization task
This step confirms the synchronization policy configuration and starts the task. On the Data Synchronization Configuration tab, confirm that the configuration is correct and click Complete to start the task.
After you click Complete, go back to the synchronization task list page to confirm that the task is successfully created. If the new task does not appear in the list, the backend verification may have failed. Common causes include:
Incompatible field types (see the type compatibility description in the Configure field mappings step).
Processing rules are not configured for
dense_vectorand other vector fields in the Configure data processing information step.The source data catalog, database, or data table names are incorrect or do not exist.
You can check the error codes and details returned by the API in the Network tab of browser developer tools, or submit a ticket for assistance.
Manage and monitor synchronization tasks
After a task is created, you can manage and monitor it on the synchronization task list page.
View task status: Task statuses include Scheduled, Running, and Run Failed.
Management operations:
Create Copy: Quickly copies the configuration of an existing task. This is useful for creating similar tasks in batches.
Delete: Deletes a task that is no longer needed.
WarningDeleted tasks cannot be recovered. Proceed with caution.
Verify data synchronization results
You can log on to Kibana to verify whether the data is synchronized successfully.