Motivation

Load Action is a synchronous import method where users send requests via HTTP protocol to import local files into Paimon. Load Action executes the import synchronously and returns the results of the import. 

Load Action is primarily suitable for importing local files.

SCENARIO

Analysts and business development personnel often encounter temporary small-scale data scenarios in their work. Faced with one or multiple CSV files, these files typically have small data volumes and are scattered across various systems. The traditional process for handling these files involves first uploading them to OSS storage, then using Flink or Hive SQL for table creation and data import, before analysis can begin. This process is not only complex and tedious but also requires specific prior knowledge. To simplify this process, we have introduced the 'Load Action' service. This service enables the rapid import of small-scale data, directly creating Paimon tables, without the dependence on any other data processing engines.

...

curl -u root -T date -H "label:123" http://paimon.com:8030/api/test/date/_load

Overview

Load Action is a synchronous import method where users send requests via HTTP protocol to import local files into Paimon. Load Action executes the import synchronously and returns the results of the import. 

Load Action is primarily suitable for importing local files.

How to Load

Users only need to execute an HTTP request with the dataset-related table creation information to complete:

• Verification of user import permissions.
• Creation of a Paimon table according to the table creation information.
• Reading of the uploaded file, data segmentation according to specified separators, followed by batch data import.
• Execution of filtering and adjustment of column positions.

Image RemovedImage Added

Signature parameters

curl -u user:passwd [-H ""...] -T data.file -XPUT http://load_host:http_port/api/{db}/{table}/_load

...

• user/passwd: To verify user identity and import permissions.
• label: Identifier of the import task.
• column_separator: Used to specify the column separator in the import file, default is \t.
• line_delimiter: Used to specify the newline character in the import file, default is \n.
• where: Filter condition specified for the import task.
• columns: Names of the column fields of the data to be imported.
• enclose:Enclosure character. When a CSV data field contains row separators or column separators, a single-byte character can be specified as an enclosure character to prevent accidental truncation. For example, if the column separator is ",", and the enclosure character is "'", then in the data "a,'b,c'", "b,c" will be interpreted as a single field.
• escape:Escape character. Used to escape characters in a CSV field that are the same as the enclosure character. For example, if the data is "a,'b,'c'" and the enclosure character is "'", and it is desired that "b,'c" be interpreted as a single field, a single-byte escape character needs to be specified, such as "". Then the data should be modified to "a,'b,'c'".
  

• format: Specifies the format of the data to be imported, supports csv and json, default is csv.

...

curl -u user:passwd [-H "sql: ${load_sql}"...] -T data.file -XPUT http://load_host:http_port/api/_http_load


# -- load_sql
# insertINSERT intoINTO db.table 
# (
#     col, ...
# ) select stream_ 
# SELECT 
#     col, ... 
# fromFROM httpread_loadfiles("property1"="value1");

file:///data.file") 
# http parameterswith
# (
#     "column_separator" = ",",
#     "format" = "CSV",
#     ...csv"
# );

Return Results

Since Load Action is a synchronous import method, the results of the import are directly returned to the user through the return value created for the import.

...