ByteHouse 是一款云原生数据仓库，为用户提供极速分析体验，能够支撑实时数据分析和海量数据离线分析。便捷的弹性扩缩容能力，极致分析性能和丰富的企业级特性，助力客户数字化转型。
火山引擎支持 ByteHouse 云数仓版（ByteHouse CDW）、ByteHouse 企业版（ByteHouse CE）两款数据仓库。下文将为您介绍如何开通这两款 ByteHouse 服务。

1 服务开通注意事项

1. 已创建火山引擎主账号或 IAM 子用户信息，并已完成个人认证和企业认证。详见账号准备
2. ByteHouse CDW、ByteHouse CE 服务支持主账号进行开通。其中：
   • ByteHouse CDW 服务可支持拥有 ByteHouseFullAccess 权限策略的 IAM 子用户进行开通操作；
   • ByteHouse CE 服务可支持拥有 ByteHouseCEFullAccess 权限策略的 IAM 子用户进行开通操作。
     IAM 子用户的权限策略添加，可请主账号前往访问控制 > 用户 > 用户详情 > 权限界面中，添加相应的权限策略。子用户更多权限操作详见用户管理。
3. 服务开通前，您可提前前往产品计费中，查看 ByteHouse 不同版本服务的计费详情。详见 ByteHouse CDW 计费、ByteHouse CE 计费。

2 服务账号授权

首次登录 ByteHouse 控制台时，需先由主账号完成 ByteHouse 服务云资源访问授权操作：

• ByteHouse CDW 服务授权

  1. 主账号首次登录 ByteHouse CDW 控制台 时，会弹窗跨服务访问请求信息。
  2. 在访问请求窗口中，单击立即授权按钮，为 ByteHouse CDW 的服务账号授予名称为 ServiceRoleForByteHouse 的系统默认策略。
     

• ByteHouse CE 服务授权

  1. 主账号首次登录 ByteHouse CE 控制台 时，会弹窗跨服务访问请求信息。
  2. 在访问请求窗口中，单击立即授权按钮，为 ByteHouse CE 的服务账号授予名称为 ServiceRoleForByteHouseCE 的系统默认策略。
     

3 进入服务开通

服务账号授权完成后，便会进入 ByteHouse 服务开通界面，进行服务开通操作。

3.1 开通 ByteHouse CDW

ByteHouse CDW 版是一个同时支持实时和离线导入的自助数据分析平台，能够对 PB 级海量数据进行高效分析。拥有免运维托管服务、弹性伸缩、可扩展、多级资源隔离和高性能单点查询的优势特性。

1. 主账号或拥有 ByteHouseFullAccess 权限策略的 IAM 子用户登录 ByteHouse CDW 控制台。

2. 在服务开通界面，进行以下服务开通操作：

   参数	说明
   地域	ByteHouse CDW 目前支持在北京、上海、广州三个地域进行开通，您可根据实际情况，在上方选择地域后，进行开通操作。
   付费方式	目前支持按量计费、包年包月的付费方式。具体收费详情详见 ByteHouse CDW 计费。
   计算组	添加 ByteHouse CDW 计算组信息，您可在此添加，同时也可开通服务后，在控制台 > 计算组的页签进行创建。详见创建计算组。 您可按需选择计算组的大小，以及计算组的名称和描述信息。也可根据情况来选择计算组是否需要自动暂停和自动启动： 自动暂停：开启后，如在间隔时间段内未使用，计算组会被自动关闭。 自动启动：开启后，有新的查询请求时，计算组会被自动启动。注意，首次查询可能会耗时较长。 说明 计算组名称需要以小写字母开头，可由小写字母和数字组成，使用单个下划线连接名称。
   私有网络	选择数据源或任务需访问资源所在的私有网络。如现有私有网络不符合您的要求，请前往控制台创建私有网络。 配置说明详见创建私有网络。 说明 为方便后续和 DataSail 独享集成资源组的网络能够互相访问，建议和独享集成资源组使用同一个私有网络。
   子网	选择VPC下对应可选的子网信息。如现有子网不符合您的要求，需前往子网控制台创建子网。 详见创建子网。 说明 为方便后续和 DataSail 独享集成资源组的网络能够互相访问，建议和独享集成资源组使用同一个子网信息。
   安全组	选择挂载在VPC下的安全组信息。如现有安全组不符合您的要求，需前往安全组控制台创建安全组。 详见创建安全组。 说明 为方便后续和 DataSail 独享集成资源组的网络能够互相访问，建议和独享集成资源组使用同一个安全组信息。

