全部產品
Search
文件中心

Tablestore:資料類型

更新時間:Dec 06, 2025

本文介紹了資料表中和多元索引中欄位資料類型的映射關係,以及不同欄位資料類型支援的附加屬性和查詢功能。

資料類型映射關係

多元索引的欄位值來源於資料表中同名欄位的值,兩者的資料類型必須相匹配。多元索引欄位資料類型與資料表中欄位資料類型的匹配關係請參見下表。

重要

表中的類型必須一一對應,否則資料會被當作髒資料丟棄,尤其是Geo-point和Nested擁有各自特定的格式。如果格式不匹配也會被當作髒資料丟棄,這將導致資料在表中能查詢到,但是在多元索引中查詢不到的情況。

多元索引中欄位資料類型

資料表中欄位資料類型

描述

Long

Integer

64位長整型。

Double

Double

64位雙精確度浮點數。

Boolean

Boolean

布爾值。

Keyword

String

不可分詞字串

FuzzyKeyword

String

支援高效能模糊查詢的字串

Text

String

分詞字串或文本。更多資訊,請參見字串類型

Date

Integer、String

日期時間類型,支援自訂各種格式日期資料。

IP

String

IP類型,支援IPv4和IPv6格式的IP地址。

Geo-point

String

位置點座標資訊,格式為緯度,經度,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍為[-180,+180]。例如35.8,-45.91

Vector

String、Binary

向量類型,格式為Float32數組的字串,數組長度與該欄位的維度相等。例如向量字串[1, 5.1, 4.7, 0.08 ]的維度為4。

Nested

String

巢狀型別,例如[{"a": 1}, {"a": 3}]

JSON類型

String

JSON類型,支援OBJECT和NESTED類型。

欄位屬性支援情況

多元索引欄位還支援數組、虛擬列、高亮顯示等附加屬性。不同資料類型支援的附加屬性不同,下表列出了不同附加屬性適用的資料類型及使用說明。

屬性

適用的資料類型

說明

數組

Long、Double、Boolean、Keyword、Text、Date、IP、Geo-point

如需儲存一系列相同類型的資料,請將欄位設定為數群組類型

在寫入資料時,必須按照JSON數組格式寫入,例如["a","b","c"]

Nested類型、Vector類型和JSON類型本身就是數組,無需設定。

虛擬列

Long、Double、Keyword、FuzzyKeyword、Text、Date、IP、Geo-point、Vector

如需在不改變Table Store的儲存結構及資料的情況下,實現新欄位新類型的查詢,請將欄位設定為虛擬列

日期格式

Date

使用日期類型時,需指定日期的格式。

分詞

Text

如需實現全文檢索索引,請為欄位設定分詞

摘要與高亮

Text

如需在全文檢索索引情境中高亮顯示命中的查詢詞,請為欄位開啟摘要與高亮功能。

向量配置

Vector

使用向量欄位時,需指定向量的度量演算法和維度。

JSON類型配置

JSON

使用JSON欄位時,需指定JSON類型,支援Object和Nested兩種類型。

查詢功能支援情況

各資料類型可用於的查詢功能請參見下表。

說明
  • “✓”表示支援,“×”表示不支援。

  • 全匹配查詢功能無需設定欄位。

查詢功能

Long

Double

Boolean

Keyword

FuzzyKeyword

Text

Date

IP

Geo-point

JSON Object

Nested/JSON Nested

Vector

精確查詢

×

×

×

×

×

多詞精確查詢

×

×

×

×

×

×

範圍查詢

×

×

×

×

×

列存在性查詢

萬用字元查詢

×

×

×

×

×

×

×

×

×

首碼查詢

×

×

×

×

×

×

×

×

×

尾碼查詢

×

×

×

×

×

×

×

×

×

×

基於分詞的萬用字元查詢

×

×

×

×

×

×

×

×

×

×

地理位置查詢

×

×

×

×

×

×

×

×

×

×

巢狀型別查詢

×

×

×

×

×

×

×

×

×

×

×

摺疊(去重)

×

×

×

×

×

×

×

×

組合查詢

×

匹配查詢

×

×

×

×

×

×

短語匹配查詢

×

×

×

×

×

×

向量檢索

×

×

×

×

×

×

×

×

×

×

×