说明:
本文档用于说明如何在腾讯云数据仓库 TCHouse-X StarRocks 中配置并使用 DLC 湖仓联动能力,实现通过 TCHouse-X StarRocks 直接读取 DLC 中的表。
适用场景:
已有数据存储在 DLC 中,希望通过 TCHouse-X StarRocks 直接查询。
需要通过 External Catalog 将 DLC 元数据接入 TCHouse-X StarRocks。
需要在 SQL 工作区或 MySQL 客户端中直接读取 DLC 表。
前提条件
购买的 StarRocks 实例与开通的 DLC 服务在同一地域。
已开启 DLC 湖仓联动白名单功能。
若您使用子账号开启湖仓一体,请提前授予子账号 DLC 的管理员权限,还需授予子账号 CAM 的全读写权限(QcloudCamFullAccess),以便在开启湖仓一体时自动给您添加 DLC 元数据查询、存储桶访问等 CAM 策略。
操作指南
1. 登录 腾讯云数据仓库 TCHouse-X 控制台 > StarRocks 实例列表,单击目标资源 ID/名称进入详情页面,在左侧列表单击 湖仓一体 > DLC 湖仓联动进入页面。
2. 在该页面中可查看湖仓一体功能开启情况,单击开关进入配置页面。
字段 | 字段说明 |
Catalog 名称 | 按需自定义,不能以数字开头,可包含数字/字母/_,不超过50个字符,腾讯云数据仓库 TCHouse-X StarRocks 将通过 External Catalog 的方式拉取数据湖 DLC 的元数据。 |
SecretId/SecretKey | 可填写主账号/子账号的 SecretId/SecretKey。 注意:若您填写的是 CAM 子账号的 SecretId/SecretKey,需要此子账号拥有 CAM 的全读写权限(QcloudCamFullAccess)。 |
3. 完成配置后,单击绑定策略并开启即可完成湖仓联动开通配置。开启后,点击编辑按钮,支持修改 SecretId 和 SecretKey。
4. 管理员默认拥有全部库表的权限,若需要对普通用户进行权限管理,可通过用户管理 > 指定用户右侧的修改权限 > Multicatalog 外表权限进行管理。
权限 | 权限说明 |
数据目录级使用权限 | 授予用户目录级别的 USAGE 权限,如需查询数据库/数据表,需同时授权数据库/数据表级别的 SELECT 权限。 |
数据库级查询权限 | 授予用户该数据库下所有数据表的 SELECT 权限,若想单独对数据表级别的权限进行控制,可通过命令行进行授权。 |
5. 使用有权限的用户登录 MySQL 客户端/ SQL 工作区,可查询 DLC 中的数据表。
说明:
暂时仅支持 DLC 1.0 中的 iceberg 内表。暂不支持 CSV/JSON 格式的外表查询。