MySQL 8.0 リファレンスマニュアル


MySQL 8.0 リファレンスマニュアル  /  INFORMATION_SCHEMA テーブル  /  INFORMATION_SCHEMA TABLES テーブル

26.38 INFORMATION_SCHEMA TABLES テーブル

TABLES テーブルは、データベース内のテーブルに関する情報を提供します。

テーブル統計を表す TABLES のカラムには、キャッシュされた値が保持されます。 information_schema_stats_expiry システム変数は、キャッシュされたテーブルの統計が期限切れになるまでの期間を定義します。 デフォルトは 86400 秒 (24 時間) です。 キャッシュされた統計がない場合、または統計が期限切れになっている場合は、テーブル統計カラムのクエリー時にストレージエンジンから統計が取得されます。 特定のテーブルのキャッシュされた値をいつでも更新するには、ANALYZE TABLE を使用します。 常に最新の統計をストレージエンジンから直接取得するには、information_schema_stats_expiry0 に設定します。 詳細は、セクション8.2.3「INFORMATION_SCHEMA クエリーの最適化」を参照してください。

注記

innodb_read_only システム変数が有効になっている場合、InnoDB を使用するデータディクショナリの統計テーブルを更新できないため、ANALYZE TABLE が失敗することがあります。 キー分散を更新する ANALYZE TABLE 操作では、操作によってテーブル自体が更新された場合でも (MyISAM テーブルの場合など)、障害が発生する可能性があります。 更新された分散統計を取得するには、information_schema_stats_expiry=0 を設定します。

