MySQL :: MySQL 8.4 参考手册 :: 29.12.20.4 语句直方图汇总表

版本 8.4

9.0
8.0

8.0 日语

MySQL 8.4 参考手册 / ... / 语句直方图汇总表

29.12.20.4 语句直方图汇总表

性能架构维护语句事件汇总表，其中包含有关最小、最大和平均语句延迟的信息（请参阅第 29.12.20.3 节，“语句汇总表”）。这些表允许对系统性能进行高级评估。为了允许在更细粒度的级别进行评估，性能架构还收集语句延迟的直方图数据。这些直方图提供了对延迟分布的更多见解。

第 29.12.6 节，“性能架构语句事件表” 描述了语句汇总基于的事件。请参阅该讨论以了解有关语句事件的内容、当前和历史语句事件表以及如何控制语句事件收集的信息，该收集默认情况下是部分禁用的。

示例语句直方图信息

mysql> SELECT *
       FROM performance_schema.events_statements_histogram_by_digest
       WHERE SCHEMA_NAME = 'mydb' AND DIGEST = 'bb3f69453119b2d7b3ae40673a9d4c7c'
       AND COUNT_BUCKET > 0 ORDER BY BUCKET_NUMBER\G
*************************** 1. row ***************************
           SCHEMA_NAME: mydb
                DIGEST: bb3f69453119b2d7b3ae40673a9d4c7c
         BUCKET_NUMBER: 42
      BUCKET_TIMER_LOW: 66069344
     BUCKET_TIMER_HIGH: 69183097
          COUNT_BUCKET: 1
COUNT_BUCKET_AND_LOWER: 1
       BUCKET_QUANTILE: 0.058824
*************************** 2. row ***************************
           SCHEMA_NAME: mydb
                DIGEST: bb3f69453119b2d7b3ae40673a9d4c7c
         BUCKET_NUMBER: 43
      BUCKET_TIMER_LOW: 69183097
     BUCKET_TIMER_HIGH: 72443596
          COUNT_BUCKET: 1
COUNT_BUCKET_AND_LOWER: 2
       BUCKET_QUANTILE: 0.117647
*************************** 3. row ***************************
           SCHEMA_NAME: mydb
                DIGEST: bb3f69453119b2d7b3ae40673a9d4c7c
         BUCKET_NUMBER: 44
      BUCKET_TIMER_LOW: 72443596
     BUCKET_TIMER_HIGH: 75857757
          COUNT_BUCKET: 2
COUNT_BUCKET_AND_LOWER: 4
       BUCKET_QUANTILE: 0.235294
*************************** 4. row ***************************
           SCHEMA_NAME: mydb
                DIGEST: bb3f69453119b2d7b3ae40673a9d4c7c
         BUCKET_NUMBER: 45
      BUCKET_TIMER_LOW: 75857757
     BUCKET_TIMER_HIGH: 79432823
          COUNT_BUCKET: 6
COUNT_BUCKET_AND_LOWER: 10
       BUCKET_QUANTILE: 0.625000
...

例如，在第 3 行中，这些值表明 23.52% 的查询在 75.86 微秒内运行。

BUCKET_TIMER_HIGH: 75857757
  BUCKET_QUANTILE: 0.235294

在第 4 行中，这些值表明 62.50% 的查询在 79.44 微秒内运行。

BUCKET_TIMER_HIGH: 79432823
  BUCKET_QUANTILE: 0.625000

每个语句直方图汇总表都具有一列或多列分组列，以指示表如何聚合事件。

events_statements_histogram_by_digest 具有 SCHEMA_NAME、DIGEST 和 BUCKET_NUMBER 列。
- SCHEMA_NAME 和 DIGEST 列标识 events_statements_summary_by_digest 表中的语句摘要行。
- 具有相同 SCHEMA_NAME 和 DIGEST 值的 events_statements_histogram_by_digest 行构成该模式/摘要组合的直方图。
- 在给定的直方图内，BUCKET_NUMBER 列指示桶号。
events_statements_histogram_global 具有 BUCKET_NUMBER 列。此表使用单个直方图，在模式名称和摘要值之间全局汇总延迟。BUCKET_NUMBER 列指示此全局直方图内的桶号。

直方图包含 N 个桶，其中每一行代表一个桶，桶号由 BUCKET_NUMBER 列指示。桶号从 0 开始。

每个语句直方图汇总表都具有这些包含聚合值的汇总列。

BUCKET_TIMER_LOW、BUCKET_TIMER_HIGH
桶会统计延迟在 BUCKET_TIMER_LOW 和 BUCKET_TIMER_HIGH 之间的语句，单位为皮秒。
- 第一个桶（BUCKET_NUMBER = 0）的 BUCKET_TIMER_LOW 值为 0。
- 桶（BUCKET_NUMBER = k）的 BUCKET_TIMER_LOW 值与前一个桶（BUCKET_NUMBER = k−1）的 BUCKET_TIMER_HIGH 值相同。
- 最后一个桶是用于延迟超过直方图中先前桶的语句的 catchall。
COUNT_BUCKET
延迟在从 BUCKET_TIMER_LOW 开始到但不包括 BUCKET_TIMER_HIGH 的间隔内测量的语句数。
COUNT_BUCKET_AND_LOWER
延迟在从 0 开始到但不包括 BUCKET_TIMER_HIGH 的间隔内测量的语句数。
BUCKET_QUANTILE
属于此桶或更低桶的语句比例。根据定义，此比例对应于 COUNT_BUCKET_AND_LOWER / SUM(COUNT_BUCKET)，并以方便列的形式显示。

语句直方图汇总表具有以下索引。

events_statements_histogram_by_digest:
- 在 (SCHEMA_NAME, DIGEST, BUCKET_NUMBER) 上建立唯一索引
events_statements_histogram_global:
- 在 (BUCKET_NUMBER) 上建立主键

TRUNCATE TABLE 允许用于语句直方图汇总表。截断将 COUNT_BUCKET 和 COUNT_BUCKET_AND_LOWER 列设置为 0。

此外，截断 events_statements_summary_by_digest 会隐式截断 events_statements_histogram_by_digest，而截断 events_statements_summary_global_by_event_name 会隐式截断 events_statements_histogram_global。