VDM Connector

There are use cases that multiple data sources need to be managed and visited together in one single session or view. Also, users may not care about the distribution and source of data at all. The VDM (Virtualize Data Market) connector is aimed at bringing in this feature to openLooKeng.

The VDM connector supports to:

  • Create, update and delete views that combines multiple catalogs
  • Visit real data through the views
  • Manage user privilege through the views
  • Log the use of VDM views by each user


VDM uses openLooKeng metastore to store its database information. It can be stored either on HDFS or relational database, depending on the implementation of openLooKeng metastore.

Therefore metastore must be configured first.

  • Here is an example of using RDBMS as metastore, create etc/hetu-metastore.properties:
# the type of metastore storage
# jdbc connection address of database
# the user name of the database
# the password of database 
  • Here is an example of using HDFS as metastore,create etc/hetu-metastore.properties

    Path white list:["/tmp”, “/opt/hetu”, “/opt/openlookeng”, “/etc/hetu”, “/etc/openlookeng”, current workspace]

    Notice:avoid to choose root directory; ../ can’t include in path; if you config node.date_dir, then the current workspace is the parent of node.data_dir; otherwise, the current workspace is the openlookeng server’s directory.

# the type of metastore storage
# profile name of hetu file system
# the path of metastore storage in the hetu file system

Check filesystem for more information.

For user interface, the connector can be accessed from JDBC or command line interface. Currently VDM only supports schemas and views. Tables are NOT supported.

Schema operations are the same as usual openLooKeng catalogs, including create schema, drop schema, rename schema and show schemas.

Views can be created under a specific schema: create view as ..., drop view.

Example usage:

Configure a data source vdm1 by creating vdm1.properties in etc/catalogs with following contents:


This example creates a schema schema1 in vdm1 catalog, and creates two views from two other different data sources. Note that metastore must be configured in advance (See usage section).

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 datasource can also be managed through dynamic catalog API. See Dynamic Catalog topic for more information.

All supported CLI queries

Support operationExternal interface (SQL command)
Add VDMcreate catalog(resulful)
Remove VDMdrop catalog(resulful)
Query all VDMshow catalogs
Create schemacreate schema
Delete schemadrop schema
Rename schemarename schema
Query all schemas under VDMshow schemas
Query all views in the schemashow tables
Create/Update Viewcreate [or replace] view
Delete viewdrop view
Query data by viewselect
Query view creation informationshow create view
Query view column informationdescribe
See SQL Statement Syntax topic for more information.