TABLES テーブルには、次のカラムがあります:

  • TABLE_CATALOG

    テーブルが属するカタログの名前。 この値は常に def です。

  • TABLE_SCHEMA

    テーブルが属するスキーマ (データベース) の名前。

  • TABLE_NAME

    テーブルの名前。

  • TABLE_TYPE

    テーブルの場合は BASE TABLE、ビューの場合は VIEWINFORMATION_SCHEMA テーブルの場合は SYSTEM VIEW です。

    TABLES テーブルには、TEMPORARY テーブルはリストされません。

  • ENGINE

    このテーブルのストレージエンジン。 第15章「InnoDB ストレージエンジンおよび第16章「代替ストレージエンジンを参照してください。

    パーティション化されたテーブルの場合、ENGINE には、すべてのパーティションで使用されるストレージエンジンの名前が表示されます。

  • VERSION

    このカラムは未使用です。 MySQL 8.0 で .frm ファイルを削除すると、このカラムには、MySQL 5.7 で最後に使用された .frm ファイルバージョンである 10 のハードコードされた値がレポートされるようになりました。

  • ROW_FORMAT

    行ストレージフォーマット (FixedDynamicCompressedRedundantCompact)。 MyISAM テーブルの場合、Dynamic は、myisamchk -dvvPacked としてレポートする内容に対応します。

  • TABLE_ROWS

    行数。 MyISAM などの一部のストレージエンジンは、正確な数を格納します。 InnoDB などのほかのストレージエンジンの場合、この値は概算であり、実際の値と 40% から 50% まで異なる可能性があります。 このような場合、正確な数を取得するには SELECT COUNT(*) を使用します。

    TABLE_ROWS は、INFORMATION_SCHEMA テーブル用の NULL です。

    InnoDB テーブルの場合、行カウントは SQL 最適化で使用される単なる概算です。 (InnoDB テーブルがパーティション化されている場合も、これは当てはまります。)

  • AVG_ROW_LENGTH

    平均行長。

  • DATA_LENGTH

    MyISAM の場合、DATA_LENGTH はデータファイルの長さ (バイト単位) です。

    InnoDB の場合、DATA_LENGTH は、クラスタ化されたインデックスに割り当てられるおおよその容量 (バイト単位) です。 具体的には、クラスタ化されたインデックスサイズ (ページ単位) に InnoDB ページサイズを乗算したものです。

    その他のストレージエンジンについては、このセクションの最後にある注を参照してください。

  • MAX_DATA_LENGTH

    MyISAM の場合、MAX_DATA_LENGTH はデータファイルの最大長です。 これは、このテーブル内に格納できるデータの合計バイト数です (使用されるデータポインタサイズが指定された場合)。

    InnoDB では未使用です。

    その他のストレージエンジンについては、このセクションの最後にある注を参照してください。

  • INDEX_LENGTH

    MyISAM の場合、INDEX_LENGTH はインデックスファイルの長さ (バイト単位) です。

    InnoDB の場合、INDEX_LENGTH は、クラスタ化されていないインデックスに割り当てられる領域の概算量 (バイト単位) です。 具体的には、クラスタ化されていないインデックスサイズの合計 (ページ数) に InnoDB ページサイズを乗算した値です。

    その他のストレージエンジンについては、このセクションの最後にある注を参照してください。

  • DATA_FREE

    割り当てられているが、使用されていないバイト数。

    InnoDB テーブルは、このテーブルが属するテーブルスペースの空き領域をレポートします。 共有テーブルスペース内に存在するテーブルの場合、これはその共有テーブルスペースの空き領域です。 複数のテーブルスペースを使用していて、このテーブルに独自のテーブルスペースがある場合は、そのテーブルのみの空き領域になります。 空き領域とは、完全な空きエクステントから安全上のマージンを引いたバイト数を示します。 空き領域が 0 として表示されている場合でも、新しいエクステントを割り当てる必要がないかぎり、行を挿入できる可能性があります。

    NDB Cluster の場合、DATA_FREE は、ディスク上の「ディスクデータ」テーブルまたはフラグメント用にディスクに割り当てられたが使用されていない領域を表示します。 (メモリー内データリソース使用率は、DATA_LENGTH カラムによってレポートされます。)

    パーティション化されたテーブルの場合、この値は推定値にすぎず、絶対的に正しいとはかぎりません。 このような場合にこの情報を取得するより正確な方法は、次の例に示すように、INFORMATION_SCHEMA PARTITIONS テーブルをクエリーすることです:

    SELECT SUM(DATA_FREE)
        FROM  INFORMATION_SCHEMA.PARTITIONS
        WHERE TABLE_SCHEMA = 'mydb'
        AND   TABLE_NAME   = 'mytable';

    詳細は、セクション26.21「INFORMATION_SCHEMA PARTITIONS テーブル」を参照してください。

  • AUTO_INCREMENT

    次の AUTO_INCREMENT 値。

  • CREATE_TIME

    いつテーブルが作成されたか。

  • UPDATE_TIME

    いつデータファイルが最後に更新されたか。 一部のストレージエンジンでは、この値は NULL です。 たとえば、InnoDB はそのシステムテーブルスペース内に複数のテーブルを格納するため、データファイルのタイムスタンプは適用されません。 各 InnoDB テーブルが個別の .ibd ファイル内に存在する file-per-table モードの場合でも、変更バッファリングによってデータファイルへの書き込みが遅延される可能性があるため、ファイルの変更時間は最後の挿入、更新、または削除の時間とは異なります。 MyISAM の場合、データファイルのタイムスタンプが使用されますが、Windows ではタイムスタンプは更新によって更新されないため、値は正確ではありません。

    UPDATE_TIME には、パーティション化されていない InnoDB テーブルに対して最後に実行された UPDATEINSERT または DELETE のタイムスタンプ値が表示されます。 MVCC の場合、タイムスタンプ値は最終更新時間とみなされる COMMIT 時間を反映します。 タイムスタンプは、サーバーの再起動時、またはテーブルが InnoDB データディクショナリキャッシュから削除されたときに永続化されません。

  • CHECK_TIME

    いつテーブルが最後にチェックされたか。 すべてのストレージエンジンがこの時間を更新するわけではありません。この場合、値は常に NULL です。

    パーティション化された InnoDB テーブルの場合、CHECK_TIME は常に NULL です。

  • TABLE_COLLATION

    テーブルのデフォルトの照合。 出力にはテーブルのデフォルトの文字セットは明示的にリストされませんが、照合順序名は文字セット名で始まります。

  • CHECKSUM

    ライブチェックサム値 (存在する場合)。

  • CREATE_OPTIONS

    CREATE TABLE で使用される追加のオプション。

    CREATE_OPTIONS には、パーティションテーブルの partitioned が表示されます。

    MySQL 8.0.16 より前の CREATE_OPTIONS では、file-per-table テーブルスペースに作成されたテーブルに指定された ENCRYPTION 句が表示されます。 MySQL 8.0.16 では、テーブルが暗号化されている場合、または指定された暗号化がスキーマ暗号化と異なる場合、file-per-table テーブルスペースの暗号化句が表示されます。 暗号化句は、一般テーブルスペースに作成されたテーブルには表示されません。 暗号化された file-per-table および一般的なテーブルスペースを識別するには、INNODB_TABLESPACES ENCRYPTION カラムをクエリーします。

    strict mode を無効にしてテーブルを作成する場合、指定した行フォーマットがサポートされていないと、ストレージエンジンのデフォルトの行フォーマットが使用されます。 テーブルの実際の行形式は、ROW_FORMAT カラムにレポートされます。 CREATE_OPTIONS には、CREATE TABLE ステートメントで指定された行形式が表示されます。

    テーブルのストレージエンジンを変更する場合、新しいストレージエンジンに適用できないテーブルオプションはテーブル定義に保持され、必要に応じて、以前に定義されたオプションを持つテーブルを元のストレージエンジンに戻すことができます。 CREATE_OPTIONS カラムに保持オプションが表示される場合があります。

  • TABLE_COMMENT

    このテーブルを作成するときに使用されたコメント (または、MySQL がテーブル情報にアクセスできなかった理由に関する情報)。

