文档中心MogDBMogDB StackUqbar
生态工具
文档工具
EN
v3.0

文档:v3.0

支持的版本:
v3.0/
v2.1

其他版本:
最新(v5.0)/
v3.1/
v2.0/
v1.1

gs_install_plugin

背景信息

MogDB提供了gs_install_plugin工具用于安装插件，目前支持安装的插件包括pg_repack、pg_trgm、dblink、wal2json、orafce、pg_bulkload、pg_prewarm等。本工具适用于一主多备部署的MogDB。

语法

gs_install_plugin [-h] [-X XML] [-p] [--all] [--force] [--plugins] [--PLUGIN_NAME] [--debug]

参数说明

  • -h, --help

    显示帮助信息

  • -X

    指定xml文件路径

  • -p

    指定plugins安装包位置，默认在$GPHOME/script/static寻找plugins安装包

  • --all

    安装全部插件

  • --force

    指定覆盖旧的插件

  • --plugins

    可安装多个插件，--plugins后跟插件名

  • --PLUGIN_NAME

    指定安装某一个插件，如：--dblink

  • --debug

    输出debug信息

注意：在不指定安装某一个插件的情况下，默认安装全部插件

支持安装的插件列表

插件名 用途
dblink 提供跨数据库访问能力
pg_trgm 提供函数和操作符测定字母数字文本基于三元模型匹配的相似性， 还有支持快速搜索相似字符串的索引操作符类
wal2json 将逻辑日志文件输出为 JSON 格式
pg_repack 在线重建表和索引的扩展。它会在数据库中建立一个和需要清理的目标表一样的临时表，将目标表中的数据 COPY 到临时表，并在临时表上建立与目标表一样的索引，然后通过重命名的方式用临时表替换目标表。
orafce 用于 Oracle 迁移到 MogDB 的兼容性
pg_bulkload 用于MogDB的高速数据加载工具，相比copy命令。最大的优势就是速度，优在跳过shared buffer、wal buffer直接写文件。
pg_prewarm 可以用于在系统重启时，手动加载经常访问的表到操作系统的cache或MogDB的shared buffer，从而减少检查系统重启对应用的影响
PostGIS 空间数据处理插件，提供支持空间数据管理、数量测量与几何拓扑分析的能力，支持空间对象、空间索引、空间操作函数和操作符。
whale Oracle兼容性插件，可以支持Oracle的特定函数和package。（语法及存储过程还处于开发中）

安装示例

  1. 插件包放置位置

    数据库未安装情况下，进入数据库安装目录下的script文件夹：

    cd /opt/software/mogdb/script/

    数据库已经安装的情况下

    su - omm
cd $GPHOME/script/

  2. 创建static文件夹：

    mkdir -p static

    注意：文件夹名称请勿更改。

  3. 访问MogDB官网下载页面，根据您的操作系统及CPU架构下载对应版本的插件，并将插件放入static文件夹下。

  4. 设置权限，例如：

    chmod +x Plugins-3.0.1-CentOS-x86_64.tar.gz

  5. 安装插件

    下面示例中假设使用的XML文件配置路径为：/opt/software/mogdb/clusterconfig.xml

    • 安装全部插件

      当不通过 -p 指定插件安装包路径时，默认在 $GPHOME/script/static 目录下获取

      # 不指定-p
gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --all
# gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml 等价于  gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --all

      输出如下：

      [omm@hostname ~]$ gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --all
SUCCESS: pg_trgm
SUCCESS: dblink
SUCCESS: orafce
SUCCESS: wal2json
SUCCESS: pg_repack
SUCCESS: pg_bulkload
SUCCESS: pg_prewarm
SUCCESS: whale
SUCCESS: postgis

    • 指定插件安装包路径安装

      # 指定-p 和 --force
gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml -p /opt/mogdb/tools/script/static/Plugins-3.0.1-CentOS-x86_64.tar.gz --all --force

      输出如下：

      [omm@hostname ~]$ gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml  -p /opt/mogdb/tools/script/static/Plugins-3.0.1-CentOS-x86_64.tar.gz --all --force
SUCCESS: pg_trgm
SUCCESS: dblink
SUCCESS: orafce
SUCCESS: wal2json
SUCCESS: pg_repack
SUCCESS: pg_bulkload
SUCCESS: pg_prewarm
SUCCESS: whale
SUCCESS: postgis

    • 安装部分插件

      gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --plugins dblink pg_trgm

      输出如下：

      这里因为之前安装了全部插件，所以要是重新进行插件安装的话，检测到之前的插件文件存在，会提示 Warning，默认不会覆盖掉已安装的插件，若需覆盖已安装的插件，需指定 --force 参数

      [omm@hostname ~]$ gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --plugins dblink pg_trgm
Warning: (plugin: pg_trgm) file /opt/mogdb/app/lib/postgresql/pg_trgm.so already exists
Warning: (plugin: pg_trgm) file /opt/mogdb/app/share/postgresql/extension/pg_trgm.control already exists
Warning: (plugin: pg_trgm) file /opt/mogdb/app/share/postgresql/extension/pg_trgm--1.0.sql already exists
Warning: (plugin: pg_trgm) file /opt/mogdb/app/share/postgresql/extension/pg_trgm--unpackaged--1.0.sql already exists
SUCCESS: pg_trgm
Warning: (plugin: dblink) file /opt/mogdb/app/lib/postgresql/dblink.so already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink.control already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink--1.0.sql already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink--unpackaged--1.0.sql already exists
SUCCESS: dblink

    • 安装单个插件

      gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --dblink --force

      输出如下：

      [omm@hostname ~]$ gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --dblink --force
SUCCESS: dblink

    • 调试模式

      gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --dblink --debug

      输出如下：

      [omm@hostname ~]$ gs_install_plugin -X /opt/software/mogdb/clusterconfig.xml --dblink --debug
use xml file: /opt/software/mogdb/clusterconfig.xml
use plugin package file: /opt/mogdb/tools/script/static/Plugins-*.tar.gz
local mode is False
deconpress plugin package to /opt/mogdb/tools/script/static/plugins/
make common dirs
Warning: (plugin: dblink) file /opt/mogdb/app/lib/postgresql/dblink.so already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink.control already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink--1.0.sql already exists
Warning: (plugin: dblink) file /opt/mogdb/app/share/postgresql/extension/dblink--unpackaged--1.0.sql already exists
SUCCESS: dblink

相关页面

orafce、dblink、pg_repack、pg_trgm、wal2json、pg_bulkload、pg_prewarm、PostGIS、whale。

首页

反馈
Copyright © 2011-2024 www.enmotech.com All rights reserved.