Index 操作

更新时间：2026-09-01

创建索引

功能介绍

为指定表和指定字段新建索引，当前支持新建向量索引、FILTERING索引、二级索引、PERSISTENT_BITMAP索引、PERSISTENT_AGGREGATED_BITMAP索引与倒排索引（全文索引），支持一次请求同时创建多个索引。

请求示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
import com.baidu.mochow.model.CreateIndexRequest;
import com.baidu.mochow.model.entity.HNSWParams;
import com.baidu.mochow.model.entity.SecondaryIndex;
import com.baidu.mochow.model.entity.VectorIndex;
import com.baidu.mochow.model.enums.IndexType;
import com.baidu.mochow.model.enums.MetricType;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        
        CreateIndexRequest createIndexRequest = CreateIndexRequest.builder()
                .database(databaseName)
                .table(tableName)
                .addIndex(new SecondaryIndex("book_name_idx", "bookName"))
                .addIndex(VectorIndex.builder()
                    .indexName("vector_idx")
                    .indexType(IndexType.HNSW)
                    .fieldName("vector")
                    .params(new HNSWParams(32, 200))
                    .metricType(MetricType.L2)
                    .autoBuild(false).build())
                .build();
        mochowClient.createIndex(createIndexRequest);
    }
}
            

注意事项

创建向量索引时可以指定truncationDimension，仅使用原始向量的一段维度子集构建索引，取值格式与限制请参见建表操作的IndexField说明；该成员与params同级，需要使用VectorIndex的对应构造函数传入，VectorIndex.builder()当前不包含该参数。
创建FILTERING索引时，FilteringIndexField的indexStructureType支持DEFAULT、BITMAP和AGGREGATED_BITMAP。
创建PERSISTENT_AGGREGATED_BITMAP索引时必须填写fanoutBits和maxDepth，取值范围分别为[1, 10]和[2, 30]，且需要满足fanoutBits * (maxDepth - 1) <= 64。
创建倒排索引（全文索引）时，fields支持TEXT、TEXT_GBK、TEXT_GB18030、ARRAY<TEXT>、JSON类型字段；InvertedIndexParams中的stopWords只能在创建索引时指定，创建后不支持原地修改，检索请求也不能临时覆盖。
倒排索引创建后会异步构建：构建完成前查询索引详情返回的state为BUILDING，此时发起BM25/Hybrid检索会返回错误码95（Index Building）；state变为NORMAL后方可用于检索。

全文索引创建示例

                Java
                
            

                import java.util.Arrays;

import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
import com.baidu.mochow.model.CreateIndexRequest;
import com.baidu.mochow.model.DescribeIndexResponse;
import com.baidu.mochow.model.entity.InvertedIndex;
import com.baidu.mochow.model.entity.InvertedIndexParams;
import com.baidu.mochow.model.entity.StopWords;
import com.baidu.mochow.model.enums.IndexState;
import com.baidu.mochow.model.enums.InvertedIndexAnalyzer;
import com.baidu.mochow.model.enums.InvertedIndexFieldAttribute;
import com.baidu.mochow.model.enums.InvertedIndexParseMode;
public class Main {
    public static void main(String[] args) throws InterruptedException {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        String indexName = "segment_inverted_idx";

        CreateIndexRequest createIndexRequest = CreateIndexRequest.builder()
                .database(databaseName)
                .table(tableName)
                .addIndex(new InvertedIndex(
                        indexName,
                        new String[]{"segment"},
                        new InvertedIndexParams(
                                InvertedIndexAnalyzer.DEFAULT_ANALYZER,
                                InvertedIndexParseMode.COARSE_MODE,
                                true,
                                new StopWords("CUSTOM", Arrays.asList("呀", "啊", "哦"))),
                        new InvertedIndexFieldAttribute[]{InvertedIndexFieldAttribute.ANALYZED}))
                .build();
        mochowClient.createIndex(createIndexRequest);

        // 倒排索引异步构建，等待 state 变为 NORMAL 后才能发起 BM25/Hybrid 检索
        while (true) {
            Thread.sleep(2000);
            DescribeIndexResponse describeIndexResponse =
                    mochowClient.describeIndex(databaseName, tableName, indexName);
            if (describeIndexResponse.getIndex().getState() == IndexState.NORMAL) {
                break;
            }
        }
    }
}
            

