连接 LAS 外表

ByteHouse 云数仓版支持访问湖仓一体分析服务 LAS 上的 ByteLake1.0/2.0以及Managed Hive表。

前提条件

此功能仅在 ByteHouse 云数仓版引擎 2.0.4 以上版本支持，使用前请前往“ ByteHouse 控制台 - 租户管理 - 基本信息” 确认所使用的 ByteHouse 云数仓集群引擎版本。

建立外表 CREATE TABLE

我们可以通过 ByteHouse CLI 工具连接并创建外表。
下图例子，建立一个火山Las上表名为uk_price_paid的外表，使用时不需要指定列名和类型，ByteHouse会读取元数据自动推断。

CREATE TABLE [IF NOT EXISTS] <数据库名>.uk_price_paid
ENGINE = CnchLas('thrift://100.96.4.11:48869', '<las侧数据库名>', 'las侧数据表名')
SETTINGS endpoint = '100.96.4.84:80', 
         region = 'cn-beijing',
         ak_id = 'AKLTMjU3ZTYzOG********yMGE0ZmJiZjc2ODkxZWMxY2Q',
         ak_secret = 'WlRkak56Ump**********sT0RCaU9UQm1NREV4WkRWaU1HWQ=='

LAS提供公网ip和火山plb地址, 火山集群推荐使用plb地址，参数说明：

• region可固定为"cn-beijing"；
• 火山plb地址 thrift://100.96.4.11:48869, endpoint = '100.96.4.84:80' 这两个地址在火山上是固定地址。
• ak_id, ak_secret： LAS用户可以通过火山引擎的 密钥管理 页面获取到 Access Key 和 Secret Access Key。

当然，在建外表时也可以指定列名和类型，一般不推荐。

CREATE TABLE [IF NOT EXISTS]  <数据库名>.uk_price_paid
( 
    uuid Nullable(String),
    price Nullable(Int32),
)
ENGINE = CnchLas('thrift://111.62.122.160:48869', '<las侧数据库名>', 'las侧数据表名')
SETTINGS endpoint = '100.96.4.84:80', 
         region = 'cn-beijing',
         ak_id = 'AKLTMjU3ZTYzOG********yMGE0ZmJiZjc2ODkxZWMxY2Q',
         ak_secret = 'WlRkak56Ump**********sT0RCaU9UQm1NREV4WkRWaU1HWQ=='

常用语法

展示建表语句 SHOW CREATE TABLE

例如，查询前文所建的uk_price_paid的外表的建表语句。

SHOW CREATE TABLE <数据库名>.uk_price_paid

显示表的列名和类型 DESCRIBE TABLE

读取表 SELECT TABLE

删除外表 DROP TABLE

可以通过 DROP TABLE来删除ByteHouse中的外表，但不会删除Las上的原表。