1、在hbase集群中各hregionserver节点的hbase-site.xml配置文件内，加入支持phoenix二级索引所需的参数。

2、同样地，需将上述配置项同步添加至HBase主节点（如HMaster所在节点）的hbase-site.xml文件中，确保全局配置一致性。

3、常见问题汇总

4、特别说明：部分公开文档建议启用某项配置，但在实际验证中（实测环境为hbase-1.3.1，参考历史版本为0.98.6），一旦启用该配置，会导致RegionServer进程无法正常启动——启动后立即退出，对应节点上查无HRegionServer进程。经排查确认，移除此配置项后，HBase可稳定启动，并能成功创建本地索引，整体功能运行良好。

5、在hbase-site.xml中配置ZooKeeper连接地址时，务必仅填写ZK地址列表（如zk1,zk2,zk3），不可显式指定端口号2181；否则在创建本地索引过程中会触发异常，致使建索引操作失败，进而干扰HBase核心服务的正常使用。

6、标准推荐配置示例

7、执行索引构建操作

8、Phoenix索引类型划分

9、全局索引为系统默认索引模式，适用于查询密集型、写入频次较低的业务场景。其特点是在数据写入时，需同步更新分布在多个RegionServer上的索引表，涉及跨节点通信与数据同步，带来显著的写入性能损耗。而在查询阶段，Phoenix会优先命中索引表以加速响应；但前提是所查字段全部包含于索引定义中，否则索引将被自动忽略，查询仍走原表扫描，性能无提升。因此，科学规划索引列组合是保障查询效率的关键前提。

10、局部索引则更适配高并发写入场景。因索引数据与原始表数据共存于同一RegionServer，避免了跨节点索引写入开销。即使查询条件中存在未被索引覆盖的字段，Phoenix仍可借助局部索引完成优化扫描，从而兼顾写入吞吐与查询响应能力。该机制有效压缩网络延迟，提升写入稳定性，并对非索引字段的检索提供一定加速效果。

11、三种高性能查询实践方式

12、索引删除操作指引