diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/scheduled-jobs/pkg-service.md b/product/zh/docs-mogdb/v3.0/developer-guide/scheduled-jobs/pkg-service.md index a9d5ca5abc3cebace61437e5d962b5461e1795ed..0f29ba01b40aad130d7cf7030a3c8d15d0cb03d0 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/scheduled-jobs/pkg-service.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/scheduled-jobs/pkg-service.md @@ -7,7 +7,7 @@ date: 2022-03-18 # PKG_SERVICE接口 -MogDB 2.1版本提供了以下PKG_SERVICE接口来实现定时任务管理。 +MogDB 3.0版本提供了以下PKG_SERVICE接口来实现定时任务管理。
@@ -132,9 +132,9 @@ MogDB 2.1版本提供了以下PKG_SERVICE接口来实现定时任务管理。 示例： ```sql - CALL PKG_SERVICE.JOB_UPDATE(101, 'call userproc();', sysdate, 'sysdate + 1.0/1440'); - - CALL PKG_SERVICE.JOB_UPDATE(101, 'insert into tbl_a values(sysdate);', sysdate, 'sysdate + 1.0/1440'); + CALL PKG_SERVICE.JOB_UPDATE(id=>101, next_time=>sysdate, interval_time=>'sysdate + 1.0/1440',content=>'call userproc();'); + + CALL PKG_SERVICE.JOB_UPDATE(id=>101, next_time=>sysdate, interval_time=>'sysdate + 1.0/1440',content=>'insert into tbl_a values(sysdate);'); ```
diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/docker-installation/docker-installation.md b/product/zh/docs-mogdb/v3.0/installation-guide/docker-installation/docker-installation.md index b1ea9e5de7d7d544994c921af6f6ac0eeb3649fe..bce86f67d1a669015d74acf16c0342e0bb82d178 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/docker-installation/docker-installation.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/docker-installation/docker-installation.md @@ -7,7 +7,7 @@ date: 2021-06-01 # 容器化安装 -本文档主要介绍MogDB容器版安装过程。MogDB容器版本不支持 MogHA工具、OM工具，目前最多支持一主八备。MogDB 2.1容器版支持最新版的compat-tools和插件功能。 +本文档主要介绍MogDB容器版安装过程。MogDB容器版本不支持 MogHA工具、OM工具，目前最多支持一主八备。MogDB 3.0容器版支持最新版的compat-tools和插件功能。 由于考虑尽可能缩减容器镜像的大小，以方便快速下载和部署，从2.0版本开始，容器化MogDB在容器里运行的操作系统在x86和ARM架构下分别运行在Ubuntu和Debian之上。 @@ -39,7 +39,7 @@ Docker Desktop下载地址： 2. 输入以下命令获取最新版MogDB镜像文件： ```bash - docker pull swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker pull swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` > 说明：MogDB镜像支持运行在x86和ARM架构中，会根据发起命令的服务器架构自动下载相应的镜像，无需手工指定。 @@ -53,7 +53,7 @@ Docker Desktop下载地址： 4. 继续输入以下命令创建一个新的容器，将容器命名为“mogdb”，以启动 MogDB 实例： ```bash - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v /mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` 对于Windows系统而言： @@ -63,13 +63,13 @@ Docker Desktop下载地址： ```bash docker volume create mogdata - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v mogdata:/var/lib/mogdb -p 15453:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v mogdata:/var/lib/mogdb -p 15453:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` - 如果Docker启用WSL 2做引擎，请执行以下命令创建容器： ```bash - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v C:\mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v C:\mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` > 注意： @@ -160,7 +160,7 @@ MogDB的密码有复杂度要求，密码长度8个字符以上，必须同时 --env GS_PASSWORD=Enmo@1234 \ --env NODE_NAME=mogdb_master \ --env REPL_CONN_INFO="replconninfo1 = 'localhost=172.18.0.10 localport=6439 localservice=6432 remotehost=172.18.0.11 remoteport=6439 remoteservice=6432 '\n" \ - swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 -M primary + swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta -M primary ``` 4. 创建备库容器： @@ -174,7 +174,7 @@ MogDB的密码有复杂度要求，密码长度8个字符以上，必须同时 --env GS_PASSWORD=Enmotech@1234 \ --env NODE_NAME=mogdb_slave_one \ --env REPL_CONN_INFO="replconninfo1 = 'localhost=172.18.0.11 localport=6439 localservice=6432 remotehost=172.18.0.10 remoteport=6439 remoteservice=6432 '\n" \ - enmotech/mogdb:2.1.1 -M standby + enmotech/mogdb:3.0.0_beta -M standby ``` 5. 查询主库角色状态： @@ -256,7 +256,7 @@ MogDB的密码有复杂度要求，密码长度8个字符以上，必须同时 ```sql [omm@mogdb_master ~] $ gsql -p6432 -gsql ((MogDB 2.1.1 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) +gsql ((MogDB 3.0.0 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. @@ -270,7 +270,7 @@ INSERT 0 1 ```sql [omm@mogdb_slave_one ~] $ gsql -p6432 -gsql ((MogDB 2.1.1 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) +gsql ((MogDB 3.0.0 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. @@ -375,7 +375,7 @@ No information ```sql [omm@mogdb_slave_one ~] $ gsql -p6432 -gsql ((MogDB 2.1.1 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) +gsql ((MogDB 3.0.0 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. @@ -393,7 +393,7 @@ INSERT 0 1 ```sql [omm@mogdb_master ~] $ gsql -p6432 -gsql ((MogDB 2.1.1 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) +gsql ((MogDB 3.0.0 build 56189e20) compiled at 2022-03-21 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. @@ -419,14 +419,14 @@ MogDB 2.1版本以后支持Kubernetes部署。 - x86 ``` - $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/2.1.1/k8s_amd.yaml + $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/3.0.0/k8s_amd.yaml pod/mogdb created ``` - arm ``` - $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/2.1.1/k8s_arm.yaml + $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/3.0.0/k8s_arm.yaml pod/mogdb created ``` diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/manual-installation.md b/product/zh/docs-mogdb/v3.0/installation-guide/manual-installation.md index 0957ba77a3cdce057775a4c6ba88c13c325d4a23..2230432ebed4e87d747906bc6d4d88f133bb0592 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/manual-installation.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/manual-installation.md @@ -42,11 +42,11 @@ date: 2021-10-14 /opt/mogdb/software [root@mogdb-kernel-0001 software]# ls -lrt total 90236 - -r-------- 1 root root 92401412 Jun 13 06:14 MogDB-2.1.1-openEuler-64bit.tar.bz2 - chown omm:dbgrp MogDB-2.1.1-openEuler-64bit.tar.bz2 + -r-------- 1 root root 92401412 Jun 13 06:14 MogDB-3.0.0-openEuler-64bit.tar.bz2 + chown omm:dbgrp MogDB-3.0.0-openEuler-64bit.tar.bz2 su - omm cd /opt/mogdb/software/ - tar -xf MogDB-2.1.1-openEuler-64bit.tar.bz2 + tar -xf MogDB-3.0.0-openEuler-64bit.tar.bz2 ``` ## 初始化数据库（单机） @@ -180,7 +180,7 @@ date: 2021-10-14 static_connections : 1 db_state : Normal detail_information : Normal - + Senders info: No information Receiver info: @@ -351,7 +351,7 @@ date: 2021-10-14 static_connections : 2 db_state : Normal detail_information : Normal - + Senders info: No information Receiver info: diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md index a9673a0ca6150adb27a341845ac5185a7ff19270..2465b4153bc6207f67aa7b75678a0fe673f0951e 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md @@ -32,7 +32,7 @@ date: 2021-06-11 > + 在允许访问外网的环境中可通过wget命令直接下载标准安装包： > > ```bash - > wget -c https://cdn-mogdb.enmotech.com/mogdb-media/2.1.1/MogDB-2.1.1-openEuler-arm_64.tar + > wget -c https://cdn-mogdb.enmotech.com/mogdb-media/3.0.0/MogDB-3.0.0-openEuler-arm_64.tar > ``` > > 然后执行tar命令解压即可。 @@ -76,8 +76,8 @@ date: 2021-06-11 | 项目 | 配置描述 | | :------- | :----------------------------------------------------------- | | 内存 | 功能调试建议32GB以上。
性能测试和商业部署时，单实例部署建议128GB以上。
复杂的查询对内存的需求量比较高，在高并发场景下，可能出现内存不足。此时建议使用大内存的机器，或使用负载管理限制系统的并发。 | -| CPU | 功能调试最小1×8 核 2.0GHz。
性能测试和商业部署时，建议1×16核 2.0GHz。
CPU超线程和非超线程两种模式都支持。
说明：
个人开发者最低配置2核4G，推荐配置4核8G。
目前，MogDB支持鲲鹏920处理器，海光3000、5000、7000系列处理器，兆芯KH30000、KH20000、ZX-C+系列处理器和基于X86_64通用PC服务器的CPU。 | -| 硬盘 | 用于安装MogDB的硬盘需最少满足如下要求：
- 至少1GB用于安装MogDB的应用程序。
- 每个主机需大约300MB用于元数据存储。
- 预留70%以上的磁盘剩余空间用于数据存储。
建议系统盘配置为Raid1，数据盘配置为Raid5，且规划4组Raid5数据盘用于安装MogDB。有关Raid的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。
MogDB支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。 | +| CPU | 功能调试最小1×8 核，2.0GHz。
性能测试和商业部署时，建议1×16核，2.0GHz。
CPU超线程和非超线程两种模式都支持。
说明：
个人开发者最低配置2核4G，推荐配置4核8G。
目前，MogDB支持鲲鹏920处理器，海光3000、5000、7000系列处理器，兆芯KH30000、KH20000、ZX-C+系列处理器和基于X86_64通用PC服务器的CPU。 | +| 硬盘 | 用于安装MogDB的硬盘需最少满足如下要求：
- 至少1GB用于安装MogDB的应用程序。
- 每个主机需大约300MB用于元数据存储。
- 预留70%以上的磁盘剩余空间用于数据存储。
建议系统盘配置为RAID1，数据盘配置为RAID5，且规划4组RAID5数据盘用于安装MogDB。有关RAID的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。
MogDB支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。 | | 网络要求 | 300兆以上以太网。
建议网卡设置为双网卡冗余bond。有关网卡冗余bond的配置方法在本手册中不做介绍。请参考硬件厂商的手册或互联网上的方法进行配置。 | ### 软件环境要求 @@ -125,11 +125,16 @@ MogDB的软件依赖要求如表4 软件依赖要求所示。 | readline-devel | 建议版本：7.0-13 | | libnsl（openeuler+x86环境中） | 建议版本 ：2.28-36 | | openSSH | 建议版本 ：8.4p1 | +| expect | 建议版本 ：5.45.4 |
## 配置操作系统 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**注意：** +> +> 以下动作需要以root用户进行操作，操作完成后请及时注销root用户，避免误操作。 + ### 关闭操作系统防火墙 为了在防火墙开启的状态下，确保MogDB的正常使用。用户需要将同MogDB相关的服务、协议、IP以及端口添加到MogDB主机的防火墙白名单中。 @@ -228,6 +233,7 @@ vim /etc/profile ### (可选）关闭swap交换内存 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> > 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 @@ -295,3 +301,33 @@ swapoff -a ``` 6. 在其他主机上重复[步骤1](#buzhou1)到[步骤5](#buzhou5)。 + +### 关闭HISTORY记录 + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> +> 为避免指令历史记录安全隐患，需关闭各主机的history指令。 + +1. 修改根目录下/etc/profile文件。 + + ``` + vim /etc/profile + ``` + +2. 设置HISTSIZE值为0。例如，系统中HISTSIZE默认值为1000，将其修改为0。 + + ``` + HISTSIZE=0 + ``` + +3. 保存/etc/profile。 + + ``` + :wq + ``` + +4. 设置/etc/profile生效。 + + ``` + source /etc/profile + ``` diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md index 08acecda1e58e0c41927daad9a4e8b3a712be41d..91c9fded6d92100f76cd8d515bf1d862c435a0a7 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md @@ -35,16 +35,28 @@ date: 2021-06-11 4. 执行install.sh脚本安装MogDB。 ``` - sh install.sh -w xxxx + sh install.sh -w Enmo@123 &&source ~/.bashrc ``` > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** > - > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。密码应包括大小写、字符、数字。 - > - -p：指定的MogDB端口号, 如不指定，默认为5432。 - > - -h|-help 打印使用说明。 - > - 安装后，数据库的名称为sgnode。 + > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 + > + > - -p：指定的MogDB端口号，如不指定，默认为5432。 + > + > - -h|--help：打印使用说明。 + > + > - 安装后，数据库的名称为sgnode（gs_initdb指定）。 + > + > - 执行时，如果出现报错“the maximum number of SEMMNI is not correct, the current SEMMNI is xxx. Please check it.”，请使用有root权限的用户执行如下命令。 + > + > ``` + > sysctl -w kernel.sem="250 85000 250 330" + > ``` + > > - 安装后，数据库目录安装路径/opt/software/mogdb/data/single_node，其中/opt/software/mogdb为解压包路径，data/single_node为新创建的数据库节点目录。 + > + > - 安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。 5. 安装执行完成后，使用ps和gs_ctl查看进程是否正常。 @@ -85,12 +97,12 @@ date: 2021-06-11 source ~/.bash_profile -bash: ulimit: open files: cannot modify limit: Operation not permitted （默认设置fd可用大小超过系统设置，可以忽略该设置） - + -- 登录数据库 gsql -d postgres -p 5432 -r gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + MogDB=# ``` \ No newline at end of file diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md index 8e1cfd59b1184ed82f9d0d04f4b627959660587b..fce87fb848c6f9e480e832e6f844e8bc11a5fd50 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md @@ -35,15 +35,15 @@ date: 2021-06-11 4. 执行install.sh脚本安装MogDB。 ``` - sh install.sh -w xxxx --multinode + sh install.sh -w Enmo@123 --multinode ``` > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** > - > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 密码应包括大小写、字符、数字。 + > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 > - -p：指定的MogDB主节点端口号，默认5432。备节点端口号会使用主端口号+200，默认5632。 - > - -multinode: 用来区分是单节点还是一主一备安装。 - > - -h|-help 打印使用说明。 + > - --multinode：用来区分是单节点还是一主一备安装。 + > - -h|--help：打印使用说明。 > - 安装后，数据库的主节点名称为nodename1，备节点名称为nodename2。 > - 安装后，数据库主节点目录安装路径/opt/software/mogdb/data/master，备节点目录安装路径为/opt/software/mogdb/data/slave，其中/opt/software/mogdb为解压包路径，data/master(slave)为新创建的数据库节点目录。 @@ -104,12 +104,12 @@ date: 2021-06-11 source ~/.bash_profile -bash: ulimit: open files: cannot modify limit: Operation not permitted （默认设置fd可用大小超过系统设置，可以忽略该设置） - + -- 登录数据库 gsql -d postgres -p 5432 -r gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + MogDB=# ``` \ No newline at end of file diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md index 3146d3e8928f849df89c8e5fefe7028d6c98040b..4f9ea3c3f8c439bde05ed1edf7ed9c653234807a 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md @@ -8,3 +8,5 @@ date: 2021-04-02 # 安装概述 MogDB支持单机部署和单机HA部署两种部署方式。单机部署时，可在一个主机部署多个数据库实例，但为了数据安全，不建议用户这样部署。单机HA部署支持一台主机和最少一台备机，最多可配置8台备机。 + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** 通过MogDB提供的脚本安装时，只允许在单台物理机部署一个数据库系统。如果您需要在单台物理机部署多个数据库系统，建议您通过命令行安装，不需要通过MogDB提供的安装脚本执行安装。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/2-environment-requirement.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/2-environment-requirement.md index 45a6583f927548c3c6df2dd4b6ca9ac765c82ace..118c6149cf8f9435e691ba886e04de0d93ea9c91 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/2-environment-requirement.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/2-environment-requirement.md @@ -13,9 +13,9 @@ date: 2021-04-2 | 项目 | 配置描述 | | -------- | ------------------------------------------------------------ | -| 最小内存 | 功能调试32GB以上。
性能测试和商业部署时，单实例部署建议128GB以上。
复杂的查询对内存的需求量比较高，在高并发场景下，可能出现内存不足。此时建议使用大内存的机器，或使用负载管理限制系统的并发。 | -| CPU | 功能调试最小1×8 核 2.0GHz。
性能测试和商业部署时，单实例部署建议1×16核 2.0GHz。
CPU超线程和非超线程两种模式都支持。但是，MogDB各节点的设置需保持一致。 | -| 硬盘 | 用于安装MogDB的硬盘需最少满足如下要求：
- 至少1GB用于安装MogDB的应用程序包。
- 每个主机需大约300MB用于元数据存储。
- 预留70%以上的磁盘剩余空间用于数据存储。
建议系统盘配置为Raid1，数据盘配置为Raid5，且规划4组Raid5数据盘用于安装MogDB。有关Raid的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。
MogDB支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。 | +| 内存 | 功能调试32GB以上。
性能测试和商业部署时，单实例部署建议128GB以上。
复杂的查询对内存的需求量比较高，在高并发场景下，可能出现内存不足。此时建议使用大内存的机器，或使用负载管理限制系统的并发。 | +| CPU | 功能调试最小1×8 核，2.0GHz。
性能测试和商业部署时，单实例部署建议1×16核，2.0GHz。
CPU超线程和非超线程两种模式都支持。但是，MogDB各节点的设置需保持一致。 | +| 硬盘 | 用于安装MogDB的硬盘需最少满足如下要求：
- 至少1GB用于安装MogDB的应用程序。
- 每个主机需大约300MB用于元数据存储。
- 预留70%以上的磁盘剩余空间用于数据存储。
建议系统盘配置为RAID1，数据盘配置为RAID5，且规划4组RAID5数据盘用于安装MogDB。有关RAID的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。
MogDB支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。 | | 网络要求 | 300兆以上以太网。
建议网卡设置为双网卡冗余bond。有关网卡冗余bond的配置方法在本手册中不做介绍。请参考硬件厂商的手册或互联网上的方法进行配置。
MogDB网络如果配置bond，请保证bond模式一致，不一致的bond配置可能导致MogDB工作异常。 | ## 软件环境要求 @@ -25,7 +25,7 @@ date: 2021-04-2 | rdtscp指令集（x86） | 执行`lscpu \| grep rdtscp`命令查看是否支持rdtscp指令集。 | | bmi2指令集（CentOS） | 执行`lscpu \| grep bmi2`命令查看是否支持bmi2指令集。 | | 工具 | Huawei JDK 1.8.0、psmisc、bzip2 | -| Python | - openEuler：支持Python 3.7.X
- CentOS：支持Python 3.6.X
- 麒麟：支持Python 3.7.X
说明：
python需要通过-enable-shared方式编译。 | +| Python | - openEuler：支持Python 3.7.X
- CentOS：支持Python 3.6.X
- 麒麟：支持Python 3.7.X
说明：
python需要通过--enable-shared方式编译。 | ## 操作系统要求 @@ -54,5 +54,6 @@ date: 2021-04-2 | readline-devel | 建议版本：7.0-13 | | libnsl（openEuler+x86环境中） | 建议版本：2.28-36 | | openSSH | 建议版本 ：8.4p1 | +| expect | 建议版本 ：5.45.4 | 注：实际测试4G内存也能安装（需要修改配置文件内存参数），4G以上内存不需要修改。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md index 9749e9439ef63e77feabb98c71cf8dace1c54dda..3fc729b2da20dc934e548b47db57f7f73a45a7a0 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md @@ -7,13 +7,17 @@ date: 2021-04-2 # 修改操作系统配置 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**注意：** +> +> 以下动作需要以root用户进行操作，操作完成后请及时注销root用户，避免误操作。 + ## 关闭操作系统防火墙 为了在防火墙开启的状态下，确保MogDB的正常使用。用户需要将同MogDB相关的服务、协议、IP以及端口添加到MogDB各主机的防火墙白名单中。 -以openEuler操作系统为例，假设MogDB信息如[表1 MogDB信息](#mogdb)所示。 +以openEuler操作系统为例，假设MogDB信息如表1所示。 -**表 1** MogDB信息 +**表 1** MogDB信息 | 主机名称 | 内部IP | 外部IP | | :------- | :----------- | :----------- | @@ -107,11 +111,21 @@ swapoff -a ## 设置网卡MTU值 -将各数据库节点的网卡MTU值设置为相同大小。对于x86，MTU值推荐1500；对于ARM，MTU值推荐8192。 +将各数据库节点的网卡MTU值设置为相同大小。 -``` -ifconfig 网卡编号 mtu 值 -``` +**操作步骤** + +1. 执行如下命令查询服务器的网卡名称。 + + ``` + ifconfig + ``` + +2. 使用如下命令将各数据库节点的网卡MTU值设置为相同大小。对于X86，MTU值推荐1500；对于ARM，MTU值推荐8192。 + + ``` + ifconfig 网卡编号 mtu 值 + ``` ## 关闭RemoveIPC @@ -163,10 +177,44 @@ ifconfig 网卡编号 mtu 值 5. 在其他主机上重复步骤[1](#01)到步骤[4](#04)。 +## 关闭HISTORY记录 + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> +> 为避免指令历史记录安全隐患，需关闭各主机的history指令。 + +1. 修改根目录下/etc/profile文件。 + + ``` + vim /etc/profile + ``` + +2. 设置HISTSIZE值为0。例如，系统中HISTSIZE默认值为1000，将其修改为0。 + + ``` + HISTSIZE=0 + ``` + +3. 保存/etc/profile。 + + ``` + :wq + ``` + +4. 设置/etc/profile生效。 + + ``` + source /etc/profile + ``` + ## 设置root用户远程登录 在MogDB安装时需要root帐户远程登录访问权限，本章介绍如何设置使用root用户远程登录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> +> 数据库需要root互信时才开启远程连接。操作完成并且验证完毕后请及时注销root用户，避免误操作。 + 1. 修改PermitRootLogin配置，允许用户远程登录。 a. 打开sshd_config文件。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md index 04ef1deb5656d17b22d471bb3c613faa9589c6cd..104df8af0c9c85e8044645c6d848ca41e0902f40 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md @@ -9,11 +9,62 @@ date: 2021-04-2 ## 创建XML配置文件 -安装MogDB前需要创建XML文件。XML文件包含部署MogDB的服务器信息、安装路径、IP地址以及端口号等。用于告知MogDB如何部署。用户需根据不同场配置对应的XML文件。 +安装MogDB前需要创建cluster_config.xml文件。cluster_config.xml文件包含部署MogDB的服务器信息、安装路径、IP地址以及端口号等。用于告知MogDB如何部署。用户需根据不同场配置对应的XML文件。
-**参数说明** +### 配置数据库名称及各项目录 + +在script/gspylib/etc/conf/cluster_config_template.xml获取XML文件模板。以下配置内容为示例，可自行替换。 + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> +> - “/opt/mogdb/install/om”存放互信等工具，为了避免权限问题，不要把实例数据目录放在此目录下。 +> - 安装目录和数据目录需为空或者不存在，否则可能导致安装失败。 +> - 在对数据库节点的实例进行具体配置时，需确保配置的目录之间不相互耦合。即各个配置目录不关联，删除其中任意一个目录，不会级联删除其它目录。如gaussdbAppPath为“/opt/mogdb/install/app”，gaussdbLogPath为“/opt/mogdb/install/app/omm”。当gaussdbAppPath目录被删除时，会级联删除gaussdbLogPath目录，从而引起其它问题。 +> - 若需要安装脚本自动创建安装用户时，各配置的目录需保证不与系统创建的默认用户目录耦合关联。 +> - 配置MogDB路径和实例路径时，路径中不能包含“|”、“;”、“&”、“$”、“<”、“>”、“`”、“\\”、“'”、“\”、“,”、“{”，“}”、“(”，“)”、“[”，“]”、“~”、“*”、“?”特殊字符。 +> - 配置数据库节点名称时，请通过hostname命令获取数据库节点的主机名称，替换示例中的**node1_hostname**，**node2_hostname**。 +> - 配置dcf_config时，角色的配置有leader、follower、passive和logger，其中可投票的角色有leader、follower和logger。配置角色组网时，可投票的角色不能少于3个，因此dcf模式下至少需要三个节点。 + +**表 1** 参数说明 @@ -71,14 +122,124 @@ date: 2021-04-2 - - + + + + + +
MogDB core文件的指定目录。
clusterType - MogDB类型，MogDB拓扑类型；可选字段。
- “single-inst”表示单机一主多备部署形态。 - 		enable_dcf是否开启DCF模式。
dcf_config开启DCF模式时配置，DCF启动节点信息。
+### 配置Host基本信息 + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> +> - 每台Host服务器都必须有如下信息，如下示例以node1为例。 +> - 加粗字体内容为示例，可自行替换。每行信息均有注释进行说明。 + +```xml + + + + + + + + + + + + + + +``` + +**表 2** 参数说明 + +| 参数 | 说明 | +| :--------- | :----------------------------------------------------------- | +| name | 主机名称。 | +| azName | 指定azName（Available Zone Name），字符串（不能含有特殊字符），例如AZ1、AZ2、AZ3。 | +| azPriority | 指定azPriority的优先级。 | +| backIp1 | 主机在后端存储网络中的IP地址（内网IP）。所有MogDB主机使用后端存储网络通讯。 | +| sshIp1 | 设置SSH可信通道IP地址（外网IP）。若无外网，则可以不设置该选项或者同backIp1设置相同IP。 | + +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> +> 配置文件中所有IP参数（包含backIp、sshIp、listenIp等）均只支持配置一个IP。如果配置第二个IP参数，则不会读取第二个参数的配置值。 示例：xml配置文件中同时配置backIp1和backIp2参数： 在解析配置文件时仅读取backIp1参数的配置值，不会读取backIp2参数的配置值。 +> +> ```xml +> +> +> ``` + +### 配置数据库主节点信息 + +内容为示例，可自行替换。每行信息均有注释进行说明。 + +**数据库主节点配置以下信息。** + +```xml + + + + + + + + + + + + +``` + +**表 3** DBnode参数说明 + +| 参数 | 说明 | +| :---------------- | :----------------------------------------------------------- | +| dataNum | 当前主机上需要部署的数据库节点个数。 | +| dataPortBase | 数据库节点的基础端口号，默认值40000。 | +| dataListenIp1 | 侦听的IP地址。未设置时，使用对应主机上的backIp1生成。第一个IP是主节点所在主机IP，第二个IP是备节点所在主机IP。 | +| dataNode1 | 用于指定当前主机上的数据库节点的数据存储目录。此目录为数据库的数据存储目录。应规划到数据盘上。 | +| dataNodeXlogPath1 | 可选参数，用于指定当前数据库中xlog存储路径。此目录为数据库xlog日志存储目录，只支持绝对路径。如不指定，则默认存放在数据目录的pg_xlog目录下。 | +| dataNode1_syncNum | 可选参数，用于指定当前数据库中同步模式的节点数目。取值范围为0~数据库备机节点数。 | + +### 配置CM_SERVER（主、非主）信息 + +**非CMS主节点配置以下信息。** + +```xml + + + +``` + +**表 4** CM参数说明 + +| 参数 | 说明 | +| :------------------ | :----------------------------------------------------------- | +| cmServerPortBase | 主CM Server端口号，默认值5000。 | +| cmServerPortStandby | 备CM Server端口号，默认值5500。 | +| cmServerListenIp1 | CM Server用于侦听CM Agent连接请求或DBA管理请求的IP地址。 | +| cmServerHaIp1 | 主、备CM Server间通信的IP地址。Value中左边为主CM Server的主机IP地址，右边为备CM Server的主机IP地址。未设置时，默认根据主、备CM Server所在主机的backIp1生成。 | +| cmDir | CM数据文件路径。保存CM Server和CM Agent用到的数据文件，参数文件等。各集群主机上均需配置该参数。 | + +**表 5** 目录说明 + +| 目录 | 说明 | +| :-------------- | :----------------------------------------------------------- | +| /opt/mogdb/data | 集群实例的数据存储总目录。此目录为数据库的数据存储目录。应规划到数据盘上。此目录应满足如下要求：磁盘空间请根据实际业务数据量大小规划。各实例间的数据路径相互独立，彼此间没有包含关系。例如本指南中各实例的数据目录规划如表6所示。 | + +**表 6** 数据库实例数据目录 + +| 实例名称 | 实例数据目录 | +| :------- | :----------------------------------------------------------- | +| CM | /opt/mogdb/data/cm | +| 主DN | /opt/mogdb/data/masterX其中，X为从1开始的连续正整数，用于标识当前主机上的第X个DN。 | +| 备DN | /opt/mogdb/data/slaveX其中，X为从1开始的连续正整数，用X标识当前主机上的第X个备DN。 | + ### 示例 #### 单节点配置文件 @@ -88,31 +249,41 @@ date: 2021-04-2 + - - - - - - - + + + + + + + + + + + + + + - - - - + + + + + - - - - - - - - + + + + + + + + + @@ -127,41 +298,54 @@ date: 2021-04-2 - - - - - - + + + + + + + + + + + + + - + + - - - + + + + + - - - - - + + + + + - - + + + - - - + + + + + - - - - + + + + ``` @@ -174,56 +358,73 @@ date: 2021-04-2 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ``` -> 说明：替换主机名和IP，其他参数默认即可。/mogdb/data/db1为数据存储路径，可根据需要替换。 +> 说明：替换主机名和IP，其他参数默认即可。
@@ -254,7 +455,7 @@ date: 2021-04-2 1. 以root用户执行以下命令安装所需的基础环境包，以避免后续安装过程中因系统采用最小化安装或者安装包不全导致的报错。 ``` - yum install -y libaio-devel gcc gcc-c++ zlib-devel + yum install -y libaio-devel gcc gcc-c++ zlib-devel except ``` 2. 以root用户登录待安装MogDB的任意主机，并按规划创建存放安装包的目录，下文以`/opt/software/mogdb`为例。 @@ -274,7 +475,7 @@ date: 2021-04-2 > 在允许访问外网的环境中，可通过`wget`命令直接下载适用于当前操作系统和CPU的安装包： > > ``` - > wget -c https://cdn-mogdb.enmotech.com/mogdb-media/2.1.1/MogDB-2.1.1-CentOS-x86_64.tar + > wget -c https://cdn-mogdb.enmotech.com/mogdb-media/3.0.0/MogDB-3.0.0-CentOS-x86_64.tar > ``` 4. 在安装包所在的目录下，依次解压安装包。 @@ -460,10 +661,10 @@ Successfully installed application. ## 连接数据库 -安装完成后，可使用omm用户通过“gsql -d postgres -p 26000 -r”命令连接MogDB数据库，其中“-p 26000”为数据库端口号，请根据实际情况替换。键入“\copyright”可查看版权信息。 +安装完成后，可使用omm用户通过“gsql -d postgres -p 15400 -r”命令连接MogDB数据库，其中“-p 15400”为数据库端口号，请根据实际情况替换。键入“\copyright”可查看版权信息。 ```sql -[omm@ecs-saving-0006 ~]$ gsql -d postgres -p 26000 -r +[omm@ecs-saving-0006 ~]$ gsql -d postgres -p 15400 -r gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/5-verifying-installation.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/5-verifying-installation.md index 549d0804c4a0c4cc6527303b58fe78441ee4cf92..2af784704fd8c2774438b0abd7ebd16a1fe5097c 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/5-verifying-installation.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/5-verifying-installation.md @@ -25,8 +25,8 @@ MogDB数据库已安装。 3. 数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。 - 其中postgres为需要连接的数据库名称，26000为数据库主节点的端口号，即XML配置文件中的dataPortBase的值。请根据实际情况替换。 + 其中postgres为需要连接的数据库名称，15400为数据库主节点的端口号，即XML配置文件中的dataPortBase的值。请根据实际情况替换。 ```bash - gsql -d postgres -p 26000 + gsql -d postgres -p 15400 ``` diff --git a/product/zh/docs-mogdb/v3.0/quick-start/container-based-installation.md b/product/zh/docs-mogdb/v3.0/quick-start/container-based-installation.md index 9c5cd0ebb1b520ab87a1355bd4e7b47f35e8fa3c..fcad0d3d12c7fa9a3d393d0631570f2210352ae7 100644 --- a/product/zh/docs-mogdb/v3.0/quick-start/container-based-installation.md +++ b/product/zh/docs-mogdb/v3.0/quick-start/container-based-installation.md @@ -7,7 +7,7 @@ date: 2021-03-30 # 容器化MogDB安装 -本文档主要介绍MogDB容器版安装过程。MogDB容器版本不支持 MogHA工具、OM工具，目前最多支持一主八备。MogDB 2.1容器版支持最新版的compat-tools和插件功能。
由于考虑尽可能缩减容器镜像的大小，以方便快速下载和部署，从2.0版本开始，容器化MogDB在容器里运行的操作系统在x86和ARM架构下分别运行在Ubuntu和Debian之上。
+本文档主要介绍MogDB容器版安装过程。MogDB容器版本不支持 MogHA工具、OM工具，目前最多支持一主八备。MogDB 3.0容器版支持最新版的compat-tools和插件功能。
由于考虑尽可能缩减容器镜像的大小，以方便快速下载和部署，从2.0版本开始，容器化MogDB在容器里运行的操作系统在x86和ARM架构下分别运行在Ubuntu和Debian之上。
x86-64架构的MogDB容器运行在Ubuntu 18.04操作系统中。
ARM64架构的MogDB容器运行在Debian 10 操作系统中。 @@ -33,7 +33,7 @@ Docker Desktop下载地址： 2. 输入以下命令获取最新版MogDB镜像文件： ```bash - docker pull swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker pull swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` > 说明：MogDB镜像支持运行在x86和ARM架构中，会根据发起命令的服务器架构自动下载相应的镜像，无需手工指定。 @@ -47,7 +47,7 @@ Docker Desktop下载地址： 4. 继续输入以下命令创建一个新的容器，将容器命名为“mogdb”，以启动MogDB实例： ```bash - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v /mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` 对于Windows系统而言： @@ -57,13 +57,13 @@ Docker Desktop下载地址： ```bash docker volume create mogdata - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v mogdata:/var/lib/mogdb -p 15453:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v mogdata:/var/lib/mogdb -p 15453:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` - 如果Docker启用WSL 2做引擎，请执行以下命令创建容器： ```bash - docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Secretpassword@123 -v C:\mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:2.1.1 + docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v C:\mogdb:/var/lib/mogdb -p 15432:5432 swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:3.0.0_beta ``` > 注意： @@ -130,14 +130,14 @@ MogDB 2.1版本以后支持Kubernetes部署。 - x86 ``` - $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/2.1.1/k8s_amd.yaml + $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/3.0.0/k8s_amd.yaml pod/mogdb created ``` - arm ``` - $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/2.1.1/k8s_arm.yaml + $ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/3.0.0/k8s_arm.yaml pod/mogdb created ``` diff --git a/product/zh/docs-mogdb/v3.0/quick-start/installation-on-a-single-node.md b/product/zh/docs-mogdb/v3.0/quick-start/installation-on-a-single-node.md index dabf90f68b29fe02a33fad8d62753c8f1797d571..c13535ace78cb4ec7e4cd5ab9144870ea0c8bef9 100644 --- a/product/zh/docs-mogdb/v3.0/quick-start/installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v3.0/quick-start/installation-on-a-single-node.md @@ -37,7 +37,7 @@ date: 2021-04-2 2. 安装依赖包 ``` - yum install libaio-devel flex bison ncurses-devel glibc-devel patch redhat-lsb-core readline-devel -y + yum install libaio-devel flex bison ncurses-devel glibc-devel patch redhat-lsb-core readline-devel except -y ``` 3. 设置时区 @@ -98,14 +98,14 @@ date: 2021-04-2 4. 执行install.sh脚本安装MogDB。 ```bash - sh install.sh -w xxxx + sh install.sh -w Enmo@123 ``` > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > - > - -w: 初始化数据库密码（gs_initdb指定），安全需要必须设置。 - > - -p: 指定的MogDB端口号，如不指定，默认为5432。 - > - -h|-help 打印使用说明。 + > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 + > - -p：指定的MogDB端口号，如不指定，默认为5432。 + > - -h|--help：打印使用说明。 > - 安装后，数据库的名称为sgnode。 > - 安装后，数据库目录安装路径`/opt/software/mogdb/data/single_node`，其中`/opt/software/mogdb`为解压包路径，`data/single_node`为新创建的数据库节点目录。 diff --git a/product/zh/docs-mogdb/v3.0/quick-start/mogila.md b/product/zh/docs-mogdb/v3.0/quick-start/mogila.md index f8d379d9ba0db08221ea60f830d663ac9068af41..c76037a28f574a9fb08365ff8cc30de36266370c 100644 --- a/product/zh/docs-mogdb/v3.0/quick-start/mogila.md +++ b/product/zh/docs-mogdb/v3.0/quick-start/mogila.md @@ -68,7 +68,7 @@ MogDB容器版本已经内置了Mogila样本数据库，无需额外安装。 ## 在MogDB企业版中使用Mogila -1. [安装MogDB企业版](https://docs.mogdb.io/zh/mogdb/v2.1/installation-on-a-single-node)。 +1. [安装MogDB企业版](installation-on-a-single-node)。 2. 创建样本数据库mogila及mogdb用户，然后登出： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-GLOBAL-CONFIGURATION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-GLOBAL-CONFIGURATION.md index c909f74ea80480d6a49631bc301e146e08e88318..200aa0209965341451fcad18202eded56bad2113 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-GLOBAL-CONFIGURATION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-GLOBAL-CONFIGURATION.md @@ -18,10 +18,30 @@ date: 2022-05-16 ## 语法格式 -```ebnf+diagram -AlterGlobalConfiguration ::= ALTER GLOBAL CONFIGURATION with ( argname = argvalue [, ... ]); +``` +ALTER GLOBAL CONFIGURATION with(参数名称=参数值，参数名称=参数值...); ``` ## 参数说明 参数名称和参数值都是text类型。 + +## 示例 + +```sql +--修改系统表gs_global_config的参数值。 +MogDB=# select * from GS_GLOBAL_CONFIG; + name | value +-------------+------- + buckets_len | 16384 +(1 row) + +MogDB=# ALTER GLOBAL CONFIGURATION with (buckets_len=16383); +ALTER GLOBAL CONFIGURATION + +MogDB=# select * from GS_GLOBAL_CONFIG; + name | value +-------------+------- + buckets_len | 16383 +(1 row) +``` \ No newline at end of file diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md index 76e50323aefcb9e9fdc468288e9b1ed35e1be7cc..9fc91a8883e16011daecb4952733d1a7c1ab7ebd 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md @@ -25,11 +25,11 @@ ALTER INDEX用于修改现有索引的定义。 这个选项会改变索引的表空间为指定表空间，并且把索引相关的数据文件移动到新的表空间里。 -- SET ( { STORAGE_PARAMETER = value } [, …] ) +- SET ( { STORAGE_PARAMETER = value } [, ...] ) 改变索引的一个或多个索引方法特定的存储参数。 需要注意的是索引内容不会被这个命令立即修改，根据参数的不同，可能需要使用REINDEX重建索引来获得期望的效果。 -- RESET ( { storage_parameter } [, …] ) +- RESET ( { storage_parameter } [, ...] ) 重置索引的一个或多个索引方法特定的存储参数为缺省值。与SET一样，可能需要使用REINDEX来完全更新索引。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-PUBLICATION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-PUBLICATION.md index aaf7730783096559ca1cf0e6dbc79bbe3f67fec2..0bf88583ee6de201a2595635792d039bdbe7a6d2 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-PUBLICATION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-PUBLICATION.md @@ -63,7 +63,7 @@ date: 2022-05-16 现有表的名称。 -- **SET ( publication_parameter [= value] [, … ] )。** +- **SET ( publication_parameter [= value] [, ...] )。** 该子句修改最初由CREATE PUBLICATION设置的发布参数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-SUBSCRIPTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-SUBSCRIPTION.md index 54665eb2ac0fdf890549af00e969cb3a61176408..91e0f7e7b73f8ba25cd29f5011a76531c2b7c78b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-SUBSCRIPTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-SUBSCRIPTION.md @@ -67,7 +67,7 @@ ALTER SUBSCRIPTION可以修改在CREATE SUBSCRIPTION中指定的订阅属性。 指定订阅是否应该主动复制，或者是否应该只是设置，但尚未启动。默认值是true。 -- **SET ( subscription_parameter [= value] [, … ] )** +- **SET ( subscription_parameter [= value] [, ... ] )** 该子句修改原先由CREATE SUBSCRIPTION设置的参数。允许的选项是slot_name和synchronous_commit。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md index dd51d68e1d495ee50e696df1aa12bc0101395581..590e99bfb5977c936e15de953ee6378a80e32244 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md @@ -219,7 +219,7 @@ date: 2021-05-17 分区键值。 - 通过PARTITION FOR ( partition_value [, …] )子句指定的这一组值，可以唯一确定一个分区。 + 通过PARTITION FOR ( partition_value [, ...] )子句指定的这一组值，可以唯一确定一个分区。 取值范围: 需要进行重命名的分区的分区键的取值范围。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md index 824c5c96de11b921e4e34b3991b063f9f3be58f9..416888066ef76f8bdbef464ae9c7c57e1cebeb43 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md @@ -79,14 +79,14 @@ date: 2021-05-17 > - **DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ]** 删除一个表上的约束。 > - **CLUSTER ON index_name** 为将来的CLUSTER（聚簇）操作选择默认索引。实际上并没有重新盘簇化处理该表。 > - **SET WITHOUT CLUSTER** 从表中删除最新使用的CLUSTER索引。这样会影响将来那些没有声明索引的CLUSTER（聚簇）操作。 - > - **SET ( {storage_parameter = value} [, … ] )** 修改表的一个或多个存储参数。 - > - **RESET ( storage_parameter [, … ] )** 重置表的一个或多个存储参数。与SET一样，根据参数的不同可能需要重写表才能获得想要的效果。 + > - **SET ( {storage_parameter = value} [, ... ] )** 修改表的一个或多个存储参数。 + > - **RESET ( storage_parameter [, ... ] )** 重置表的一个或多个存储参数。与SET一样，根据参数的不同可能需要重写表才能获得想要的效果。 > - **OWNER TO new_owner** 将表、序列、视图的属主改变成指定的用户。 > - **SET TABLESPACE new_tablespace** 这种形式将表空间修改为指定的表空间并将相关的数据文件移动到新的表空间。但是表上的所有索引都不会被移动，索引可以通过ALTER INDEX语法的SET TABLESPACE选项来修改索引的表空间。 > - **SET {COMPRESS|NOCOMPRESS}** 修改表的压缩特性。表压缩特性的改变只会影响后续批量插入的数据的存储方式，对已有数据的存储毫无影响。也就是说，表压缩特性的修改会导致该表中同时存在着已压缩和未压缩的数据。 - > - **TO { GROUP groupname | NODE ( nodename [, … ] ) }** 此语法仅在扩展模式（GUC参数support_extended_features为on时）下可用。该模式谨慎打开，主要供内部扩容工具使用，一般用户不应使用该模式。 - > - **ADD NODE ( nodename [, … ] )** 此语法主要供内部扩容工具使用，一般用户不建议使用。 - > - **DELETE NODE ( nodename [, … ] )** 此语法主要供内部缩容工具使用，一般用户不建议使用。 + > - **TO { GROUP groupname | NODE ( nodename [, ... ] ) }** 此语法仅在扩展模式（GUC参数support_extended_features为on时）下可用。该模式谨慎打开，主要供内部扩容工具使用，一般用户不应使用该模式。 + > - **ADD NODE ( nodename [, ... ] )** 此语法主要供内部扩容工具使用，一般用户不建议使用。 + > - **DELETE NODE ( nodename [, ... ] )** 此语法主要供内部缩容工具使用，一般用户不建议使用。 > - **DISABLE TRIGGER [ trigger_name | ALL | USER ]** 禁用trigger_name所表示的单个触发器，或禁用所有触发器，或仅禁用用户触发器（此选项不包括内部生成的约束触发器，例如，可延迟唯一性和排除约束的约束触发器）。 应谨慎使用此功能，因为如果不执行触发器，则无法保证原先期望的约束的完整性。 > - **| ENABLE TRIGGER [ trigger_name | ALL | USER ]** 启用trigger_name所表示的单个触发器，或启用所有触发器，或仅启用用户触发器。 > - **| ENABLE REPLICA TRIGGER trigger_name** 触发器触发机制受配置变量[session_replication_role](1-statement-behavior)的影响，当复制角色为“origin”（默认值）或“local”时，将触发简单启用的触发器。 配置为ENABLE REPLICA的触发器仅在会话处于“replica”模式时触发。 @@ -124,11 +124,11 @@ date: 2021-05-17 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** > - > - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 + > - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 > - > - **ADD ( { column_name data_type [ compress_mode ] } [, …] )** 向表中增加多列。 + > - **ADD ( { column_name data_type [ compress_mode ] } [, ... ] )** 向表中增加多列。 > - > - **MODIFY ( { column_name data_type | column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAINT constraint_name ] NULL } [, …] )** 修改表已存在字段的数据类型。 + > - **MODIFY ( { column_name data_type | column_name [ CONSTRAINT constraint_name ] NOT NULL [ ENABLE ] | column_name [ CONSTRAINT constraint_name ] NULL } [, ... ] )** 修改表已存在字段的数据类型。 > > - **DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ]** 从表中删除一个字段，和这个字段相关的索引和表约束也会被自动删除。如果任何表之外的对象依赖于这个字段，必须声明CASCADE ，比如视图。 DROP COLUMN命令并不是物理上把字段删除，而只是简单地把它标记为对SQL操作不可见。随后对该表的插入和更新将在该字段存储一个NULL。因此，删除一个字段是很快的，但是它不会立即释放表在磁盘上的空间，因为被删除了的字段占据的空间还没有回收。这些空间将在执行VACUUM时而得到回收。 > @@ -146,9 +146,9 @@ date: 2021-05-17 > > - **ALTER [ COLUMN ] column_name SET STATISTICS [PERCENT] integer** 为随后的ANALYZE操作设置针对每个字段的统计收集目标。目标的范围可以在0到10000之内设置。设置为-1时表示重新恢复到使用系统缺省的统计目标。 > - > - **{ADD | DELETE} STATISTICS ((column_1_name, column_2_name [, …]))** 用于添加和删除多列统计信息声明（不实际进行多列统计信息收集），以便在后续进行全表或全库analyze时进行多列统计信息收集。每组多列统计信息最多支持32列。不支持添加/删除多列统计信息声明的表：系统表、外表。 + > - **{ADD | DELETE} STATISTICS ((column_1_name, column_2_name [, ... ]))** 用于添加和删除多列统计信息声明（不实际进行多列统计信息收集），以便在后续进行全表或全库analyze时进行多列统计信息收集。每组多列统计信息最多支持32列。不支持添加/删除多列统计信息声明的表：系统表、外表。 > - > - **ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, … ] )** **ALTER [ COLUMN ] column_name RESET ( attribute_option [, … ] )** 设置/重置属性选项。 目前，属性选项只定义了n_distinct和n_distinct_inherited。n_distinct影响表本身的统计值，而n_distinct_inherited影响表及其继承子表的统计。目前，只支持SET/RESET n_distinct参数，禁止SET/RESET n_distinct_inherited参数。 + > - **ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, ... ] )** **ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )** 设置/重置属性选项。 目前，属性选项只定义了n_distinct和n_distinct_inherited。n_distinct影响表本身的统计值，而n_distinct_inherited影响表及其继承子表的统计。目前，只支持SET/RESET n_distinct参数，禁止SET/RESET n_distinct_inherited参数。 > > - **ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }** 为一个字段设置存储模式。这个设置控制这个字段是内联保存还是保存在一个附属的表里，以及数据是否要压缩。仅支持对行存表的设置；对列存表没有意义，执行时报错。SET STORAGE本身并不改变表上的任何东西，只是设置将来的表操作时，建议使用的策略。 @@ -362,13 +362,13 @@ date: 2021-05-17 - **UNIQUE index_parameters** - **UNIQUE ( column_name [, … ] ) index_parameters** + **UNIQUE ( column_name [, ... ] ) index_parameters** UNIQUE约束表示表里的一个或多个字段的组合必须在全表范围内唯一。 - **PRIMARY KEY index_parameters** - **PRIMARY KEY ( column_name [, … ] ) index_parameters** + **PRIMARY KEY ( column_name [, ... ] ) index_parameters** 主键约束表明表中的一个或者一些字段只能包含唯一（不重复）的非NULL值。 @@ -407,7 +407,7 @@ date: 2021-05-17 局部聚簇存储，列存表导入数据时按照指定的列(单列或多列)，进行局部排序。 -- **WITH ( {storage_parameter = value} [, … ] )** +- **WITH ( {storage_parameter = value} [, ... ] )** 为表或索引指定一个可选的存储参数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CLEAN-CONNECTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CLEAN-CONNECTION.md index 1cf240d8782382ed9fda75e9dc260b99e34a3c00..58917cf1f69b44f514e3fb7e35e63cd8d4610b97 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CLEAN-CONNECTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CLEAN-CONNECTION.md @@ -36,7 +36,7 @@ CleanConnection ::= CLEAN CONNECTION 仅在节点列表为TO ALL时可以指定，如果指定该参数，所有和指定dbname和username相关的线程都会收到SIGTERM信号，然后被强制关闭。 -- **COORDINATOR ( nodename [, … ] ) | NODE ( nodename [, … ] ) | ALL** +- **COORDINATOR ( nodename [, ... ] ) | NODE ( nodename [, ... ] ) | ALL** 删除指定节点上的连接。有三种场景： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md index cd8e782b384ce691880f417c6277ba136e2c19d5..5b1d7fbb04d98d1e7922d6e70fb9c1f89b983ea9 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md @@ -322,13 +322,13 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 > - EOL参数不能和分隔符、null参数相同。 > - EOL参数不能包含：.abcdefghijklmnopqrstuvwxyz0123456789。 - - FORCE_QUOTE { ( column_name [, …] ) | * } + - FORCE_QUOTE { ( column_name [, ...] ) | * } 在CSV COPY TO模式下，强制在每个声明的字段周围对所有非NULL值都使用引号包围。NULL输出不会被引号包围。 取值范围: 已存在的字段。 - - FORCE_NOT_NULL ( column_name [, …] ) + - FORCE_NOT_NULL ( column_name [, ...] ) 在CSV COPY FROM模式下，指定的字段输入不能为空。 @@ -462,13 +462,13 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - - FORCE NOT NULL column_name [, …] + - FORCE NOT NULL column_name [, ...] 在CSV COPY FROM模式下，指定的字段不为空。若输入为空，则将视为长度为0的字符串。 取值范围: 已存在的字段。 - - FORCE QUOTE { column_name [, …] | * } + - FORCE QUOTE { column_name [, ...] | * } 在CSV COPY TO模式下，强制在每个声明的字段周围对所有非NULL值都使用引号包围。NULL输出不会被引号包围。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CAST.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CAST.md index 166ade841f449bdc6533276e12ef893e0572eaa7..266397f7b88669450c1783843361c4ddd334da61 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CAST.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CAST.md @@ -45,7 +45,7 @@ CreateCast ::= CREATE CAST (source_type AS target_type) 转换的目标数据类型。 -- **function_name(argument_type [, …])** +- **function_name(argument_type [, ...])** 用于执行转换的函数。 这个函数名可以是用模式名修饰的。 如果它没有用模式名修饰， 那么该函数将从模式搜索路径中找出来。 函数的结果数据类型必须匹配转换的目标类型。 它的参数在下面讨论。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md index 9fef68977fd2402afbc2d5e5ffc84611a88608a0..9781673ca4f439372ffd0d7ae207e36b9d08c65a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md @@ -61,7 +61,7 @@ column_constraint ::= [ CONSTRAINT constraint_name ] 外表的server名称。默认值为mot_server。 -- **OPTIONS ( option 'value' [, … ] )** +- **OPTIONS ( option 'value' [, ...] )** 选项与新外部表或外部表中的字段有关。允许的选项名称和值，是由每一个外部数据封装器指定的。 也是通过外部数据封装器的验证函数来验证。重复的选项名称是不被允许的（尽管表选项和表字段选项可以有相同的名字）。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md index 6d4dbce65b4586b5ae667032808d08ba3cebbf79..eca95b342f194ecd429d9c367847fbee4b3ead22 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md @@ -31,8 +31,8 @@ date: 2021-05-10 ```ebnf+diagram CreateFunction ::= CREATE [ OR REPLACE ] FUNCTION function_name - [ ( [ { argname [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ]} [, '...'] ] ) ] - [ RETURNS rettype [ DETERMINISTIC ] | RETURNS TABLE ( { column_name column_type } [, '...'] )] + [ ( [ { argname [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ]} [, ...] ] ) ] + [ RETURNS rettype [ DETERMINISTIC ] | RETURNS TABLE ( { column_name column_type } [, ...] )] LANGUAGE lang_name [ {IMMUTABLE | STABLE | VOLATILE } @@ -57,7 +57,7 @@ date: 2021-05-10 ```ebnf+diagram CreateFunction ::= CREATE [ OR REPLACE ] FUNCTION function_name - ( [ { argname [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ] } [, '...'] ] ) + ( [ { argname [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ] } [, ...] ] ) RETURN rettype [ DETERMINISTIC ] [ diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md index 289eaef870568f7966682921b90a60d38229047f..6f3159b0773a14210e973ac3708724319f10b871 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md @@ -172,7 +172,7 @@ date: 2021-05-10 目前只有ubtree索引访问方式支持该特性。非键列会被保存在与堆元组对应的索引叶子元组中，不会包含在索引上层页面的元组中。 -- **WITH ( {storage_parameter = value} [, … ] )** +- **WITH ( {storage_parameter = value} [, ...] )** 指定索引方法的存储参数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-MATERIALIZED-VIEW.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-MATERIALIZED-VIEW.md index e24ff07160d0e934d3e0f2989b6a552a100df9d5..ee4407237a348747f2526f6d1c20a8eb67f35341 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-MATERIALIZED-VIEW.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-MATERIALIZED-VIEW.md @@ -47,7 +47,7 @@ CreateMaterializedView ::= CREATE MATERIALIZED VIEW mv_name 取值范围: 字符串，要符合标识符的命名规范。 -- **WITH ( storage_parameter [= value] [, … ] )** +- **WITH ( storage_parameter [= value] [, ...] )** 这个子句为表或索引指定一个可选的存储参数。详见[CREATE TABLE](CREATE-TABLE)。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md index 92e4ac9b1d1199416c164063a33ef99122ca33b0..d55f16cbdfcc29f34c03ab489f53735f0645213e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md @@ -32,7 +32,7 @@ date: 2021-05-10 ```ebnf+diagram CreateProcedure ::= CREATE [ OR REPLACE ] PROCEDURE procedure_name - [ ( {[ argname ] [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ]}[, '...']) ] + [ ( {[ argname ] [ argmode ] argtype [ { DEFAULT | ':=' | = } expression ]}[, ...]) ] [ { IMMUTABLE | STABLE | VOLATILE } | { SHIPPABLE | NOT SHIPPABLE } diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PUBLICATION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PUBLICATION.md index 7e4825eb6ddf903d0af3fd78b00c250f5ca905d5..cd72326dc89dc0ef7cf5817595908fc38793ccca 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PUBLICATION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PUBLICATION.md @@ -42,7 +42,7 @@ CreatePublication ::= CREATE PUBLICATION name 将发布标记为复制数据库中所有表的更改，包括在将来创建的表。 -- **WITH ( publication_parameter [= value] [, … ] )** +- **WITH ( publication_parameter [= value] [, ...] )** 该子句指定发布的可选参数。支持下列参数： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SERVER.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SERVER.md index ab51097928554be8216092994070b00681c6cd5e..983b2d82bafb83da59c82dda6ad88d1d46208f2e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SERVER.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SERVER.md @@ -33,7 +33,7 @@ CreateServer ::= CREATE SERVER server_name 取值范围: dist_fdw，hdfs_fdw，log_fdw，file_fdw，mot_fdw。 -- **OPTIONS ( { option_name ' value ' } [, …] )** +- **OPTIONS ( { option_name ' value ' } [, ...] )** 这个子句为服务器指定选项。这些选项通常定义该服务器的连接细节， 但是实际的名称和值取决于该服务器的外部数据包装器。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SUBSCRIPTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SUBSCRIPTION.md index 78a3c604fc97facc1a5e8ee8d729af7791acdbb4..b81e5b81d502ffc003c629f05358c88f139e8042 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SUBSCRIPTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SUBSCRIPTION.md @@ -59,7 +59,7 @@ CreateSubscription ::= CREATE SUBSCRIPTION subscription_name 要订阅的发布端的发布名称，一个订阅可以对应多个发布。 -- **WITH ( subscription_parameter [= value] [, … ] )** +- **WITH ( subscription_parameter [= value] [, ...] )** 该子句指定订阅的可选参数。支持的参数有： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md index 974fcb1be36bb9a2775172cf66e4c3c2a78db53a..53bb18b41201e02da305a1d4b725a3499fd88a2a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md @@ -73,7 +73,7 @@ CreateTableAs ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] 取值范围: 字符串，要符合标识符的命名规范。 -- **WITH ( storage_parameter [= value] [, … ] )** +- **WITH ( storage_parameter [= value] [, ...] )** 这个子句为表或索引指定一个可选的存储参数。参数的详细说明如下所示。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md index 35c3914c7338da4f5ee067bb55aeab90b3cecc2a..8fc6f500638af08c3a8a5093089904e5ba14baaf 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md @@ -161,7 +161,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - 列约束：作为一个列定义的一部分，仅影响该列。 - 表约束：不和某个列绑在一起，可以作用于多个列。 -- **LIKE source_table [ like_option … ]** +- **LIKE source_table [ like_option ...]** LIKE子句声明一个表，新表自动从这个表里面继承所有字段名及其数据类型和非空约束。 @@ -180,7 +180,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）也将拷贝至新表。默认情况下，不拷贝源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 -- **WITH ( storage_parameter [= value] [, … ] )** +- **WITH ( storage_parameter [= value] [, ...] )** 这个子句为表或索引指定一个可选的存储参数。参数的详细描述如下所示： @@ -309,12 +309,12 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name > 3. 在创建分区表时START END与LESS THAN语法不可混合使用。 > 4. 即使创建分区表时使用START END语法，备份（gs_dump）出的SQL语句也是VALUES LESS THAN语法格式。 -- **INTERVAL ('interval_expr') [ STORE IN (tablespace_name [, … ] ) ]** +- **INTERVAL ('interval_expr') [ STORE IN (tablespace_name [, ...] ) ]** 间隔分区定义信息。 - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - - STORE IN (tablespace_name [, … ] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 + - STORE IN (tablespace_name [, ...] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 @@ -398,7 +398,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - **UNIQUE index_parameters** - **UNIQUE ( column_name [, … ] ) index_parameters** + **UNIQUE ( column_name [, ...] ) index_parameters** UNIQUE约束表示表里的一个字段或多个字段的组合必须在全表范围内唯一。 @@ -406,7 +406,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - **PRIMARY KEY index_parameters** - **PRIMARY KEY ( column_name [, … ] ) index_parameters** + **PRIMARY KEY ( column_name [, ...] ) index_parameters** 主键约束声明表中的一个或者多个字段只能包含唯一的非NULL值。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md index 974c70b1847e28f11208c0bcb650362e5b39f393..310ef27206475c5fa483a368a426d145c9774cad 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md @@ -127,11 +127,11 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH - 列约束：作为一个列定义的一部分，仅影响该列。 - 表约束：不和某个列绑在一起，可以作用于多个列。 -- **LIKE source_table [ like_option … ]** +- **LIKE source_table [ like_option ...]** 二级分区表暂不支持该功能。 -- **WITH ( storage_parameter [= value] [, … ] )** +- **WITH ( storage_parameter [= value] [, ...] )** 这个子句为表或索引指定一个可选的存储参数。参数的详细描述如下所示： @@ -256,7 +256,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH - **UNIQUE index_parameters** - **UNIQUE ( column_name [, … ] ) index_parameters** + **UNIQUE ( column_name [, ...] ) index_parameters** UNIQUE约束表示表里的一个字段或多个字段的组合必须在全表范围内唯一。 @@ -264,7 +264,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH - **PRIMARY KEY index_parameters** - **PRIMARY KEY ( column_name [, … ] ) index_parameters** + **PRIMARY KEY ( column_name [, ...] ) index_parameters** 主键约束声明表中的一个或者多个字段只能包含唯一的非NULL值。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md index f5d331bf7059ff8e248a2733fd3957e9d29d3526..b3f5aafdf7c26591774044230dfd99889098adcd 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md @@ -152,7 +152,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA COLLATE子句指定列的排序规则（该列必须是可排列的数据类型）。如果没有指定，则使用默认的排序规则。排序规则可以使用“select * from pg_collation;”命令从pg_collation系统表中查询，默认的排序规则为查询结果中以default开始的行。 -- **LIKE source_table [ like_option … ]** +- **LIKE source_table [ like_option ...]** LIKE子句声明一个表，新表自动从这个表中继承所有字段名及其数据类型和非空约束。 @@ -175,7 +175,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 > - 对于分区表EXCLUDING，需要配合INCLUDING ALL使用，如INCLUDING ALL EXCLUDING DEFAULTS，除源分区表的DEFAULTS，其它全包含。 -- **WITH ( { storage_parameter = value } [, … ] )** +- **WITH ( { storage_parameter = value } [, ...] )** 这个子句为表或索引指定一个可选的存储参数。 @@ -385,7 +385,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - **UNIQUE index_parameters** - **UNIQUE ( column_name [, … ] ) index_parameters** + **UNIQUE ( column_name [, ...] ) index_parameters** UNIQUE约束表示表里的一个字段或多个字段的组合必须在全表范围内唯一。 @@ -393,7 +393,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - **PRIMARY KEY index_parameters** - **PRIMARY KEY ( column_name [, … ] ) index_parameters** + **PRIMARY KEY ( column_name [, ...] ) index_parameters** 主键约束声明表中的一个或者多个字段只能包含唯一的非NULL值。 @@ -401,7 +401,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - **REFERENCES reftable [ ( refcolum ) ] [ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (column constraint)** - **FOREIGN KEY ( column_name [, … ] ) REFERENCES reftable [ ( refcolumn [, … ] ) ] [ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (table constraint)** + **FOREIGN KEY ( column_name [, ...] ) REFERENCES reftable [ ( refcolumn [, ...] ) ] [ MATCH matchtype ] [ ON DELETE action ] [ ON UPDATE action ] (table constraint)** 外键约束要求新表中一列或多列构成的组应该只包含、匹配被参考表中被参考字段值。若省略refcolum，则将使用reftable的主键。被参考列应该是被参考表中的唯一字段或主键。外键约束不能被定义在临时表和永久表之间。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md index 07cafb748f4186818743a33dfeb6b497f6734b08..38fa2a78502a833ef738ae2904aef9e2a9e989e8 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md @@ -80,7 +80,7 @@ CreateType ::= CREATE TYPE name ```ebnf+diagram CreateType ::= CREATE TYPE name AS ENUM - ( [ 'label' [, '... '] ] ) + ( { 'label' } [, ...] ) ``` ```ebnf+diagram diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md index 6f38f466b65a9fd7b54ab99f6481df019d3c1e70..e40a30ad5d906adaceb2d57bcb5a599a90e5d048 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md @@ -20,7 +20,7 @@ date: 2021-05-10 ```ebnf+diagram CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name - [ OPTIONS ( option 'value' [ ,' ... '] ) ]; + [ OPTIONS ( { option 'value' } [, ... ] ) ]; ``` ## 参数说明 @@ -33,7 +33,7 @@ CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER 将为其创建用户映射的现有服务器的名称。 -- **OPTIONS ( { option_name ' value ' } [, …] )** +- **OPTIONS ( { option_name ' value ' } [, ...] )** 这个子句指定用户映射的选项。这些选项通常定义该映射实际的用户名和口令。选项名必须唯一。允许的选项名和值与该服务器的外部数据包装器有关。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DELETE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DELETE.md index 959a4fc9123097fde72ce2bd2dc7afb9cd553a69..92daf9cdcfb06aed7bfe69af0d124d8e57286a7c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DELETE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DELETE.md @@ -28,7 +28,7 @@ DELETE [/*+ plan_hint */] [ FROM ] [ ONLY ] table_name [partition_clause] [ * ] ## 参数说明 -- **WITH [ RECURSIVE ] with_query [, …]** +- **WITH [ RECURSIVE ] with_query [, ...]** 用于声明一个或多个可以在主查询中通过名称引用的子查询，相当于临时表。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md index ed4236bf14d813aec00ac91596091e2166c305a7..6bcaea0660dad2b31b9096236cdbdcefd4235ada 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md @@ -40,7 +40,7 @@ INSERT [/*+ plan_hint */] INTO table_name [partition_clause] [ AS alias ] [ ( co ## 参数说明 -- **WITH [ RECURSIVE ] with_query [, …]** +- **WITH [ RECURSIVE ] with_query [, ...]** 用于声明一个或多个可以在主查询中通过名称引用的子查询，相当于临时表。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SNAPSHOT.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SNAPSHOT.md index ecc6cd7d3fdf0a89d09154f464a4483b4c8ff5e4..7e6c7c5672579ef59ec1bf9d25e7ffc833e11ffc 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SNAPSHOT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SNAPSHOT.md @@ -41,7 +41,7 @@ date: 2021-11-01 { INSERT [INTO SNAPSHOT] '...' | UPDATE [SNAPSHOT] [AS 'alias'] SET '...' [FROM '...'] [WHERE '...'] | DELETE [FROM SNAPSHOT] [AS 'alias'] [USING '...'] [WHERE '...'] - | ALTER [SNAPSHOT] { ADD '...'| DROP '...' } [, '...'] + | ALTER [SNAPSHOT] { ADD '...'| DROP '...' } [, ...] } [; '...'])]; ``` diff --git a/product/zh/docs-mogdb/v3.0/toc.md b/product/zh/docs-mogdb/v3.0/toc.md index 086c204cbc8ee716e2cfe351bf9114f5137aac68..cf82a7c7151d754df7bafc3181aa96cddd4777fa 100644 --- a/product/zh/docs-mogdb/v3.0/toc.md +++ b/product/zh/docs-mogdb/v3.0/toc.md @@ -19,8 +19,8 @@ + [法律声明](/about-mogdb/terms-of-use.md) + 快速入门 + [MogDB实训平台](/quick-start/mogdb-playground.md) - + [容器化安装](/quick-start/container-based-installation.md) - + [单节点安装](/quick-start/installation-on-a-single-node.md) + + [容器化安装（beta版）](/quick-start/container-based-installation.md) + + [单节点安装（630后发布）](/quick-start/installation-on-a-single-node.md) + 访问数据库 + 使用命令行访问MogDB + [gsql](/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md) @@ -132,12 +132,12 @@ + [分布式数据库能力](/characteristic-description/middleware/distributed-database-capability.md) + [使用kubernetes部署分布式数据库](/characteristic-description/middleware/deploying-a-distributed-database-using-kubernetes.md) + 安装指南 - + [容器化安装](/installation-guide/docker-installation/docker-installation.md) - + 极简安装 + + [容器化安装（beta版）](/installation-guide/docker-installation/docker-installation.md) + + 极简安装（630后发布） + [安装准备](/installation-guide/simplified-installation-process/1-installation-preparation.md) + [单节点安装](/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md) + [一主一备节点安装](/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md) - + 标准安装 + + 标准安装（630后发布） + [安装概述](/installation-guide/standard-installation/1-installation-overview.md) + 安装准备 + [环境要求](/installation-guide/standard-installation/2-environment-requirement.md) @@ -146,7 +146,7 @@ + [安装验证](/installation-guide/standard-installation/5-verifying-installation.md) + [推荐参数设置及新建测试库](/installation-guide/standard-installation/7-recommended-parameter-settings.md) + [卸载MogDB](/installation-guide/standard-installation/6-uninstallation.md) - + [手动安装](/installation-guide/manual-installation.md) + + [手动安装（630后发布）](/installation-guide/manual-installation.md) + 管理指南 + 日常运维 + [启停MogDB](/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md)