ByteHouse 企业版是火山引擎自主研发的数据仓库产品，帮助企业高效处理海量数据，提升数据查询与写入效率，适用于需要大规模数据存储、快速查询分析的场景。本文将介绍使用 ByteHouse 企业版管理数据前，需要管理员完成的服务开通、创建子用户、新建集群等配置操作，并介绍如何快速上手使用 ByteHouse 企业版管理数据。

进入火山引擎官网首页，单击右上角的立即注册，按界面引导完成火山引擎官网账号注册及实名认证，操作详情请参见账号注册流程。

1. 访问 ByteHouse 产品首页，单击购买企业版。
   

2. 根据界面提示单击立即授权，授权 ByteHouse 企业版跨服务访问私有化网络、云监控等产品。授权完成后，即可进入 ByteHouse 企业版控制台。
   

3. 在 ByteHouse 企业版控制台上，单击新建集群，该集群提供了完整的 ByteHouse 企业版服务。您可根据您的实际数据量情况选择合适的计算与存储资源。
   

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

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

5. 您可在集群管理中的集群列表查看创建的集群，集群状态为运行中时，即可正常访问 ByteHouse 集群。

ByteHouse 企业版支持通过主账号或 IAM 子用户两种方式访问 ByteHouse 企业版服务。您可通过创建并配置多个 IAM 子用户并配置差异化权限策略，可实现精细化权限管理，从权限层面保障业务数据的安全性与合规性。本节将详细说明子用户的创建流程及授权配置步骤。
您也可以直接使用主账号快速体验 ByteHouse 企业版服务，可直接参考下文步骤四的内容，开始体验 ByteHouse 企业版。

操作步骤：

1. 使用火山引擎主账号登录火山引擎访问控制台，在左侧导航栏，选择用户管理 > 用户，单击新建用户按钮。
2. 通过用户名、手机号或邀请巨量引擎账号方式创建子用户。以下步骤使用通过用户名方式创建子用户。
3. 配置用户基本信息。
   • 用户信息：填写子用户的用户名（必选）、手机号、邮箱、显示名称、备注、标签等信息。
   • 访问方式：勾选控制台访问选项，并为用户分配密码。

   说明

   您可以根据自身安全策略要求，选择是否启用“下次登录时重置密码”与“登录时开启 MFA 二次身份认证”功能。
   开启“下次登录时重置密码”功能后，在用户的下次登录时，会弹出修改密码页面，完成后才可进入 ByteHouse 控制台。
   开启“MFA 二次身份认证”功能后，每次登录时需要通过 TOTP 校验器 APP（如 Google Authenticator 等 ），或者是支持 FIDO Passkey 的终端设备来实现身份验证。具体可参见启用和解绑 MFA 设备。

4. 配置 ByteHouse 企业版的使用权限。
   • 当前系统为您预置了「ByteHouseCEFullAccess」、「ByteHouseCEStandardAccess」、「ByteHouseCEReadOnlyAccess」、「ByteHouseCEEngineOnlyAccess」权限策略。不同权限策略对应的用户可执行的操作不同，您可按需配置，更多权限策略的说明请参见子用户管理。
   • 限制到项目资源选项请务必勾选全局，否则子用户将无法访问 ByteHouse。
5. 完成权限配置后，单击下一步，审阅授予的权限，确认无误后，单击下一步，完成子用户创建。
   复制或保存您创建的 IAM 子用户的账号、密码、控制台登录地址信息，并将用户的账号密码等信息提供给使用者。
6. 在 ByteHouse 企业版控制台上，使用主账号将 IAM 子用户同步至 ByteHouse 企业版控制台，并为用户授予数据权限。此时，获得授权的子用户可以登录 ByteHouse 企业版控制台并开始管理数据。
   • 同步 IAM 子用户请参见同步子用户并重置密码。
   • 为 IAM 子用户授予数据权限请参见为用户授予库表权限。