其他2.4新增索引类型的创建示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
import com.baidu.mochow.model.CreateIndexRequest;
import com.baidu.mochow.model.entity.FilteringIndex;
import com.baidu.mochow.model.entity.FilteringIndexField;
import com.baidu.mochow.model.entity.PersistentAggregatedBitmapIndex;
import com.baidu.mochow.model.entity.PersistentBitmapIndex;
import com.baidu.mochow.model.enums.IndexStructureType;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";

        CreateIndexRequest createIndexRequest = CreateIndexRequest.builder()
                .database(databaseName)
                .table(tableName)
                // AGGREGATED_BITMAP 结构除等值查询外还可加速 >、>=、<、<= 范围查询
                .addIndex(FilteringIndex.builder()
                        .name("filtering_idx")
                        .addField(new FilteringIndexField("status", IndexStructureType.BITMAP))
                        .addField(new FilteringIndexField("publishTime", IndexStructureType.AGGREGATED_BITMAP))
                        .build())
                .addIndex(new PersistentBitmapIndex("status_bitmap_idx", "status"))
                .addIndex(new PersistentAggregatedBitmapIndex(
                        "publish_time_bitmap_idx", "publishTime", 4, 10))
                .build();
        mochowClient.createIndex(createIndexRequest);
    }
}
            

成员名	类型	是否必填	成员含义
database	String	是	建索引的库名
table	String	是	建索引的表名
indexes	List<IndexField>	是	待创建的索引列表，builder中通过addIndex逐个追加

删除索引

功能介绍

删除指定索引，支持删除向量索引、标量索引（含PERSISTENT_BITMAP、PERSISTENT_AGGREGATED_BITMAP）、FILTERING索引与倒排索引（含2.4之前版本创建的全文索引）。当前不支持删除构建中（state为BUILDING）的向量索引与倒排索引。

请求示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        mochowClient.dropIndex(databaseName, tableName, "test_index");
    }
}
            

请求参数

参数	参数类型	是否必选	参数含义
databaseName	String	是	库名
tableName	String	是	表名
indexName	String	是	索引名

重建向量索引

功能介绍

重建指定索引，当前仅支持重建向量索引。

请求示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        mochowClient.rebuildIndex(databaseName, tableName, "test_index");
    }
}
            

请求参数

参数	参数类型	是否必选	参数含义
databaseName	String	是	库名
tableName	String	是	表名
indexName	String	是	索引名

查询索引详情

功能介绍

查询指定索引的详情。

请求示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
import com.baidu.mochow.model.DescribeIndexResponse;
import com.baidu.mochow.util.JsonUtils;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        DescribeIndexResponse response = mochowClient.describeIndex(databaseName, tableName, "test_index");
        System.out.printf("Describe table response: %s\n", JsonUtils.toJsonString(response));
    }
}
            

请求参数

参数	类型	是否必填	参数含义
databaseName	String	是	库名
tableName	String	是	表名
indexName	String	是	索引名

DescribeIndexResponse

成员名	类型	是否必填	成员含义
indexField	IndexField	是	索引详细信息

IndexField

