最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- GaussDB(DWS)权限管理
- 如何访问GaussDB(DWS)
- 使用限制
- 技术支持
- 配额说明
- GaussDB(DWS)技术指标
计费说明
- GaussDB(DWS)计费概述
- 计费模式
- 计费项
- 计费样例
- 变更计费模式
- 续费
  - 续费概述
  - 手动续费
- 费用账单
- 欠费说明
- 停止计费
- 成本管理
- 计费FAQ
快速入门
- 免费体验GaussDB(DWS)
- 快速创建GaussDB(DWS)集群并导入数据进行查询
- GaussDB(DWS)数据开发SQL入门操作
- GaussDB(DWS)入门实践
用户指南
- GaussDB(DWS)使用流程
- 准备工作
- 创建GaussDB(DWS)集群
- 连接GaussDB(DWS)集群
- 创建GaussDB(DWS)数据库和用户
- 迁移业务数据至GaussDB(DWS)集群
  - 使用GDS-Kafka工具迁移数据至GaussDB(DWS)集群
  - 管理数据源
- GaussDB(DWS)集群数据安全与加密
- GaussDB(DWS)集群管理
- GaussDB(DWS)集群运维
最佳实践
- DWS最佳实践汇总
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - GaussDB(DWS) 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
- 集群管理
  - 为两种作业绑定不同资源池以实现GaussDB(DWS)资源负载能力
  - GaussDB(DWS)存算一体架构弹性伸缩系统性介绍
- 安全管理
  - 安全最佳实践
数据迁移与同步
- 迁移数据到GaussDB(DWS)
- 导入数据
- 整库迁移
  - 使用CDM迁移数据到GaussDB(DWS)
  - 使用DSC工具迁移SQL脚本
- 实时入库
  - Kafka实时入库到GaussDB(DWS)
- 元数据迁移
  - 使用gs_dump和gs_dumpall命令导出元数据
  - 使用gs_restore导入数据
- 导出数据
- 其他操作
开发指南
- 开发指南(9.1.0.x)
- 开发指南(8.1.3.x)
- 实时数仓开发指南(8.1.3.x)
- 历史版本
SQL语法参考
- SQL语法参考(9.1.0.x)
- SQL语法参考(8.1.3.x)
- 历史版本
工具指南
- 工具简介
- 工具下载
- gsql
- Data Studio
- GDS
- DSC
- DataCheck
- DWS-Connector
- 服务端工具
  - gs_dump
  - gs_dumpall
  - gs_restore
  - gds_check
  - gds_install
  - gds_uninstall
  - gds_ctl
API参考
- 使用前必读
- API概述
- 如何调用API
- 快速入门
- API说明
- 应用示例
  - 使用Postman调用创建集群接口
  - 使用Postman调用创建快照接口
- 权限及授权项说明
- 附录
SDK参考
- SDK概述
场景代码示例
错误码参考
- 控制台错误码
  - 管理控制台错误码
- 错误码(8.2.0及以下版本)
- 8.2.1及以上版本
  - 错误码命名规范
  - 行列存
    - 行存
    - 列存
    - GIN索引
    - Btree索引
    - 行存vacuum
    - SP-GiST索引
    - Hash索引
  - 事务
    - 锁
    - GTM
    - xlog
    - checkpoint
  - HA
  - SQL on Anywhere
    - SQL on hudi
    - OBS / HDFS / DLI
  - GDS/Copy
    - 公共机制（选项参数、任务分配、压缩）
    - 导入
  - 解析器
    - 词法分析
    - 语法分析
    - DDL
    - DML
    - 表达式
    - 元数据
  - 优化器
  - 执行器
  - 安全
    - 授权
    - 脱敏
  - 通信
  - WLM
  - 逻辑集群
  - 其他
常见问题
- Top问题汇总
- 产品咨询
- 数据库连接
- 数据迁移
- 数据库使用
- 集群管理
- 账户与权限
- 数据库性能
- 备份恢复
  1. 为什么DWS自动快照创建很慢，很长时间都没有创建好？
  2. DWS快照是否与EVS快照功能相同？
