pt-stat-snapshot

概要

統計情報のスナップショットを取得、保存、管理します。

実行方法

pt-stat-snapshot [option...] install
pt-stat-snapshot [option...] uninstall
pt-stat-snapshot [option...] create [level]
pt-stat-snapshot [option...] list
pt-stat-snapshot [option...] delete [sid]
pt-stat-snapshot [option...] export [file]
pt-stat-snapshot [option...] import [file]

コマンド

install 動作に必要なスキーマ、テーブルや関数の作成などを行います。    
uninstall 関連するスキーマ、テーブルや関数などを削除します。    
create [level] スナップショットを取得します。レベルには 1 2 4 のいずれかを指定できます。
list 保存されているスナップショットの一覧を表示します。    
delete [sid] 指定したスナップショットIDのスナップショットを削除します。 M:N のように記述することで範囲指定することが可能です。    
export [file] 指定したファイルにスナップショットデータをエクスポートします。    
import [file] 指定したファイルからスナップショットデータをインポートします。    

オプション

-h, --host=HOSTNAME
-p, --port=PORT
-U, --username=USERNAME
-d, --dbname=DBNAME
--help

-h, --host オプションは、接続するPostgreSQLデータベースのサーバ名またはIPアドレスを指定します。オプションが指定されない場合は、PGHOST環境変数に設定された値が使われます。PGHOST環境変数が設定されていない場合には、デフォルトの値として localhost が使われます。

-p, --port オプションは、接続するPostgreSQLデータベースのポート番号を指定します。オプションが指定されない場合は、PGPORT環境変数に設定された値が使われます。PGPORT環境変数が設定されていない場合には、デフォルトの値として 5432 が使われます。

-U, --username オプションは、PostgreSQLデータベースに接続するユーザ名を指定します。オプションが指定されない場合は、PGUSER環境変数に設定された値が使われます。PGUSER環境変数が設定されていない場合には、USER環境変数に設定された値が使われます。

-d, --dbname オプションは、接続するデータベース名を指定します。オプションが指定されない場合は、PGDATABASE環境変数に設定された値が使われます。PGDATABASE環境変数が設定されていない場合には、データベースに接続するユーザ名と同じ名前のデータベースに接続します。

出力項目

list コマンドで表示される項目は以下の通りです。

SID スナップショットID（スナップショットを取得するごとに単調増加する整数値）
TIMESTAMP スナップショットを取得したタイムスタンプ
LEVEL スナップショットレベル

実行例

動作に必要なスキーマ、テーブル、関数を testdb データベースにインストールします。

$ pt-stat-snapshot -h 127.0.0.1 -U postgres -d testdb install
[2015-03-31 17:21:37] INFO: Succeeded to install pgperf snapshot.
$

スナップショットレベル4でスナップショットを取得します。

$ pt-stat-snapshot -h 127.0.0.1 -U postgres -d testdb create 4
[2015-03-31 17:21:47] INFO: Succeeded to take a snapshot.
$

スナップショットの一覧を表示します。

$ pt-stat-snapshot -h 127.0.0.1 -U postgres -d testdb list
+-----+---------------------+-------+
| SID |      TIMESTAMP      | LEVEL |
+-----+---------------------+-------+
|   0 | 2015-03-31 17:21:47 |     1 |
+-----+---------------------+-------+
$

関連するスキーマ、テーブル、関数を testdb データベースからアンインストールします。

$ pt-stat-snapshot -h 127.0.0.1 -U postgres -d testdb uninstall
[2015-03-31 17:21:59] INFO: Succeeded to uninstall pgperf snapshot.
$

pgperf-snapshotモジュールについて

pt-stat-snapshot コマンドは、その内部で旧 pgperf-snapshot モジュールを使っています。

pgperf-snapshotモジュールについての詳細は、以下のドキュメントを参照してください。