Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions en/basic/admin-panel/table-query-ops.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@ Use **Table Query Ops** when views, filters, relations, or searches on a large t
| Analysis type | Use it for |
| --- | --- |
| **Queries & indexes** | Find query risks and possible index improvements. |
| **Full-text search** | Check whether full-text search could improve broad or multi-field searches. |
| **Substring search** | Check whether a substring search access path could speed up contains searches without changing their matching behavior. |

## Run an Analysis

Choose **Table**, **Base**, or **Space**, then enter the corresponding ID and select an analysis type. Start with **Table** when you already know which table is slow.

Click **Generate query report** or **Generate search report**. The report summarizes detected risks and recommended next actions. For a search report, **EXPLAIN sample search** is optional. Add a sample to compare ILIKE and full-text search matches and query plans. Teable does not save the sample value.
Click **Generate query report** or **Generate search report**. The report summarizes detected risks and recommended next actions. For a search report, **EXPLAIN sample search** is optional. Add a sample to check result compatibility, query plans, and repeated query timing for the proposed substring search access path. Teable does not save the sample value.

<Info>The query report does not change the database. Applying a full-text search recommendation requires an **EXPLAIN sample search** and administrator confirmation.</Info>
<Info>The query report does not change the database. Applying a substring search recommendation requires an **EXPLAIN sample search** and administrator confirmation.</Info>

For a large table, review the impact and schedule any confirmed change for a suitable maintenance window.
2 changes: 2 additions & 0 deletions en/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ mode: "wide"
| BACKEND_STORAGE_S3_REGION | S3 storage region, required when BACKEND_STORAGE_PROVIDER is s3 | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | S3 storage endpoint, required when BACKEND_STORAGE_PROVIDER is s3 | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_INTERNAL_ENDPOINT | S3 internal endpoint (optional) | - | - | http://s3.internal |
| BACKEND_STORAGE_S3_FORCE_PATH_STYLE | Use path-style URLs (`endpoint/bucket/key`) for browser-facing S3 requests. Enable this when the public endpoint cannot serve bucket subdomains. Cannot be combined with BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | false | - | true |
| BACKEND_STORAGE_S3_INTERNAL_FORCE_PATH_STYLE | Override path-style addressing for internal S3 requests. When unset, it inherits the public setting if both clients share an endpoint; a separate internal endpoint keeps virtual-hosted addressing | - | - | true |
| BACKEND_STORAGE_S3_ACCESS_KEY | S3 storage access key, required when BACKEND_STORAGE_PROVIDER is s3 | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | S3 storage secret key, required when BACKEND_STORAGE_PROVIDER is s3 | - | - | your_secret_key |
| BACKEND_STORAGE_S3_MAX_SOCKETS | S3 max sockets (optional) | 100 | - | 100 |
Expand Down
6 changes: 3 additions & 3 deletions zh/basic/admin-panel/table-query-ops.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@ description: "分析慢查询,并查看可能的数据库优化建议。"
| 分析类型 | 适用场景 |
| --- | --- |
| **查询与索引** | 查找查询风险和可能的索引优化建议。 |
| **全文搜索** | 判断全文搜索是否适合优化大范围或多字段搜索。 |
| **子串搜索** | 判断子串搜索访问路径能否在保持匹配行为不变的情况下加快包含搜索。 |

## 运行分析

选择 **表**、**Base** 或 **Space**,填写对应 ID,再选择分析类型。如果已经知道哪张表较慢,建议从 **表** 开始分析。

点击 **生成查询报告** 或 **生成搜索报告**。报告会汇总发现的风险和建议的后续操作。生成搜索报告时,**EXPLAIN 样例搜索词**为可选项。填写后,报告会比较 ILIKE 与全文搜索的命中结果和执行计划。Teable 不会保存这个搜索词。
点击 **生成查询报告** 或 **生成搜索报告**。报告会汇总发现的风险和建议的后续操作。生成搜索报告时,**EXPLAIN 样例搜索词**为可选项。填写后,报告会检查建议的子串搜索访问路径是否保持相同的查询结果,并比较执行计划和多次查询耗时。Teable 不会保存这个搜索词。

<Info>查询报告不会修改数据库。执行全文搜索建议前,必须填写 **EXPLAIN 样例搜索词**并由管理员确认。</Info>
<Info>查询报告不会修改数据库。执行子串搜索建议前,必须填写 **EXPLAIN 样例搜索词**并由管理员确认。</Info>

对于大表,请先评估影响,并把需要确认执行的变更安排在合适的维护窗口。
2 changes: 2 additions & 0 deletions zh/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ mode: "wide"
| BACKEND_STORAGE_S3_REGION | S3 云存储区域,当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | S3 云存储端点,当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_INTERNAL_ENDPOINT | S3 内网 endpoint(可选) | - | - | http://s3.internal |
| BACKEND_STORAGE_S3_FORCE_PATH_STYLE | 让浏览器访问 S3 时使用路径式 URL(`endpoint/bucket/key`)。当公网 endpoint 无法提供 bucket 子域名时启用。不能与 BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT 同时使用 | false | - | true |
| BACKEND_STORAGE_S3_INTERNAL_FORCE_PATH_STYLE | 单独设置内网 S3 请求是否使用路径式访问。不设置时,如果公网和内网客户端共用 endpoint,则继承公网设置;使用独立内网 endpoint 时,默认使用虚拟主机式访问 | - | - | true |
| BACKEND_STORAGE_S3_ACCESS_KEY | S3 云存储访问密钥,当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | S3 云存储秘密密钥,当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | your_secret_key |
| BACKEND_STORAGE_S3_MAX_SOCKETS | S3 最大连接数(可选) | 100 | - | 100 |
Expand Down