NAME

       ANALYZE - 收集與數據庫有關的統計

SYNOPSIS

       ANALYZE [ VERBOSE ] [ table [ (column [, ...] ) ] ]

DESCRIPTION 描述

       ANALYZE    收集有關    PostgreSQL    表的內容的統計，然後把結果保存在系統表   pg_statistic
       裏。隨後，查詢規劃器就可以使用這些統計幫助判斷查詢的最有效的規劃。

        如果沒有參數，ANALYZE  檢查在當前數據庫裏的所有表。  如果有參數，ANALYZE   只檢查那個表。
       你還可以給出一列字段名字，這個時候只收集那些字段的統計信息。

PARAMETERS 參數

       VERBOSE
               打開處理過程信息的顯示。

       table
               要分析的特定表（可能用模式名修飾）的名字。缺省是當前數據庫裏所有表。

       column
               要分析的特定字段的名字。缺省是所有字段。

OUTPUTS 輸出

        如果聲明瞭            VERBOSE，ANALYZE           發出進度信息，表明當前正在處理的是哪行。
       同時打印有關改表的很多其它信息。

NOTES 注意

        週期性地運行            ANALYZE，或者在對錶的大部分內容做了更改之後馬上運行它是個好習慣，
       準確的統計信息將幫助規劃器選擇最合適的查詢規劃，並因此而改善查詢處理的速度。
       一種比較經常採用的策略是每天在低負荷的時候運行一次 VACUUM [vacuum(7)] 和 ANALYZE。

        和      VACUUM      FULL      不同的是，      ANALYZE      只需要在目標表上有一個讀取鎖，
       因此它可以和表上的其它活動並行地運行。

        收集的統計信息通常包括一個每字段最常用數值的列表以及一個包線圖，顯示每個字段裏數據的近似分佈。
       如果                            ANALYZE                             認爲它們都沒有什麼用，
       （比如，在一個唯一鍵字的字段上沒有公共的數值）或者是該字段數據類型不支持相關的操作符，
       那麼它們都可以忽略。在     Chapter      21      ``Routine      Database      Maintenance''
       中有關於統計的更多信息。

        對於大表，ANALYZE                    採集表內容的一個隨機的抽樣做統計，而不是檢查每一行。
       這樣就保證了即使是在很大的表上，我們也只需要很少的一些時間就可以完成分析。
       不過，要注意的是統計只是近似的結果，而且每次運行ANALYZE都會導致                    EXPLAIN
       顯示的規劃器的預期開銷有一些小變化，
       即使表內容實際上沒有改變也這樣。在很小的概率的情況下，這個不確定的行爲會導致查詢優化器在不同
       ANALYZE             之間選擇不同的查詢規劃。爲了避免這個問題，可以提高             ANALYZE
       收集的統計數量，像下面描述的那樣。

        分析的廣度可以通過用調整  default_statistics_target  參變量，  或者是以每字段爲基礎通過用
       ALTER TABLE ... ALTER COLUMN ... SET STATISTICS  （參閱   ALTER  TABLE  [alter_table(7)]）
       設置每字段的統計目標來控制。目標數值設置最常用數值列表中的記錄的最大數目以及包線圖中的最大塊數。
       缺省的目標數值是         10，不過我們可以調節這個數值獲取規劃器計算精度和          ANALYZE
       運行所需要的時間以及              pg_statistic              裏面佔據的空間數目之間的平衡。
       特別是，把統計目標設置爲零就關閉了該字段的統計收集。        這麼做對那些從來不參與到查詢的
       WHERE，GROUP                     BY，或者                     ORDER                     BY
       子句裏的字段是很有用的，因爲規劃器不會使用到這樣的字段上的統計。

        在被分析的字段中最大的統計目標決定爲統計採樣的表中的行的數目。  增大目標會導致做  ANALYZE
       的時候成比例地增大對時間和空間的需求。

COMPATIBILITY 兼容性

       SQL 標準裏沒有 ANALYZE 語句。

譯者

       Postgresql 中文網站 何偉平 <laser@pgsqldb.org>

跋

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh