IBM Cloud Docs
Cloud Databases 命令行界面

Cloud Databases 命令行界面

Cloud Databases CLI 插件提供了访问 Cloud Databases 服务功能的额外方法。 您可以使用 Cloud Databases CLI 管理和连接以下服务：

CLI Cloud Databases 插件需要安装 IBM Cloud CLI。

CLI Cloud Databases 插件 (cdb) 仅支持第一代实例。 要管理 Gen 2 实例，请参阅 Gen 2 CLI Cloud Databases 参考 文档。

IBM Cloud CLI

IBM Cloud CLI 是一种通用开发工具，可通过命令行界面访问 IBM Cloud 账户和服务。

IBM Cloud CLI 入门页面上有介绍和安装说明。 如果使用 cURL 命令安装 CLI，就能获得适用于多个集成开发环境的额外插件和扩展。

从 安装独立 IBM Cloud CLI 页面安装独立软件包。

通过 IBM Cloud CLI 访问服务受 Identity and Access Management 管理。 要使用 CLI 查看或管理服务（或向账户上的其他用户授予权限），必须设置正确的权限。 有关 IAM 管理的更多信息，请参阅 IAM 入门教程

安装 Cloud Databases CLI 插件

获得 IBM Cloud CLI 后，登录 并使用类似命令安装 Cloud Databases 插件：

ibmcloud plugin install cloud-databases

要查看命令列表和使用信息，请使用类似命令：

ibmcloud cdb help

ibmcloud cdb help

ibmcloud cdb help 命令本身会显示可用的顶级命令。 如果后面跟着另一条命令，则会显示该命令的具体帮助。

ibmcloud cdb help [<command>]

命令选项

无特定命令选项。

示例

获取关于任务显示命令的帮助。

ibmcloud cdb help task-show

入门 - 创建实例

您可以使用以下命令创建一个实例：

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"

命令选项

如果想使用其他组来代替默认组，请设置资源组。 您也可以省略该标记。

示例

创建一个 MongoDB 实例。

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

部署和可部署

获取有关 Cloud Databases 平台上可部署数据库和数据库版本的信息。 此外，请获取 IBM Cloud 账户上所有 Cloud Databases 的列表。

ibmcloud cdb deployables-show

deployables 是可用于新数据库部署的模板。 该命令显示可部署的数据库类型，特别是数据库的可用版本及其首选或稳定状态。

ibmcloud cdb deployables-show [--stable] [--preferred] [--output, -o FORMAT]

简短版本-- deployables

命令选项

  • --stable 或 -s 只列出数据库的稳定版本。
  • --preferred 或 -p 只列出首选的数据库版本。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示现有数据库的所有稳定版本。

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

简短版本-- ls

使用此命令可列出与账户关联的部署。

ibmcloud cdb deployments [--all] [--output json]

命令选项

  • --all 或 -a 显示实例名称和 CRN。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

列出账户当前的所有部署。

ibmcloud cdb ls

ibmcloud cdb deployment-about

简短版本-- about

使用此命令可获取实例中部署的数据库、版本和应用的任何选项的详细信息。 同时显示的还有资源控制器的 ID 和 GUID、资源计划、当前状态、类型和最后已知操作。

ibmcloud cdb deployment-about <deployment name or CRN> [--all] [--output, -o FORMAT]

命令选项

  • --all 或 -a 显示资源控制器记录中的所有可用数据。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

列出名为 "RedisDBOne" 的部署的详细信息。

ibmcloud cdb about RedisDBOne

连接

获取连接字符串和证书信息，用于连接部署。 管理具有该选项的数据库的连接。

ibmcloud cdb deployment-connections

简短版本-- cxn

显示已插入或未插入用户凭证的部署的连接字符串和其他连接详细信息。

ibmcloud cdb deployment-connections [--user <userid>] [--password <password>] [--endpoint-type <endpoint type>] [--all] [--only] [--start] [--certroot <path>] [--output, -o FORMAT]

命令选项

  • --start 或 -s 运行生成的 CLI 命令启动连接。 如果没有在标记中指定密码，命令会以交互方式提示输入密码。 插件使用默认命令进行命令行交互和管理 CA 证书，以确保 TLS 会话的安全性。 默认以部署的管理员用户身份连接。
  • --user <userid> 或 -u 设置检索连接设置时使用的用户 ID。 它被替换为连接字符串。 默认为部署的管理员用户。
  • --password <password> 或 -p 设置检索连接设置时使用的密码。 它被替换到连接字符串中，$PASSWORD 作为默认值出现。
  • --endpoint-type [public or private] 或 -e [public or private] 返回连接字符串的端点类型。 公共 "或 "私有"。(默认："公共"）。 端点类型不强制执行，仅用于显示目的。
  • --all 或 -a 列出所有可用的连接设置，包括连接字符串的组成部分。
  • --certroot <path> 或 -c 使用该路径作为证书根目录。 如果路径不存在，则会自动创建。 与 --save 标志一起使用。 证书根值也可在 $CERTROOT 环境变量中设置。
  • --only [app or cli] 或 -o 只显示与 app 连接或 cli 连接相关的设置。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --endpoint-type 或 -e 返回连接字符串的端点类型， public 或 private。 默认值为 public. 由于默认值为 public，如果没有 public 端点，则找不到任何端点，您将收到一个错误信息：{"errors":"not_found"}。 使用 -e private 标志可使用 private 端点。

示例

显示如何连接部署。

ibmcloud cdb deployment-connections MyPSQL

(显示连接字符串和 CLI 命令字符串）

以管理员身份连接部署。

ibmcloud cdb deployment-connections MyPSQL --start

运行时，插件会提示输入管理员密码，然后运行 CLI 命令字符串。 CLI 命令串中使用的命令必须安装。

显示如何为特定用户和密码组合与部署建立连接的所有详细信息。

ibmcloud cdb cxn MyPSQL -a -u auser -p auserpassword

ibmcloud cdb deployment-cacert

简短版本-- cacert

显示用于验证与部署的 TLS/SSL 连接的自签名证书。 默认情况下，结果会输出到控制台，但也可以保存到文件中。

ibmcloud cdb deployment-cacert <deployment name or CRN> [--user <userid>] [--save] [--certroot <path>] [--output, -o FORMAT]

命令选项

  • --user <userid> 或 -u 默认情况下，使用管理员用户获取证书。 在部署支持每个用户证书的情况下，可选择使用此标记指定用户。
  • --save 或 -s 将解码后的证书保存到证书根目录。 默认值为 $ HOME/.cloud/plugins/cdb/cdbcerts/。
  • --certroot <path> 或 -c 使用该路径作为证书根目录。 如果路径不存在，则会自动创建。 与 --save 标志一起使用。 证书根值也可在 $CERTROOT 环境变量中设置。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示名为 MyPostgreSQL 的部署的证书。

ibmcloud cdb deployment-cacert MyPostgreSQL

在当前目录下保存同一部署的证书。

ibmcloud cdb deployment-cacert MyPostgreSQL --save --certroot .

注：文件名以证书名为准。

ibmcloud cdb deployment-kill-connections

简短版本-- kill-connections

关闭部署上的所有连接。 仅限于 PostgreSQL 可用。

ibmcloud cdb deployment-kill-connections <deployment name or CRN> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待用户创建任务完成。 显示用户创建任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

该命令会杀死名为 postgresq-preproduction 的部署的所有外部连接。

ibmcloud cdb deployment-kill-connections postgresq-preproduction

功能

功能命令可帮助您确定数据库和备份可用和受支持的功能。

ibmcloud cdb capability

capability-show

该命令可发现特定数据库类型是否支持某种功能。

简短版本-- cs

ibmcloud cdb capability-show CAPABILITY_ID TYPE VERSION PLATFORM LOCATION TARGET_PLATFORM TARGET_LOCATION [--output, -o FORMAT] [--api-version]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --api-version 或 -v 请求使用的 API 版本。
  • --hostflavor 为团体能力提供主机风味。

能力标识选项

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • restores
  • versions

示例

ibmcloud cdb capability-show 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e database 3.2.1 IBMCloud us-south

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor multitenant

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor b3c.4x16.encrypted

backup-capability-show

该命令可发现能否从特定实例还原数据库类型。

简短版本-- bcs

ibmcloud cdb discover-capability-information-from-backup (BACKUP_ID) (CAPABILITY_ID) (TARGET_PLATFORM) (TARGET_LOCATION) [--output, -o FORMAT] [--api-version] [--nowait]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --api-version 或 -v 请求使用的 API 版本。

能力标识选项

  • restores

示例

  ibmcloud cdb discover-capability-information-from-backup f7d318b6-6d4e-4d2a-9be4-7c1efbc94a52 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e IBMCloud us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

deployment-capability-show

该命令可发现特定部署或编队是否支持特定能力。

简短版本-- dcs

ibmcloud cdb deployment-capability-show (NAME|ID) (CAPABILITY_ID) [--target-platform] [--target-location] [--output, -o FORMAT] [--api-version] [--nowait]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --api-version 或 -v 请求使用的 API 版本。
  • --target-platform 或 -p 请求的目标平台
  • --target-location 或 -l 请求的目标位置

能力标识选项

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • versions

示例

ibmcloud cdb deployment-capability-show my-deployment 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e --target-location us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

用户

为部署中的用户创建、删除或更改密码。

ibmcloud cdb deployment-user-create

简短版本-- user-create

在部署数据库上创建用户。

ibmcloud cdb deployment-user-create <deployment name or CRN> <newusername> <newpassword> [--nowait] [--output, -o FORMAT]

newusername 必须是格式正确的用户名，以便在部署数据库中使用。 newpassword 必须符合数据库的密码规则，长度至少为 10 个字符。

命令选项

  • --nowait 或 -n 不要等待用户创建任务完成。 显示用户创建任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

在 "MyPSQL" 部署上创建名为 "fred "的数据库用户，密码为 "X1234Y5678"。

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

简短版本-- user-delete

从指定的数据库部署中删除现有用户。

ibmcloud cdb deployment-user-delete <deployment name or CRN> <username> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待用户删除任务完成。 显示用户删除任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

从 "MyPSQL" 部署中删除名为 "fred "的数据库用户。

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

简短版本-- user-password

更改指定数据库部署上指定用户的密码。

ibmcloud cdb deployment-user-password <deployment name or CRN> <username> <newpassword> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待用户密码更改任务完成。 显示用户密码更改任务详情并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

将数据库部署 "MyPSQL" 上的用户 "fred "的密码更改为 "A9876B5432"。

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

数据库配置

列出或更改部署上的可配置设置。 新配置在 JSON 文件或 JSON 设置字符串中指定。 设置因数据库类型而异，请参阅_更改数据库配置_以获取更多信息。PostgreSQL 或 Redis.

ibmcloud cdb deployment-configuration-schema

简短版本-- config-schema

获取指定部署的默认配置。

ibmcloud cdb deployment-configuration-schema <deployment name or CRN> [--description] [--output, -o FORMAT]

ibmcloud cdb deployment-configuration-schema 显示的是默认配置。 要验证当前配置值，请直接从数据库查询配置。

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --description 或 -d 显示设置说明。

示例

ibmcloud cdb deployment-configuration-schema my-redis-cache

ibmcloud cdb deployment-configuration

简短版本-- configuration

更改指定部署的配置。

ibmcloud cdb deployment-configuration <deployment name or CRN> [@JSON_FILE | JSON_STRING] [--output, -o FORMAT] [--nowait]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。

示例

将名为 " PGSettings4 " 的 PostgreSQL 部署的 max_connections 更改为 150。

ibmcloud cdb deployment-configuration PGSettings4 '{"configuration":{"max_connections":150}}'

缩放

检索和配置分配给部署的资源。

ibmcloud cdb deployables-groups-show

每个部署都是根据可部署模板创建的。 deployables-groups-show 命令显示特定类型数据库的初始或默认缩放组。 类型名称可通过 deployables-show 命令发现。

ibmcloud cdb deployables-groups-show <deployable type> [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示 PostgreSQL 数据库部署的默认组设置。

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

简短版本-- groups

显示部署成员的缩放组值。 缩放组与内存、CPU 和磁盘有关。 默认组名为"member"。 每组显示组内节点的数量，后面跟着"......"：

  • 内存- 总内存分配、每个成员的分配、最小分配以及总内存可以变化的增量。
  • CPU- 专用于该组的 CPU 数量。 未配置专用 CPU 时，CPU 部分的所有字段值均为 0。 CPU 组仅在可调整时显示。
  • 磁盘- 磁盘分配总量、每个成员的分配量、最小分配量以及磁盘总量的增量。
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示名为 "MyRedis" 的数据库部署的扩展组设置。

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

简短版本-- groups-set

设置扩展组的值（请参阅部署组）。 用户可以设置以 MB 为单位的总内存大小或以 MB 为单位的总磁盘存储空间，这两种大小都会在成员之间平均分配。 在可用的情况下，还可以设置分配的 CPU 数量。

ibmcloud cdb deployment-groups-set <deployment name or CRN> <memberid> [--memory <memory size>] [--disk <disk size>] [--cpu <value>] [--hostflavor <val>] [--nowait] [--output, -o FORMAT]

memberid 是要设置这些值的组的名称。 该名称可通过 deployment-groups 命令找到。 通常是“成员”。

命令选项

  • --memory <memory size> 或 -m 设置指定部署组的总内存，单位为 MB。
  • --disk <disk size> 或 -d 设置指定部署组的磁盘总大小，单位为 MB。
  • --cpu <value> 或 -c 设置专用CPU核心的数量。
  • --hostflavor <val> 设置数据库的托管类型：共享计算从 multitenant 中选择，隔离计算从单个大小选择。
  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 结果为 JSON 格式。

示例

将名为 "MyPGSQL" 的 PostgreSQL 部署与 "member "组设置为总内存为 4096 MB。

ibmcloud cdb deployment-groups-set MyPGSQL member --memory 4096

区域

列出部署可从当前区域调配到的所有区域。

ibmcloud cdb regions [--output, -o FORMAT] [--api-version]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • api-version value 请求使用的 API 版本。

示例

返回可从当前区域调配部署的所有区域的 JSON 文件。

ibmcloud cdb regions --output, -o FORMAT

自动缩放

自动扩展配置表示控制部署自动扩展的各种条件。

ibmcloud cdb deployment-autoscaling

简短版本-- autoscaling

检索特定部署的所有自动缩放条件。

ibmcloud cdb deployment-autoscaling <deployment name or CRN> GROUP_ID [--output, -o FORMAT]

自动扩展目前只适用于部署中的数据成员，因此 GROUP_ID 是 member。

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

简短版本-- autoscaling-set

在部署中启用、禁用或设置自动扩展的条件。

ibmcloud cdb deployment-autoscaling-set (NAME|ID) GROUP_ID (@JSON_FILE|JSON_STRING) [--output, -o FORMAT] [--nowait]

自动扩展目前只适用于部署中的数据成员，因此 GROUP_ID 是 member。 您希望设置或取消设置的自动缩放参数定义在一个 JSON 对象中。

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --nowait 或 -n 不要等待命令完成。

示例

对于名为 elasticsearch-preproduction 的部署，此命令将内存设置为在 I/O 利用率达到一定阈值时自动扩展。

ibmcloud cdb deployment-autoscaling-set elasticsearch-preproduction member '{"autoscaling": { "memory": {"scalers": {"io_utilization": {"enabled": true, "over_period": "5m","above_percent": 90}},"rate": {"increase_percent": 10.0, "period_seconds": 300,"limit_mb_per_member": 125952,"units": "mb"}}}}'

只读副本

检索和配置只读副本。 目前，只有 PostgreSQL 部署支持只读复制。

ibmcloud cdb deployment-read-replicas

简短版本-- read-replicas

列出指定部署的所有只读副本。

ibmcloud cdb deployment-read-replicas <deployment name or CRN> [--long] [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --long 或 -l 在输出中显示附加字段。

示例

列出名为 "MyPGSQL" 的 PostgreSQL 部署的只读副本。

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

简短版本-- rr-leader

返回指定只读复制部署的领导者。

ibmcloud cdb read-replica-leader <deployment name or CRN> [--long] [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --long 或 -l 在输出中显示附加字段。

示例

列出名为 "MyPGSQL-replica" 的 PostgreSQL 只读副本部署的领导者。

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

简短版本-- rr-promote

将只读副本升级为独立实例。

ibmcloud cdb read-replica-promote <deployment name or CRN> [--output, -o FORMAT] [--nowait] [--skip-initial-backup]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --nowait 或 -n 不要等待命令完成。
  • --skip-initial-backup 或 s 数据恢复后，无需备份即可恢复实例的选项。 允许尽快恢复部署。

示例

将名为 "MyPGSQL-replica" 的 PostgreSQL 只读副本部署提升为独立部署。

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

简短版本-- rr-resync

重新同步只读副本。

ibmcloud cdb read-replica-resync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • --nowait 或 -n 不要等待命令完成。

示例

重新同步名为 "MyPGSQL-replica" 的 PostgreSQL 只读副本部署。

ibmcloud cdb read-replica-resync MyPGSQL-replica

备份

管理部署中的备份或按需备份。

ibmcloud cdb deployment-backups-list

简短版本-- backups

显示与部署关联的备份列表。 结果是一个由备份 ID、类型、状态和创建日期组成的表格。 结果排序以最新备份为先。

ibmcloud cdb deployment-backups-list <deployment name or CRN> [--scheduled] [--first] [--output, -o FORMAT]

命令选项

  • --scheduled 或 -s 只输出计划备份。
  • --first 或 -f 只输出找到的第一个（或最近的）备份。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示名为 " Postgres2000 " 的部署上可用的备份。

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

显示备份的详细信息。 备份由其 CRN ID 标识，如 deployment-backups-list 命令所示。

ibmcloud cdb backup-show <CRN> [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示特定备份的详细信息。

ibmcloud cdb backup-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:ebcea542-8d8c-4b6e-a7d4-922ffd08eb50

ibmcloud cdb deployment-backup-now

简短版本-- backup-now

启动部署的按需备份。 该命令会轮询正在运行的备份，完成后退出。

ibmcloud cdb deployment-backup-now <deployment name or CRN> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待备份任务完成。 显示备份任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

创建名为 "PgTips" 的部署备份。

ibmcloud cdb deployment-backup-now PgTips

安全性

管理部署的 IP 允许列表。

ibmcloud cdb deployment-allowlist-list

简短版本-- wl-ls

显示部署的当前允许列表。

ibmcloud cdb deployment-allowlist-list <deployment name or CRN> [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

列出 "MyPSQL" 部署的当前允许列表。

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

简短版本-- wl-add

将 IP 地址或范围添加到部署的当前允许列表中。 IP 地址是 IPv4 或 IPv6 地址，而范围是屏蔽的 IPv4 地址，例如 1.2.3.0/24。 描述必须是人类可读的字符串，用于描述允许列表的地址或范围。

ibmcloud cdb deployment-allowlist-add <deployment name or CRN> <allowlist address or range> <description> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待允许列表添加任务完成。 显示允许列表添加任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

将 IP 地址 198.51.100.1 添加到 "MyPSQL" 部署的当前 allowlist 中。

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.1 "allowlisted for testing"

将 IP 范围 198.51.100.0 至 198.51.100.255 添加到 "MyPSQL" 部署的当前 allowlist 中。

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.0/24 "Testing range is now open"

ibmcloud cdb deployment-allowlist-delete

简短版本-- wl-del

从部署的当前允许列表中删除 IP 地址或范围。 IP 地址是 IPv4 或 IPv6 地址，而范围是屏蔽的 IPv4 地址，例如 1.2.3.0/24。

ibmcloud cdb deployment-allowlist-delete <deployment name or CRN> <allowlist address or range> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待允许列表删除任务完成。 显示允许列表删除任务详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

从 "MyPSQL" 部署的当前允许列表中删除 IP 地址 198.51.100.1。

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.1 "allowlisted for testing"

从 "MyPSQL" 部署的当前允许列表中删除 IP 范围 198.51.100.0 至 198.51.100.255。

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.0/24 "Testing range is now open"

任务

每当您对部署执行操作时，都会创建任务。 任务包括备份、组缩放和更改用户密码等。 大多数 cdb 命令都会轮询正在运行的任务，并在任务完成后退出。 您可以使用 --nowait 标志改变这种行为，它会返回任务信息并退出。 成功任务的记录显示 24 - 48 小时，不成功任务的记录显示 7 - 8 天。 任何时间段的任务历史记录都可通过 Activity Tracker 整合 获取。

ibmcloud cdb deployment-tasks-list

简短版本-- tasks

显示自创建指定部署以来在该部署上运行的所有任务的列表。 每项任务都会显示其通用报告编号、可读描述、完成百分比、状态和创建日期。

ibmcloud cdb deployment-tasks-list <deployment name or CRN> [--output, -o FORMAT]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示针对名为 "NewRedis" 的部署运行的任务列表。

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

简短版本-- task

显示特定任务的状态。 任务由其 CRN ID 标识，如 deployment-tasks-list 命令所示。 如果任务正在运行，命令会等待任务完成，并在定期轮询时报告状态变化。

ibmcloud cdb task-show <CRN> [--nowait] [--output, -o FORMAT]

命令选项

  • --nowait 或 -n 不要等待任务完成。 显示用户密码更改任务详情并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

显示特定备份任务的详细信息。

ibmcloud cdb task-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:task:0faea465-de5a-4f14-a5ff-b402fefbd652

Elasticsearch

执行 Elasticsearch 部署的特定任务。

ibmcloud cdb elasticsearch file-sync

简短版本-- fs

将 ibm_file_sync 索引中的文件同步到磁盘。 如需了解更多信息，请参阅 将文件上传到 Elasticsearch 文档。

ibmcloud cdb elasticsearch file-sync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

命令选项

  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

在名为 "MyElasticsearch" 的部署上同步文件到磁盘。

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

简短版本-- ul

列出数据库内部凭证存储中的所有用户。 更多信息，请参阅 检索和更新用户密码。

ibmcloud cdb elasticsearch user-list (NAME|ID) (ADMIN_PASSWORD) [--output, -o FORMAT] [-c DIRECTORY] [--api-version]

命令选项

  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • -c DIRECTORY 证书根
  • --api-version 请求使用的 API 版本。

示例

user-list 命令会输出账户用户列表的各种选项。

ibmcloud cdb elasticsearch user-list

PostgreSQL

执行 PostgreSQL 部署的特定任务。

ibmcloud cdb postgresql earliest-pitr-timestamp

简短版本-- ept

以 ISO8601 UTC 格式返回时间点恢复的最早可用时间。 有关详细信息，请参阅 Point in Time Recovery 文档。

ibmcloud cdb postgresql earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

命令选项

  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

简短版本-- rsc

创建一个新的 PostgreSQL 复制插槽。 更多信息，请参阅 Wal2json 文档获取更多信息。

ibmcloud cdb postgresql replication-slot-create <deployment name or CRN> <databasename> <slotname> <plugintype> [--output, -o FORMAT] [--nowait]

插件类型必须是 " wal2json "。

命令选项

  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

在名为 "MyPostgres", 的部署上创建一个复制插槽，数据库名为 "testdb"，插槽名为" slot1 "。

ibmcloud cdb postgresql replication-slot-create MyPostgres testdb slot1 wal2json

ibmcloud cdb postgresql replication-slot-delete

简短版本-- rsd

删除指定的 PostgreSQL 复制插槽。 更多信息请参见 Wal2json 文件获取更多信息。

ibmcloud cdb postgresql replication-slot-delete <deployment name or CRN> <slotname> [--output, -o FORMAT] [--nowait]

命令选项

  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。

示例

删除名为 "MyPostgres" 的部署和名为 " slot1 " 的插槽上的复制插槽。

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB 企业

执行 MongoDB Enterprise 部署的特定任务。

ibmcloud cdb mongodbee earliest-pitr-timestamp

简短版本-- ept

以 ISO8601 UTC 格式返回时间点恢复的最早可用时间。 更多信息，请参阅“及时点恢复”。

ibmcloud cdb mongodb-enterprise earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

命令选项

  • --nowait 或 -n 不要等待小组设置任务完成。 显示缩放任务的详细信息并退出。
  • --output 或 -o FORMAT 指定输出格式。 仅支持 JSON。
  • api-version value 请求使用的 API 版本。

示例

ibmcloud cdb mongodb earliest-pitr-timestamp (NAME|ID)

Redis

执行 Redis 部署的特定任务。

ibmcloud cdb redis user-set

编辑 Redis 用户的角色。 更多信息，请参阅 管理 Redis RBAC。

ibmcloud cdb redis user-set <"roles">

示例

ibmcloud cdb redis user-set "-all +@read"