GaussDB数据库使用COPY命令导数

++一、前言++

++二、GaussDB数据库使用COPY命令导数语法++

++[1、语法COPY FROM](#1、语法COPY FROM)++

++[2、语法COPY TO](#2、语法COPY TO)++

++3、特别说明及参数示意++

++三、GaussDB数据库使用COPY命令导数示例++

++1、操作步骤++

++2、准备工作（示例）++

++3、把一个表的数据拷贝到一个文件（示例）++

++4、从一个数据文件拷贝数据到一个表（示例）++

++四、常见数据导入导出的场景++

++五、小结++

一、前言

在数字化时代，数据是驱动业务决策和创新的关键要素。数据库作为数据存储、管理和分析的核心工具，其高效、准确的数据导入功能至关重要。

GaussDB作为华为推出的高性能数据库，提供了丰富的数据导入选项，其中之一便是COPY命令。COPY命令为数据迁移、备份恢复、大数据加载等场景提供了一个高效且灵活的手段。通过COPY命令，用户可以将外部文件、数据流或其他数据源的数据快速导入到GaussDB中，从而支持业务分析、报表生成、数据挖掘等多样化需求。

二、GaussDB数据库使用COPY命令导数语法

通过COPY命令实现在表和文件之间拷贝。在GaussDB中，COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据拷贝到一个文件。

1、语法COPY FROM

sql 复制代码

COPY table_name [ ( column_name [, ...] ) ] 
    FROM { 'filename' | STDIN }
    [ [ USING ] DELIMITERS 'delimiters' ]
    [ WITHOUT ESCAPING ]
    [ LOG ERRORS ]
    [ REJECT LIMIT 'limit' ]
    [ [ WITH ] ( option [, ...] ) ]
    | copy_option
    | TRANSFORM  ( { column_name [ data_type ] [ AS transform_expr ] } [, ...] )
    | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [  ...] ] ];

2、语法COPY TO

sql 复制代码

COPY table_name [ ( column_name [, ...] ) ]
    TO { 'filename' | STDOUT }
    [ [ USING ] DELIMITERS 'delimiters' ]
    [ WITHOUT ESCAPING ]
    [ [ WITH ] ( option [, ...] ) ]
    | copy_option
    | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [  ...] ] ];

COPY query
    TO { 'filename' | STDOUT }
    [ WITHOUT ESCAPING ]
    [ [ WITH ] ( option [, ...] ) ]
    | copy_option
    | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [  ...] ] ];

3、特别说明及参数示意

1 ）特别说明：

语法中的FIXED FORMATTER ( { column_name( offset, length ) } [, ...] )以及 [copy_option [ ...] ] 的无冲突项可以任意排列组合。
(query)与[USING] DELIMITERS不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。
对于FIXED FORMATTTER语法后面跟随的copy_option是以空格进行分隔的。
copy_option是指COPY原生的参数形式，而option是兼容外表导入的参数形式。

2 ）参数说明：

STDIN **：**声明输入是来自标准输入。
STDOUT **：**声明输出打印到标准输出。
FIXED ：打开字段固定长度模式（每条记录的每个字段长度相同。长度不足的字段以空格填充，数字类型字段左对齐，字符字段右对齐。字段和字段之间没有分隔符）。
WITHOUT ESCAPING **：**在TEXT格式中，不对'\'和后面的字符进行转义。仅支持TEXT格式
FORMATTER **：**在固定长度模式中，定义每一个字段在数据文件中的位置。按照column(offset,length)格式定义每一列在数据文件中的位置。
OPTION { option_name ' value ' }：用于指定兼容外表的各类参数
TRANSFORM ( { column_name [ data_type ] [ AS transform_expr ] } [, ...] ) **：**指定表中各个列的转换表达式；其中data_type指定该列在表达式参数中的数据类型；transform_expr为目标表达式，返回与表中目标列数据类型一致的结果值

三、GaussDB数据库使用COPY命令导数示例

COPY 属于SQL命令，导入导出的文件是在数据库服务端的进行的。且需要数据库管理员权限才可以执行，COPY对较大数据集的整体读写效率较好。

1、操作步骤

根据业务需求确定导数需求，提前做好规划，具体可参考如下步骤：

2、准备工作（示例）

1 ）指定（创建）数据文件存取目录。

登录数据库服务器，切换至omm用户，在"/home/omm"目录下创建用于存放数据文件的目录，此处取名"mydata"

"su omm "

"mkdir mydata "

Tip **：**如果在目录操作中遇到类似"ls: cannot open directory .: Permission denied"报错，需要切换到"cd /home/omm"目录下，因为其它用户（omm是数据库用户）是不能在root目录下操作的。另外，有时候可能还需要通过"chmod"给文件或者文件夹赋权限，具体根据实际报错提示处理即可。