故障排除
- 数据库连接管理
- JDBC/ODBC类
- 数据导入/导出
- 数据库参数修改
- 账号/权限/密码
- 集群性能
- 集群异常
  - 磁盘监控告警阈值太低，告警频繁
- 数据库使用
视频帮助
性能白皮书
- 性能白皮书(9.1.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

展开导读

文档首页/ 数据仓库服务 GaussDB(DWS)/ 工具指南/ GDS/ gds

gds

更新时间：2025-04-10 GMT+08:00

查看PDF

背景信息

gds可以为GaussDB(DWS)提供导入导出数据的功能。更多详细内容可参考《开发指南》的“导入数据”和“导出数据”章节。

语法

gds [ OPTION ] -d DIRECTORY

其中，-d、-H是必选参数，option项是可选参数。gds将DIRECTORY中的文件数据提供给GaussDB(DWS)访问。

在启动GDS服务前，请确定使用的GDS版本和数据库的版本保持一致，否则数据库会提示错误并终止导入导出操作，因此请注意GDS工具和数据库的版本务必严格匹配。具体版本可通过-V参数进行查看。

参数说明

-d dir
设置待导入数据文件的目录。在gds进程权限允许的条件下，-d指定的目录会自动被创建。
-p ip:port
设置gds监听IP和监听端口。

IP的取值范围：IP需为合法IP地址。

IP的默认值：127.0.0.1。

监听端口的取值范围：1024~65535，正整数。

监听端口的默认值：8098。
-l log_file
设置日志文件。本次特性添加了日志自动切分的功能。当设置-R参数后gds会根据设置的值重新生成新的文件，以此来避免单个日志文件过大的问题。

生成规则：gds默认只识别后缀是log的文件重新生成日志文件。

例如，当-l参数指定为 gds.log，-R指定为 20MB的时候，当gds.log大小达到20MB后就会新创建一个 "gds-2020-01-17_115425.log"文件。

当-l指定的日志文件没有以log为后缀，例如：" gds.log.txt"，则新创建的日志文件名为" gds.log-2020-01-19_122739.txt"。

gds启动时会检测-l参数设置的日志文件是否存在，如果存在则根据当前日期时间新生成一个日志文件，不会覆盖之前的日志文件。

说明：

如果当前目录下GDS进程的日志数目超过--log-filecount时，会触发旧日志的回收。为了保存大量日志，建议每个GDS设置单独目录，并且调高启动参数--log-filecount。
-H address_string
设置允许哪些主机连接到gds，参数需为CIDR格式，仅支持linux系统。需要配置多个不同网段时，使用“,”分隔。例如：-H 10.10.0.0/24,10.10.5.0/24。
-e dir
设置导入时产生的错误日志存放路径。

默认值：数据文件目录。
-E size
设置导入产生的错误日志的上限值。

取值范围：0<size<1TB，请使用正整数+单位的形式进行取值设置，单位支持KB、MB和GB。
-S size
设置导出单个文件大小上限。

取值范围：1MB<size<100TB，请使用正整数+单位的形式进行取值设置，单位支持KB、MB和GB。如果使用KB，取值需要大于1024KB。
-R size
设置-l指定的gds单个日志文件大小上限。

取值范围：1MB<size<1TB，请使用正整数+单位的形式进行取值设置，单位支持KB、MB和GB。如果使用KB，取值需要大于1024KB。

默认值：16MB
-t worker_num
设置导入导出工作并发线程数目。

取值范围：0<worker_num<=200，正整数

默认值：8

推荐值：普通文件导入导出场景取值：CPU核数*2；管道文件导入导出场景取值：64。

说明：

当管道文件导入导出场景并发较大时，该值应不低于业务并发数。
-s status_file
设置状态文件，仅支持linux系统。
-D
后台运行gds，仅支持linux系统。
-r
递归遍历目录（外表目录下的子目录）下文件，会递归读取location指定的目录层级下所有的同名文件，仅支持linux系统。
-h
显示帮助信息。
--enable-ssl
使用SSL认证的方式与集群通信。
--ssl-dir Cert_file
在使用SSL认证方式时，指定认证证书的所在路径。
--debug-level
设置GDS端的debug日志级别，以控制GDS debug相关的日志输出。

取值范围：0、1、2
- 0：仅打印导入导出相关的文件列表，日志量小，推荐在系统处于正常状态时使用设置。
- 1：打印日志的完整信息，增加各节点的连接信息、session转换信息和一些数据统计。
- 2：打印详细的交互日志以及所属状态，输出较大量的debug日志信息，以帮助故障定位分析。推荐仅在故障定位时开启。
默认值：1
--log-filecount
设置保留的日志文件最大个数，当日志文件个数超过该参数值，按照文件创建时间，保留最近创建的日志文件。

取值范围：5<=log-filecount<=1024，正整数

默认值：50
--pipe-timeout
设置GDS操作管道文件的等待超时时间。
说明：
- 该参数的设置是为了避免人为或程序自身问题造成管道文件的一端长时间不读取或者不写入，导致管道另一端的读取或写入操作hang住。
- 该参数表示的超时时间不是指GDS一个导入导出任务的最长时间，而是GDS对管道文件的每一次read/open/write的最大超时时间，当超过--pipe-timeout参数设置时间会向前端报错。
取值范围：大于1s。请使用正整数+单位的形式进行取值设置，单位支持s、m和h。如：1小时可以设置为3600s、60m或者1h。

默认值：1h/60m/3600s
--pipe-size
设置GDS管道文件导入/导出时所使用的文件容量。

取值范围：大于1K。

默认值：操作系统允许的最大值，可以通过命令 cat /proc/sys/fs/pipe-max-size 查看。

说明：

该参数只能在Linux内核版本不低于2.6.35的环境下使用。

示例

数据文件存放在“/data” 目录，IP为192.168.0.90，监听端口为5000。

gds -d /data/ -p 192.168.0.90:5000 -H 10.10.0.1/24

数据文件存放在“/data/” 目录下的任意子目录，IP为192.168.0.90，监听端口为5000。

gds -d /data/ -p 192.168.0.90:5000 -H 10.10.0.1/24 -r

数据文件存放在“/data/ ”目录，IP为192.168.0.90，监听端口为5000，以后台方式运行，将日志保存在“/log/gds_log.txt”文件中，指定并发导入工作线程数目为32。

gds -d /data/ -p 192.168.0.90:5000 -H 10.10.0.1/24 -l /log/gds_log.txt -D  -t 32

数据文件存放在“/data/ ”目录，IP为192.168.0.90，监听端口为5000，只允许IP为10.10.0.*的节点进行连接。

gds -d /data/ -p 192.168.0.90:5000 -H 10.10.0.1/24

数据文件存放在“/data/ ”目录，IP为192.168.0.90，监听端口为5000，只允许IP为10.10.0.*的节点进行连接，设定为使用SSL认证的方式与集群通信，证书文件存放在/certfiles/目录。

gds -d /data/ -p 192.168.0.90:5000 -H 10.10.0.1/24 --enable-ssl --ssl-dir /certfiles/

说明：

1个GDS在同一时刻，只能为1个集群提供导入导出服务；
为满足安全要求，请通过-p显示指定监听ip和监听端口。
证书文件包括根证书文件cacert.pem，以及二级证书文件client.crt和密钥文件client.key。
在加载证书时，需要使用密码保护文件client.key.rand和client.key.cipher。

父主题： GDS

上一篇：GDS导入示例

下一篇：gds_ctl.py

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

gds

背景信息

语法

参数说明

示例

相关文档

意见反馈

文档内容是否对您有帮助？

文档反馈