| |
| pt-stat-snapshot |
| ================ |
| |
| 概要 |
| ---- |
| |
| 統計情報のスナップショットを取得、保存、管理します。 |
| |
| |
| 実行方法 |
| -------- |
| |
| .. code-block:: none |
| |
| 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] |
| |
| コマンド |
| -------- |
| |
| .. csv-table:: |
| |
| ``install``, 動作に必要なスキーマ、テーブルや関数の作成などを行います。 |
| ``uninstall``, 関連するスキーマ、テーブルや関数などを削除します。 |
| ``create [level]``, スナップショットを取得します。レベルには ``1``, ``2``, ``4`` のいずれかを指定できます。 |
| ``list``, 保存されているスナップショットの一覧を表示します。 |
| ``delete [sid]``, 指定したスナップショットIDのスナップショットを削除します。 ``M:N`` のように記述することで範囲指定することが可能です。 |
| ``export [file]``, 指定したファイルにスナップショットデータをエクスポートします。 |
| ``import [file]``, 指定したファイルからスナップショットデータをインポートします。 |
| |
| |
| オプション |
| ---------- |
| |
| .. code-block:: none |
| |
| -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`` コマンドで表示される項目は以下の通りです。 |
| |
| .. csv-table:: |
| |
| ``SID``, スナップショットID(スナップショットを取得するごとに単調増加する整数値) |
| ``TIMESTAMP``, スナップショットを取得したタイムスタンプ |
| ``LEVEL``, スナップショットレベル |
| |
| 実行例 |
| ------ |
| |
| 動作に必要なスキーマ、テーブル、関数を ``testdb`` データベースにインストールします。 |
| |
| .. code-block:: none |
| |
| $ 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でスナップショットを取得します。 |
| |
| .. code-block:: none |
| |
| $ 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. |
| $ |
| |
| スナップショットの一覧を表示します。 |
| |
| .. code-block:: none |
| |
| $ 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`` データベースからアンインストールします。 |
| |
| .. code-block:: none |
| |
| $ 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モジュールについての詳細は、以下のドキュメントを参照してください。 |
| |
| .. toctree:: |
| :maxdepth: 2 |
| |
| pgperf_overview.rst |
| pgperf_intro.rst |
| pgperf_functions.rst |
| pgperf_tables.rst |