GBase 8c MySQL协议兼容说明

原文链接：
https://www.gbase.cn/community/post/4028
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。

GBase 8c 5.0.0版本通过抽象协议层接口，在dophin插件的加持下， B兼容性数据库（dbcompatibility='B'，下文称为B兼容库）对mysql协议兼容，用户在设置相关参数后，可通过MySQL的JDBC driver或者MySQL命令行客户端，直接连接GBase 8c。

Dolphin使用

插件自动安装加载，无须手动安装加载。

(1)使用OM工具安装GBase8s，详见《GBase 8c V5_5.0.0_安装部署手册》。

(2)创建B库并使用初始用户连接B库即可，Dophin插件默认启用。

create database dbname with DBCOMPATIBILITY='B';
\q
$gsql -d dbname -p 15400 -U gbase

Dolphin使用限制

• 不支持小型化版本。
• 不支持删除dolphin插件。
• dolphin插件只能在B兼容性数据库下创建。
• dolphin插件需要在pg_catalog等schema下创建数据类型、函数等，所以加载dolphin插件需要初始用户权限。GBase8s将在第一次通过初始用户或拥有初始用户权限的用户连接B数据库时自动加载dolphin插件。如果一个B兼容性数据库从来没有被初始用户或拥有初始用户权限的用户连接过，那么它也不会加载dolphin插件。
• dolphin中所有新增/修改的语法不支持在gsql客户端通过\h查看帮助说明，不支持在gsql客户端自动补齐。
• dolphin插件的创建会删除数据库存在的插件所需的同名函数和类型以及之前存在的与之依赖的对象。
• dolphin插件依赖于publicschema，因此不支持使用dropschema的方式删除publicschema。
• 连接安装有dolphin插件的B兼容性数据库时，会默认修改GUC参数behavior_compat_options，增加display_leading_zero和select_into_return_null选项，以保持兼容性。

约束说明

当前支持的MySQL客户端版本

• ·MySQL JDBC Driver：5.1.47
• ·MySQL命令行客户端：5.7.26~5.7.42

不支持项

• ·不支持游标（指在JDBC中通过useCursorFetch、setFetchSize的方式获取数据）。
• ·不支持执行存储过程。

使用方式

创建B类型数据库，创建用户并设置MySQL native密码（可根据需要通过GRANT命令给新用户赋权）：

CREATE DATABASE proto_test_db DBCOMPATIBILITY 'B'; 
\c proto_test_db 
CREATE USER proto_test WITH PASSWORD 'Proto_test123'; 
SELECT set_native_password('proto_test', 'Proto_test123');

打开dolphin数据库协议功能参数

gs_guc set -N all -I all -c “ enable_dolphin_proto = on”

备注：参数POSTMASTER类型参数，修改需要重启才生效。

设置MySQL协议监听端口号， dolphin_server_port，注意端口号需要与GBase 8c本身监听的端口号 port 不同。

gs_guc set -N all -I all -c “ dolphin_server_port = 3307”

备注：参数POSTMASTER类型参数，修改需要重启才生效。

如果数据库中存在多个B兼容性数据库，需要通过dolphin.default_database_name设置默认连接的数据库实例名。

alter database proto_test set dolphin.default_database_name = my_test;

设置完成后，即可通过MySQL客户端，使用对应的用户名和密码连接GBase 8c。

使用须知

• · 使用MySQL客户端连接GBase 8c前，请确认listen_addresses配置正确，pg_hba允许MySQL客户端所在机器IP连接。
• ·使用MySQL客户端连接时，可通过形如 mysql -u [user_name] -p --port [dolphin_server_port] -h [GBase 8c_listen_address] 的方式连接。

原文链接：
https://www.gbase.cn/community/post/4028
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。