diff --git a/TOC-tidb-cloud-essential.md b/TOC-tidb-cloud-essential.md index 5ab6a98249c9f..67b4894a5b3a8 100644 --- a/TOC-tidb-cloud-essential.md +++ b/TOC-tidb-cloud-essential.md @@ -12,7 +12,7 @@ - 快速上手 - [试用 TiDB Cloud](/tidb-cloud/tidb-cloud-quickstart.md) - [试用 HTAP](/tidb-cloud/tidb-cloud-htap-quickstart.md) - - [试用 TiDB Cloud CLI](/tidb-cloud/get-started-with-cli.md) + - [试用 TiDB Cloud CLI (ticloud)](/tidb-cloud/get-started-with-cli.md) - 关键概念 - [概览](/tidb-cloud/key-concepts.md) - [架构](/tidb-cloud/architecture-concepts.md) @@ -463,7 +463,7 @@ - [`schema_unused_indexes`](/sys-schema/sys-schema-unused-indexes.md) - [元数据锁](/metadata-lock.md) - [TiDB 加速建表](/accelerated-table-creation.md) -- CLI 参考 ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) +- TiDB Cloud CLI (ticloud) 参考 ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [概述](/tidb-cloud/cli-reference.md) - auth - [login](/tidb-cloud/ticloud-auth-login.md) @@ -557,6 +557,7 @@ - [服务器状态变量](/status-variables.md) - [表库过滤](/table-filter.md) - [外部存储服务的 URI 格式](/external-storage-uri.md) + - [为慢查询配置触发规则](/config-slow-query-trigger-rules.md) - [数据索引不一致报错](/troubleshoot-data-inconsistency-errors.md) - [通知](/tidb-cloud/notifications.md) - [适用于 {{{ .starter }}} 和 Essential 的项目 API 迁移指南](/tidb-cloud/tidbx-starter-essential-project-api-migration-guide.md) diff --git a/TOC-tidb-cloud-lake.md b/TOC-tidb-cloud-lake.md index a0f7a98a56db5..741f1b124609d 100644 --- a/TOC-tidb-cloud-lake.md +++ b/TOC-tidb-cloud-lake.md @@ -1,7 +1,7 @@ -# 目录 +# 目录 ## 开始使用 diff --git a/TOC-tidb-cloud-premium.md b/TOC-tidb-cloud-premium.md index 353f040f7f201..c036d380bf550 100644 --- a/TOC-tidb-cloud-premium.md +++ b/TOC-tidb-cloud-premium.md @@ -479,6 +479,7 @@ - [表库过滤](/table-filter.md) - [外部存储服务的 URI 格式](/external-storage-uri.md) - [内嵌于 DDL 的 Analyze](/ddl_embedded_analyze.md) + - [配置慢查询的触发规则](/config-slow-query-trigger-rules.md) - [数据索引不一致报错](/troubleshoot-data-inconsistency-errors.md) - [通知](/tidb-cloud/notifications.md) - 支持计划 diff --git a/TOC-tidb-cloud-starter.md b/TOC-tidb-cloud-starter.md index 02656f7a8e7a9..0bb12b21b6b65 100644 --- a/TOC-tidb-cloud-starter.md +++ b/TOC-tidb-cloud-starter.md @@ -13,7 +13,7 @@ - [试用 TiDB Cloud](/tidb-cloud/tidb-cloud-quickstart.md) - [试用 TiDB + AI 工具](/tidb-cloud/use-tidb-cloud-with-ai-tools.md) - [试用 HTAP](/tidb-cloud/tidb-cloud-htap-quickstart.md) - - [试用 TiDB Cloud CLI](/tidb-cloud/get-started-with-cli.md) + - [试用 TiDB Cloud CLI (ticloud, Legacy)](/tidb-cloud/get-started-with-cli.md) - 关键概念 - [概览](/tidb-cloud/key-concepts.md) - [架构](/tidb-cloud/architecture-concepts.md) @@ -461,7 +461,7 @@ - [`schema_unused_indexes`](/sys-schema/sys-schema-unused-indexes.md) - [元数据锁](/metadata-lock.md) - [TiDB 加速建表](/accelerated-table-creation.md) -- CLI 参考 ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) +- TiDB Cloud CLI (ticloud, Legacy) 参考 ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [概述](/tidb-cloud/cli-reference.md) - auth - [login](/tidb-cloud/ticloud-auth-login.md) diff --git a/config-slow-query-trigger-rules.md b/config-slow-query-trigger-rules.md new file mode 100644 index 0000000000000..ce33b412ccef8 --- /dev/null +++ b/config-slow-query-trigger-rules.md @@ -0,0 +1,195 @@ +--- +title: 配置慢查询的触发规则 +summary: 定义慢查询日志的触发规则。 +--- + +# 配置慢查询的触发规则 + + + +本文介绍如何使用 [`tidb_slow_log_rules`](/system-variables.md#tidb_slow_log_rules) 系统变量来定义[慢查询日志](/identify-slow-queries.md)的触发规则。 + +[`tidb_slow_log_rules`](/system-variables.md#tidb_slow_log_rules) 支持多维度指标组合，适用于慢查询日志的“定向采样”和“问题复现”，使你能够基于特定指标组合筛选目标语句。 + +对于 TiDB Self-Managed，慢查询日志的触发行为取决于 `tidb_slow_log_rules` 的配置： + +- 如果当前会话没有适用的 `tidb_slow_log_rules` 规则（无论是因为未设置该变量，还是因为已配置的规则均不适用于该会话），慢查询日志仍然依赖 [`tidb_slow_log_threshold`](/system-variables.md#tidb_slow_log_threshold)（单位为毫秒）。 +- 如果当前会话存在任意适用的 `tidb_slow_log_rules` 规则，慢查询日志是否输出由规则匹配结果决定，并且会忽略 [`tidb_slow_log_threshold`](/system-variables.md#tidb_slow_log_threshold)。 + + + + +在 [TiDB Cloud console](https://tidbcloud.com/) 中，你可以在 [**Diagnosis**](/tidb-cloud/tune-performance.md#view-the-diagnosis-page) 页面的 [**Slow Query**](/tidb-cloud/tune-performance.md#slow-query) 页签查看慢查询。 + +默认情况下，执行时间超过 300 毫秒的 SQL 查询会被视为慢查询。要配置慢查询的触发规则，你可以修改 [`tidb_slow_log_rules`](/system-variables.md#tidb_slow_log_rules) 系统变量。 + +[`tidb_slow_log_rules`](/system-variables.md#tidb_slow_log_rules) 支持多维度指标组合，适用于慢查询的“定向采样”和“问题复现”，使你能够基于特定指标组合筛选目标语句。 + + + +## 示例 {#examples} + +- 标准格式（`SESSION` 作用域）： + + ```sql + SET SESSION tidb_slow_log_rules = 'Query_time: 0.5, Is_internal: false'; + ``` + +- 无效的 `SESSION` 规则（`SESSION` 作用域不支持 `Conn_ID`）： + + ```sql + SET SESSION tidb_slow_log_rules = 'Conn_ID: 12, Query_time: 0.5, Is_internal: false'; + ``` + + + +- 全局规则（适用于所有连接）： + + ```sql + SET GLOBAL tidb_slow_log_rules = 'Query_time: 0.5, Is_internal: false'; + ``` + +- 针对特定连接的全局规则（分别应用于两个连接 `Conn_ID:11` 和 `Conn_ID:12`）： + + ```sql + SET GLOBAL tidb_slow_log_rules = 'Conn_ID: 11, Query_time: 0.5, Is_internal: false; Conn_ID: 12, Query_time: 0.6, Process_time: 0.3, DB: db1'; + ``` + + + + + +- 全局规则（适用于所有连接）： + + ```sql + SET GLOBAL tidb_slow_log_rules = 'Query_time: 0.5, Is_internal: false'; + ``` + +- 针对特定连接的全局规则（分别应用于两个连接 `Conn_ID:11` 和 `Conn_ID:12`）： + + ```sql + SET GLOBAL tidb_slow_log_rules = 'Conn_ID: 11, Query_time: 0.5, Is_internal: false; Conn_ID: 12, Query_time: 0.6, Process_time: 0.3, DB: db1'; + ``` + + + +## 统一规则语法和类型约束 {#unified-rule-syntax-and-type-constraints} + +- 规则容量与分隔方式：每个支持的作用域最多可包含 10 条规则。规则之间使用 `;` 分隔。 +- 条件格式：每个条件使用 `field_name:value` 格式。单条规则中的多个条件使用 `,` 分隔。 +- 字段名不区分大小写。字段名中的下划线和其他字符会被保留。 + + + +TiDB Self-Managed 同时支持 `tidb_slow_log_rules` 的 `SESSION` 和 `GLOBAL` 规则。单个会话在这两个作用域中最多可以有 20 条生效规则。`SESSION` 规则不支持 `Conn_ID`；只有 `GLOBAL` 规则支持该字段。 + + + + + +TiDB Cloud Dedicated 同时支持 `tidb_slow_log_rules` 的 `SESSION` 和 `GLOBAL` 规则。单个会话在这两个作用域中最多可以有 20 条生效规则。`SESSION` 规则不支持 `Conn_ID`；只有 `GLOBAL` 规则支持该字段。 + + + + + +TiDB Cloud Essential 和 TiDB Cloud Premium 仅支持 `tidb_slow_log_rules` 的 `SESSION` 规则。因此，仅在 `GLOBAL` 规则中可用的 `Conn_ID` 不受支持。 + + + +- 匹配语义： + - 除 `Conn_ID` 外的数值字段使用 `>=` 进行匹配。`Conn_ID`、字符串字段和布尔字段使用相等匹配（`=`）。 + - `DB` 和 `Resource_group` 的匹配不区分大小写。 + - 不支持显式运算符，例如 `>`、`<` 和 `!=`。 + +类型约束如下： + +- 数值类型（`int64`、`uint64`、`float64`）要求值大于或等于 `0`。负值会导致解析错误。 + - `int64`：最大值为 `2^63-1`。 + - `uint64`：最大值为 `2^64-1`。 + - `float64`：值必须是有限且非负的。最大值约为 `1.79e308`。`NaN` 以及 `Inf`、`-Inf` 等无穷值均无效，并会导致错误。 +- `bool`：支持 `true`/`false`、`1`/`0` 和 `t`/`f`（不区分大小写）。 +- `string`：当前不支持包含分隔符 `,`（条件分隔符）或 `;`（规则分隔符）的字符串，即使使用引号（单引号或双引号）也不支持。不支持转义。 +- 重复字段：如果同一字段在单条规则中被指定多次，则最后一次出现的值生效。 + +## 支持的字段 {#supported-fields} + +下表中的字段遵循[统一规则语法和类型约束](#unified-rule-syntax-and-type-constraints)中描述的一般匹配和类型规则，除非另有说明。 + +| 字段名 | 类型 | 单位 | 描述 | +| --- | --- | --- | --- | +| `Conn_ID` | `uint` | 次数 | 连接 ID（会话 ID）。该字段使用精确匹配。例如，`Conn_ID:3` 仅匹配会话 ID 为 `3` 的日志。该字段仅在 `GLOBAL` 规则中受支持。 | +| `Session_alias` | `string` | 无 | 当前会话的别名。 | +| `DB` | `string` | 无 | 当前数据库。匹配时不区分大小写。 | +| `Exec_retry_count` | `uint` | 次数 | 该语句的重试次数。该字段通常用于悲观事务，在锁失败时语句会被重试。 | +| `Query_time` | `float` | 秒 | 语句的执行时间。 | +| `Parse_time` | `float` | 秒 | 语句的解析时间。 | +| `Compile_time` | `float` | 秒 | 查询优化的持续时间。 | +| `Rewrite_time` | `float` | 秒 | 重写该语句查询所消耗的时间。 | +| `Optimize_time` | `float` | 秒 | 优化执行计划所消耗的时间。 | +| `Wait_TS` | `float` | 秒 | 语句获取事务时间戳的等待时间。 | +| `Is_internal` | `bool` | 无 | SQL 语句是否为 TiDB 内部语句。`true` 表示该语句在 TiDB 内部执行，`false` 表示该语句由用户执行。 | +| `Digest` | `string` | 无 | SQL 语句的指纹。 | +| `Plan_digest` | `string` | 无 | 执行计划的摘要。 | +| `Num_cop_tasks` | `int` | 次数 | 该语句发送的 Coprocessor 任务数。 | +| `Mem_max` | `int` | bytes | SQL 语句执行期间使用的最大内存空间。 | +| `Disk_max` | `int` | bytes | SQL 语句执行期间使用的最大磁盘空间。 | +| `Write_sql_response_total` | `float` | 秒 | 该语句将结果返回给客户端所消耗的时间。 | +| `Succ` | `bool` | 无 | 语句是否执行成功。 | +| `Resource_group` | `string` | 无 | 该语句绑定的资源组。匹配时不区分大小写。 | +| `KV_total` | `float` | 秒 | 该语句发送到 TiKV 或 TiFlash 的所有 RPC 请求所花费的时间。 | +| `PD_total` | `float` | 秒 | 该语句发送到 PD 的所有 RPC 请求所花费的时间。 | +| `Process_time` | `float` | 秒 | SQL 语句在 TiKV 中的总处理时间。由于数据会并发发送到 TiKV，该值可能超过 `Query_time`。 | +| `Backoff_time` | `float` | 秒 | 语句遇到需要重试的错误时，在重试前的等待时间。常见错误包括锁冲突、Region 切分以及 TiKV 服务器繁忙。 | +| `Total_keys` | `uint` | 次数 | Coprocessor 已扫描的 key 数量。 | +| `Process_keys` | `uint` | 次数 | Coprocessor 已处理的 key 数量。与 `Total_keys` 相比，`Process_keys` 不包含 MVCC 的旧版本。`Process_keys` 与 `Total_keys` 差异较大通常表示存在大量旧版本。 | +| `cop_mvcc_read_amplification` | `float` | 比率 | MVCC 读放大比率，计算方式为 `Total_keys / Process_keys`。 | +| `Prewrite_time` | `float` | 秒 | 两阶段事务提交第一阶段（prewrite）的持续时间。 | +| `Commit_time` | `float` | 秒 | 两阶段事务提交第二阶段（commit）的持续时间。 | +| `Write_keys` | `uint` | 次数 | 事务写入 TiKV 中 Write CF 的 key 数量。 | +| `Write_size` | `uint` | bytes | 事务提交时待写入的 key 或 value 的总大小。 | +| `Prewrite_region` | `uint` | 次数 | 两阶段事务提交第一阶段（prewrite）涉及的 TiKV Region 数量。每个 Region 都会触发一次远程过程调用。 | + +## 生效行为与匹配顺序 {#effective-behavior-and-matching-order} + +- 设置 `tidb_slow_log_rules` 会覆盖指定作用域中的现有规则，而不是追加新规则。 +- 将 `tidb_slow_log_rules` 设置为空字符串会清除指定作用域中的规则。 +- 多条规则之间使用 `OR` 组合，而单条规则中的多个字段条件之间使用 `AND` 组合。 +- 如果你仍希望使用 SQL 执行时间作为写入慢查询日志的条件，请在规则中使用 `Query_time`，并注意其单位为秒。 + + + +TiDB Self-Managed 同时支持 `tidb_slow_log_rules` 的 `SESSION` 和 `GLOBAL` 规则。 + +- 如果当前会话存在任意适用规则，例如 `SESSION` 规则、当前 `Conn_ID` 对应的 `GLOBAL` 规则，或不带 `Conn_ID` 的通用 `GLOBAL` 规则，则慢查询日志是否输出由规则匹配结果决定，并且会忽略 `tidb_slow_log_threshold`。 +- 如果当前会话没有适用规则，例如 `SESSION` 和 `GLOBAL` 规则都为空，或者仅配置了与当前 `Conn_ID` 不匹配的 `GLOBAL` 规则，则慢查询日志仍然取决于 `tidb_slow_log_threshold`。`tidb_slow_log_threshold` 的单位为毫秒。 +- TiDB 会先匹配 `SESSION` 规则。如果都不匹配，再匹配当前 `Conn_ID` 对应的 `GLOBAL` 规则，最后匹配不带 `Conn_ID` 的通用 `GLOBAL` 规则。 +- `SHOW VARIABLES LIKE 'tidb_slow_log_rules'` 和 `SELECT @@SESSION.tidb_slow_log_rules` 返回 `SESSION` 规则文本；如果未设置，则返回空字符串。`SELECT @@GLOBAL.tidb_slow_log_rules` 返回 `GLOBAL` 规则文本。 + + + + + +TiDB Cloud Dedicated 同时支持 `tidb_slow_log_rules` 的 `SESSION` 和 `GLOBAL` 规则。 + +- 如果当前会话存在任意适用规则，例如 `SESSION` 规则、当前 `Conn_ID` 对应的 `GLOBAL` 规则，或不带 `Conn_ID` 的通用 `GLOBAL` 规则，则慢查询日志是否输出由规则匹配结果决定。 +- 如果当前会话没有适用规则，例如 `SESSION` 和 `GLOBAL` 规则都为空，或者仅配置了与当前 `Conn_ID` 不匹配的 `GLOBAL` 规则，则慢查询日志规则会回退到默认规则：执行时间超过 300 毫秒的 SQL 查询会被视为慢查询。 +- TiDB 会先匹配 `SESSION` 规则。如果都不匹配，再匹配当前 `Conn_ID` 对应的 `GLOBAL` 规则，最后匹配不带 `Conn_ID` 的通用 `GLOBAL` 规则。 +- `SHOW VARIABLES LIKE 'tidb_slow_log_rules'` 和 `SELECT @@SESSION.tidb_slow_log_rules` 返回 `SESSION` 规则文本；如果未设置，则返回空字符串。`SELECT @@GLOBAL.tidb_slow_log_rules` 返回 `GLOBAL` 规则文本。 + + + + + +TiDB Cloud Essential 和 TiDB Cloud Premium 仅支持 `tidb_slow_log_rules` 的 `SESSION` 规则。 + +- 如果当前会话存在任意 `SESSION` 规则，则慢查询日志是否输出由规则匹配结果决定。 +- `SHOW VARIABLES LIKE 'tidb_slow_log_rules'` 和 `SELECT @@SESSION.tidb_slow_log_rules` 返回 `SESSION` 规则文本；如果未设置，则返回空字符串。 + + + +## 建议 {#recommendations} + +- `tidb_slow_log_rules` 旨在替代单一阈值方式。它支持多维度指标条件组合，从而能够更灵活、更细粒度地控制慢查询日志记录。 + +- 在资源充足的测试环境中（1 个 TiDB 节点，16 个 CPU 核心、48 GiB 内存；3 个 TiKV 节点，每个节点 16 个 CPU 核心、48 GiB 内存），重复的 sysbench 测试表明：当多维度慢查询日志规则在 30 分钟内生成数百万条慢日志记录时，性能影响仍然较小。然而，当日志量达到数千万条时，TPS 会显著下降，延时也会明显增加。因此，如果业务负载较高，或者 CPU 和内存资源已接近上限，请谨慎配置 `tidb_slow_log_rules`，以避免因规则过宽而导致日志泛滥。 如果你需要限制日志输出速率，请使用 [`tidb_slow_log_max_per_sec`](/system-variables.md#tidb_slow_log_max_per_sec) 对其进行限流，以降低对业务性能的影响。 \ No newline at end of file diff --git a/functions-and-operators/json-functions/json-functions-return.md b/functions-and-operators/json-functions/json-functions-return.md index 9fa4fd5f87ae9..6ef9b07ea25a0 100644 --- a/functions-and-operators/json-functions/json-functions-return.md +++ b/functions-and-operators/json-functions/json-functions-return.md @@ -17,7 +17,7 @@ TiDB 支持 MySQL 8.0 中所有 [返回 JSON 值属性的 JSON 函数](https://d - 根节点（`$`） - weather（`$.weather`） -- weather current（`$.weather.sunny`） +- weather current（`$.weather.current`） ```sql SELECT JSON_DEPTH('{"weather": {"current": "sunny"}}'); diff --git a/latest_translation_commit.json b/latest_translation_commit.json index ffba225abb001..46efd66930729 100644 --- a/latest_translation_commit.json +++ b/latest_translation_commit.json @@ -1,4 +1,4 @@ { "target": "release-8.5", - "sha": "bb4a157686a85532718c55e06ba029996486dab0" + "sha": "6acba5d04f2e3ab5702335c3823a92994ec87789" } diff --git a/sql-statements/sql-statement-grant-privileges.md b/sql-statements/sql-statement-grant-privileges.md index 5ab557d8c2b78..fcc865a614386 100644 --- a/sql-statements/sql-statement-grant-privileges.md +++ b/sql-statements/sql-statement-grant-privileges.md @@ -82,6 +82,7 @@ mysql> SHOW GRANTS FOR 'newuser'; ## MySQL 兼容性 * 类似于 MySQL，`USAGE` 权限表示登录 TiDB 服务器的能力。 +* 与 MySQL 不同，TiDB 不支持 `GRANT PROXY`。 * 从 v8.5.6 开始，TiDB 支持与 MySQL 兼容的列级权限管理机制。你可以对指定表中的特定列授予或撤销 `SELECT`、`INSERT`、`UPDATE` 和 `REFERENCES` 权限。更多信息，请参见 [列级权限管理](/column-privilege-management.md)。 * 类似于 MySQL，当 sql mode 中没有 `NO_AUTO_CREATE_USER` 时，如果用户不存在，`GRANT` 语句会自动创建一个空密码的新用户。移除此 sql mode（它默认启用）存在安全风险。 * 在 TiDB 中，成功执行 `GRANT ` 语句后，执行结果会立即在当前连接生效。而 [在 MySQL 中，对于某些权限，执行结果只在后续连接中生效](https://dev.mysql.com/doc/refman/8.0/en/privilege-changes.html)。详情请参见 [TiDB #39356](https://github.com/pingcap/tidb/issues/39356)。 diff --git a/system-variables.md b/system-variables.md index 4d6d13c09ff2d..e44497cf611dc 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5984,32 +5984,54 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) > > 跳过字符检查可能会使 TiDB 检测不到应用写入的非法 UTF-8 字符，进一步导致执行 `ANALYZE` 时解码错误，以及引入其他未知的编码问题。如果应用不能保证写入字符串的合法性，不建议跳过该检查。 -### tidb_slow_log_max_per_sec 从 v8.5.6 和 v9.0.0 版本开始引入 +### tidb_slow_log_max_per_sec 在 v8.5.6 和 CLOUD.202603.1 中引入 {#tidb_slow_log_max_per_sec} + +>**注意：** +> +> 对于 TiDB Cloud，此变量为只读。 - 作用域：GLOBAL -- 是否持久化到集群：是 +- 持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`0` - 类型：整数型 -- 范围：`[0, 1000000]` -- 控制每个 TiDB 节点每秒打印的慢查询日志的数量上限。 - - 当值为 `0` （默认值）时，表示不限制每秒打印的慢查询日志数量。 - - 当值大于 `0` 时，TiDB 每秒最多打印指定数量的慢查询日志，超过部分将被丢弃，不会写入慢查询日志文件。 -- 该变量常与 [`tidb_slow_log_rules`](#tidb_slow_log_rules-从-v856-和-v900-版本开始引入) 结合使用，以防止在高负载情况下产生过多的慢查询日志。 +- 取值范围：`[0, 1000000]` +- 此变量用于控制每个 TiDB 节点每秒最多可写入的慢查询日志条目数。 + - 值为 `0` 表示每秒写入的慢查询日志条目数不受限制。 + - 值大于 `0` 表示 TiDB 每秒最多写入指定数量的慢查询日志条目。超出的日志条目会被丢弃，不会写入慢查询日志文件。 +- 此变量通常与 [`tidb_slow_log_rules`](#tidb_slow_log_rules) 一起使用，以防止在高负载条件下生成过多的慢查询日志。 -### tidb_slow_log_rules 从 v8.5.6 和 v9.0.0 版本开始引入 +### tidb_slow_log_rules v8.5.6 和 CLOUD.202603.1 中引入 {#tidb_slow_log_rules} -- 作用域：SESSION | GLOBAL -- 是否持久化到集群：是 +>**注意：** +> +> TiDB Cloud Starter 不支持此变量。 + +- 作用域 + - TiDB Self-Managed 和 TiDB Cloud Dedicated：SESSION | GLOBAL + - TiDB Cloud Essential 和 Premium：SESSION +- 持久化到集群：是 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 -- 默认值："" +- 默认值：`""` - 类型：字符串 -- 用于定义慢查询日志的触发规则，支持基于多维度指标的组合条件，实现更加灵活和精细化的日志记录控制。 -- 关于该系统变量的详细使用方法，请参考 [`tidb_slow_log_rules` 使用方法](/identify-slow-queries.md#tidb_slow_log_rules-使用方法)。 +- 此变量定义了慢查询日志的触发规则。它支持组合多维指标，从而提供更灵活、细粒度的日志记录能力。 +- 有关如何使用此系统变量的更多信息，请参见[配置慢查询触发规则](/config-slow-query-trigger-rules.md)。 + + + +> **Tip:** +> +> - 在生产环境中启用 `tidb_slow_log_rules` 时，建议同时配置 [`tidb_slow_log_max_per_sec`](#tidb_slow_log_max_per_sec)，以避免过于频繁地打印慢查询日志。 +> - 建议先从更严格的条件开始，再根据故障排查需求逐步放宽。有关性能影响的更多信息，请参见[建议](/config-slow-query-trigger-rules.md#recommendations)。 + + + > **Tip:** > -> 建议在启用 `tidb_slow_log_rules` 后，同时配置 [`tidb_slow_log_max_per_sec`](#tidb_slow_log_max_per_sec-从-v856-和-v900-版本开始引入)，以限制慢查询日志打印频率，防止基于规则的慢查询日志触发过于频繁。 +> 建议先从更严格的条件开始，再根据故障排查需求逐步放宽。有关性能影响的更多信息，请参见[建议](/config-slow-query-trigger-rules.md#recommendations)。 + + ### tidb_slow_log_threshold diff --git a/tidb-cloud-lake/sql/alter-view.md b/tidb-cloud-lake/sql/alter-view.md index fa74546e28f6f..d312a7da8aa1a 100644 --- a/tidb-cloud-lake/sql/alter-view.md +++ b/tidb-cloud-lake/sql/alter-view.md @@ -3,7 +3,7 @@ title: ALTER VIEW summary: 使用另一个 QUERY 修改现有视图。 --- -# ALTER VIEW +# ALTER VIEW 为现有视图设置或移除标签。标签必须先通过 [CREATE TAG](/tidb-cloud-lake/sql/create-tag.md) 创建。完整说明请参见 [SET TAG / UNSET TAG](/tidb-cloud-lake/sql/set-tag.md)。 diff --git a/tidb-cloud-lake/sql/ddl-view-overview.md b/tidb-cloud-lake/sql/ddl-view-overview.md index 38213c0750ec5..f1f1406f3c0d2 100644 --- a/tidb-cloud-lake/sql/ddl-view-overview.md +++ b/tidb-cloud-lake/sql/ddl-view-overview.md @@ -3,7 +3,7 @@ title: 视图 summary: 本页按功能分类，全面概述了 {{{ .lake }}} 中的视图操作，便于快速查阅。 --- -# 视图 +# 视图 本页按功能分类，全面概述了 {{{ .lake }}} 中的视图操作，便于快速查阅。 diff --git a/tidb-cloud-lake/sql/materialized-view.md b/tidb-cloud-lake/sql/materialized-view.md index 061a8339fe332..a1675ba6c1f7a 100644 --- a/tidb-cloud-lake/sql/materialized-view.md +++ b/tidb-cloud-lake/sql/materialized-view.md @@ -1,20 +1,20 @@ --- title: 物化视图 -summary: 物化视图会将查询结果以物理方式存储。在创建物化视图时，TiDB Cloud Lake 会对源表启用变更跟踪。 +summary: 物化视图会以物理方式存储查询结果。在创建物化视图时，TiDB Cloud Lake 会对源表启用变更跟踪。 --- -# 物化视图 +# 物化视图 -物化视图会将查询结果以物理方式存储。它定义在 `default` catalog 中的一张持久化 FUSE 表之上。在创建物化视图时，{{{ .lake }}} 会对源表启用变更跟踪。 +物化视图会以物理方式存储查询结果。它定义在 `default` catalog 中的一张持久化 FUSE 表之上。在创建物化视图时，{{{ .lake }}} 会对源表启用变更跟踪。 -与逻辑视图不同，物化视图可以通过显式刷新来持久化其源表中的变更。即使物理存储落后于源表，读也能保持一致。在第一次刷新之前，{{{ .lake }}} 会根据源表计算该定义。当源表存在尚未刷新的变更时，{{{ .lake }}} 会使用 **read fix**：在读取时，将已持久化的物化视图数据与所需的源表增量数据进行联合体，并对该增量应用视图定义。因此，查询会返回当前结果，而不是过期的物化数据。 +与逻辑视图不同，物化视图可以显式刷新，以持久化其源表中的变更。即使物理存储落后于源表，读也能保持一致。在首次刷新之前，{{{ .lake }}} 会根据源表计算该定义。当源表存在尚未刷新的变更时，{{{ .lake }}} 会使用 **read fix**：在读取时，将已持久化的物化视图数据与所需的增量源数据做联合体（并将视图定义应用到该增量上）。因此，查询返回的是当前结果，而不是过期的物化数据。 ## 限制 {#limitations} -- 定义必须是基于且仅基于一张基表的简单 `SELECT ... FROM ... [WHERE ...] [GROUP BY ...]` 查询。不支持 Join、子查询、集合操作以及非确定性函数。 -- 聚合仅支持 `sum`、`min`、`max`、`avg`、`count` 和 `approx_count_distinct`。不支持 `DISTINCT`、`FILTER`、窗口函数以及带排序的聚合形式。 -- 源必须是 `default` catalog 中的持久化 FUSE 基表。物化视图不能将其他视图或不同表引擎的表作为源。 -- 物化视图是只读的。请使用 `REFRESH MATERIALIZED VIEW` 来维护其内容；不支持 `INSERT`、`UPDATE`、`DELETE`、`TRUNCATE` 和普通的 `ALTER TABLE` 操作。 +- 定义必须是一个简单的 `SELECT ... FROM ... [WHERE ...] [GROUP BY ...]` 查询，并且只能基于一张基表。Join、子查询、集合操作以及非确定性函数均不支持。 +- 聚合仅支持 `sum`、`min`、`max`、`avg`、`count` 和 `approx_count_distinct`。不支持 `DISTINCT`、`FILTER`、窗口聚合以及有序聚合形式。 +- 源必须是 `default` catalog 中的持久化 FUSE 基表。物化视图不能使用另一个视图或不同的表引擎作为其源。 +- 物化视图是只读的。请使用 `REFRESH MATERIALIZED VIEW` 来维护其内容；不支持 `INSERT`、`UPDATE`、`DELETE`、`TRUNCATE` 以及普通的 `ALTER TABLE` 操作。 ## 创建物化视图 {#create-a-materialized-view} @@ -61,11 +61,11 @@ REFRESH MATERIALIZED VIEW paid_orders_by_customer; REFRESH MATERIALIZED VIEW [ . ][ . ] ``` -第一次刷新会将源数据物化。后续刷新会对仅追加的变更进行增量地处理。如果源表存在 `UPDATE`、`DELETE` 或 `TRUNCATE` 变更，{{{ .lake }}} 会根据当前源状态重建物化视图，以确保结果正确。 +首次刷新会将源数据物化。后续刷新会对仅追加变更进行增量地处理。如果源包含 `UPDATE`、`DELETE` 或 `TRUNCATE` 变更，{{{ .lake }}} 会基于当前源状态重建物化视图，以确保结果正确。 ## 修改物理布局 {#change-physical-layout} -对于支持的维护操作，请使用专用的 `ALTER MATERIALIZED VIEW` 语法： +对于受支持的维护操作，请使用专用的 `ALTER MATERIALIZED VIEW` 语法： ```sql ALTER MATERIALIZED VIEW CLUSTER BY ( , ... ); @@ -107,4 +107,4 @@ DROP MATERIALIZED VIEW IF EXISTS paid_orders_by_customer; ## 访问控制要求 {#access-control-requirements} -要查询、刷新、修改、查看或删除物化视图，用户需要对其源表具有 `SELECT` 权限（或具有提供等效访问能力的所有权）。权限会根据当前源表标识进行检查，因此源表重命名不会改变这一要求。 \ No newline at end of file +要查询、刷新、修改、查看或删除物化视图，用户需要对其源表具有 `SELECT` 权限（或具有提供等效访问权限的所有权）。权限会根据当前源表标识进行检查，因此源表重命名不会改变这一要求。 \ No newline at end of file diff --git a/tidb-cloud/ai-feature-concepts.md b/tidb-cloud/ai-feature-concepts.md index 5661f8dadcdba..14c8765f2a2e6 100644 --- a/tidb-cloud/ai-feature-concepts.md +++ b/tidb-cloud/ai-feature-concepts.md @@ -23,7 +23,7 @@ Chat2Query 是集成在 SQL Editor 中的 AI 驱动功能，能够帮助用户 即使搜索词与数据库中的内容并不完全匹配，向量搜索也可以通过分析数据的语义，返回符合用户意图的结果。例如，全文搜索 “a swimming animal” 只会返回包含这些精确关键字的结果。而向量搜索则可以返回其他游泳动物（如鱼或鸭子）的结果，即使这些结果中并不包含完全相同的关键字。 -更多信息，参见 [Vector Search (PREVIEW) Overview](/ai/concepts/vector-search-overview.md)。 +更多信息，参见 [Vector Search (PREVIEW) Overview](/ai/guides/vector-search-overview.md)。 ## AI 集成 @@ -37,7 +37,7 @@ TiDB 官方支持多种主流 AI 框架，使你能够轻松将基于这些框 向量 embedding（也称为 embedding）是一组数字序列，用于在高维空间中表示现实世界的对象。它能够捕捉非结构化数据（如文档、图片、音频和视频）的语义和上下文信息。 -Embedding 模型是一种将数据转换为 [vector embeddings](/ai/concepts/vector-search-overview.md#vector-embedding) 的算法。选择合适的 embedding 模型对于确保语义搜索结果的准确性和相关性至关重要。 +Embedding 模型是一种将数据转换为 [vector embeddings](/ai/guides/vector-search-overview.md#vector-embedding) 的算法。选择合适的 embedding 模型对于确保语义搜索结果的准确性和相关性至关重要。 TiDB 向量搜索支持存储最多 16383 维的向量，能够满足大多数 embedding 模型的需求。对于非结构化文本数据，你可以在 [Massive Text Embedding Benchmark (MTEB) Leaderboard](https://huggingface.co/spaces/mteb/leaderboard) 上找到表现最优的文本 embedding 模型。 diff --git a/tidb-cloud/cli-reference.md b/tidb-cloud/cli-reference.md index 531abe16544e1..41ab48e41b03d 100644 --- a/tidb-cloud/cli-reference.md +++ b/tidb-cloud/cli-reference.md @@ -1,15 +1,24 @@ --- -title: TiDB Cloud CLI 参考（PREVIEW） -summary: 提供 TiDB Cloud CLI 的概览。 +title: TiDB Cloud CLI (ticloud) 参考（PREVIEW） +summary: 提供适用于 TiDB Cloud Starter 和 Essential 的 ticloud CLI 概览。 --- -# TiDB Cloud CLI 参考（PREVIEW） +# TiDB Cloud CLI (ticloud) 参考（PREVIEW） > **Note:** > -> 目前，TiDB Cloud CLI 处于公开预览阶段，暂不适用于 TiDB Cloud Dedicated 集群。 +> 目前，TiDB Cloud 提供了使用范围不同的两个 CLI：[`ti`](https://github.com/tidbcloud/ti-cli) 和 [`ticloud`](https://github.com/tidbcloud/tidbcloud-cli)。 +> +> - 当 `ti` 支持你所需的操作时，建议将其用于 TiDB Cloud Starter 的新自动化工作流。你也可以使用 `ti` 管理 TiDB Cloud Filesystem。要开始使用，请参见 [TiDB Cloud CLI (`ti`) 快速开始](/ai/ti/ti-quick-start.md)。 +> - `ticloud` 仍然是适用于 TiDB Cloud Essential 以及 [`ti`](/ai/ti/ti-overview.md) 尚不支持的操作（例如数据导入、数据导出和审计日志操作）的 CLI。 +> +> 有关何时使用 `ti` 或 `ticloud` 的更多信息，请参见 [`ti` 与 `ticloud` 的区别](/ai/ti/ti-overview.md#differences-between-ti-and-ticloud)。 + +`ticloud` CLI 是一个命令行接口，让你可以通过终端操作 TiDB Cloud。它可管理 {{{ .starter }}} 和 Essential 实例、导入和导出数据，并支持其他 CLI 工作流。 -TiDB Cloud CLI 是一个命令行界面，允许你通过几行命令在终端中操作 TiDB Cloud。在 TiDB Cloud CLI 中，你可以轻松管理 {{{ .starter }}} 和 Essential 实例、向实例导入数据以及执行更多操作。 +> **Note:** +> +> `ticloud` CLI 当前处于公开预览阶段，不支持 TiDB Cloud Dedicated 集群。 ## 开始之前 diff --git a/tidb-cloud/connected-ai-chat-in-im.md b/tidb-cloud/connected-ai-chat-in-im.md index 0e1cee6a01d74..39d430d7664c9 100644 --- a/tidb-cloud/connected-ai-chat-in-im.md +++ b/tidb-cloud/connected-ai-chat-in-im.md @@ -5,7 +5,7 @@ summary: 介绍 IM（即时消息）中 AI 聊天的详细信息。 # Connected：IM 中的 AI 聊天 -由 PingCAP 提供支持的 IM（即时消息）中的 AI 聊天，是一项可以将 TiDB AI 助手聊天机器人邀请到指定 IM 频道中，用于初步技术支持和咨询的服务。该服务基于构建在 [TiDB Vector Search](/ai/concepts/vector-search-overview.md) 之上的 Graph RAG（检索增强生成）。 +由 PingCAP 提供支持的 IM（即时消息）中的 AI 聊天，是一项可以将 TiDB AI 助手聊天机器人邀请到指定 IM 频道中，用于初步技术支持和咨询的服务。该服务基于构建在 [TiDB Vector Search](/ai/guides/vector-search-overview.md) 之上的 Graph RAG（检索增强生成）。 ## 限制 diff --git a/tidb-cloud/get-started-with-cli.md b/tidb-cloud/get-started-with-cli.md index 5d52a4077a06e..7b34c2925bf78 100644 --- a/tidb-cloud/get-started-with-cli.md +++ b/tidb-cloud/get-started-with-cli.md @@ -1,11 +1,20 @@ --- -title: TiDB Cloud CLI 快速入门 -summary: 了解如何通过 TiDB Cloud CLI 管理 {{{ .starter }}} 和 Essential 实例。 +title: TiDB Cloud CLI (`ticloud`) 快速入门 +summary: 了解如何通过 ticloud CLI 管理 {{{ .starter }}} 和 Essential 实例。 --- -# TiDB Cloud CLI 快速入门 +# TiDB Cloud CLI (`ticloud`) 快速入门 -TiDB Cloud 提供了一个命令行界面（CLI）[`ticloud`](https://github.com/tidbcloud/tidbcloud-cli)，你可以通过在终端输入几行命令与 TiDB Cloud 进行交互。例如，你可以使用 `ticloud` 轻松完成以下操作： +> **Note:** +> +> TiDB Cloud 目前提供两个作用域不同的 CLI：[`ti`](https://github.com/tidbcloud/ti-cli) 和 [`ticloud`](https://github.com/tidbcloud/tidbcloud-cli)。 +> +> - 当 `ti` 支持你所需的操作时，建议将其用于 TiDB Cloud Starter 的新自动化工作流。你也可以使用 `ti` 管理 TiDB Cloud Filesystem。要开始使用，请参见 [TiDB Cloud CLI (`ti`) Quick Start](/ai/ti/ti-quick-start.md)。 +> - `ticloud` 仍然是用于 TiDB Cloud Essential 以及 [`ti`](/ai/ti/ti-overview.md) 尚不支持的操作（例如数据导入、数据导出和审计日志操作）的 CLI。 +> +> 有关何时使用 `ti` 或 `ticloud` 的更多信息，请参见 [`ti` 与 `ticloud` 的区别](/ai/ti/ti-overview.md#differences-between-ti-and-ticloud)。 + +TiDB Cloud 提供了一个命令行界面（CLI）[`ticloud`](https://github.com/tidbcloud/tidbcloud-cli)，你可以通过在终端输入几行命令与 TiDB Cloud Starter 和 Essential 进行交互。例如，你可以使用 `ticloud` 完成以下操作： - 创建、删除和列出你的 {{{ .starter }}} 或 Essential 实例。 - 向你的 {{{ .starter }}} 或 Essential 实例导入数据。 @@ -13,7 +22,7 @@ TiDB Cloud 提供了一个命令行界面（CLI）[`ticloud`](https://github.com > **Note:** > -> TiDB Cloud CLI 目前处于公开预览阶段。 +> `ticloud` CLI 目前处于公开预览阶段。 ## 开始之前 diff --git a/tidb-cloud/releases/release-notes-2024.md b/tidb-cloud/releases/release-notes-2024.md index c6fe541631fa5..882274be9e200 100644 --- a/tidb-cloud/releases/release-notes-2024.md +++ b/tidb-cloud/releases/release-notes-2024.md @@ -247,7 +247,7 @@ summary: 了解 2024 年 TiDB Cloud 的发布说明。 - Python 语言支持：[SQLAlchemy](/ai/integrations/vector-search-integrate-with-sqlalchemy.md)、[Peewee](/ai/integrations/vector-search-integrate-with-peewee.md) 和 [Django ORM](/ai/integrations/vector-search-integrate-with-django-orm.md)。 - 示例应用和教程：使用 [Python](/ai/quickstart-via-python.md) 或 [SQL](/ai/quickstart-via-sql.md) 对文档进行语义检索。 - 更多信息，参见 [向量检索（测试版）概述](/ai/concepts/vector-search-overview.md)。 + 更多信息，参见 [向量检索（测试版）概述](/ai/guides/vector-search-overview.md)。 - [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 现为组织所有者提供每周邮件报告。 diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index 16c4ca63ac67b..1847d92d379e9 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -8,6 +8,18 @@ aliases: ['/zh/tidbcloud/supported-tidb-versions','/zh/tidbcloud/release-notes', 本页面列出了 [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 在 2026 年的发布说明。 +## 2026 年 9 月 15 日 {#september-15-2026} + +**常规变更** + +* **TiDB Cloud CLI** + + [TiDB Cloud CLI (`ti`)](https://github.com/tidbcloud/ti-cli) 现已进入公开预览版，可用于管理 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 实例和 TiDB Cloud Filesystem。TiDB Cloud Filesystem 是一种无服务器分布式文件系统，专为 AI 代理和自动化工作负载而设计。 + + 你可以直接使用 `ti`，也可以让脚本、CI 作业和 AI 代理运行它，以自动化 TiDB Cloud 工作流。借助 `ti`，你可以创建和管理 TiDB Cloud Starter 实例、执行 SQL 语句，以及通过文件命令或支持的挂载创建和访问持久化的 Filesystem 工作区。默认 JSON 输出、JMESPath 输出查询，以及在适用命令上支持 `--wait` 和 `--dry-run`，可简化自动化流程。 + + 更多信息，请参见 [开始使用 TiDB Cloud CLI](/ai/ti/ti-quick-start.md) 和 [TiDB Cloud CLI (`ti`) 概览](/ai/ti/ti-overview.md)。 + ## 2026 年 9 月 8 日 {#september-8-2026} **控制台变更** diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index caf8456a80b2e..2d390b9dcddcb 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -150,7 +150,7 @@ TiDB Cloud Dedicated 适用于生产环境，具备跨可用区高可用性、 ## {{{ .lake }}} {#lake} -TiDB Cloud Lake 是一项面向分析工作负载的云原生数据仓库服务。它将计算与存储分离，使你能够独立配置 warehouse，随工作负载变化进行扩展，并以经济高效的方式将数据存储在对象存储中。 +[TiDB Cloud Lake](https://docs.pingcap.com/tidbcloudlake/) 是一项面向分析工作负载的云原生数据仓库服务。它将计算与存储分离，使你能够独立配置 warehouse，随工作负载变化进行扩展，并以经济高效的方式将数据存储在对象存储中。 TiDB Cloud Lake 在一个平台中支持 ANSI SQL、半结构化数据处理、向量搜索和面向 AI 的工作流。它专为希望获得托管式分析体验而无需自行运维底层基础设施的团队而设计。 diff --git a/tidb-cloud/tidb-cloud-billing.md b/tidb-cloud/tidb-cloud-billing.md index a2f10f7d45d58..60863ae895aff 100644 --- a/tidb-cloud/tidb-cloud-billing.md +++ b/tidb-cloud/tidb-cloud-billing.md @@ -115,7 +115,7 @@ TiDB Cloud 根据你所消耗的资源进行收费。 > **注意：** > - > Infrequent Access 目前对 {{{ .essential }}} 处于私有预览阶段，仅可按请求提供。 + > Infrequent Access 目前处于私有预览阶段，仅可按请求提供。 - **Columnar storage**：列存储由 **TiFlash** 引擎提供支持。 diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 31c03bdbba01d..1b5f426d7ee4f 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -69,7 +69,7 @@ Data Service 中的 endpoint 是你可以自定义的 Web API，用于执行 SQL ### Full-text search -与关注语义相似度的 [Vector Search](/ai/concepts/vector-search-overview.md) 不同，全文检索允许你通过精确关键字检索文档。在 RAG（Retrieval-Augmented Generation）场景中，你可以将全文检索与向量检索结合使用，以提升检索质量。 +与关注语义相似度的 [Vector Search](/ai/guides/vector-search-overview.md) 不同，全文检索允许你通过精确关键字检索文档。在 RAG（Retrieval-Augmented Generation）场景中，你可以将全文检索与向量检索结合使用，以提升检索质量。 更多信息，参见 [Full-Text Search with SQL](/ai/guides/vector-search-full-text-search-sql.md) 和 [Full-Text Search with Python](/ai/guides/vector-search-full-text-search-python.md)。 @@ -232,7 +232,7 @@ TiDB X instance 是一种基于 [TiDB X architecture](/tidb-cloud/tidb-x-archite ### Vector search -[Vector search](/ai/concepts/vector-search-overview.md) 是一种以数据语义为核心、提供相关性结果的检索方法。与依赖精确关键字匹配和词频的传统全文检索不同，vector search 会将多种数据类型（如文本、图片或音频）转换为高维向量，并基于这些向量间的相似度进行查询。该方法能够捕捉数据的语义和上下文信息，更准确理解用户意图。即使检索词与数据库内容不完全匹配，vector search 也能通过分析数据语义，返回符合用户意图的结果。 +[Vector search](/ai/guides/vector-search-overview.md) 是一种以数据语义为核心、提供相关性结果的检索方法。与依赖精确关键字匹配和词频的传统全文检索不同，vector search 会将多种数据类型（如文本、图片或音频）转换为高维向量，并基于这些向量间的相似度进行查询。该方法能够捕捉数据的语义和上下文信息，更准确理解用户意图。即使检索词与数据库内容不完全匹配，vector search 也能通过分析数据语义，返回符合用户意图的结果。 ### Virtual Private Cloud diff --git a/tidb-cloud/tidb-cloud-intro.md b/tidb-cloud/tidb-cloud-intro.md index 4dc6c57ae54cb..205aa15d1df06 100644 --- a/tidb-cloud/tidb-cloud-intro.md +++ b/tidb-cloud/tidb-cloud-intro.md @@ -6,7 +6,9 @@ category: intro # 什么是 TiDB Cloud -[TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 是一款完全托管的云原生数据库即服务（DBaaS），基于 [TiDB](https://docs.pingcap.com/tidb/stable/overview) —— 一个开源 HTAP (Hybrid Transactional and Analytical Processing) 数据库。TiDB Cloud 提供了一种简单的方式来部署和管理数据库，让你专注于应用程序开发，而无需关注数据库的复杂性。你可以在 Amazon Web Services (AWS)、Google Cloud、Microsoft Azure 和阿里云上创建 TiDB Cloud 资源（例如 {{{ .starter }}} 实例、{{{ .essential }}} 实例和 {{{ .dedicated }}} 集群），快速构建关键业务应用。You can create TiDB Cloud resources (such as {{{ .starter }}} instances, {{{ .essential }}} instances, and {{{ .dedicated }}} clusters) to quickly build mission-critical applications on Amazon Web Services (AWS), Google Cloud, and Microsoft Azure. +[TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 是一款完全托管的云原生数据库即服务（DBaaS），基于 [TiDB](https://docs.pingcap.com/tidb/stable/overview) —— 一个开源 HTAP (Hybrid Transactional and Analytical Processing) 数据库。TiDB Cloud 提供了一种简单的方式来部署和管理数据库，让你专注于应用程序开发，而无需关注数据库的复杂性。 + +你可以在 Amazon Web Services (AWS)、Google Cloud、Microsoft Azure 和阿里云上创建 TiDB Cloud 资源（例如 Starter 实例、Essential 实例、Premium 实例和 Dedicated 集群），快速构建关键业务应用。You can create TiDB Cloud resources (such as Starter instances, Essential instances, Premium instances, and Dedicated clusters) to quickly build mission-critical applications on Amazon Web Services (AWS), Google Cloud, and Microsoft Azure. 此外，你还可以使用 TiDB Cloud Lake 构建一个面向分析负载的云原生数据仓库。 ![TiDB Cloud Overview](/media/tidb-cloud/tidb-cloud-overview.png) diff --git a/tidb-cloud/tidb-cloud-org-sso-authentication.md b/tidb-cloud/tidb-cloud-org-sso-authentication.md index 17c5688491e92..8630d2c29f30b 100644 --- a/tidb-cloud/tidb-cloud-org-sso-authentication.md +++ b/tidb-cloud/tidb-cloud-org-sso-authentication.md @@ -186,13 +186,20 @@ TiDB Cloud 为组织 SSO 提供以下认证方式： 在 TiDB Cloud 中，SAML 认证方式默认禁用。启用云组织 SSO 后，你可以按如下方式启用并配置 SAML 认证方式： -1. 从你的身份提供商获取 TiDB Cloud 组织 SSO 所需的以下信息： +1. 在 TiDB Cloud 控制台的 **Authentication** 页面，在 **Authentication Methods** 区域找到 SAML 行，然后点击 展开 SAML 方法详情。 +2. 在 **Authentication Method Details** 面板中，复制以下值。TiDB Cloud 会在你输入 **Sign on URL** 和 **Signing Certificate** 之前预先填充这些值： + + - **Entity ID**：这是 TiDB Cloud 的服务提供商（SP）实体 ID。 + - **Postback URL**：这是 SAML 端点（也称为 Assertion Consumer Service (ACS) URL 或 Reply URL），你的身份提供商会将 SAML 响应发送到该端点。 + +3. 在你的身份提供商中，使用上一步中的 **Entity ID** 和 **Postback URL** 为 TiDB Cloud 创建或配置一个 SAML 应用。如果你的身份提供商由 SSO 团队管理，请将这些值提供给该团队。 + + 然后，从你的身份提供商获取以下信息： - Sign on URL - Signing Certificate -2. 在 TiDB Cloud 控制台的 **Authentication** 页面，在 **Authentication Methods** 区域找到 SAML 行，然后点击 展开 SAML 方式详情。 -3. 在认证方式详情中，你可以配置以下内容： +4. 返回 TiDB Cloud 控制台中的 **Authentication Method Details** 面板，然后配置以下内容： - **Name** @@ -226,7 +233,7 @@ TiDB Cloud 为组织 SSO 提供以下认证方式： 在启用 **SCIM Provisioning Accounts** 之前，请先为要加入的用户添加并验证邮箱域名，并在 **Allowed Email Domains** 字段中进行配置。 -4. 点击 **Save**。 +5. 点击 **Activate**。 #### 配置 SCIM 自动化管理 diff --git a/tidb-cloud/tune-performance.md b/tidb-cloud/tune-performance.md index 3c7e09b86f7c1..5ca2329618358 100644 --- a/tidb-cloud/tune-performance.md +++ b/tidb-cloud/tune-performance.md @@ -46,6 +46,14 @@ TiDB Cloud 提供了 [慢查询](#slow-query) 和 [语句分析](#statement-anal 默认情况下，执行时间超过 300 毫秒的 SQL 查询会被视为慢查询。 + + +> **注意：** +> +> 你还可以为慢查询配置触发规则，以根据特定指标组合筛选目标语句。更多信息，请参见[为慢查询配置触发规则](/config-slow-query-trigger-rules.md)。 + + + 要在 {{{ .starter }}} 实例{{{ .essential }}} 实例{{{ .premium }}} 实例{{{ .dedicated }}} 集群 中查看慢查询，请执行以下步骤： 1. [进入 **Diagnosis** 页面](#view-the-diagnosis-page)。