Rechercher dans le manuel MySQL

26.12.12.4 The table_handles Table

Contents

The Performance Schema exposes table lock information through the table_handles table to show the table locks currently in effect for each opened table handle. table_handles reports what is recorded by the table lock instrumentation. This information shows which table handles the server has open, how they are locked, and by which sessions.

The table_handles table is read only and cannot be updated. It is autosized by default; to configure the table size, set the performance_schema_max_table_handles system variable at server startup.

Table lock instrumentation uses the wait/lock/table/sql/handler instrument, which is enabled by default.

To control table lock instrumentation state at server startup, use lines like these in your my.cnf file:

  • Enable: 

    [mysqld]
performance-schema-instrument='wait/lock/table/sql/handler=ON'

  • Disable: 

    [mysqld]
performance-schema-instrument='wait/lock/table/sql/handler=OFF'

To control table lock instrumentation state at runtime, update the setup_instruments table:

  • Enable:

    1. UPDATE performance_schema.setup_instruments
    2. SET ENABLED = 'YES', TIMED = 'YES'
    3. WHERE NAME = 'wait/lock/table/sql/handler';

  • Disable:

    1. UPDATE performance_schema.setup_instruments
    2. SET ENABLED = 'NO', TIMED = 'NO'
    3. WHERE NAME = 'wait/lock/table/sql/handler';

The table_handles table has these columns:

  • OBJECT_TYPE

    The table opened by a table handle.

  • OBJECT_SCHEMA

    The schema that contains the object.

  • OBJECT_NAME

    The name of the instrumented object.

  • OBJECT_INSTANCE_BEGIN

    The table handle address in memory.

  • OWNER_THREAD_ID

    The thread owning the table handle.

  • OWNER_EVENT_ID

    The event which caused the table handle to be opened.

  • INTERNAL_LOCK

    The table lock used at the SQL level. The value is one of READ, READ WITH SHARED LOCKS, READ HIGH PRIORITY, READ NO INSERT, WRITE ALLOW WRITE, WRITE CONCURRENT INSERT, WRITE LOW PRIORITY, or WRITE. For information about these lock types, see the include/thr_lock.h source file.

  • EXTERNAL_LOCK

    The table lock used at the storage engine level. The value is one of READ EXTERNAL or WRITE EXTERNAL.

The table_handles table has these indexes:

  • Primary key on (OBJECT_INSTANCE_BEGIN)

  • Index on (OBJECT_TYPE, OBJECT_SCHEMA, OBJECT_NAME)

  • Index on (OWNER_THREAD_ID, OWNER_EVENT_ID)

TRUNCATE TABLE is not permitted for the table_handles table.


Find a PHP function

Document created the 26/06/2006, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/mysql-rf-table-handles-table.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:en Manuel MySQL : https://dev.mysql.com/

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut