#### 27.12.20.4 语句直方图汇总表

[](<>)[](<>)[](<>)[](<>)

性能模式维护语句事件摘要表，其中包含有关最小、最大和平均语句延迟的信息（请参阅[第 27.12.20.3 节，“报表汇总表”](performance-schema-statement-summary-tables.html)）。这些表允许对系统性能进行高级评估。为了允许在更细粒度的级别进行评估，性能模式还收集语句延迟的直方图数据。这些直方图提供了对延迟分布的额外洞察。

[第 27.12.6 节，“性能模式语句事件表”](performance-schema-statement-tables.html)描述语句摘要所基于的事件。有关语句事件的内容、当前和历史语句事件表以及如何控制语句事件收集（默认情况下部分禁用）的信息，请参阅该讨论。

示例语句直方图信息：

```
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`](performance-schema-statement-histogram-summary-tables.html)已`SCHEMA_NAME`,`消化`， 和`BUCKET_NUMBER`列：

    -   这`SCHEMA_NAME`和`消化`列标识语句摘要行[`events_statements_summary_by_digest`](performance-schema-statement-summary-tables.html)桌子。

    -   这[`events_statements_histogram_by_digest`](performance-schema-statement-histogram-summary-tables.html)具有相同的行`SCHEMA_NAME`和`消化`值构成该模式/摘要组合的直方图。

    -   在给定的直方图中，`BUCKET_NUMBER`列表示桶号。

-   [`events_statements_histogram_global`](performance-schema-statement-histogram-summary-tables.html)有个`BUCKET_NUMBER`柱子。此表使用单个直方图汇总了跨模式名称和摘要值的全局延迟。这`BUCKET_NUMBER`列表示此全局直方图中的桶编号。

    直方图包括*`ñ`*桶，其中每一行代表一个桶，桶号由`BUCKET_NUMBER`柱子。桶号以 0 开头。

    每个语句直方图汇总表都有以下汇总列，其中包含汇总值：

-   `BUCKET_TIMER_LOW`,`BUCKET_TIMER_HIGH`

    存储桶计数具有延迟（以皮秒为单位）的语句，在`BUCKET_TIMER_LOW`和`BUCKET_TIMER_HIGH`：

    -   的价值`BUCKET_TIMER_LOW`对于第一个桶（`BUCKET_NUMBER`= 0) 为 0。

    -   的价值`BUCKET_TIMER_LOW`对于一个桶（`BUCKET_NUMBER`=*`ķ`*） 是相同的`BUCKET_TIMER_HIGH`对于前一个桶 (`BUCKET_NUMBER`=*`ķ`*-1)

    -   最后一个桶是对延迟超过直方图中先前桶的语句的统称。

-   `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`](performance-schema-statement-histogram-summary-tables.html)：

    -   唯一索引 (`SCHEMA_NAME`,`消化`,`BUCKET_NUMBER`)

-   [`events_statements_histogram_global`](performance-schema-statement-histogram-summary-tables.html)：

    -   主键打开 (`BUCKET_NUMBER`)

[`截断表`](truncate-table.html)允许用于语句直方图汇总表。截断设置`COUNT_BUCKET`和`COUNT_BUCKET_AND_LOWER`列为 0。

此外，截断[`events_statements_summary_by_digest`](performance-schema-statement-summary-tables.html)隐式截断[`events_statements_histogram_by_digest`](performance-schema-statement-histogram-summary-tables.html), 并截断[`events_statements_summary_global_by_event_name`](performance-schema-statement-summary-tables.html)隐式截断[`events_statements_histogram_global`](performance-schema-statement-histogram-summary-tables.html).
