Ontology 使用指南

更新时间:
复制 MD 格式

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 行。

步骤三:在桌面端构建

  1. 打开 ADB-PG Data Agent 桌面端,进入 Ontology 页面,数据源使用创建角色账号。

  2. 点击 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 语句会把所有权转移给新账号)。