成员名	类型	是否必填	成员含义
indexName	String	是	索引的名字
field	String	是	索引作用于的字段名称
indexType	IndexType	是	索引类型。取值如下：非向量索引类型： SECONDARY_INDEX：标量二级索引，JSON取值为SECONDARY FILTERING_INDEX：过滤索引，JSON取值为FILTERING INVERTED_INDEX：倒排索引（全文索引），JSON取值为INVERTED PERSISTENT_BITMAP：持久化BITMAP索引 PERSISTENT_AGGREGATED_BITMAP：持久化聚合BITMAP索引向量索引类型： FLAT HNSW HNSWPQ HNSWSQ HNSWRABITQ PUCK DISKANN IVF IVFSQ IVFPQ SPARSE_OPTIMIZED_FLAT
metricType	MetricType	否	向量之间距离度量算法类型。取值如下： L2：欧几里得距离 IP：内积距离 COSINE：余弦距离注：当使用COSINE距离时，用户需要自行对相关向量进行归一化操作，未经归一化的向量将导致search结果不准确
params	IndexParams	否	向量索引或倒排索引的构建参数
truncationDimension	List<Integer>	否	构建向量索引时使用的原始向量维度子集，格式为[begin, end)，需满足0 <= begin < end <= dimension，实际构建维度为end - begin，不填写时使用完整向量。该成员与params同级，不在params内部。仅支持FLOAT_VECTOR字段，且仅支持HNSW、HNSWRABITQ、HNSWPQ、HNSWSQ、IVF、IVFPQ、IVFSQ索引类型；HNSWPQ、IVFPQ还要求end - begin能被params中的NSQ整除。
autoBuild	Boolean	否	是否有自动构建索引策略
autoBuildPolicy	AutoBuildPolicy	否	自动构建索引策略参数 policyType：策略类型，有如下几种类型: periodical，周期性构建索引。 rowCountIncrement，根据tablet行增长数自动构建索引。 timing，定时构建索引 periodInSecond：周期性构建索引的秒数，只在周期性构建索引策略类型时返回。 timing：字符串类型，返回定时构建的时间，只在定时构建索引策略类型时返回 rowCountIncrement：返回触发构建时增长的行数以及百分比，只在行增长数构建索引类型时返回。
state	IndexState	否	索引状态，建索引时不需要使用。取值如下： INVALID：仅向量索引会出现本状态，表示索引没有生效，需要触发一次索引重建 BUILDING：表示索引正在构建中。倒排索引在该状态下发起BM25/Hybrid检索会返回错误码95（Index Building） NORMAL：表示索引已完成构建并处于正常状态

不同索引类型的典型返回成员

索引类型	主要返回成员
向量索引	field、metricType、params、autoBuild、autoBuildPolicy、state；如创建时配置了truncationDimension，还会返回truncationDimension
二级索引、PERSISTENT_BITMAP、PERSISTENT_AGGREGATED_BITMAP	field
FILTERING索引	fields，其中每个元素包含field和indexStructureType
倒排索引（全文索引）	fields、fieldAttributes，以及params中的analyzer、parseMode、analyzerCaseSensitive、stopWords

倒排索引的params.stopWords始终返回mode。CUSTOM模式同时返回保持创建顺序的words；DEFAULT和NONE模式不返回words；未显式配置停用词的已有索引返回mode为DEFAULT。

修改索引

功能介绍

修改向量索引信息，目前只支持修改autoBuild属性。

请求示例

                Java
                
            

                import com.baidu.mochow.auth.Credentials;
import com.baidu.mochow.client.ClientConfiguration;
import com.baidu.mochow.client.MochowClient;
import com.baidu.mochow.model.ModifyIndexRequest;
import com.baidu.mochow.model.entity.HNSWParams;
import com.baidu.mochow.model.entity.VectorIndex;
import com.baidu.mochow.model.enums.IndexType;
import com.baidu.mochow.model.enums.MetricType;
public class Main {
    public static void main(String[] args) {
        String account = "root";
        String apiKey = "*********";
        String endpoint = "*.*.*.*:*"; // example: 127.0.0.1:5287
        ClientConfiguration clientConfiguration = new ClientConfiguration();
                clientConfiguration.setCredentials(new Credentials(account, apiKey));
                clientConfiguration.setEndpoint(endpoint);
        MochowClient mochowClient = new MochowClient(clientConfiguration);
        String databaseName = "test";
        String tableName = "test";
        
        ModifyIndexRequest modifyIndexRequest = ModifyIndexRequest.builder()
                .database(databaseName)
                .table(tableName)
                .index(VectorIndex.builder()
                    .indexName("vector_idx")
                    .indexType(IndexType.HNSW)
                    .fieldName("vector")
                    .params(new HNSWParams(32, 200))
                    .metricType(MetricType.L2)
                    .autoBuild(false).build()
                    )
                .build();
        mochowClient.modifyIndex(modifyIndexRequest);
    }
}
            