创建子用户，并为子用户授予权限后，您可使用主账号或子账号登录 ByteHouse 企业版控制台，并开始使用 ByteHouse。
本节将以创建数据库和使用 SQL 语句创建表、插入并查询数据为示例，演示如何快速上手使用 ByteHouse 企业版管理数据。

创建数据库

1. 单击数据管理，单击左侧集群列表，选择目标集群，单击新建，单击创建库。
   
2. 在创建库弹窗中填写数据库名称、描述，单击创建。
   
   其中数据库名称的命名规则如下：
   • 请以字母或下划线开头，支持数字，字母及下划线。
   • 不能使用关键字：'system', 'default' 或 'admin'。
   • 最大长度不超过 63 字符。
3. 确认数据库名称和描述填写无误后，单击创建。

执行 SQL 语句

1. 在 ByteHouse 企业版控制台上，单击数据查询，进入查询窗口，在右上角选择目标集群。

2. 在新工作表中输入以下示例语句，选择全部节点，勾选所有查询，单击运行。

   -- 创建数据表
   CREATE TABLE
     default.demo_table (
       `first_name` String,
       `last_name` String,
       `email` String,
       `address` String,
       `city` String,
       `start_date` Date
     ) ENGINE = MergeTree
   ORDER BY
     start_date
   SETTINGS
     storage_policy = 's3_cold',
     index_granularity = 8192;
   
   -- 插入数据
   INSERT INTO default.demo_table
   VALUES 
   ('Arlene', 'Davidovits', 'adavidovitsk@bytedance.com', '7571 New Castle Circle', 'Meniko', '2017-05-03'),
   ('Violette', 'Shermore', 'vshermorel@bytedance.com', '899 Merchant Center', 'Troitsk', '2017-01-19'),
   ('Ron', 'Mattys', 'rmattysm@bytedance.com', '423 Lien Pass', 'Bayaguana', '2017-11-15'),
   ('Shurlocke', 'Oluwatoyin', 'soluwatoyinn@bytedance.com', '40637 Portage Avenue', 'Semmanovskoye', '2017-09-12'),
   ('Granger', 'Bassford', 'gbassfordo@bytedance.co.uk', '6 American Ash Circle', 'Kardmatsa', '2016-12-30'),
   ('Wallis', 'Sizey', 'wsizeyf@bytedance.com', '36761 American Lane', 'Taibao', '2016-12-30'),
   ('Di', 'McGowran', 'dmcgowrang@bytedance.com', '1856 Maple Lane', 'Banjar Bengkelgede', '2017-04-22'),
   ('Carson', 'Bedder', 'cbedderh@bytedance.co.au', '71 Clyde Gallagher Place', 'Leninskoye', '2017-03-29'),
   ('Dana', 'Avory', 'davoryi@bytedance.com', '2 Holy Cross Pass', 'Wenlin', '2017-05-11'),
   ('Ronny', 'Talmadge', 'rtalmadgej@bytedance.co.uk', '588 Chinook Street', 'Yawata', '2017-06-02');
   
   -- 查询数据
   SELECT * FROM default.demo_table;
   

3. 您可在工作表下方查看查询结果。
   

您可参考以下文档了解更多查询窗口的用法和 ByteHouse SQL 语句：

• 查询窗口
• SQL 语法

除了使用 SQL 语句创建表，ByteHouse 企业版也支持可视化建表，也提供了不同表引擎的建表 DDL 语句模板，帮助您更好地使用 ByteHouse。此外，ByteHouse 也支持通过数据导入功能将数据从对象存储、Kafka 等数据源导入至 ByteHouse。您可参考以下文档，更好地了解 ByteHouse 的用法：

• 新建数据库/表
• 新建数据库/表：基于DDL模板
• 数据导入：支持从 Kafka/对象存储导入数据到 ByteHouse。
• 数据查询：支持对集群发起查询，以及浏览查询历史，诊断大查询。

ByteHouse 企业版也提供了多种连接方式，如 ClickHouse Client、JDBC、Python Driver 等等，您可参考以下文档，了解更多信息：连接集群。