页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

  • 数据连接类型变更(如从 MySQL 迁移至 PostgreSQL)。
  • 数据库的 catalog 或 schema 发生修改(如重命名)。
  • 从旧版本(如 V10.5.8 前)升级至新版本(如 V11),涉及多 catalog 支持的规则变更。

1.2 关键概念说明


概念说明
catalog数据库的逻辑分组(类似
“数据库集群中的子库”),部分数据库(如 PostgreSQL)支持,MySQL 默认无
“数据库集群中的子库”),大部分数据库(如 PostgreSQL)支持,默认与配置的数据库名称相同,部分数据库不支持如Oracle无
schema数据库中的模式(类似 “表的分组容器”,如
“public”“admin”)
“public”“admin”),部分数据库不支持,如MySQL无 
ID 规则控制字段 ID 的生成逻辑,分 “带 catalog” 和 “不带 catalog”
两类,支持原值、大写、小写三种格式。
两类,支持原值、大写、小写三种格式。不支持catalog或schema,用null参与ID构成

2 操作步骤

目前schema节点、表字段的ID会记录添加表时数据库对应的catalog、schema;目前产品有2种规则,一种是新规则实现了多catalog的资源,另外一种是之前没有实现多catalog的资源;如果是旧版本升级到新版本,需要针对数据源名称、schema、catalog进行ID替换,替换成最新的规则,才能正常查数。

...

代码块
INSERT INTO .t_schema_idrule(c_id,c_schemaid,c_dataSourcename,c_origcatalog,c_origschema,c_catalog,c_schema,c_rule) 
                      VALUES ('I8a8a9f5a0192bf79bf7978dc0192c19e76550121','SCHEMA.northwind.null','northwind',NULL,NULL,'northwind_for_compatibility','public','ORIGINAL_NO_CATALOG'),

t_schema_idrule,具体表结构如下:

字段名

说明

c_id

uuid 随机生成,保证是表主键唯一即可,如:I8a8a9f5a0192bf79bf7978dc0000000000000001

c_schemaid

对应数据连接下面schema的资源树节点ID,可右键查看节点id属性获取

Image Modified

c_dataSourcename

数据源name,可右键数据连接资源查看节点名称属性获取

Image Modified

c_origcatalog

原库的catalog、schema。

右键数据连接下面schema的资源树节点,可右键查看节点id属性判断,ID组成有2种情况:

  • 情况1:如果源库是支持了catalog的情况,ID构成为:SCHEMA.数据源名.catalog.schema。
IDc_origcatalogc_origschema
SCHEMA.northwind.catalog.schema 
catalogschema
SCHEMA.northwind.null.schemanull schema
SCHEMA.northwind.catalog.nullcatalognull
  • 情况2:如果源库没有支持catalog的情况,ID构成为:SCHEMA.数据源名.schema
IDc_origcatalogc_origschema
SCHEMA.northwind.schemanullschema
SCHEMA.northwind.null nullnull


信息
title说明

上述null是指真实的NULL值,不是空字符串或z字符串“null“



c_origschema

c_catalog

当前数据源的catalog、schema

可以打开数据库管理界面,可以查看当前数据库的catalog、schema对象,根据数据库切换前后的实际数据库结构选择catalog、schema设置

通常数据库管理界面后默认选中的catalog、schema就是默认值

Image Modified

部分数据库不支持schema和catalog,需要设置为:null


c_schema

c_rule

产品内置6种ID规则。规则说明:

规则不拼catalog时,适用旧资源(没有支持catalog即V10.5.8之前创建的资源)默认catalog下的schema ID资源,构成为:SCHEMA.数据源名.schema

名称留原值、变大写、变小写,如:

规则名称说明
ORIGINAL_NO_CATALOG保留原值,如字段id=FIELD + .数据源名称 + .origschema + .表名 +. 字段名
UPPER_NO_CATALOG转大写,如字段id=FIELD + .数据源名称 + .origschema + .toUpper(表名) +. toUpper(字段名)
LOWER_NO_CATALOG转小写,如字段id=FIELD + .数据源名称+ + .origschema + .toLower(表名) +. toLower(字段名)

规则拼catalog时,使用于新资源(支持catalog)schema ID下的资源,构成为:SCHEMA.数据源名.catalog.schema,

名称留原值、变大写、变小写,如:

ORIGINAL_CATALOG保留原值,如字段id=FIELD + .数据源名称+.origcatalog + .origschema + .表名 +. 字段名
UPPER_CATALOG转大写,如字段id=FIELD + .数据源名称+.origcatalog + .origschema + .toUpper(表名) +. toUpper(字段名)
LOWER_CATALOG转小写,如字段id=FIELD + .数据源名称+.origcatalog + .origschema + .toLower(表名) +. toLower(字段名)


3、把所有的schema节点,插入了知识库之后,可以检查一下表预览数据、数据集、数据模型等是否正常查询数据。

3 不支持的情况及注意事项说明

1、旧资源(

...

没有支持catalog即V11之前创建的资源,)同一catalog、schema下存在多个不同的catalog值,只能选中一个进行替换处理,无法同时支持多个

历史旧ID资源所有的catalog为null,产品支持catalog后,有部分表数据库管理新添加或移除保存后又重新加入,catalog会更新为实际值,这样就会出现旧资源多个catalog的情况

检查方式:可以通过下面sql语句在知识库中查看:

select distinct c_catalog from t_basictable where c_datasrcid = 'DS.northwind' and c_schema = "schema名称"

...