前提条件

注册火山引擎账号，并完成企业实名认证。

快速使用 ByteHouse

1. 开启服务

单击火山引擎控制台左上角，展示 产品与服务 列表，选择 “ByteHouse 企业版”。
首次通过火山账号进入 ByteHouse 企业版，会开启 ByteHouse 服务，同时系统会自动生成 ByteHouse 初始服务密码。
在界面右上角点击个人中心图标，在下拉菜单中单击“账号管理”，即可在集群连接模块查看系统给用户生成的临时服务密码。

2. 新建集群

使用 ByteHouse 企业版，首先需要新建一个 ByteHouse 集群。该集群提供了完整的 ByteHouse 服务。
下面我们来开始新建集群：

1. 登录火山引擎，进入 ByteHouse 企业版控制台。

2. 单击 新建集群 按钮，进入新建集群配置界面。
   

3. 接下来，选择创建新集群的选项。您需要根据您的实际数据量情况选择合适的计算与存储资源：
   

   参数	说明
   地域
   地域	火山引擎数据中心的地理位置区域，根据地理位置的不同划分了不同的地域。在实例创建后，实例的地域不可更改。
   可用区	是一个或多个物理数据中心的集合。在同一个地域内，可用区的电力网络相互独立，即一个可用区故障时不会影响到同地域内的其他可用区。不同地域的可用区相互隔离，相同地域的可用区可以互通。
   付费信息
   计费类型	ByteHouse 企业版目前仅支持包年包月计费模式。计费详情参考：定价规则。
   计算资源
   规格	单个计算节点的规格，支持通用型和性能型两种规格。 通用型：适用于业务的性能要求不高的场景，可选 4 核 16 GiB - 64 核 256 GiB。计算规格和集群的性能正相关。 性能型：适用于业务对性能要求高的场景，如 IOPS 敏感型、计算密集型、高吞吐量应用场景，可选 16 核 128 GiB - 64 核 512 GiB。
   副本模式	单副本： 即 ByteHouse 集群的一个分片（Shard）仅含一个节点（Node），单节点故障、集群重启时，集群会不可查询，且不可导入。 双副本： 即 ByteHouse 集群的一个分片（Shard）含两个节点（Node），实现高可用，即便单节点故障、集群重启时，集群仍能正常提供服务。
   节点数量	为集群的节点数量，如果选择了双副本，则节点数量必须为偶数。
   存储资源
   单节点存储空间	单个节点的数据盘空间，即 ByteHouse 可用的空间。 在单副本下，集群的总体存储为 单节点存储空间 * 节点数，容量为单节点存储空间 * 节点数。 在双副本下，集群的总体存储为 单节点存储空间 * 节点数，容量为单节点存储空间 * 节点数/2。
   冷热分层存储（Beta）	对于访问频次较低的数据，存储在较低价的冷数据存储中（即对象存储），以达到节省存储成本的目的。冷存储单独计费，您也可以在后续再开启此功能。详见冷热分层存储。
   网络信息
   私有网络	私有网络（VPC，Virtual Private Cloud）为云上资源构建隔离的、自主配置和管理的虚拟网络环境。详见私有网络。 此处，建议将 ByteHouse 集群和上游数据源（如 Kafka，MySQL 等）配置在一个 VPC 中，便于网络互访。
   子网	子网是私有网络内的IP地址块，创建私有网络后，通过创建子网可以将私有网络划分为一个或多个网络模块。详见子网文档。
   安全组	安全组是一个逻辑意义上的分组，为同一个私有网络内具有相同安全保护需求并相互信任的云服务器提供访问策略，是重要的网络安全隔离手段。详见安全组。 需保证当前安全组对于访问 ByteHouse 的 8123，9000 端口放行。
   高级特性
   GIS 时空分析	GIS 时空分析是在 ByteHouse 上提供了一系列数据分析的能力，用于处理和分析地理空间数据，通过对地理数据进行提取、转换、分析和可视化，揭示地理现象的模式、趋势、关联和变化规律，从而获得对地理现象、商业目标的深入洞察。 您可单击功能卡片右上角的按钮，启用该功能。该功能建议搭配性能型（1:8）计算资源规格使用，以享受更好的性能。
   向量检索	支持对文本、图片、视频等非结构化数据的向量特征进行存储和高效的相似度检索，可应用于以图搜图、以图搜视频、文本检索、文本搜图等场景，也可以与大模型结合构建智能化应用。 您可单击功能卡片右上角的按钮，启用该功能。该功能建议搭配性能型（1:8）计算资源规格使用，以享受更好的性能。
   全文检索	对非结构化数据进行自动分词，自动构建倒排索引，支持高效的全文检索，可应用于结构化和非结构化数据混合检索场景。 您可单击功能卡片右上角的按钮，启用该功能。该功能建议搭配性能型（1:8）计算资源规格使用，以享受更好的性能。
   集群
   集群名称	控制台上展示的集群名称，也会作为 ByteHouse 配置文件内的集群名。集群名在账户内唯一。命名规则如下： 仅支持字母，数字，下划线_，以字母开头； 最多支持设置 128 个字符。
   描述	输入集群的描述信息，方便后续管理。最多支持设置 128 个字符。
   购买时长	可选择 1 个月 - 3 年。
   自动续订	在集群到期前7天，系统将会自动从您的账户余额中扣除续费费用。详见计费方式。
   集群时区	选择 ByteHouse 集群的时区，集群时区需要和导入数据的时区保持一致。
   更多设置
   所属项目	项目是火山引擎提供的一种资源分组管理的机制，帮助达成逻辑层面的资源隔离，您能够通过资源项目进行项目制授权和分账等操作。 您可从下拉列表中选择集群所属的项目，如需将集群归属在新项目，请单击新建项目。
   标签	标签由一个键-值对组成，用于标记资源，便于搜索和资源聚合。您设置的用户自定义标签将应用在本次购买的 ByteHouse 集群中。标签管理的详情请参见标签管理。

4. 在选择完所有信息后，勾选“我已阅读并同意”相关协议，单击确认订单，即完成集群的创建。

5. 集群进入“运行中”状态后，即可正常访问。

3. 导入用户

若需要让子用户也激活 ByteHouse 企业版，需要进行如下操作：

1. 主账号给子用户关联 ByteHouse 企业版 IAM 策略。
   1. 登录 访问控制 IAM 控制台。
   2. 在左侧导航栏，选择身份管理 > 用户。
   3. 在用户列表中，找到需要设置权限的用户名，单击对应操作列下的添加权限。
   4. 在添加权限面板的搜索框中输入 ByteHouseCEFullAccess 并单击提交。
   5. 提交后，单击完成。
2. 子用户 通过 IAM 登录页面进入 ByteHouse 企业版控制台。

4. GUI 访问集群

登录 ByteHouse 企业版控制台，单击集群列表，查看已创建的集群，可通过 GUI 对集群进行以下操作：

• 数据管理：支持库表创建、分区管理。
• 数据导入：支持从 Kafka/对象存储 导入数据到 ByteHouse。
• 数据查询：支持对集群发起查询，以及浏览查询历史，诊断大查询。

5. Client 访问集群

在任何一台和 ByteHouse 集群网络联通的云服务器上安装 clickhouse-client，并执行命令，即可实现连接集群：

clickhouse-client --host <HOSTNAME> \
                  --user <USERNAME> \
                  --password <PASSWORD>

步骤和参数配置参考：ClickHouse Client。