このページはCalíope 1.8を紹介しています。私がいま作っているバージョンです。1.7は、Mac、iPad、iPhone、Apple Watch、Apple TV、Apple Vision Pro向けにApp Storeで公開中です。それぞれの機能がどのバージョンで入ったかは変更履歴に書いてあります。

すべてのトピックに「Calíopeで開く」ボタンを追加します。アプリがインストールされている場合にのみ機能します。

テーブルメンテナンス

テーブルメンテナンス

選択したテーブルを、サーバにある操作で分析、チェック、最適化、修復します。

場所: ワークスペース › ツール › テーブルメンテナンス

ワークスペースのサイドバーから「テーブルメンテナンス」を開きます。左のツリーでテーブルを選び(データベースのチェックボックスでそのテーブルをすべて選べます。1つずつチェックしてもかまいません)、上で操作(「ANALYZE」、「CHECK」、「CHECKSUM」、「OPTIMIZE」、「REPAIR」)を選んで「実行」を押します。ボタンの横に、選択中のテーブル数が表示されます。

結果は下に表示され、サーバが各テーブルについて返すメッセージごとに1行になります:警告はオレンジ、エラーは赤で強調されます。InnoDBでは、OPTIMIZEは注記で答えます:代わりにテーブルを再構築して分析します。CHECKSUMはテーブルごとに1つの数値を返し、2台のサーバで同じ数値なら行も同じです。REPAIRは、ストレージエンジンが自分で修復できるテーブル(MyISAM、Aria、ARCHIVE、CSV)でしか実行されません。実行する前に、修飾子の下の行に、選択したテーブルのうち何個がスキップされるかが表示され、それぞれに理由を述べる行が付きます。InnoDBでは、その行はテーブルを再構築するOPTIMIZEを勧めます。Macでは列の見出しをクリックすると結果を並べ替えられ、「結果を消去」でリストが空になります。操作の実行中は、「実行」の横に進行状況バーと「キャンセル」が表示されます。テーブルは1つずつ処理されるので、キャンセルすると次のテーブルの前で止まります。

ツリーの見出しには、SQLエディタと同じ「名前でフィルタ」があります:データベース名やテーブル名の一部を入力すると、リストが絞り込まれます。各データベースは最初に展開したときにテーブルを読み込むので、まだ展開していないデータベースがある状態でフィルタすると、フッターに足りない数が表示され、読み込むよう提案されます。「すべてを選択」は、サーバ自身のシステムデータベースを除くサーバ上のすべてのデータベースを対象にします(システムデータベースは手でチェックできます)。数秒かかることがあります。サーバがあるテーブルでの操作を拒否した場合、そのテーブルにはサーバのメッセージを載せたエラーの行が付きます。

SQL Server

操作は4つです:ANALYZE(UPDATE STATISTICS)、CHECK(DBCC CHECKTABLE)、OPTIMIZE(ALTER INDEX ALL … REBUILD)、CHECKSUM(テーブル全体に対するCHECKSUM_AGG(BINARY_CHECKSUM(*)))。チェックサムはtext、ntext、image、xmlの列と、geometryのような型の列を無視し、結果の隣にそれらの名前が出ます。そこだけが違う2つのテーブルは同じチェックサムになります。パーティション構成上のテーブルでは、1つのパーティションだけを再構築することもできます。REPAIRはありません。データベースをシングルユーザモードにする必要があり、データを失うことがあるからです。OPTIMIZEは再構築のあいだテーブルをロックします。オンラインでの再構築はEnterpriseエディションにしかなく、空間インデックスでは使えません。

PostgreSQL

操作は3つです:ANALYZE、VACUUMのあとにREINDEX TABLE CONCURRENTLYを実行するOPTIMIZE(テーブルごとに2行を返します)、そしてamcheck拡張機能を使うCHECK(各Bツリーインデックスにbt_index_check、14からはテーブルにverify_heapam)。拡張機能がなければ、CHECKはCREATE EXTENSION amcheck付きの注記を返します。どれもテーブルを止めません。REPAIRとCHECKSUMはありません。システムに容量を返す唯一のVACUUM FULLは、書き直すあいだテーブル全体をロックするため、意図的に外しています。12より古いサーバでは、OPTIMIZEはVACUUMで止まり、インデックスの行にその理由が表示されます。

ClickHouse

ClickHouseでは操作は3つです:テーブルのパートごとに1行を返すCHECK、パートをマージするOPTIMIZE、そしてオプティマイザがフィルタの順序を決めるのに使う列の統計情報を計算するANALYZE(数値と日付の列にはtdigestとuniq、テキストの列にはuniqでADD STATISTICSし、終わるまで待つMATERIALIZE STATISTICS)。ArrayとMapは統計情報を取らず、受け付ける列のないテーブルはそう伝えます。REPAIRとCHECKSUMはエンジンになく、表示されません。テーブルを1つだけチェックすると「パーティション」が表示され、テーブル全体ではなく1つのパーティションを最適化できます。

Oracle

