最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- 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)集群运维
最佳实践
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - GaussDB(DWS) 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
  - 基于表结构设计和调优提升GaussDB(DWS)查询性能
  - 分析正在执行的SQL以处理GaussDB(DWS)业务阻塞
- 集群管理
  - 为两种作业绑定不同资源池以实现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)
- 实时数仓开发指南(9.1.0.x)
- 实时数仓开发指南(8.1.3.x)
- 历史版本
SQL语法参考
- SQL语法参考(9.1.0.x)
- SQL语法参考(8.1.3.x)
- 历史版本
工具指南
- 工具简介
- 工具下载
- gsql
- Data Studio
- GDS
- DSC
- DataCheck
- DWS-Connector
- 服务端工具
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. 为什么GaussDB(DWS)自动快照创建很慢，很长时间都没有创建好？
  2. GaussDB(DWS)快照是否与EVS快照功能相同？
故障排除
- 数据库连接管理
- JDBC/ODBC类
- 数据导入/导出
- 数据库参数修改
- 账号/权限/密码
- 集群性能
- 集群异常
  - 磁盘监控告警阈值太低，告警频繁
- 数据库使用
视频帮助
性能白皮书
- 性能白皮书(9.1.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

展开导读

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

gds_ctl

更新时间：2024-12-10 GMT+08:00

查看PDF

背景信息

gds_ctl是一个批量控制GDS启停的脚本工具，一次执行可以在多个节点上启动/停止相同端口的GDS服务进程，并在启动时为每一个进程设置看护程序，用于看护GDS进程。

注意事项

执行脚本前需切换到GDS用户，必须在普通用户下执行脚本gds_ctl。
脚本需要在python 3环境下运行。
gds_ctl继承了GDS主要命令行参数，除-p以及-h外，其他参数意义不变。在gds_ctl中，-p只需指定端口即可。
使用gds_ctl批量操作的节点必须是此前使用gds_install安装部署的节点。

语法

启动命令

gds_ctl start --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT -d DATADIR -H ALLOW_IPs [gds other original options]

停止命令

gds_ctl stop --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT

重启命令

gds_ctl restart --host [/path/to/hostfile | ipaddr1,ipaddr2...] -p PORT

参数说明

--host
待运行GDS节点的IP列表，支持文件和字符串两种形式：
- 文件形式：每一行一个IP地址，如：
  192.168.2.200
  
  192.168.2.201
- 字符串形式：半角逗号分隔，如：
  192.168.2.200,192.168.2.201

-p
监听端口。

取值范围：1024~65535，正整数。

默认值：8098
--help
显示帮助信息。
-V
显示版本信息。

兼容GDS原参数

-d dir
设置待导入数据文件的目录。在GDS进程权限允许的条件下，-d指定的目录会自动被创建。
-l log_file
设置日志文件。

与-R参数一起使用，可支持日志自动切分。当设置-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参数设置的日志文件是否存在，如果存在则根据当前日期时间新生成一个日志文件，不会覆盖之前的日志文件。
-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
递归遍历目录（外表目录下的子目录）下文件，仅支持linux系统。
--enable-ssl
使用SSL认证的方式与集群通信。
--ssl-dir cert_file
在使用SSL认证方式时，指定认证证书的所在路径。
--debug-level
设置GDS端的debug日志级别，以控制GDS debug相关的日志输出。

取值范围：0、1、2。
- 0：仅打印导入导出相关的文件列表，日志量小，推荐在系统处于正常状态时使用设置。
- 1：打印日志的完整信息，增加各节点的连接信息、session转换信息和一些数据统计。推荐仅在故障定位时开启。
- 2：打印详细的交互日志以及所属状态，输出较大量的debug日志信息，以帮助故障定位分析。推荐仅在故障定位时开启。
--pipe-timeout
设置GDS操作管道文件的等待超时时间。

取值范围：大于1s。请使用正整数+单位的形式进行取值设置，单位支持s、m和h。如：1小时可以设置为3600s、60m或者1h。

默认值：1h/60m/3600s
说明：
- 该参数的设置是为了避免人为或程序自身问题造成管道文件的一端长时间不读取或者不写入，导致管道另一端的读取或写入操作hang住。
- 该参数表示的超时时间不是指GDS一个导入导出任务的最长时间，而是GDS对管道文件的每一次read/open/write的最大超时时间，当超过--pipe-timeout参数设置时间会向前端报错。

示例

启动一个GDS进程，其数据文件存放在“/data” 目录，IP为192.168.0.90，监听端口为5000。

gds_ctl start --host 192.168.0.90 -d /data/ -p 5000 -H 10.10.0.1/24 -D

启动一批GDS进程，其数据文件存放在“/data” 目录，IP为192.168.0.90、192.168.0.91、192.168.0.92，监听端口为5000。

gds_ctl start --host 192.168.0.90,192.168.0.91,192.168.0.92 -d /data/ -p 5000 -H 0/0 -D

批量关闭位于192.168.0.90、192.168.0.91、192.168.0.92节点上，端口是5000的GDS进程：

gds_ctl stop --host 192.168.0.90,192.168.0.91,192.168.0.92 -p 5000

批量重启位于192.168.0.90、192.168.0.91、192.168.0.92节点上，端口是5000的GDS进程：

gds_ctl restart  --host 192.168.0.90,192.168.0.91,192.168.0.92 -p 5000

父主题： 服务端工具

上一篇：gds_uninstall

下一篇：ESLDoTrust.py

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

智能客服提问云社区提问

gds_ctl

背景信息

注意事项

语法

参数说明

兼容GDS原参数

示例

相关文档

意见反馈

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

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