前提條件

存在已登錄實(shí)例，請參見登錄實(shí)例。

進(jìn)入Query洞察

您可從HoloWeb的診斷與優(yōu)化頁面直接進(jìn)入Query洞察，也可通過HoloWeb的SQL編輯器或歷史慢 Query跳轉(zhuǎn)至Query洞察頁面。

1. 登錄Hologres管理控制臺。

2. 在頂部菜單欄左側(cè)，選擇相應(yīng)的地域。

3. 單擊前往HoloWeb，進(jìn)入HoloWeb開發(fā)頁面。

4. 進(jìn)入Query洞察頁面。

   直接進(jìn)入Query洞察

   在頂部選擇診斷與優(yōu)化，單擊左側(cè)的元倉分析 > Query洞察，進(jìn)入Query洞察頁面。

   跳轉(zhuǎn)Query洞察

   在HoloWeb中，SQL編輯器和歷史慢 Query也可以跳轉(zhuǎn)至Query洞察。跳轉(zhuǎn)方式如下：

   • SQL編輯器：如果SQL在HoloWeb的SQL編輯器中運(yùn)行，則執(zhí)行時(shí)間大于1 s、且含有Query ID的SQL可以直接跳轉(zhuǎn)至Query洞察。

   • 歷史慢 Query：在Query列表中，單擊目標(biāo)SQL操作列的圖標(biāo)可以跳轉(zhuǎn)至Query洞察。

   在Query洞察頁面，您可以查看Query元數(shù)據(jù)、Table元數(shù)據(jù)，及進(jìn)行Plan可視化和表鎖分析。

Query元數(shù)據(jù)

Query元數(shù)據(jù)來源于Hologres慢Query日志，默認(rèn)只采集執(zhí)行時(shí)間大于100 ms的DML和所有的DDL（查詢時(shí)僅能展示執(zhí)行時(shí)間大于1 s的DDL），且慢Query日志需要一定的權(quán)限才能查詢，詳情請參見慢Query日志查看與分析。您需要在Query元數(shù)據(jù)頁簽選擇對應(yīng)的實(shí)例名和Query ID，單擊查詢即可展示Query元數(shù)據(jù)。

• 基本信息

  展示Query所屬的實(shí)例ID、DB以及實(shí)例版本。

• Query信息

  展示Query的基本信息，采集自慢Query日志，包括執(zhí)行的用戶、執(zhí)行狀態(tài)、所用的執(zhí)行引擎等。

• 資源消耗

  展示Query運(yùn)行過程中的資源消耗情況，采集自慢Query日志，包括掃描函數(shù)、CPU消耗等。

• 其他信息

  Query的額外擴(kuò)展信息，采集自慢Query日志，包括Client IP等。

• SQL

  當(dāng)前的Query具體內(nèi)容，可以對Query進(jìn)行格式化（更加直觀友好的展示Query）以及復(fù)制Query。

• Query Detail

  Query如果是傳參數(shù)形式執(zhí)行，Query Detail將會采集出具體的參數(shù)值。可以選擇將參數(shù)合并到SQL里。

• 執(zhí)行計(jì)劃

  當(dāng)前Query的Plan，采集自慢Query日志的Plan字段，需要注意的是，僅執(zhí)行時(shí)間大于10 s的Query才會采集Plan。可以使用可視化功能跳轉(zhuǎn)至Plan可視化，通過圖形化的能力分析Plan，以便進(jìn)一步對Query調(diào)優(yōu)。Plan詳情請參見EXPLAIN和EXPLAIN ANALYZE。

• Statistics

  當(dāng)前Query的運(yùn)行信息，采集自慢Query日志的Statistics字段。會展示每個(gè)算子的詳細(xì)消耗信息，包括掃描的行數(shù)、算子耗時(shí)等?？梢愿鶕?jù)Statistics進(jìn)一步分析算子的消耗，以便進(jìn)一步對Query調(diào)優(yōu)。

• 讀寫表信息

  展示當(dāng)前Query涉及的表（讀或?qū)懀?，可以單擊?/p>

  • 表元數(shù)據(jù)：跳轉(zhuǎn)至表元數(shù)據(jù)頁面，查看當(dāng)前表的相關(guān)元數(shù)據(jù)。但需要注意表的元數(shù)據(jù)采集自hg_table_info表，默認(rèn)T+1日更新數(shù)據(jù)，如果表是當(dāng)天創(chuàng)建的，會查詢不到。

  • 表鎖分析：跳轉(zhuǎn)至表鎖分析頁面，可以查看當(dāng)前Query是否有鎖，僅會檢測DML相關(guān)的鎖。例如走Fixed Plan的SQL查詢變慢，可以使用表鎖分析查看表是否同時(shí)存在HQE（Hologres自研執(zhí)行引擎）的DML，導(dǎo)致Query耗時(shí)增加。