完成以上配置信息后，勾选“我已阅读并同意 《ByteHouse 服务专用条款》”，并单击“开通 ByteHouse”按钮，完成 ByteHouse CDW 服务开通。

3.1.1 创建 ByteHouse CDW 数据库

ByteHouese CDW 服务开通完成后，您便可继续创建相应的 ByteHouese CDW 数据库信息。
在数据库页签下，单击新建数据库按钮，进入新建窗口，完成以下信息配置：

3.1.2 创建 Access Key

数据库创建完成后，您需创建 ByteHouse CDW 中的 Access Key 信息，用于后续 DataSail 配置数据源时使用，或也可用于其他第三方连接工具连接 ByteHouse CDW 时使用。

1. 进入租户管理 > 连接信息界面；
2. 在连接信息界面，单击“新建”按钮，进行创建 API Token。

3.1.3 获取 ByteHouse CDW 连接信息

1. 设置计算组和默认角色
   在与 ByteHouse CDW 连接初始化过程中，会采用默认的计算组和角色设置。
   在使用驱动程序连接到 ByteHouse CDW 之前，您需要通过租户管理 > 参数设置中确认这些值。
   
2. 获取 ByteHouse CDW 连接信息
   一般情况下，连接到 ByteHouse CDW 需要以下信息：
   • {HOST}:{PORT} 集群的访问地址和端口
   • {API_KEY} 当前账户的 API Token，即上方创建的 Access Key 信息

   说明

   火山引擎 ByteHouse 的 User 用户默认为bytehouse。
   非火山引擎托管的 ByteHouse， 需要与平台管理员获取 {USERNAME} 信息。

3. 获取集群信息
   您也可以直接在控制台租户管理 > 连接信息页面，获取到集群相关连接方式的连接地址。
   

3.2 创建 ByteHouse CE 集群

ByteHouse 是火山引擎自主研发的数据仓库产品，提供海量数据上更强的查询服务和数据写入性能，应用包括海量数据多维分析、机器学习模型评估、微服务监控和统计等。

1. 主账号或拥有 ByteHouseCEFullAccess 权限策略的 IAM 子用户，登录 ByteHouse CE 控制台。

2. 在上方下拉选择需要创建集群的地域信息，目前支持北京、上海地域进行集群创建。

3. 在对应地域的概览界面，单击新建集群按钮，可进行 ByteHouse CE 集群相关创建。

   

4. 在新建集群界面，完成新建集群相关操作。操作详见创建集群。

   说明

   集群中的网络信息配置：私有网络、子网、安全组，为方便后续和 DataSail 独享集成资源组的网络能够互相访问，建议和独享集成资源组使用同一个网络配置信息。

5. 集群信息配置完成后，勾选“我已阅读并同意 《ByteHouse 服务专用条款》，《产品和服务协议》，《服务等级协议》”，并单击确认订单按钮，完成支付后，集群便创建完成。

3.2.1 创建 ByteHouse CE 数据库

ByteHouse CE 集群服务创建完成后，您便可继续创建相应的 ByteHouse CE 数据库信息。

1. 登录 ByteHouse 企业版控制台。

2. 单击右上角运维与权限管理入口，并下拉选择数据管理与查询按钮，进入数据管理界面。

   

3. 在右上角下拉选择已创建成功的集群信息。
   

4. 在对应集群下，单击左侧目录树上新建按钮，进行新建数据库操作。

   

5. 在新建数据库窗口，完成以下信息配置：

   配置项	说明
   数据库名称	输入 ByteHouse CE 数据库名称信息，库名命名规则如下： 请以字母或下划线开头，支持数字，字母及下划线； 不能使用关键字: 'system', 'default' or 'admin' 最大长度不超过 63 字符
   数据库描述	根据实际情况输入数据库描述信息，方便后续维护管理。

6. 单击创建按钮，完成 ByteHouse CE 数据库创建。