Ontology 使用指南
AnalyticDB for PostgreSQL Data Agent 的 Ontology 功能(语义层 + 知识图谱)按使用角色划分权限:推荐为创建角色新建一个专用账号;查询角色可对任意多个已有业务账号授权,互相独立。两种角色也可以共用一个账号(只需执行创建角色的授权,创建权限已覆盖查询所需)。全部操作幂等,可重复执行。
前提条件
已创建 AnalyticDB for PostgreSQL 7.0 版实例,且内核小版本为 7.2.1.0 及以上(建议 7.2.1.4 及以上,该版本起
age插件已预装,无需手动安装)。内核版本较低时,请先参考安装、升级与卸载插件完成
age插件安装,或升级内核小版本。已创建业务数据库,业务表已就位。
使用初始高权限账号执行本文全部 SQL。
操作步骤
步骤一:环境准备(一次性,管理员执行)
在目标业务数据库上执行:
CREATE EXTENSION IF NOT EXISTS age;
DO $$
BEGIN
IF NOT EXISTS (SELECT 1 FROM ag_catalog.ag_graph WHERE name = 'ontology_graph') THEN
PERFORM ag_catalog.create_graph('ontology_graph');
END IF;
END $$;
CREATE SCHEMA IF NOT EXISTS semantic;语义层中的表和视图由桌面端 Initialize 自动创建,无需手工建表。
步骤二:为「创建」角色授权(管理员执行)
新建专用账号(推荐,创建角色建议只保留这一个账号):
CREATE ROLE ontology_builder LOGIN PASSWORD '<密码>';
-- 下方 your_account 均替换为 ontology_builder使用已有账号:跳过建号,your_account 替换为实际账号名。
-- ---- Ontology 专属对象(写入范围仅限于此,不涉及业务表)----
GRANT USAGE, CREATE ON SCHEMA semantic TO your_account;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA semantic TO your_account;
ALTER DEFAULT PRIVILEGES IN SCHEMA semantic
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO your_account;
GRANT USAGE, CREATE ON SCHEMA ontology_graph TO your_account;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA ontology_graph TO your_account;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA ontology_graph TO your_account;
ALTER DEFAULT PRIVILEGES IN SCHEMA ontology_graph
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO your_account;
ALTER DEFAULT PRIVILEGES IN SCHEMA ontology_graph
GRANT USAGE, SELECT ON SEQUENCES TO your_account;
GRANT USAGE ON SCHEMA ag_catalog TO your_account;
GRANT EXECUTE ON FUNCTION ag_catalog.cypher(name, cstring, ag_catalog.agtype) TO your_account;
GRANT SELECT ON TABLE ag_catalog.ag_graph TO your_account;
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE ag_catalog.ag_label TO your_account;
ALTER TABLE ontology_graph._ag_label_vertex OWNER TO your_account;
ALTER TABLE ontology_graph._ag_label_edge OWNER TO your_account;
ALTER SEQUENCE ontology_graph._ag_label_vertex_id_seq OWNER TO your_account;
ALTER SEQUENCE ontology_graph._ag_label_edge_id_seq OWNER TO your_account;
ALTER SEQUENCE ontology_graph._label_id_seq OWNER TO your_account;
ALTER INDEX ontology_graph._ag_label_vertex_pkey OWNER TO your_account;
ALTER INDEX ontology_graph._ag_label_edge_pkey OWNER TO your_account;
-- ---- 业务数据只读 ----
DO $$
DECLARE r record;
BEGIN
FOR r IN SELECT unnest(ARRAY['public', 'ods', 'dwd', 'dws', 'dim', 'ads']) AS nspname
LOOP
EXECUTE format('GRANT USAGE ON SCHEMA %I TO your_account', r.nspname);
EXECUTE format('GRANT SELECT ON ALL TABLES IN SCHEMA %I TO your_account', r.nspname);
EXECUTE format('ALTER DEFAULT PRIVILEGES IN SCHEMA %I GRANT SELECT ON TABLES TO your_account', r.nspname);
END LOOP;
END $$;
业务 schema 列表(public, ods, dwd, dws, dim, ads)请替换为实际存放业务表的 schema,不要去掉 GRANT USAGE 行。
步骤三:在桌面端构建
打开 ADB-PG Data Agent 桌面端,进入 Ontology 页面,数据源使用创建角色账号。
点击 Initialize,随后依次执行 Generate Semantic → Sync YAML → Build,完成 Ontology 构建。
步骤四:为「查询」角色授权(管理员执行,构建完成后)
创建与查询使用同一账号时跳过本步。
查询角色支持多个账号:对每个需要查数的账号分别执行一次下方授权块(新建账号先建号,已有业务账号直接授权),各账号互相独立、无数量限制。本步在 Initialize 完成后执行——语义层表和视图此时才存在,授权一次即生效,无需重复。
新建专用账号:
CREATE ROLE ontology_reader LOGIN PASSWORD '<密码>';
-- 下方 your_account 均替换为 ontology_reader
使用已有业务账号:跳过建号,your_account 替换为实际账号名(已有业务读权限也会被重复授予,无害)。
-- ---- Ontology 只读 ----
GRANT USAGE ON SCHEMA semantic TO your_account;
GRANT SELECT ON ALL TABLES IN SCHEMA semantic TO your_account;
GRANT USAGE ON SCHEMA ontology_graph TO your_account;
GRANT SELECT ON ALL TABLES IN SCHEMA ontology_graph TO your_account;
GRANT USAGE ON SCHEMA ag_catalog TO your_account;
GRANT EXECUTE ON FUNCTION ag_catalog.cypher(name, cstring, ag_catalog.agtype) TO your_account;
GRANT SELECT ON TABLE ag_catalog.ag_graph TO your_account;
GRANT SELECT ON TABLE ag_catalog.ag_label TO your_account;
-- ---- 业务数据只读 ----
DO $$
DECLARE r record;
BEGIN
FOR r IN SELECT unnest(ARRAY['public', 'ods', 'dwd', 'dws', 'dim', 'ads']) AS nspname
LOOP
EXECUTE format('GRANT USAGE ON SCHEMA %I TO your_account', r.nspname);
EXECUTE format('GRANT SELECT ON ALL TABLES IN SCHEMA %I TO your_account', r.nspname);
EXECUTE format('ALTER DEFAULT PRIVILEGES IN SCHEMA %I GRANT SELECT ON TABLES TO your_account', r.nspname);
END LOOP;
END $$;
步骤五:在桌面端查数
同账号模式:直接开始对话查数;
分账号模式:将日常会话的数据源切换为查询角色账号即可开始查数。
常见问题
Q:Initialize 报「缺少前置条件」
第一步未执行或执行到了别的数据库。请确认第一步的三条语句都在目标业务数据库上执行过。
Q:Initialize 报「图谱标签注册不完整」或「注册图谱结构失败」
第二步授权块未执行完整,请整块重新执行后重试。
Q:查询时报 permission denied for schema
对应授权块缺少 GRANT USAGE ON SCHEMA。重新执行对应授权块即可。
Q:构建完成后想收回创建权限
分账号模式下锁定创建账号即可,查询账号不受影响:
ALTER ROLE ontology_builder NOLOGIN;
Q:后续想增加新的查询账号
在构建完成后对每个新账号执行一次第四步授权块即可,无需其他操作。
Q:日常更新数据需要重新执行授权吗?
不需要。授权一次长期有效——后续在桌面端更新语义层、重建图谱等操作使用的是普通数据读写权限。若团队中有多人需要执行更新操作,对每个账号分别执行一遍第二步授权块即可并行使用;仅当更换创建账号时,才需要对新账号重新执行第二步(其中的 OWNER 语句会把所有权转移给新账号)。