doc/objects-ja.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD html 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4 <title>pg_dbms_stats</title>
   5 <link rel="home" title="pg_dbms_stats" href="index.html">
   6 <link rel="stylesheet" TYPE="text/css"href="style.css">
   7 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   8 </head>
   9
  10 <body>
  11 <h1 id="pg_dbms_stats">pg_dbms_stats-1.3.9</h1>
  12 <div class="navigation">
  13   <a href="pg_dbms_stats-ja.html">pg_dbms_stats</a> &gt;
  14   <a href="objects-ja.html">Appendix A. オブジェクト一覧</a>
  15 </div>
  16
  17 <div class="index">
  18 <ol>
  19 <li><a href="#functions">関数</a></li>
  20 <li><a href="#table">テーブル</a></li>
  21 <li><a href="#view">ビュー</a></li>
  22 </ol>
  23 </div>
  24
  25 <h2 id="functions">関数</h2>
  26 <p>
  27 pg_dbms_stats は下記の関数を含みます。
  28 <br>
  29 <p>各関数の意味は以下の通りです。</p>
  30 <table>
  31 <thead>
  32 <tr>
  33 <tr><th>機能</th><th>関数</th><th>引数</th><th>オブジェクト単位</th><th>戻り値</th></tr>
  34 </tr>
  35 </thead>
  36 <tbody>
  37 <tr><td rowspan="6" nowrap>バックアップ</td>
  38   <td nowrap>dbms_stats.backup_database_stats</td>
  39   <td nowrap>comment</td>
  40   <td nowrap>データベース</td>
  41   <td rowspan="6">int8</td></tr>
  42 <tr><td nowrap>dbms_stats.backup_schema_stats</td>
  43   <td nowrap>schemaname、comment</td>
  44   <td>スキーマ</td></tr>
  45 <tr><td rowspan="2" nowrap>dbms_stats.backup_table_stats</td>
  46   <td nowrap>relname、comment</td>
  47   <td rowspan="2">テーブル</td></tr>
  48 <tr><td nowrap>schemaname、tablename、comment</td></tr>
  49 <tr><td rowspan="2" nowrap>dbms_stats.backup_column_stats</td>
  50   <td nowrap>relname、attname、comment</td>
  51   <td rowspan="2">列</td></tr>
  52 <tr><td nowrap>schemaname、tablename、attname、comment</td></tr>
  53 <tr><td rowspan="7" nowrap>リストア</td>
  54   <td nowrap>dbms_stats.restore_database_stats</td>
  55   <td nowrap>timestamp</td>
  56   <td nowrap>データベース</td>
  57   <td rowspan="7">regclass</td></tr>
  58 <tr><td nowrap>dbms_stats.restore_schema_stats</td>
  59   <td nowrap>schemaname、timestamp</td>
  60   <td>スキーマ</td></tr>
  61 <tr><td rowspan="2" nowrap>dbms_stats.restore_table_stats</td>
  62   <td nowrap>relname、timestamp</td>
  63   <td rowspan="2">テーブル</td></tr>
  64 <tr><td nowrap>schemaname、tablename、timestamp</td></tr>
  65 <tr><td rowspan="2" nowrap>dbms_stats.restore_column_stats</td>
  66   <td nowrap>relname、attname、timestamp</td>
  67   <td rowspan="2">列</td></tr>
  68 <tr><td nowrap>schemaname、tablename、attname、timestamp</td></tr>
  69 <tr><td nowrap>dbms_stats.restore_stats</td>
  70   <td nowrap>backup_id</td>
  71   <td>バックアップ</td></tr>
  72 <tr><td rowspan="6" nowrap>ロック</td>
  73   <td nowrap>dbms_stats.lock_database_stats</td>
  74   <td nowrap>(なし)</td>
  75   <td nowrap>データベース</td>
  76   <td rowspan="6">regclass</td></tr>
  77 <tr><td nowrap>dbms_stats.lock_schema_stats</td>
  78   <td nowrap>schemaname</td>
  79   <td>スキーマ</td></tr>
  80 <tr><td rowspan="2" nowrap>dbms_stats.lock_table_stats</td>
  81   <td nowrap>relname</td>
  82   <td rowspan="2">テーブル</td></tr>
  83 <tr><td nowrap>schemaname、tablename</td></tr>
  84 <tr><td rowspan="2" nowrap>dbms_stats.lock_column_stats</td>
  85   <td nowrap>relname、attname</td>
  86   <td rowspan="2">列</td></tr>
  87 <tr><td nowrap>schemaname、tablename、attname</td></tr>
  88 <tr><td rowspan="6" nowrap>ロック解除</td>
  89   <td nowrap>dbms_stats.unlock_database_stats</td>
  90   <td nowrap>(なし)</td>
  91   <td nowrap>データベース</td>
  92   <td rowspan="6">regclass</td></tr>
  93 <tr><td nowrap>dbms_stats.unlock_schema_stats</td>
  94   <td nowrap>schemaname</td>
  95   <td>スキーマ</td></tr>
  96 <tr><td rowspan="2" nowrap>dbms_stats.unlock_table_stats</td>
  97   <td nowrap>relname</td>
  98   <td rowspan="2">テーブル</td></tr>
  99 <tr><td nowrap>schemaname、tablename</td></tr>
 100 <tr><td rowspan="2" nowrap>dbms_stats.unlock_column_stats</td>
 101   <td nowrap>relname、attname</td>
 102   <td rowspan="2">列</td></tr>
 103 <tr><td nowrap>schemaname、tablename、attname</td></tr>
 104 <tr><td rowspan="6" nowrap>インポート</td>
 105   <td nowrap>dbms_stats.import_database_stats</td>
 106   <td nowrap>src</td>
 107   <td nowrap>データベース</td>
 108   <td rowspan="6">void</td></tr>
 109 <tr><td nowrap>dbms_stats.import_schema_stats</td>
 110   <td nowrap>schemaname、src</td>
 111   <td>スキーマ</td></tr>
 112 <tr><td rowspan="2" nowrap>dbms_stats.import_table_stats</td>
 113   <td nowrap>relname、src</td>
 114   <td rowspan="2">テーブル</td></tr>
 115 <tr><td nowrap>schemaname、tablename、src</td></tr>
 116 <tr><td rowspan="2" nowrap>dbms_stats.import_column_stats</td>
 117   <td nowrap>relname、attname、src</td>
 118   <td rowspan="2">列</td></tr>
 119 <tr><td nowrap>schemaname、tablename、attname、src</td></tr>
 120 <tr><td nowrap>パージ</td>
 121   <td nowrap>dbms_stats.purge_stats</td>
 122   <td nowrap>backup_id、force</td>
 123   <td>バックアップ</td>
 124   <td>dbms_stats.backup_history</td></tr>
 125 <tr><td nowrap>クリーンアップ</td>
 126   <td nowrap>dbms_stats.clean_up_stats</td>
 127   <td nowrap>(なし)</td>
 128   <td nowrap>データベース</td>
 129   <td>text</td></tr>
 130 </tbody>
 131 </table>
 132
 133 <p>各関数で用いられている引数の意味は以下の通りです。</p>
 134 <table>
 135 <thead>
 136 <tr>
 137 <tr><th>引数</th><th>データ型</th><th>意味</th></tr>
 138 </tr>
 139 </thead>
 140 <tbody>
 141 <tr><td nowrap>schemaname</td>
 142   <td nowrap>text</td>
 143   <td>処理対象のスキーマ名です。</td></tr>
 144 <tr><td nowrap>relname</td>
 145   <td nowrap>regclass</td>
 146   <td>処理対象のテーブル名です。ただし、(スキーマ名).(テーブル名) という形になります。</td></tr>
 147 <tr><td nowrap>tablename</td>
 148   <td nowrap>text</td>
 149   <td>処理対象のテーブル名です。</td></tr>
 150 <tr><td nowrap>attname</td>
 151   <td nowrap>text</td>
 152   <td>処理対象の列名です。</td></tr>
 153 <tr><td nowrap>comment</td>
 154   <td nowrap>text</td>
 155   <td>バックアップを識別するためのコメントです。</td></tr>
 156 <tr><td nowrap>as_of_timestamp</td>
 157   <td nowrap>timestamptz</td>
 158   <td>リストアしたいタイミングの基準になるタイムスタンプです。このタイムスタンプ以前で最新のバックアップデータをリストアします。該当するバックアップが存在しない場合、統計情報は現在プランナが見ている値から変更されません。</td></tr>
 159 <tr><td nowrap>src</td>
 160   <td nowrap>text</td>
 161   <td>インポート対象のファイルの絶対パスです。</td></tr>
 162 <tr><td nowrap>backup_id</td>
 163   <td nowrap>bigint</td>
 164   <td>リストアやパージの対象となるバックアップIDです。
 165 リストアの場合、一致するバックアップIDのバックアップデータをリストアします。
 166 パージの場合、一致するバックアップID以前のバックアップを削除します。
 167 </td></tr>
 168 <tr><td nowrap>force</td>
 169   <td nowrap>bool</td>
 170   <td>パージするとき、バックアップを強制的に削除するかを決める変数です。
 171 trueの場合、対象範囲のバックアップを全て削除します。
 172 falseの場合、対象範囲外にデータベース単位のバックアップデータが存在しなければ、警告メッセージを出力して処理を中断します。
 173 デフォルトはfalseです。
 174 </td></tr>
 175 </tbody>
 176 </table>
 177 <p>また、統計情報のエクスポート機能は、SQLファイルで実装しています。
 178 <br>
 179 各SQLファイルの意味は以下の通りです。なお、出力ファイル名のデフォルトはexport_stats.dmpです。</p>
 180 <table>
 181 <thead>
 182 <tr>
 183 <tr><th>ファイル名</th><th>対象統計情報</th><th>備考</th></tr>
 184 </tr>
 185 </thead>
 186 <tbody>
 187 <tr><td nowrap>export_effective_stats.&lt;PGバージョン&gt;.sql.sample</td>
 188   <td nowrap>プランナが見ている統計情報</td>
 189   <td>-</td></tr>
 190 <tr>
 191   <td nowrap>export_plain_stats-&lt;PGバージョン&gt;.sql.sample</td>
 192   <td nowrap>真の統計情報のみ</td>
 193   <td>pg_dbms_stats未インストールでも使用可能です。</td></tr>
 194 </tbody>
 195 </table>
 196
 197 <h2 id="table">テーブル</h2>
 198 <p>pg_dbms_statsは以下のテーブルを含みます。</p>
 199 <p>各テーブルの意味は以下の通りです。</p>
 200 <table>
 201 <thead>
 202 <tr>
 203 <tr><th>テーブル名</th><th>列名</th><th>データ型</th><th>意味</th></tr>
 204 </tr>
 205 </thead>
 206 <tbody>
 207 <tr><td rowspan="4" nowrap>dbms_stats.backup_history</td>
 208   <td nowrap>id</td>
 209   <td nowrap>int8</td>
 210   <td>バックアップ時に付与されたバックアップIDです。</td></tr>
 211 <tr><td nowrap>time</td>
 212   <td nowrap>timestamptz</td>
 213   <td>バックアップ時のタイムスタンプです。</td></tr>
 214 <tr><td nowrap>unit</td>
 215   <td nowrap>char(1)</td>
 216   <td>バックアップ時のオブジェクト単位です。<br>
 217 d:データベース、s:スキーマ、t:テーブル、c:列</td></tr>
 218 <tr><td nowrap>comment</td>
 219   <td nowrap>text</td>
 220   <td>バックアップ時に指定したコメントです。</td></tr>
 221 </tbody>
 222 </table>
 223
 224 <h2 id="view">ビュー</h2>
 225 <p>pg_dbms_stats は下記のビューを含みます。</p>
 226 <p>各ビューの意味は以下の通りです。</p>
 227 <table>
 228 <thead>
 229 <tr>
 230 <tr><th>ビュー名</th><th>意味</th></tr>
 231 </tr>
 232 </thead>
 233 <tbody>
 234 <tr><td nowrap>dbms_stats.relation_stats_effective</td>
 235   <td>プランナに見せるテーブルごとの統計情報を表示します。PostgreSQLのpg_classカタログに対応します。</td></tr>
 236 <tr><td nowrap>dbms_stats.column_stats_effective</td>
 237   <td>プランナに見せる列ごとの統計情報を表示します。PostgreSQLのpg_statisticカタログに対応します。</td></tr>
 238 <tr><td nowrap>dbms_stats.stats</td>
 239   <td>プランナに見せる列ごとの統計情報のうち、ユーザが読み取り可能なものを表示します。PostgreSQLのpg_statsビューに対応します。</td></tr>
 240 </tbody>
 241 </table>
 242
 243 <h2 id="seealso">関連項目</h2>
 244 <a href="http://www.postgresql.jp/document/current/html/app-psql.html">psql</a>,
 245 <a href="http://www.postgresql.jp/document/current/html/app-vacuumdb.html">vacuumdb</a>
 246
 247 <hr />
 248 <p class="footer">Copyright (c) 2009-2017, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
 249
 250 </body>
 251 </html>