[Troubleshoot SQL with SAP HANA Database Explorer](https://developers.sap.com/tutorials/hana-dbx-troubleshooting.html#e904b470-079e-44e1-9891-61c99ea2fa3c)

偵錯程式可用於幫助查詢過程、函式或匿名塊中的問題。 以下步驟演示瞭如何使用偵錯程式來除錯過程。

選中某個儲存過程，右鍵，選擇 Open for debugging：

![](https://img-blog.csdnimg.cn/img_convert/99ae9265ed12091a18e1002fa5941d3e.png)

從偵錯程式附加選項對話方塊中，確保選擇了 SQL 控制檯連線。
![](https://img-blog.csdnimg.cn/img_convert/e510bc65bf583599b184be5d37622fc1.png)

透過單擊行號旁邊的在過程中設定斷點。 行號旁邊將出現一個複選標記，表示已設定斷點。
![](https://img-blog.csdnimg.cn/img_convert/ac54b56312d15fed8ef5140744e75ee1.png)

在資料庫瀏覽器中右鍵單擊需要除錯的儲存過程，然後選擇 Generate Call Statement 或 Generate Call Statement with UI。

![](https://img-blog.csdnimg.cn/img_convert/4e5502f119303908182093ef0204688e.png)

該過程的呼叫語句將在新的 SQL 控制檯中開啟。 提供輸入引數值，例如 10，然後執行該語句。
![](https://img-blog.csdnimg.cn/img_convert/2babe484be90ab23c37a1982995ae448.png)

當斷點觸發時，執行將暫停。
![](https://img-blog.csdnimg.cn/img_convert/b00a33b2c6cd3570cc0b2624a13ccdcb.png)

可以檢查使用的任何變數的當前值。 可以透過單擊上面突出顯示的編輯按鈕來修改某些區域性和全域性變數型別的值。

![](https://img-blog.csdnimg.cn/img_convert/01b83d930424f73fdd36f879f49f2525.png)

可以使用偵錯程式頂部的導航圖示繼續執行。 可以使用分離圖示停止除錯會話。
![](https://img-blog.csdnimg.cn/img_convert/284eee1b98efd2782766e24f2034795a.png)

右鍵選單裡，還能使用 Report Code Coverage 檢視程式碼執行覆蓋率：

![](https://img-blog.csdnimg.cn/img_convert/056090a08e97f667d3238f4bb57c80f0.png)

程式碼覆蓋率報告顯示命中的語句數。
![](https://img-blog.csdnimg.cn/img_convert/3f632d35c31cd311e775efde5765f67b.png)

該報告還直觀地顯示了命中的語句和未命中的語句。
![](https://img-blog.csdnimg.cn/img_convert/c39b87a1b2c9b3cc3277e4ca561c5a22.png)

# SQLScript analysis

SQLScript 程式碼分析器可用於識別指示程式碼質量、安全性或效能問題的模式。

![](https://img-blog.csdnimg.cn/img_convert/c5d2190d6c49f488384b2d41c64e455a.png)

效果如下：
![](https://img-blog.csdnimg.cn/img_convert/81078b74bc22a2c98a206f48c842cfd5.png)

雙擊某個問題將開啟另一個包含該過程的 SQL 的選項卡，該問題將突出顯示。
![](https://img-blog.csdnimg.cn/img_convert/eba9dc579d64ee2fb524f997fbca8b18.png)

# Explain plan

解釋計劃以表格形式提供編譯後的計劃，而不執行它。 當很難在不引起問題的情況下重現問題時，這在分析某些情況時非常有用。

效果如下：
![](https://img-blog.csdnimg.cn/img_convert/262fea20e58fc5f41e4d63c57d7f72de.png)

# SQL Analyzer

SQL 分析器提供瞭如何執行分析的 SQL 語句的圖形檢視，這可以提供對查詢執行的更多見解。 最新版本可用作 Visual Studio Code 的擴充套件或 SAP Business Application Studio 中的附加擴充套件 (SAP Performance Tools)。 可以在 SAP HANA 資料庫瀏覽器中生成一個 .plv 檔案，然後可以在 SQL Analyzer 中開啟該檔案。 內部部署 SAP HANA 資料庫瀏覽器、內部部署 SAP HANA 駕駛艙以及 SAP HANA 工作室中還包含 SQL 分析器的先前版本。

![](https://img-blog.csdnimg.cn/img_convert/8655c797b00617e5a111de9b6729b0b5.png)

可以在 Visual Studio Code 裡安裝對應的外掛來檢視分析檔案：
![](https://img-blog.csdnimg.cn/img_convert/d10a91604d4501e958f82c25e7332069.png)

顯示前 5 個主要運算子、前 10 個關鍵路徑運算子、編譯和執行 SQL 語句所花費的時間、峰值記憶體、結果記錄數和訪問表的資訊。
![](https://img-blog.csdnimg.cn/img_convert/0b4f70ac0cff0e143cf0f724b7fae160.png)

切換到 PLAN GRAPH 選項卡以直觀地檢視查詢執行的詳細資訊。
![](https://img-blog.csdnimg.cn/img_convert/ba00f16e16036f54c9945af96c79c640.png)

# SQL trace

在除錯問題或識別特定應用程式正在使用的 SQL 語句時，SQL 跟蹤會很有幫助。 以下步驟演示了啟用 SQL 跟蹤，然後使用 SAP HANA 資料庫資源管理器檢視生成的跟蹤檔案的示例。

右鍵選單裡透過 Show overview 進行查詢：
![](https://img-blog.csdnimg.cn/img_convert/9eacd1fd6a17d6a93b8bd2381898d3cd.png)

為選定的資料庫顯示不同的資訊和統計資料。
![](https://img-blog.csdnimg.cn/img_convert/378c709b6a3c54d10f1dc0c9a04f73c0.png)

要確定為填充概覽的各個欄位（例如使用的記憶體）而執行的 SQL 請求，請透過在 SQL 控制檯中執行以下 SQL 語句來啟用 SQL 跟蹤。

```sql
ALTER SYSTEM ALTER CONFIGURATION ('indexserver.ini', 'SYSTEM') SET ('sqltrace', 'trace') = 'on', ('sqltrace', 'application') = 'sap_xsac_hrtt', ('sqltrace', 'user') = 'DBAdmin' WITH RECONFIGURE;
```

可以透過對以下監控檢視執行選擇來檢視配置檔案的名稱、它們的內容和更改歷史記錄：

* M_INIFILES
* M_INIFILE_CONTENTS
* M_INIFILE_CONTENT_HISTORY
* CONFIGURATION_PARAMETER_PROPERTIES
* M_CONFIGURATION_PARAMETER_VALUES

trace 檔案的位置：
![](https://img-blog.csdnimg.cn/img_convert/292cd2515c9b4cb6dad2ee225797602d.png)

可以在檔案中檢視返回有關 HANA 例項正在使用的記憶體的資訊的 SQL 查詢。 例如，突出顯示的查詢就是這樣一種 SQL 請求。
![](https://img-blog.csdnimg.cn/img_convert/3361d4c8de4d9added6d714c8495ee2a.png)

# Expensive statements trace

檢查消耗大量時間、CPU 或記憶體的 SQL 語句可能很重要。 以下步驟演示瞭如何啟用昂貴的語句跟蹤。

下面的 SQL 將啟用昂貴語句的跟蹤，設定閾值，執行一些將超過閾值的語句，然後禁用昂貴的語句跟蹤。

```sql
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'DATABASE') SET ('expensive_statement', 'enable') = 'on' WITH RECONFIGURE;
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'DATABASE') SET ('expensive_statement', 'threshold_memory') = '41943040' WITH RECONFIGURE;   -- 40 MB
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'DATABASE') SET ('expensive_statement', 'threshold_duration') = '3000000' WITH RECONFIGURE;  -- 3 sec

CALL HOTEL.RESERVATION_GENERATOR(1000);  --consumes more than 40 MB of memory

DO BEGIN
  -- Wait for a few seconds
  USING SQLSCRIPT_SYNC AS SYNCLIB;
  CALL SYNCLIB:SLEEP_SECONDS( 3 );  --runs for longer than 3 seconds
  -- Now execute a query
  SELECT * FROM M_TABLES;
END;

ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'DATABASE') SET ('expensive_statement', 'enable') = 'off' WITH RECONFIGURE;
```

可以在檢視中找到超出昂貴語句閾值的語句列表：M_EXPENSIVE_STATEMENTS

```sql
select TOP 2 DURATION_MICROSEC/1000000, CPU_TIME/1000000, MEMORY_SIZE/1048576, START_TIME, RECORDS, STATEMENT_STRING from  M_EXPENSIVE_STATEMENTS order by start_time desc;
```

![](https://img-blog.csdnimg.cn/img_convert/bf68ee2a7d5ab01e74dda1b26eaccc92.png)

# Viewing trace files with SQL

SAP HANA 資料庫提供一組監控檢視，允許訪問跟蹤檔案。 一個例子是 M_MERGED_TRACES 系統檢視，它包含多個跟蹤檔案的內容，允許在特定時間段內跨跟蹤檔案執行查詢。 以下說明提供了一些訪問檢視的示例。

可以查詢有關可用跟蹤檔案和來自各個跟蹤檔案的內容的資訊。

```sql
SELECT * FROM M_TRACEFILES;
SELECT * FROM M_TRACEFILE_CONTENTS  WHERE HOST = 'XXXXXXXX' AND FILE_NAME='XXXXXXXX.XXX';
```

執行以下 SQL 查詢以檢視過去 45 分鐘的條目。

```sql
SELECT SERVICE_NAME, TIMESTAMP, TRACE_LEVEL, COMPONENT, SOURCE_FILE_NAME, TRACE_TEXT
FROM M_MERGED_TRACES
WHERE TIMESTAMP > ADD_SECONDS (TO_TIMESTAMP (CURRENT_TIMESTAMP), -1*60*45) AND TIMESTAMP < CURRENT_TIMESTAMP
ORDER BY TIMESTAMP;
```

![](https://img-blog.csdnimg.cn/img_convert/8123b3f17d6ae526e3f341f9f8999c99.png)

SAP HANA 的 SAP Note SQL 語句集合包含一個名為 HANA_TraceFiles_Content 的查詢，該查詢還包括與跟蹤檔案中的某些字串匹配的相關 SAP 註釋。

![](https://img-blog.csdnimg.cn/img_convert/7cee56e46572e091fed5b4ef5c720550.png)

SAP HANA Database Explorer 裡的 SQL 語句如何排錯 trouble shoot

相關文章