hetu-core/hetu-docs/zh/connector/vdm.md

VDM连接器

在一些场景中，需要在同一个会话或视图中管理或访问多个数据源，同时，用户不需要关心数据的分布和来源。虚拟数据市场（VDM）连接器旨在将该特性引入openLooKeng。

VDM连接器支持：

• 创建、更新和删除组合多个目录的视图
• 通过视图访问真实数据
• 通过视图管理用户权限
• 记录每个用户使用VDM视图的情况

配置

VDM使用openLooKeng元存储存储其数据库信息。信息可以存储在HDFS或关系数据库中，这取决于openLooKeng元存储的实现。

因此必须先配置VDM元数据的存储方式。

• 下面是使用RDBMS作为VDM元数据的示例，创建etc/hetu-metastore.properties：

# the type of metastore storage
hetu.metastore.type=jdbc
# jdbc connection address of database
hetu.metastore.db.url=jdbc:mysql://....
# the user name of the database
hetu.metastore.db.user=root
# the password of database     
hetu.metastore.db.password=123456

• 下面是使用HDFS作为元数据存储的实例，创建etc/hetu-metastore.properties：

  路径配置白名单：["/tmp", "/opt/hetu", "/opt/openlookeng", "/etc/hetu", "/etc/openlookeng", 工作目录]

  注意：避免选择根目录；路径不能包含../；如果配置了node.data_dir,那么当前工作目录为node.data_dir的父目录； 如果没有配置，那么当前工作目录为openlookeng server的目录

# the type of metastore storage
hetu.metastore.type=hetufilesystem
# profile name of hetu file system
hetu.metastore.hetufilesystem.profile-name=hdfs-config-metastore
# the path of metastore storage in the hetu file system
hetu.metastore.hetufilesystem.path=/etc/openlookeng/metastore

可以从文件系统中获取更多的文件系统相关的信息

对于用户界面，可以从openLooKeng的JDBC或命令行界面访问连接器。当前VDM仅支持schema和view，不支持table。

schema操作与常用的openLooKeng目录相同，包括create schema、drop schema、rename schema和show schemas。

view可以创建在特定的模式下：create view as ...，drop view。

使用示例

配置数据源vdm1，在etc/catalogs中创建vdm1.properties，内容如下：

connector.name=vdm

此示例在vdm1目录中创建模式schema1，并从其他两个不同的数据源创建两个视图。注意，需要提前配置元存储（见使用部分）。

create schema vdm1.schema1;
use vdm1.schema1;
create view view1 as select * from mysql.table.test;
create view view2 as select * from hive.table.test;
select * from view1;

VDM数据源也可以通过动态目录API进行管理。有关更多信息，参见动态目录。

所有支持的CLI查询

支持操作	外部接口（SQL命令）
添加VDM	create catalog（RESTful）
删除VDM	drop catalog（RESTful）
查询所有VDM	show catalogs
创建模式	create schema
删除模式	drop schema
重命名模式	rename schema
查询VDM下所有模式	show schemas
查询模式下的所有视图	show tables
创建/更新视图	create [or replace] view
删除视图	drop view
按视图查询数据	select
查询视图创建信息	show create view
查询视图列信息	describe
有关更多信息，参见SQL语法介绍。