• DDL沖突分析

  展示當(dāng)前Query執(zhí)行的前后1min時(shí)間內(nèi)，涉及到的表是否產(chǎn)生了DDL操作，用于輔助判斷是否存在DDL沖突，導(dǎo)致Query失敗報(bào)錯：Query is canceled。

• 錯誤信息

  如果是失敗的Query，將顯示失敗原因的詳細(xì)信息。同時(shí)HoloWeb中Query洞察上線SQL智能診斷功能，會將新增的失敗原因和解決方案自動返回錯誤信息中，以方便您更好地處理錯誤SQL。更多常見的失敗SQL和解決方法可以參考Hologres SQL語句的常見問題。

Table元數(shù)據(jù)

Table元數(shù)據(jù)來源于Hologres的表統(tǒng)計(jì)信息日志系統(tǒng)表hg_table_info，每天凌晨采集匯報(bào)一次，T-1更新，因此當(dāng)天的Table元數(shù)據(jù)只能在第二天查詢。

使用Table元數(shù)據(jù)可以直接從Query元數(shù)據(jù)的表信息跳轉(zhuǎn)，即可查看表對應(yīng)的元數(shù)據(jù)。同時(shí)也可以手動輸入表的相關(guān)信息（所在實(shí)例名、數(shù)據(jù)庫、Schema）以及表的元數(shù)據(jù)收集時(shí)間，即可查看表對應(yīng)的元數(shù)據(jù)信息。

• 基本信息

  包含表名、是否分區(qū)，以及分區(qū)對應(yīng)的信息。

• 表元數(shù)據(jù)信息

  包含表的創(chuàng)建時(shí)間，收集時(shí)間，存儲量等信息。

• 表屬性信息

  展示當(dāng)前表設(shè)置的索引，包括PK、Distribution Key等。

• 表結(jié)構(gòu)信息

  展示當(dāng)前表的結(jié)構(gòu)，包含字段及字段類型、是否可空、有無Default值。

Plan可視化

Plan可視化用于將慢Query日志中的plan字段進(jìn)行可視化展示，但需要注意，僅運(yùn)行耗時(shí)超過10 s的Query才會采集plan信息。plan詳情請參見EXPLAIN和EXPLAIN ANALYZE。

表鎖分析

表鎖分析可以查詢當(dāng)前SQL是否產(chǎn)生HQE的DML（INSERT、UPDATE、DELETE）操作，用于輔助診斷SDK的SQL因?yàn)殒i而導(dǎo)致執(zhí)行慢的問題。如果同一時(shí)間內(nèi)，一個(gè)表同時(shí)存在SDK或HQE的Query和HQE的DML Query，則說明有鎖。建議盡量避免同一時(shí)間執(zhí)行兩種操作。

使用Query洞察排查常見問題

• 報(bào)錯：relation with OID xxx does not exist

  排查方法：通常是由于Query涉及到的表發(fā)生了TRUNCATE或DROP等操作，導(dǎo)致表的oid發(fā)生了變化。可以使用Query洞察查看報(bào)錯的Query ID，確認(rèn)同一時(shí)間是否存在DDL鎖。

• 報(bào)錯：query is canceled

  排查方法：當(dāng)前Query執(zhí)行的同一時(shí)間，涉及到的表執(zhí)行了TRUNCATE或DROP等DDL操作，導(dǎo)致報(bào)錯?？梢詫?bào)錯的Query ID輸入到Query洞察中進(jìn)行查詢，在Query元數(shù)據(jù)頁簽的DDL沖突分析區(qū)域可以看到表的DDL操作。

• SDK的SQL延遲高

  排查方法：如果SDK的SQL延遲較高，可以通過Query洞察查看是否同一時(shí)間表有HQE的SQL搶鎖，如下示例，一個(gè)SDK的SQL耗時(shí)18s，在讀寫表信息區(qū)域單擊表鎖分析。可查看到同一時(shí)間存在HQE的DML。HQE的DML是表鎖，會導(dǎo)致SDK的Query等鎖，從而出現(xiàn)耗時(shí)增加。若是不存在HQE的DML，則說明沒有表鎖，請前往優(yōu)化寫入和更新性能進(jìn)一步排查原因。