> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asktable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 表、字段备注

> 说明如何在 AskTable 中为表和字段添加或编辑备注，利用元数据提升 AI 对业务含义的理解，生成更准确的查询结果。

元数据是对数据的"数据"描述，提供了数据的背景信息，如结构、格式和含义。这些信息让 AI 能够更准确地解读和处理数据，从而提升查询的精准度和效率。

AskTable 会自动从数据库中提取元数据，包括数据库、表、字段的信息，以及字段备注。即使没有备注，系统也会自动生成相关信息。所有元数据将汇总并存储在 AskTable 的 Meta Brain 中，为后续查询和分析提供支持。

## 如何添加和编辑备注

进入数据源详情页的 **数据概览** 标签页，在左侧树形导航中选中一张表，右侧即可查看和编辑它的表描述与字段备注：

* **表描述** — 字段表格上方的蓝色边框区块，点击其中的编辑图标即可修改。
* **字段备注** — 在字段表格的 **备注** 列，将鼠标移到对应单元格，点击编辑图标打开编辑框，输入或修改描述后保存。编辑框支持字符计数（上限 255）和 **AI 优化** 一键润色。

元数据在数据查询中的作用体现在多个方面，比如：

**示例 1：枚举值**

例如，一个字段记录性别，其中 sex=1 表示男性，sex=2 表示女性。当用户查询"性别为男"的数据时，AI 会基于元数据自动生成查询条件 sex=1，无需用户明确说明。

**示例 2：特定格式**

例如，一个字段记录基金的星级评价，使用从 ★ 到 ★★★★★ 的格式。如果用户查询"四星以上的基金有多少"，元数据会帮助 AI 理解星级格式，自动生成正确的查询条件：

* 错误：`select count(*) from fund where star >= 4;`
* 正确：`select count(*) from fund where star in ('★★★★','★★★★★')`

通过元数据的加持，AskTable 能更深入地理解数据的实际含义，为您生成更精准的查询结果，助力高效决策。

## 备注来源

备注列左侧的图标标识每个字段备注的来源：

* **数据库图标** — 来自数据库的原始备注
* **机器人图标** — AI 自动生成
* **笔图标** — 人工标注

人工标注的备注最贴近业务语义，有助于 AI 更好地理解字段含义。

## 批量更新描述

如果需要批量更新多个字段的描述，可通过元数据导出 / 导入完成：

1. 在数据概览页点击右上角 **···** 菜单，选择 **导出元数据**，将当前字段描述、字段可见性和训练数据保存为 JSON 文件
2. 用文本编辑器批量修改 JSON 文件中的描述内容
3. 返回数据概览页，选择 **导入元数据**，将修改后的文件导入

导入后，字段描述和可见性将被覆盖更新，训练数据则会追加。