✔️实时表

实时表 是 Manticore 中的主要表类型。它允许您添加、更新和删除文档，并且可以立即看到这些更改。您可以通过配置文件设置实时表，或使用 CREATE、UPDATE、DELETE 或 ALTER 等命令来操作。

在内部，实时表由一个或多个称为 chunk（块） 的普通表组成。chunk 分为两种类型：

多个 磁盘块 - 这些块保存到磁盘中，其结构类似于普通表。
一个 内存块 - 存储在内存中，收集所有的更改。

内存块的大小由 rt_mem_limit 设置控制。一旦达到此限制，内存块将被传输到磁盘作为磁盘块。如果磁盘块过多，Manticore 会合并部分块以提高性能。

创建实时表：

您可以通过两种方式创建新的实时表：使用 CREATE TABLE 命令，或通过 HTTP JSON API 的 _mapping endpoint。

CREATE TABLE 命令：

您可以通过 SQL 和 HTTP 协议使用此命令：

通过 SQL 协议创建实时表：

CREATE TABLE products(title text, price float) morphology='stem_en';

Query OK, 0 rows affected (0.00 sec)

通过 HTTP 使用 JSON 创建实时表：

POST /cli -d "CREATE TABLE products(title text, price float)  morphology='stem_en'"

{
"total":0,
"error":"",
"warning":""
}

通过PHP客户端创建实时表：

$index = new \Manticoresearch\Index($client);
$index->setName('products');
$index->create([
    'title'=>['type'=>'text'],
    'price'=>['type'=>'float'],
]);

Python:

utilsApi.sql('CREATE TABLE forum(title text, price float)')

Javascript:

res = await utilsApi.sql('CREATE TABLE forum(title text, price float)');

Java:

utilsApi.sql("CREATE TABLE forum(title text, price float)");

C#:

utilsApi.Sql("CREATE TABLE forum(title text, price float)");

通过配置文件创建实时表：

table products {
  type = rt
  path = tbl
  rt_field = title
  rt_attr_uint = price
  stored_fields = title
}

_mapping API:

注意：_mapping API 需要 Manticore Buddy。如果它不起作用，请确保 Buddy 已安装。

您还可以通过 _mapping 端点创建一个新表。此端点允许您定义类似 Elasticsearch 的表结构，并将其转换为 Manticore 表。

请求的主体必须具有以下结构：

"properties"
{
  "FIELD_NAME_1":
  {
    "type": "FIELD_TYPE_1"
  },
  "FIELD_NAME_2":
  {
    "type": "FIELD_TYPE_2"
  },

  ...

  "FIELD_NAME_N":
  {
    "type": "FIELD_TYPE_M"
  }
}

创建表时，Elasticsearch 数据类型将根据以下规则映射到 Manticore 类型：

aggregate_metric => json
binary => string
boolean => bool
byte => int
completion => string
date => timestamp
date_nanos => bigint
date_range => json
dense_vector => json
flattened => json
flat_object => json
float => float
float_range => json
geo_point => json
geo_shape => json
half_float => float
histogram => json
integer => int
integer_range => json
ip => string
ip_range => json
keyword => string
knn_vector => float_vector
long => bigint
long_range => json
match_only_text => text
object => json
point => json
scaled_float => float
search_as_you_type => text
shape => json
short => int
text => text
unsigned_long => int
version => string

通过 _mapping 端点创建一个实时表：

POST /your_table_name/_mapping -d '
{
  "test": {
    "mappings": {
      "properties": {
        "price": {
            "type": "float"
        },
        "title": {
            "type": "text"
        }
      }
    }
  }
}
'

{
"total":0,
"error":"",
"warning":""
}

CREATE TABLE LIKE:

你可以创建一个实时表的副本，包含或不包含数据。如果表很大，复制数据可能会花费一些时间。复制操作是同步模式的，但如果连接中断，它会在后台继续执行。

CREATE TABLE table_name LIKE old_table_name [WITH DATA]

注意：复制表需要 Manticore Buddy。如果无法正常工作，请确保 Buddy 已安装。

示例：

create table products LIKE old_products;

示例 (WITH DATA):

create table products LIKE old_products WITH DATA;

👍 你可以用实时表做的事：

添加文档。
通过更新过程更新属性和全文字段。
删除文档。
清空表。
使用 ALTER 命令在线更改表结构，如在线更新表结构中所述。
按照定义表的说明，在配置文件中定义表。
使用 UUID 功能自动分配ID。

⛔ 你不能用实时表做的事：

使用 indexer 功能导入数据。
连接到 sources 以便从外部存储轻松索引数据。
更新 killlist_target，因为它由实时表自动管理。

实时表文件结构

下表列出了实时表中不同文件扩展名及其对应的描述：

扩展名

描述

.lock

锁文件，确保同一时间内只有一个进程可以访问该表。

.ram

表的RAM块，存储在内存中，用作变更的累加器。

.meta

实时表的头文件，定义了表的结构和设置。

.*.sp*

磁盘块，存储在磁盘上，格式与普通表相同。当RAM块大小超过 rt_mem_limit 时，创建这些文件。

有关磁盘块结构的更多信息，请参考普通表文件结构。

最后更新于8个月前