大家好，我是 iamkz，今天我们不讲复杂原理，直接动手带大家在 OpenTenBase 里实现一个最简单的 

PostgreSQL 是一款非常流行的开源数据库，长期活跃在全球数据库流行度排行榜前列，也多次获得 DB-Engines 年度数据库相关荣誉。

在 PostgreSQL 中，扩展（Extension）是一种非常重要的能力。它允许开发者以可插拔的方式，为数据库增加新的函数、数据类型、操作符、索引方法、过程语言等能力。很多常见的 PostgreSQL 能力，本质上都可以通过扩展机制引入。

OpenTenBase 是在 PostgreSQL 基础上研发的企业级分布式 HTAP 开源数据库，也继承了 PostgreSQL 强大的插件系统。通过扩展机制，开发者可以为 OpenTenBase 增加新的数据库能力。例如空间数据库插件 PostGIS，就是非常知名的 PostgreSQL 扩展之一，它可以为数据库增加地理信息系统相关能力。

本文通过一个最简单的 SQL-only 插件，手工实现一个 

通过这个例子，我们可以完整走一遍 OpenTenBase 插件的基础流程：编写 control 文件、编写 SQL 安装脚本、复制到 extension 目录、在 CN 节点执行 

一、一个最小插件需要哪些文件？

对于一个最简单的 SQL-only 插件，只需要两个文件：

 是插件控制文件，用来描述插件的基础信息，例如插件说明、默认版本等。

，再根据其中的版本信息找到对应的 SQL 安装脚本，并执行里面的 SQL 语句。

这里有一个命名规则需要注意：control 文件的文件名是 

先创建一个目录，用来存放本次插件文件：

mkdir manual_hello_world
cd manual_hello_world

后续所有文件都在这个目录中编写。

comment = 'hello_world extension for OpenTenBase'
default_version = '1.0'
relocatable = true

 表示这个扩展是否允许安装到其他 schema。

 这个安装脚本。如果版本号和文件名对不上，安装就会失败。

CREATE SCHEMA IF NOT EXISTS hello_world;

CREATE OR REPLACE FUNCTION hello_world.hello()
RETURNS text
LANGUAGE sql
AS $$
    SELECT 'hello_world';
$$;

 的 schema。第二，在这个 schema 下创建一个 

 函数。这个函数没有参数，返回一个固定字符串 

五、找到 OpenTenBase 的 extension 目录

插件文件写好后，需要放到 OpenTenBase 的 extension 目录中。

/data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql

/data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension

接下来把两个插件文件复制进去：

cp hello_world.control /data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension/
cp hello_world--1.0.sql /data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension/

ls -l /data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension/hello_world*

OpenTenBase 是分布式数据库，通常包含多个 CN 和 DN。用户一般连接 CN 执行 SQL，但插件文件本身是操作系统层面的文件，不是数据库自动同步出来的对象。

 文件需要放到相关节点的 extension 目录中。

。除了当前机器，也需要把插件文件分发到另一台机器对应的 extension 目录。

scp hello_world.control opentenbase@otb132:/data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension/
scp hello_world--1.0.sql opentenbase@otb132:/data/opentenbase/install/opentenbase_bin_v2.0/share/postgresql/extension/

登录另一台机器后，也可以执行下面的命令确认：

，说明插件文件已经分发过去了。

这里有一个容易踩坑的地方：如果只在一台机器上放文件，执行 

could not open extension control file ".../hello_world.control": No such file or directory

这个错误不一定是 SQL 脚本写错了，而可能是某个相关节点找不到插件文件。

所以在 OpenTenBase 这种分布式环境中，插件开发除了要关注 SQL 逻辑本身，还要关注插件文件在多节点上的一致性。

psql -h 192.168.244.130 -p 30004 -U opentenbase -d postgres

这里的 IP、端口、用户名和数据库名需要根据实际环境替换。

这一步可以理解为：数据库先查找 

，执行 SQL 安装脚本，最后把扩展信息写入 

也就是说，复制文件只是让数据库“能找到插件”；真正把插件安装进当前数据库的是 

大家好，我是 iamkz，今天我们不讲复杂原理，直接动手带大家在 OpenTenBase 里实现一个最简单的 hello_world 插件。

OpenTenBase 插件开发实践：5分钟手动实现一个 hello_world 扩展

本文实现了一个基于 OpenTenBase 的SQL-only 插件 hello_world

后端

数据库

开发工具

学习如何在OpenTenBase中创建简单插件，实现hello_world功能。了解PostgreSQL扩展机制，掌握control文件和SQL安装脚本编写方法，完成插件部署与调用全流程。适用于分布式数据库环境，帮助开发者快速入门OpenTenBase插件开发。

分布式数据库

PostgreSQL

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

OpenTenBase 插件开发实践：5分钟手动实现一个 hello_world 扩展

OpenTenBase 插件开发实践：5分钟手动实现一个 hello_world 扩展

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