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

> ## Agent Instructions
> PawSQL 是一个产品：Cloud 是公网部署形态，Engine / Optimizer / Auditor / Advisor / Patroller 是同一产品的组件与交付形态，不是彼此独立的产品。 / PawSQL is a single product: Cloud is the public deployment form, while Engine / Optimizer / Auditor / Advisor / Patroller are components and delivery forms of the same product, not separate products.
> 术语以站内术语表为准：SQL 审核对应英文 SQL Review，查询重写对应 Query Rewrite，索引推荐对应 Index Recommendation；英文内容统一用 Review，不用 Audit。 / Use the site glossary for terminology: 审核 is SQL Review, 重写 is Query Rewrite, 索引推荐 is Index Recommendation; English content uses Review, never Audit.
> 引用能力范围或版本支持时以对应页面为准；标注 unknown、或 status 非 published 的内容表示尚未经产品核实，不应作为事实引用。 / Cite capability scope and version support from the corresponding page; content marked unknown, or with a status other than published, is not yet product-verified and must not be cited as fact.

# 工作空间与审核上下文

> 理解工作空间如何为 SQL 审核提供对象元数据，并在创建审核工单时选择匹配的工作空间。

审核上下文描述 SQL 将在哪个数据库环境中运行。在创建审核工单页面，数据库类型、版本、默认 Schema 是独立字段；“配置审核上下文（工作空间）”字段则用于选择工作空间，为对象识别和规则判断提供表、列、约束和索引等元数据。工作空间在[工作空间与上下文](/user-guide/workspaces/)中集中创建和管理，不要在审核工单中重复维护另一份表结构。

## 目标

选择数据库类型、版本、Schema 范围与对象定义均与目标环境一致的工作空间，使审核能识别 SQL 依赖的对象。

## 准备工作

选择工作空间前，先确认目标数据库类型、版本和默认 Schema，并明确 SQL 引用的表、列、约束和索引。

## 选择工作空间

<Steps>
  <Step title="确认 SQL 的目标环境">
    确定 SQL 面向的数据库实例、数据库或 Schema，以及开发、测试或生产环境。
  </Step>

  <Step title="选择匹配的工作空间">
    优先选择数据库类型、版本和对象结构均与目标环境一致的工作空间。
  </Step>

  <Step title="检查元数据范围">
    确认 SQL 引用的表、视图、列、约束和索引已经包含在工作空间中。
  </Step>

  <Step title="确认更新时间">
    如果近期发生过 DDL 变更或索引调整，应先更新工作空间元数据。
  </Step>

  <Step title="设置默认 Schema">
    SQL 中使用未限定对象名时，确保默认 Schema 与实际会话配置一致。
  </Step>
</Steps>

## 何时必须关注工作空间

以下分析通常依赖或受益于数据库元数据：

* 表、列或数据类型是否存在；
* 主键、唯一约束和非空约束检查；
* 已有索引识别和索引建议；
* `SELECT *`、隐式类型转换及连接条件分析；
* 对象依赖、字段歧义和 Schema 解析；
* 基于表结构的 SQL 重写或优化建议。

未配置工作空间时，PawSQL 仍可执行不依赖对象元数据的语法和静态规则，但结果覆盖范围可能受限。

## 保证上下文一致

| 风险          | 可能表现           | 建议             |
| ----------- | -------------- | -------------- |
| 工作空间过期      | 新列无法识别、索引判断不准确 | 更新或重新同步元数据     |
| Schema 选择错误 | 对象不存在或解析到同名表   | 设置正确的默认 Schema |
| 数据库版本错误     | 语法误报或版本规则不适用   | 使用实际运行版本       |
| 使用生产以外的结构   | 结果与上线环境不一致     | 标注环境并核对结构差异    |

<Warning>
  连接数据库创建工作空间时，应使用满足最小权限原则的只读账号，并遵守组织对凭据、网络和生产访问的管理要求。
</Warning>

## 预期结果

选择匹配的工作空间后，审核能够识别引用的对象，索引建议等依赖元数据的分析结果可用。

## 提交前检查

* [ ] 数据库类型和版本与目标环境一致。
* [ ] 默认数据库或 Schema 设置正确。
* [ ] 工作空间包含 SQL 引用的主要对象。
* [ ] 元数据已覆盖最近的结构变更。
* [ ] 无法提供的上下文已在工单说明中记录。

## 延伸阅读

完成工作空间配置后，返回[创建审核工单](/user-guide/sql-audit/create-review-task)。工作空间的创建与管理参阅[工作空间与上下文](/user-guide/workspaces/)。