请求参数

参数	类型	是否必填	参数含义
databaseName	String	是	库名
tableName	String	是	表名
index	IndexField	是	索引详细信息

IndexField

成员名	类型	是否必填	成员含义
indexName	String	是	索引的名字
field	String	是	索引作用于的字段名称
indexType	IndexType	是	索引类型。取值如下：非向量索引类型： SECONDARY_INDEX：标量二级索引，JSON取值为SECONDARY FILTERING_INDEX：过滤索引，JSON取值为FILTERING INVERTED_INDEX：倒排索引（全文索引），JSON取值为INVERTED PERSISTENT_BITMAP：持久化BITMAP索引 PERSISTENT_AGGREGATED_BITMAP：持久化聚合BITMAP索引向量索引类型： FLAT HNSW HNSWPQ HNSWSQ HNSWRABITQ PUCK DISKANN IVF IVFSQ IVFPQ SPARSE_OPTIMIZED_FLAT
metricType	MetricType	否	向量之间距离度量算法类型。取值如下： L2：欧几里得距离 IP：内积距离 COSINE：余弦距离注：当使用COSINE距离时，用户需要自行对相关向量进行归一化操作，未经归一化的向量将导致search结果不准确
params	IndexParams	否	向量索引或倒排索引的构建参数
truncationDimension	List<Integer>	否	构建向量索引时使用的原始向量维度子集，格式为[begin, end)，需满足0 <= begin < end <= dimension，实际构建维度为end - begin，不填写时使用完整向量。该成员与params同级，不在params内部。仅支持FLOAT_VECTOR字段，且仅支持HNSW、HNSWRABITQ、HNSWPQ、HNSWSQ、IVF、IVFPQ、IVFSQ索引类型；HNSWPQ、IVFPQ还要求end - begin能被params中的NSQ整除。
autoBuild	Boolean	否	是否有自动构建索引策略
autoBuildPolicy	AutoBuildPolicy	否	自动构建索引策略参数 policyType：策略类型，有如下几种类型: periodical，周期性构建索引。 rowCountIncrement，根据tablet行增长数自动构建索引。 timing，定时构建索引 periodInSecond：周期性构建索引的秒数，只在周期性构建索引策略类型时返回。 timing：字符串类型，返回定时构建的时间，只在定时构建索引策略类型时返回 rowCountIncrement：返回触发构建时增长的行数以及百分比，只在行增长数构建索引类型时返回。
state	IndexState	否	索引状态，建索引时不需要使用。取值如下： INVALID：仅向量索引会出现本状态，表示索引没有生效，需要触发一次索引重建 BUILDING：表示索引正在构建中。倒排索引在该状态下发起BM25/Hybrid检索会返回错误码95（Index Building） NORMAL：表示索引已完成构建并处于正常状态

评价此篇文章

有帮助没帮助

Row 操作

C++ SDK

百度智能云

向量数据库 VectorDB

向量数据库 VectorDB

Index 操作

创建索引

功能介绍

请求示例

相关类说明

CreateIndexRequest

IndexField

SecondaryIndex

VectorIndex

FilteringIndex、PersistentBitmapIndex、PersistentAggregatedBitmapIndex、InvertedIndex

删除索引

功能介绍

请求示例

请求参数

重建向量索引

功能介绍

请求示例

请求示例

请求参数

查询索引详情

功能介绍

请求示例

请求参数

DescribeIndexResponse

IndexField

修改索引

功能介绍

请求示例

请求参数

IndexField