文档

创建多元索引的映射关系

更新时间:

执行CREATE TABLE语句为已存在的表或者多元索引创建映射关系。创建映射关系时需要配置表的字段名称、字段类型和主键信息以及根据需要配置查询数据时的执行引擎。本文介绍如何为已存在的多元索引创建映射关系。

说明

关于创建表的映射关系的具体操作,请参见创建表的映射关系

背景信息

由于执行CREATE TABLE创建表的映射关系时,数据表可能会包含多种不同的索引类型,当用户使用映射表查询数据时,SQL引擎会自动选择合适的数据表主键查询、二级索引或者多元索引执行查询。为了让用户更清晰地选择指定多元索引执行查询,SQL引擎支持通过CREATE TABLE语句创建指定多元索引的映射关系。

语法

CREATE TABLE [IF NOT EXISTS] user_defined_name(column_name data_type [,column_name data_type])
ENGINE='searchindex',
ENGINE_ATTRIBUTE='{"index_name": index_name, "table_name": table_name}';

参数

参数

是否必选

说明

IF NOT EXISTS

如果指定IF NOT EXISTS,无论表是否存在,均会返回成功;如果未指定IF NOT EXISTS,则只有当表不存在时,才会返回成功。

user_defined_name

多元索引映射表名,用于唯一标识一张SQL绑定表。

后续执行SQL操作时要使用该表名。

column_name

列名。

SQL中的列名必须和原始表中的列名等效,例如原始表中列名为Aa,在SQL中列名必须使用Aa、AA、aA或者aa中的一个。

data_type

列的数据类型,包含BIGINT、DOUBLE、BOOL等多种数据类型。

SQL中列的数据类型必须和原始表中列的数据类型相匹配。关于数据类型映射的更多信息,请参见SQL数据类型映射

ENGINE

使用映射表查询数据时的执行引擎。取值范围如下:

  • tablestore(默认):SQL引擎将自动选择合适的索引执行查询。

  • searchindex:SQL引擎将通过指定的多元索引执行查询。设置为此项时,您必须在ENGINE_ATTRIBUTE中配置index_name和table_name。

ENGINE_ATTRIBUTE

执行引擎的属性,以JSON格式表示。包括如下选项:

  • index_name:多元索引映射表绑定的多元索引名称。只有创建多元索引的映射关系时才需要配置。

  • table_name:多元索引映射表绑定的多元索引所属的数据表名称。只有创建多元索引的映射表时才需要配置。

  • consistency:执行引擎支持的一致性模式。

    • 创建表的映射关系时,取值范围如下:

      • eventual(默认):执行的查询结果满足最终一致。此时新数据写入后会在几秒后影响到查询结果。

      • strong:执行的查询结果满足强一致性。此时新数据写入后立刻影响到查询结果。

    • 创建多元索引的映射关系时,consistency取值固定为eventual。

  • allow_inaccurate_aggregation:是否允许通过牺牲聚合操作的精准度提升查询性能。类型为Boolean。

    • 创建表的映射关系时,allow_inaccurate_aggregation的默认取值为true,表示允许通过牺牲聚合操作的精度提升查询性能。您可以根据需要将此项配置为false。

    • 创建多元索引的映射关系时,allow_inaccurate_aggregation的取值固定为true。

示例

以下示例用于为exampletable1数据表的多元索引exampletable1_index创建多元索引映射表search_exampletable1。多元索引映射表包含id(BIGINT类型)、colvalue(MEDIUMTEXT类型)和content(MEDIUMTEXT类型)。

CREATE TABLE search_exampletable1(id BIGINT, colvalue MEDIUMTEXT, content MEDIUMTEXT) ENGINE='searchindex' ENGINE_ATTRIBUTE='{"index_name": "exampletable1_index", "table_name": "exampletable1"}';

创建多元索引映射表search_exampletable1后,您可以执行以下操作:

  • 查询索引描述信息

    以下示例用于查询search_exampletable1的索引描述信息。

    SHOW INDEX IN search_exampletable1;

    关于查询索引描述信息的更多信息,请参见查询索引描述信息

  • 查询匹配字符串的数据

    以下示例用于查询search_exampletable1中content列值匹配"tablestore cool"字符串至少1个分词的行数据,最多返回10行,并且返回id和content列。

    SELECT id,content FROM search_exampletable1 WHERE TEXT_MATCH(content, "tablestore cool") LIMIT 10;

    关于查询匹配字符串的数据的更多信息,请参见查询数据全文检索

常见问题

SQL查询常见错误排查

相关文档

  • 创建多元索引映射关系后,您可以通过SELECT语句查询与分析表中数据。更多信息,请参见查询数据多元索引数组类型多元索引嵌套类型全文检索多元索引虚拟列

  • 如果数据表的属性列有变化,您需要先修改多元索引属性列后再修改多元索引映射关系的属性列。

    1. 修改多元索引属性列,请根据选择合适的方式。

      • 通过动态修改Schema功能修改多元索引字段。更多信息,请参见动态修改schema

      • 删除多元索引后重新创建多元索引。更多信息,请参见创建多元索引

    2. 修改多元索引映射关系的属性列,请根据选择合适的方式。

      • 通过ALTER TABLE语句直接修改映射表属性列。更多信息,请参见更新映射表属性列

      • 删除映射表后重新创建多元索引映射关系。

  • 如果需要查询表的描述信息,您可以通过DESCRIBE语句实现。更多信息,请参见查询表的描述信息

  • 如果不再需要使用某个映射关系,您可以通过DROP MAPPING TABLE语句删除映射关系。更多信息,请参见删除映射关系

  • 如果需要查看表的索引信息,您可以通过SHOW INDEX语句实现。更多信息,请参见查询索引描述信息

  • 如果需要列出当前数据库中的映射表名称列表,您可以通过SHOW TABLES语句实现。更多信息,请参见列出映射表名称列表

  • 本页导读 (1)