使用資料庫檢查器對資料庫偵錯

資料庫檢查器可檢查、查詢及修改應用程式的資料庫，特別適合用於資料庫偵錯。資料庫檢查器適用於一般的 SQLite 和以 SQLite 為基礎的程式庫，例如 Room。

開啟資料庫檢查器

如要在資料庫檢查器中開啟資料庫，請按照下列步驟操作：

在執行 API 級別 26 以上的模擬器或已連結裝置上執行應用程式。

注意：已知有一個與 Android 11 模擬器相關的問題，會在連線至 DB 檢查器時造成應用程式當機。如要修正問題，請按照這些步驟操作。
從選單列中依序選取「View」>「Tool Windows」>「App Inspection」。
選取「Database Inspector」分頁標籤。
從選單中選取正在執行的應用程式程序。
執行中應用程式的資料庫會顯示在「Databases」窗格中。針對您要檢查的資料庫展開節點。

「Databases」窗格會顯示應用程式內的資料庫清單，以及每個資料庫包含的資料表。在資料表名稱上按兩下，即可在右側的檢查器中顯示資料，如圖 1 所示。請按一下資料欄標題，按照該欄排序檢查器視窗中的資料。

如要修改資料表中的資料，請遵循下列步驟操作：

如果您的應用程式使用 Room，且 UI 會觀察資料庫，例如使用 LiveData 或 Flow，則您對資料所做的任何變更都會立即顯示在執行中的應用程式。否則，只有在應用程式下次從資料庫讀取修改的資料時，才會顯示變更。

如果希望資料庫檢查器會在您與執行中的應用程式互動時自動更新顯示的資料，請勾選檢查器視窗頂端的「Live updates」核取方塊。啟用即時更新時，檢查器視窗中的資料表為唯讀狀態，您無法修改其中的值。

或者，如要手動更新資料，請按一下檢查器視窗頂端的「Refresh table」按鈕。

資料庫檢查器可以在應用程式執行時，對應用程式資料庫執行查詢。如果您的應用程式使用 Room，這項工具就可以使用 DAO 查詢，但也支援自訂 SQL 查詢。

如果您的應用程式使用 Room，Android Studio 會提供溝槽操作，可讓您快速執行已在 DAO 類別中定義的查詢方法。您可以在應用程式執行期間和 IDE 開啟資料庫檢查器的情況下執行這些動作。

如要在 DAO 中執行任何查詢方法，請按一下 @Query 註解旁的「Run SQLite statement in Database Inspector」按鈕。

如果您的應用程式包含多個資料庫，Android Studio 會提示您從清單中選取要查詢的資料庫。如果查詢方法包含已命名的繫結參數，Android Studio 會在執行查詢前要求每個參數的值。查詢結果會顯示在檢查器視窗中。

您也可以使用資料庫檢查器，在應用程式執行期間，針對應用程式資料庫執行自訂 SQL 查詢。

如要查詢資料庫，請按照下列步驟操作：

按一下「Databases」窗格頂端的「Open New Query」分頁標籤，在檢查器視窗中開啟新分頁。

圖 3. 開啟「New Query」分頁。
如果您的應用程式包含多個資料庫，請從「New Query」分頁的清單中選取要查詢的資料庫。
在「New Query」分頁頂端的文字欄位中，輸入自訂 SQL 查詢。
按一下「Run」。