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

# 平台全景与核心概念

> 一次讲清 Chaintable 里的八个名词，以及它们之间的关系。

Chaintable 的控制台里有八类对象。读完这页，你应该能看懂界面上的每一块是干什么的。

<Note>
  本页正在编写中，下面是各概念的一句话定义和关系图，细节会陆续补齐。
</Note>

## 八个名词

| 名词            | 一句话                                          |
| ------------- | -------------------------------------------- |
| **Space**     | 装东西的容器。你的表、Function、Notebook、查询都归属于某个 Space。 |
| **Table**     | 存数据的地方。分四种类型，选哪种取决于你的数据长什么样。                 |
| **Function**  | 一段 Python 转换逻辑：一行数据进去，一行数据出来。                |
| **Notebook**  | 驱动器。它盯着链上的新块，组装任务并提交给平台。                     |
| **Query**     | 一条 SQL 查询，用来分析数据。                            |
| **Dashboard** | 把查询结果的图表组织成看板。                               |
| **Schedule**  | 让 Notebook 自动跑起来——常驻或定时。                     |
| **Instance**  | 一次具体的运行。日志、资源曲线、错误都在这里看。                     |

## 它们怎么组合在一起

```mermaid theme={null}
flowchart TB
    subgraph space["Space"]
        direction TB
        T["Table<br/>存数据"]
        F["Function<br/>转换逻辑"]
        N["Notebook<br/>驱动"]
        Q["Query<br/>SQL 分析"]
        D["Dashboard<br/>看板"]
    end

    S["Schedule<br/>常驻 / 定时"] --> N
    N --> I["Instance<br/>一次运行"]
    N -.->|"提交任务"| F
    F -.->|"写入结果"| T
    T -.->|"数据源"| Q
    Q -.->|"图表"| D
```

一条索引管道的典型形态是：**Schedule 拉起 Notebook，Notebook 盯着新块、把每个块的数据交给 Function 处理，Function 的返回值写进 Table。** 每一次运行都会产生一个 Instance，你在那里看日志和排查问题。

## Function 和 Notebook 的分工

这是新用户最容易搞混的一对。

<Columns cols={2}>
  <Card title="Function：算什么" icon="function">
    纯粹的转换逻辑。输入一行数据，输出一行数据。它不关心数据从哪来、要处理哪些块。

    跑在隔离沙箱里，会被大规模并行执行。
  </Card>

  <Card title="Notebook：什么时候算、算哪些" icon="notebook-pen">
    驱动逻辑。决定盯哪张表、从哪个高度开始、每个块要提交什么任务。

    跑在一个常驻或定时拉起的运行时里。
  </Card>
</Columns>

<Tip>
  同一个 Function 可以既被实时管道调用，也被历史回填调用——区别只在驱动侧怎么喂数据。这也是为什么两者要分开。
</Tip>

## 表有四种类型

| 类型              | 什么时候用                   |
| --------------- | ----------------------- |
| **Block State** | 记录实体的当前状态，比如余额、合约状态。    |
| **Block Event** | 记录发生过的事情，只追加不修改，比如转账明细。 |
| **Time**        | 按时间分桶的时序数据，比如价格、TVL 快照。 |
| **Normal**      | 不带区块语义的普通表，比如配置、映射关系。   |

<Card title="选哪种表类型" icon="arrow-right" href="/indexing/tables/types">
  四种类型的详细对比和决策表
</Card>

## 账号层面还有什么

除了 Space 里的东西，账号层面还有几样：

* **Instances** —— 你所有运行的总览
* **API Keys** —— 调用 Open API 用的密钥
* **Secrets** —— 存第三方密钥，代码里按名字取，不用写死在代码里
* **Organizations** —— 团队协作和权限
* **Billing** —— 用量和套餐