Oracleでは操作は3つです。ANALYZEはDBMS_STATS.GATHER_TABLE_STATSでテーブルとそのインデックスの統計情報を収集し、結果の行には統計情報が数える行数と収集した日時が表示されます。別のスキーマのテーブルに対する権限がなければ、収集できなかったと表示され、その下にサーバのメッセージが付きます。CHECKはANALYZE TABLE … VALIDATE STRUCTURE CASCADE ONLINEで、書き込みをブロックせずにテーブルとそのインデックスを確かめます。パーティション化したテーブルではCASCADE FASTを実行し、破損があるかどうかを詳細なしで伝えます。完全な形には自分のスキーマにINVALID_ROWSテーブルが必要だからです。OPTIMIZEはALTER TABLE … SHRINK SPACE CASCADEで、テーブルとそのインデックスをオンラインで詰め、空き領域を返します。テーブルにROW MOVEMENTがなければ、Calíopeは操作の間それをオンにし、またオフに戻します。テーブルがSHRINKを受け付けなければ(ORA-10631またはORA-10635:ファンクションインデックス、上にあるON COMMITのマテリアライズドビュー、ASSMのない表領域)、CalíopeはMOVE ONLINEで書き直し、行にそう表示します。パーティション化したテーブルではパーティションを選べます(MODIFY PARTITION … SHRINK SPACE CASCADE)。REPAIRとCHECKSUMはありません。Oracleにはテーブル単位のそうした操作がないからです。「キャンセル」は処理中のテーブルも中断します:サーバがその文を止め(ORA-01013)、そのテーブルにはリストの行が付きません。

TiDB

TiDBでは操作は2つです:ANALYZEと、ADMIN CHECK TABLE(インデックスと行を照合します)をテーブルごとに実行するCHECK。何も見つからなければ、行にはテーブルに問題がないと表示されます。何か見つかれば、インデックスの名前を挙げたサーバのメッセージがそこに入ります。REPAIR、CHECKSUM、OPTIMIZEはありません:TiDBにはなく(ストレージが自分で圧縮します)、提示されません。

読み出し専用の環境タグがあると、このツールは提示されません。書き込みを確認する環境タグでは、ANALYZE、OPTIMIZE、REPAIRはバッチごとに一度確認を求めます。読み取りだけのCHECKとCHECKSUMは確認を求めません。

MySQLMariaDBAurora

テーブルを1つだけチェックすると、OPTIMIZEでそのパーティションの1つを選べます。CalíopeはREBUILD PARTITIONで再構築し、ANALYZE PARTITIONで分析します。InnoDBではOPTIMIZE PARTITIONがテーブル全体を再構築してしまうからです。この操作は、それを避ける修飾子にチェックを入れてもバイナリログに書かれます。ALTER TABLEがそれを受け付けないからです。

キーワード: ANALYZE、CHECK、OPTIMIZE、REPAIR、メンテナンス、CHECKSUM

操作の修飾子

操作の動作を変える追加のオプション。

場所: テーブルメンテナンス › 修飾子のグリッド

操作の下には修飾子のグリッドがあります:「LOCAL(binlogなし)」、FOR UPGRADE、QUICK、FAST、MEDIUM、EXTENDED、CHANGED、USE_FRM。各操作は受け付けるものだけを有効にし、操作を変えると選択は消去されます。たとえば、QUICKは不正なリンクを探して行を走査しないことでCHECKを速くし、FOR UPGRADEは現在のサーバのバージョンとの互換性をチェックし、LOCALはANALYZE、OPTIMIZE、REPAIRをバイナリログに残さないので、レプリカはそれを繰り返しません。CHECKSUMでは、QUICKはテーブルが常時保持しているチェックサムだけを報告し、ほとんどのテーブルは保持していません。USE_FRMはMyISAMテーブルのインデックスを定義から再構築します。最後の手段です。

グリッドには、エンジンにある修飾子だけが表示されます。SQL Serverでは、CHECKはPHYSICAL_ONLY(構造だけで、より速い)とEXTENDED_LOGICAL_CHECKSを受け付けます。PostgreSQLでは、OPTIMIZEがFREEZE、SKIP_LOCKED、INDEX_CLEANUP OFF(後の2つは12から)を、ANALYZEがSKIP_LOCKEDを受け付けます。SKIP_LOCKEDは、ほかの誰かがロックしているテーブルを待たずに飛ばします。

ClickHouse

ClickHouseでは修飾子は3つで、3つともOPTIMIZE用、初期状態はオフです。FINALはテーブル(またはパーティション)を1つのパートにまとめることを強制し、チェックすると、数時間かかり2倍のディスクが必要になりうるという警告が表示されます。DEDUPLICATEはすべての列が同じ行を取り除き、常にFINALと一緒に使います。FINALなしでは、サーバがいずれマージするはずだったものしか重複を除きません。CLEANUPは削除フラグの列を持つReplacingMergeTree用で、削除の印が付いた行を捨てます。テーブルが独自の設定でそれを許可している必要があり、そのエンジンでないか許可していなければ、結果の行に理由が表示され、何も送られません。

Oracle

Oracleでは3つです。CHECKのFASTは、パーティションのないテーブルでもCASCADE FASTを求めます。OPTIMIZEのMOVE ONLINEは、詰める代わりにセグメント全体を書き直し(ALTER TABLE … MOVE ONLINE、またはMOVE PARTITION … ONLINE)、インデックスは使える状態のままです。ANALYZEのNO_INVALIDATEは、古い統計情報をすでに使っているカーソルを生かしておきます(no_invalidate => TRUE)。

TiDB

TiDBには修飾子がなく、このセクションは描画されません。

SQL Server

SQL Serverでは、CHECKSUMに修飾子はありません。チェックサムはテーブル全体を対象にします。

キーワード: QUICK、EXTENDED、FOR UPGRADE、LOCAL、修飾子