2 ）准备数据

COPY TO **：**如果是从库表导出数据到文件，以文件形式保存，请先确认需要被导出的库表，实际业务中以真实存在的表为准，本次为了演示临时创建测试表。

sql 复制代码

-创建测试表
DROP TABLE IF EXISTS public.test_3;
CREATE TABLE public.test_3
(
  id int4,
  name varchar(20),
  course varchar(20),
  score int4
);

--插入测试数据
INSERT INTO public.test_3 VALUES (1, 'zhangsan', '语文', 90);
INSERT INTO public.test_3 VALUES (2, 'zhangsan', '数学', 95);
INSERT INTO public.test_3 VALUES (3, 'zhangsan', '英语', 85);
INSERT INTO public.test_3 VALUES (4, 'lisi', '语文', 85);
INSERT INTO public.test_3 VALUES (5, 'lisi', '数学', 90);
INSERT INTO public.test_3 VALUES (6, 'lisi', '英语', 95);

COPY FROM **：**如果是从数据文件导入数据到库表，需要准备目标表和数据文件，目标表的表结构和数据文件的结构需要根据业务需求提前约定好。

sql 复制代码

--创建目标表
DROP TABLE IF EXISTS public.test_4;
CREATE TABLE public.test_4 
(
  id int4,
  name varchar(20),
  course varchar(20),
  score int4
);

数据文件建议均以".txt、.bat、.csv"等文本文件格式存储，文件分隔符以"不跟字段值重复"为原则。文件编码格式需要与数据库设置的格式统一，防止出现中文乱码。

数据文件"test_3.csv"（COPY命令相对大数据文件效率更高，此处以示意为主）

sql 复制代码

1;zhangsan;语文;90
2;zhangsan;数学;95
3;zhangsan;英语;85

3、把一个表的数据拷贝到一个文件（示例）

1 ）将数据表导出到指定 TXT 文件中（默认分隔符是 tab）

sql 复制代码

COPY public.test_3 TO '/home/omm/mydata/test_3.txt';

2 ）将数据表导出到指定 TXT 文件中（文件指定分隔符为';'）

sql 复制代码

COPY public.test_3 TO '/home/omm/mydata/test_3.txt' delimiter ';';

3 ）将查询结果集导出到指定 CSV 文件中（默认分隔符为','）

sql 复制代码

COPY (SELECT * FROM public.test_3 WHERE name='zhangsan') TO '/home/omm/mydata/test_3.txt' WITH CSV;

4、从一个数据文件拷贝数据到一个表（示例）

测试数据复用上文的数据文件"test_3.csv"，将其导入到测试表"public.test_4"。

sql 复制代码

COPY public.test_4 FROM '/home/omm/mydata/test_3.csv' WITH CSV;

**特别说明：**数据的导入导出一定是在业务的需求下进行的，其中涉及到类似脱敏（加密）、数据覆盖与被覆盖、文件存储目录管理、数据量大小及数据导入导出效率等问题，本次不做说明，如有机会后续讲解。

四、常见数据导入导出的场景

数据导入导出常见的应用场景常见于数据库、数据仓库和大数据平台中。

1 、数据库：

**数据迁移：**当从一个数据库系统迁移到另一个数据库系统时，需要进行数据导入导出，确保数据的完整性和准确性。
**备份与恢复：**为了防止数据丢失，定期备份数据库是必要的。导入导出功能可以用于备份和恢复操作。

2 、数据仓库：

ETL **（提取、转换、加载）：**在构建数据仓库时，通常需要从多个源提取数据，进行转换和清洗，然后加载到数据仓库中。这涉及到数据的导入导出。
**报表生成：**数据仓库中的数据可以导出到报表中，以供分析和决策。

3 、大数据平台：

**数据集成：**在大数据平台中，可能需要从各种来源导入大量数据，然后再导出到其他系统或服务中。
**实时分析：**某些场景下，需要实时地从大数据平台中导入数据，以便进行实时分析或处理。
**数据备份与恢复：**与传统的数据库类似，大数据平台也需要定期备份数据，以确保数据的完整性和可用性。
**数据共享与分发：**大数据平台的数据可以导出到其他系统或服务中，以实现数据的共享和分发。

这些场景都强调了数据导入导出的重要性，它们是确保数据流动、满足业务需求、支持决策和风险管理的基础设施。

五、小结

使用COPY命令可以方便地导入数据到GaussDB。只需确保源文件的格式与数据库表结构相匹配，并正确指定文件路径，即可轻松完成数据导入。此外，GaussDB还提供了其他数据导入工具和功能，如使用GDS导入数据、使用INSERT多行插入、使用gsql元命令导入数据、ETL工具集成等，以满足不同场景下的数据导入需求。

------结束