メモ

  • NDB テーブルの場合、このステートメントの出力には AVG_ROW_LENGTH カラムと DATA_LENGTH カラムの適切な値が表示されますが、BLOB カラムは考慮されません。

  • NDB テーブルの場合、DATA_LENGTH にはメインメモリーに格納されているデータのみが含まれます。MAX_DATA_LENGTH および DATA_FREE カラムはディスクデータに適用されます。

  • 「NDB Cluster ディスクデータの場合」テーブル、MAX_DATA_LENGTH には、「ディスクデータ」テーブルまたはフラグメントのディスク部分に割り当てられた領域が表示されます。 (メモリー内データリソース使用率は、DATA_LENGTH カラムによってレポートされます。)

  • MEMORY テーブルの場合、DATA_LENGTHMAX_DATA_LENGTH および INDEX_LENGTH の値は、割り当てられたメモリーの実際の量を概算します。 割り当てアルゴリズムは、割り当て操作の数を減らすために、大量のメモリーを確保します。

  • ビューの場合、TABLE_NAME がビュー名を示し、CREATE_TIME が作成時間を示し、TABLE_COMMENTVIEW を示すことを除き、ほとんどの TABLES カラムは 0 または NULL です。

テーブル情報は、SHOW TABLE STATUS ステートメントおよび SHOW TABLES ステートメントからも入手できます。 セクション13.7.7.38「SHOW TABLE STATUS ステートメント」およびセクション13.7.7.39「SHOW TABLES ステートメント」を参照してください。 次のステートメントは同等です。

SELECT
    TABLE_NAME, ENGINE, VERSION, ROW_FORMAT, TABLE_ROWS, AVG_ROW_LENGTH,
    DATA_LENGTH, MAX_DATA_LENGTH, INDEX_LENGTH, DATA_FREE, AUTO_INCREMENT,
    CREATE_TIME, UPDATE_TIME, CHECK_TIME, TABLE_COLLATION, CHECKSUM,
    CREATE_OPTIONS, TABLE_COMMENT
  FROM INFORMATION_SCHEMA.TABLES
  WHERE table_schema = 'db_name'
  [AND table_name LIKE 'wild']

SHOW TABLE STATUS
  FROM db_name
  [LIKE 'wild']

次のステートメントは同等です。

SELECT
  TABLE_NAME, TABLE_TYPE
  FROM INFORMATION_SCHEMA.TABLES
  WHERE table_schema = 'db_name'
  [AND table_name LIKE 'wild']

SHOW FULL TABLES
  FROM db_name
  [LIKE 'wild']

関連キーワード:  テーブル, SCHEMA, INFORMATION, TABLE, INNODB, LENGTH, InnoDB, ストレージ, DATA, エンジン