Updated on 2023-10-23 GMT+08:00

Importing Data

You can use GDS, INSERT, COPY, or \copy (a gsql meta-command) to import data to GaussDB. GDS has high efficiency because of its parallel import and is used to import large volume of data. The rest statements and commands are used to import small volume of data. For details, see Table 1.

Table 1 Import modes

Method

Feature

GDS

Multiple DNs are used for parallel import, improving the efficiency. It is recommended for importing a large volume of data.

INSERT

Insert one or more rows of data, or insert data from a specified table.

COPY

Run the COPY FROM STDIN statement to write data into GaussDB.

Service data does not need to be stored in files when it is written from other databases to GaussDB through the CopyManager interface driven by JDBC.

\copy, a gsql meta-command

Different from the SQL COPY statement, the \copy command can read data from or write data into only local files on a gsql client.

NOTE:

\copy applies only to small-scale data import in good format. It does not preprocess invalid characters or provide error tolerance. Therefore, \copy cannot be used in scenarios where abnormal data exists. GDS or COPY is preferred for data import.