SHOW [GLOBAL|SESSION] BINDINGS

The SHOW BINDINGS statement is used to display information about created SQL bindings. A BINDING can be on either a GLOBAL or SESSION basis. The default is SESSION.

Synopsis

ShowBindingsStmt

SHOW BINDINGS - 图1

ShowLikeOrWhere

SHOW BINDINGS - 图2

  1. ShowBindingsStmt ::=
  2.     "SHOW" ("GLOBAL" | "SESSION")? "BINDINGS" ShowLikeOrWhere?
  4. ShowLikeOrWhere ::=
  5.     "LIKE" SimpleExpr
  6. |   "WHERE" Expression

Syntax description

This statement outputs the execution plan bindings at the GLOBAL or SESSION level. The default scope is SESSION. Currently SHOW BINDINGS outputs eight columns, as shown below:

Column NameDescription
original_sqlOriginal SQL statement after parameterization
bind_sqlBound SQL statement with hints
default_dbDefault database
statusStatus including ‘Using’, ‘Deleted’, ‘Invalid’, ‘Rejected’, and ‘Pending verification’
create_timeCreated time
update_timeUpdated time
charsetCharacter set
collationSorting rule
sourceThe way in which a binding is created, including manual (created by the create [global] binding SQL statement), capture (captured automatically by TiDB), and evolve (evolved automatically by TiDB)

Examples

  1. mysql> CREATE TABLE t1 (
  2.           id INT NOT NULL PRIMARY KEY auto_increment,
  3.           b INT NOT NULL,
  4.           pad VARBINARY(255),
  5.           INDEX(b)
  6.          );
  7. Query OK, 0 rows affected (0.07 sec)
  9. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM dual;
  10. Query OK, 1 row affected (0.01 sec)
  11. Records: 1  Duplicates: 0  Warnings: 0
  13. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  14. Query OK, 1 row affected (0.00 sec)
  15. Records: 1  Duplicates: 0  Warnings: 0
  17. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  18. Query OK, 8 rows affected (0.00 sec)
  19. Records: 8  Duplicates: 0  Warnings: 0
  21. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  22. Query OK, 1000 rows affected (0.04 sec)
  23. Records: 1000  Duplicates: 0  Warnings: 0
  25. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  26. Query OK, 100000 rows affected (1.74 sec)
  27. Records: 100000  Duplicates: 0  Warnings: 0
  29. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  30. Query OK, 100000 rows affected (2.15 sec)
  31. Records: 100000  Duplicates: 0  Warnings: 0
  33. mysql> INSERT INTO t1 SELECT NULL, FLOOR(RAND()*1000), RANDOM_BYTES(255) FROM t1 a JOIN t1 b JOIN t1 c LIMIT 100000;
  34. Query OK, 100000 rows affected (2.64 sec)
  35. Records: 100000  Duplicates: 0  Warnings: 0
  37. mysql> SELECT SLEEP(1);
  38. +----------+
  39. | SLEEP(1) |
  40. +----------+
  41. |        0 |
  42. +----------+
  43. 1 row in set (1.00 sec)
  45. mysql> ANALYZE TABLE t1;
  46. Query OK, 0 rows affected (1.33 sec)
  48. mysql> EXPLAIN ANALYZE SELECT * FROM t1 WHERE b = 123;
  49. +-------------------------------+---------+---------+-----------+----------------------+---------------------------------------------------------------------------+-----------------------------------+----------------+------+
  50. | id                            | estRows | actRows | task      | access object        | execution info                                                            | operator info                     | memory         | disk |
  51. +-------------------------------+---------+---------+-----------+----------------------+---------------------------------------------------------------------------+-----------------------------------+----------------+------+
  52. | IndexLookUp_10                | 583.00  | 297     | root      |                      | time:10.545072ms, loops:2, rpc num: 1, rpc time:398.359µs, proc keys:297  |                                   | 109.1484375 KB | N/A  |
  53. | ├─IndexRangeScan_8(Build)     | 583.00  | 297     | cop[tikv] | table:t1, index:b(b) | time:0s, loops:4                                                          | range:[123,123], keep order:false | N/A            | N/A  |
  54. | └─TableRowIDScan_9(Probe)     | 583.00  | 297     | cop[tikv] | table:t1             | time:12ms, loops:4                                                        | keep order:false                  | N/A            | N/A  |
  55. +-------------------------------+---------+---------+-----------+----------------------+---------------------------------------------------------------------------+-----------------------------------+----------------+------+
  56. 3 rows in set (0.02 sec)
  58. mysql> CREATE SESSION BINDING FOR
  59.          SELECT * FROM t1 WHERE b = 123
  60.         USING
  61.          SELECT * FROM t1 IGNORE INDEX (b) WHERE b = 123;
  62. Query OK, 0 rows affected (0.00 sec)
  64. mysql> EXPLAIN ANALYZE SELECT * FROM t1 WHERE b = 123;
  65. +-------------------------+-----------+---------+-----------+---------------+--------------------------------------------------------------------------------+--------------------+---------------+------+
  66. | id                      | estRows   | actRows | task      | access object | execution info                                                                 | operator info      | memory        | disk |
  67. +-------------------------+-----------+---------+-----------+---------------+--------------------------------------------------------------------------------+--------------------+---------------+------+
  68. | TableReader_7           | 583.00    | 297     | root      |               | time:222.32506ms, loops:2, rpc num: 1, rpc time:222.078952ms, proc keys:301010 | data:Selection_6   | 88.6640625 KB | N/A  |
  69. | └─Selection_6           | 583.00    | 297     | cop[tikv] |               | time:224ms, loops:298                                                          | eq(test.t1.b, 123) | N/A           | N/A  |
  70. |   └─TableFullScan_5     | 301010.00 | 301010  | cop[tikv] | table:t1      | time:220ms, loops:298                                                          | keep order:false   | N/A           | N/A  |
  71. +-------------------------+-----------+---------+-----------+---------------+--------------------------------------------------------------------------------+--------------------+---------------+------+
  72. 3 rows in set (0.22 sec)
  74. mysql> SHOW SESSION BINDINGS\G
  75. *************************** 1. row ***************************
  76. Original_sql: select * from t1 where b = ?
  77.     Bind_sql: SELECT * FROM t1 IGNORE INDEX (b) WHERE b = 123
  78.   Default_db: test
  79.       Status: using
  80.  Create_time: 2020-05-22 14:38:03.456
  81.  Update_time: 2020-05-22 14:38:03.456
  82.      Charset: utf8mb4
  83.    Collation: utf8mb4_0900_ai_ci
  84. 1 row in set (0.00 sec)

MySQL compatibility

This statement is a TiDB extension to MySQL syntax.

See also