一、前置条件
你已成功创建 TCHouse-X 产品服务角色,详细操作请参见访问授权。
二、创建 TCHouse-X 实例
进入 TCHouse-X 控制台,单击新建实例后进入新建实例页面,你可自定义基本信息、用户管理、存储资源、计算资源等配置信息。
三、Step 1:填写基本信息
在基本信息中,你可自定义实例名称,选择地域、内核版本、计费模式、可用区、TCLake 服务状态、网络,在网络中选择VPC、子网。
字段说明与名称规范性要求如下:
| 字段名称 | 字段释义 | 字段可选值说明及规范性要求 |
| 实例名称 | 实例的名称 | 长度:6~36个字符,1个中文作为1个字符内容:支持中文、英文、数字及特殊字符"-"、"_"唯一性:实例名称无唯一性约束, 自动生成的实例ID为全局唯一 |
| 内核版本 | 实例运行的数据仓库内核版本 | – |
| 地域 | 实例所属的地域 | 暂仅支持广州,如需使用其他地域,可联系 TCHouse-X 产研团队 |
| 可用区 | 实例所属的可用区 | 暂仅支持广州七区,如需使用其他可用区,可联系 TCHouse-X 产研团队 |
| TCLake 服务 | TCHouse-X 存储 TCLake 服务的状态 | 配额限制: 单个主账号在单个地域内,仅支持存在一个 TCLake 服务前置依赖: 开通 TCLake 服务是创建 TCHouse-X 实例的前提条件快捷开通: 用户可在创建 TCHouse-X 实例的过程中,选择授权并自动开通 TCLake 服务 |
| 网络 | 实例所属的 VPC 及子网 | 支持选择主账号下的 VPC 及子网所选子网的剩余可用IP数需多于 6 个 |
四、Step 2:选择用户管理体系
TCHouse-X 当前支持 3 种用户体系:
| 用户体系 | 说明 |
| 腾讯云 CAM 用户 | 用户可使用腾讯云子账号 ID,以及其密钥凭证(SecretId、SecretKey 或临时 Token)连接 TCHouse-X 实例。用户身份和权限的校验由腾讯云 CAM 服务负责。 |
| 自定义用户 | 允许用户设置自定义的用户名和密码,并将其绑定至腾讯云子账号。用户使用该自定义凭证连接 TCHouse-X 实例时,由 TCHouse-X 负责完成用户名和密码的校验。 |
| 自定义 LDAP 用户 | 将自有 LDAP 服务中的用户身份与腾讯云子账号绑定。用户可使用自有 LDAP 凭证连接 TCHouse-X 实例,由自有 LDAP 服务进行用户名和密码校验。 |
注意:说明:
注意:自定义 LDAP 用户体系目前处于实验性阶段。如需申请开通和使用此功能,请联系我们。
五、自定义 LDAP 用户认证开启方法
若用户体系选择自定义 LDAP 用户,新建实例时需配置自定义 LDAP 服务信息, LDAP 配置经过校验后,新建实例流程才可继续。
需配置的LDAP 服务信息如下:
| 配置项 | 说明 | 样例 |
| LdapUrl | LDAP URL 是一个字符串,用于封装目录服务器的地址和端口 | ldap://ds.example.com:389 |
| LdapBaseDn | LDAP Base DN(基础辨别名)用于指定应用程序在 LDAP 目录中搜索用户和信息的层级起始点和边界范围。 | dc=admin, dc=com |
| LdapBindDn | TCHouse-X 用于连接和认证到 LDAP 服务器,以便获取执行用户搜索和信息查询权限的服务账号的完整辨别名(DN) | cn=admin, dc=example, dc=com |
| LdapBindPasswd | 与 LdapBindDn(服务账号)配对使用的密码,用于 TCHouse-X 完成对 LDAP 服务器的身份认证(即绑定操作)。 | – |
| LdapUserFilter | LDAP 搜索语法的过滤器,用于精确筛选出在 Base DN 范围内被识别为有效用户账号的条目。 | – |
| VerifyClientCa | 用于配置 LDAP 服务器在建立 TLS/SSL 安全连接时,是否需要校验客户端证书的有效性和可信度,以实现双向身份验证。默认关闭。 | – |
| VerifyServerCa | 用于配置 LDAP 客户端在建立 TLS/SSL 安全连接时,是否需要验证 LDAP 服务器证书的有效性和可信度,以确保连接到正确的服务器。默认关闭 | – |
| 服务端证书 | LDAP 服务端认证开启时需填充 | – |
六、Step 3:配置存储资源
TCHouse-X 以 TCLake 作为存储基座,因此需配置以下 TCLake 相关参数:
| 配置项 | 说明 |
| TCLake 权限 | TCHouse-X 需要在 TCLake 上执行数据读写、配置管理及获取权限等操作。因此,开通 TCHouse-X 服务时,你必须授予其操作 TCLake 的权限。此权限的授权粒度为腾讯云主账号级别。 |
| Catalog 名称 | TCHouse-X 实例创建时,系统将在 TCLake 中新建 Catalog,用于保存实例内的表数据。该 Catalog 名称支持用户自定义,默认由系统自动生成。 |
| 存储类型 | 目前仅支持选择 TCLake 全托管的批流一体存储方案。 |
七、Step 4:配置数据安全
TCHouse-X 支持 SSL/TLS 传输加密功能,用于保障传输中数据的机密性和完整性,以满足高安全性和合规性要求。此功能默认处于关闭状态。
八、Step 5:配置计算资源
TCHouse-X 实例的 OLAP 任务使用 Warehouse 计算资源,离线任务使用 Serverless 计算资源。创建实例时支持同步创建 Warehouse 资源。
TCHouse-X 目前支持以下两种 Warehouse 计算资源:
| 计算资源类型 | 特点 |
| 标准 Warehouse 计算资源 | 由一个或多个相同规格的计算节点组成。它支持随时进行配置变更、暂停、重启、销毁等操作,并具备分时弹性、定时启停和自动扩缩容等多种弹性能力。 |
| 自适应 Warehouse 计算资源 | 自适应 Warehouse 计算资源包含多个独立的虚拟集群。它具备无基础设施管理的优势(仅需配置最大/单 SQL CU 数),支持根据查询复杂度按需动态分配资源。为提高资源利用率,系统会在集群空闲后自动回收资源。此外,该资源支持虚拟集群异构:集群内部节点规格相同,但集群间规格可不同。 |
注意:说明:
注意:自适应 Warehouse 计算资源目前处于实验性功能阶段(Beta)。如需申请开通和使用此功能,请联系我们。
九、创建标准 Warehouse 计算资源
如果你选择创建标准 Warehouse 计算资源,你需要配置如下信息:
| 字段名称 | 字段释义 |
| Warehouse 名称 | 用户可自定义 Warehouse 名称,默认为“我的Warehouse” |
| 节点规格 | Warehouse 中节点的规格,可选择的规格和说明如下:2X-Small:每节点包含 4 CU 计算资源X-Small:每节点包含 8 CU 计算资源Small:每节点包含 16 CU 计算资源Medium:每节点包含 32 CU 计算资源Large:每节点包含 64 CU 计算资源 |
| 节点个数 | 用户可结合数据规模、查询复杂度和查询并发,设定合适的 Warehouse 节点个数。 |
十、创建自适应 Warehouse 计算资源
如果你选择创建自适应 Warehouse 计算资源,你需要配置如下信息:
| 字段名称 | 字段释义 |
| Warehouse 名称 | 同标准 Warehouse 计算资源 |
| Warehouse 最大可用 CU 数 | 多虚拟集群架构中,资源池能够同时提供给整个 Warehouse 中所有正在运行的虚拟集群的计算资源(CU)总量的上限。 |
| 单条 SQL 最大可用 CU 数 | 单虚拟集群最大可用 CU 数量,其值不允许超过 Warehouse 最大可用 CU 数。 |
十一、Step 6:创建实例
1. 确认无误后,阅读并确认同意《腾讯云服务协议》,单击新建实例,等待实例创建完成。等待约3~5分钟后, 实例创建完成。单击实例ID,进入实例。
注意:TCHouse-X 的运行依赖于对元数据、权限及存储的访问。为确保服务正常启动,系统需创建以下服务关联角色:
注意:若你的账号尚未创建上述角色,系统将在新建流程中通过弹窗引导授权。请务必确认,否则实例将无法完成创建。
2. 进入实例后,可查看实例的基本信息。
注意:说明:
注意:首次创建 TCHouse-X 实例时同步开通 TCLake 服务,预计实例创建完成时间为 20 至 30 分钟。
十二、操作步骤
登录 TCHouse-X 控制台 → 进入实例列表 → 找到目标实例 → 单击操作列中的销毁按钮。
十三、实例存量数据处理(销毁前选择)
| 选项 | 说明 |
| 删除 | 保留 TCLake 服务中当前 TCHouse-X 默认数据目录(Catalog)及数据,但会产生存储费用。 |
| 销毁 | 删除 TCLake 服务中当前 TCHouse-X 默认数据目录(Catalog)及数据。 |
十四、隔离期规则
实例销毁后先进入隔离状态,相关规则如下:
·隔离期:14 天,期间实例不会被立即删除。
·恢复条件:仅实例创建者或主账号可操作恢复,且账户不能欠费。
·隔离期计费:仅收取存储费用。
·恢复后计费:恢复实例后,若使用到计算资源,计算资源将正常计费。
·自动销毁:隔离期结束后,若用户未手动恢复,系统将自动执行销毁流程,实例中的数据与元数据按照用户配置的存量数据处理方式处理。
注意:警告:
注意:执行销毁前请务必确认:
注意:1. 数据安全性: 请确保已完成必要的数据备份或迁移。
注意:2. 链路完整性: 请确认已下线所有指向该实例的 API 接口或报表连接。