資料庫連線疑難排解
如果您無法連線到資料庫,您需要找出問題是出在 Metabase 還是資料庫伺服器。
如果您的資料庫連線成功,但在資料瀏覽器中看不到表格,請前往看不到表格的疑難排解。
Metabase 連線疑難排解
-
前往「管理」>「資料庫」,然後選取您的資料庫,確認您的連線未變更或刪除。
-
如果 Metabase 尚未開始與您的資料庫同步,請按一下「立即同步資料庫結構描述」。
-
如果 Metabase 同步時間過長,請前往同步和掃描疑難排解。
-
-
前往「管理」>「疑難排解」>「日誌」,檢查 Metabase 是否因錯誤而同步失敗。
- 如果您覺得日誌太多難以負荷,請查看如何讀取伺服器日誌。
如果您無法存取 Metabase 管理面板,您需要詢問設定 Metabase 的人員。
資料庫伺服器連線疑難排解
-
檢查您是否可以使用執行 Metabase 的機器,從另一個用戶端連線到資料倉儲。
-
如果您可以從跳板主機或其他機器存取伺服器,請檢查您的 Metabase IP 位址是否可以存取您的資料庫伺服器。
-
如果您執行的是 Metabase Cloud,請檢查您是否已將我們的 IP 位址加入允許清單。
-
-
確認 Metabase 使用的角色具有連線到資料倉儲的必要權限。請參閱授予資料庫權限。
上述步驟將協助您偵測問題是否發生在 Metabase 之外。若要修正資料庫伺服器的問題,您需要參考您的資料庫或雲端服務的文件。請記得在進行變更後測試您的資料庫連線。
如果您無法存取資料倉儲伺服器,您需要詢問管理您的資料庫或資料倉儲的人員。
BigQuery 和 Google 雲端硬碟連線疑難排解
請參閱BigQuery 和 Google 雲端硬碟連線疑難排解
常見的資料庫連線錯誤
您的問題耗時過長
如果您在 Metabase 介面中看到此錯誤訊息,請前往逾時疑難排解。
無法從基礎資料庫取得連線
如果您在日誌中看到此錯誤訊息(「管理」>「疑難排解」>「日誌」)
- 前往「管理」>「資料庫」,然後選取您的資料庫。
- 前往「進階選項」>「其他 JDBC 連線字串選項」,然後新增
trustServerCertificate=true
。 - 按一下「儲存」。
您用來連線到資料倉儲的 Metabase 版本必須支援您的資料庫版本。例如,舊於 46 的 Metabase 版本不支援 Microsoft SQL Server 2022。
測試資料庫連線
當您逐步執行本指南中的疑難排解步驟時,您可以檢查每個元件是否如預期般運作
檢查伺服器狀態
如果您使用的是託管資料庫服務,請前往主控台並驗證其狀態。
如果您可以直接存取命令列介面,請登入並確認您的資料庫正在執行且接受查詢。
檢查您的伺服器存取權
若要驗證您的 Metabase IP 位址是否可以存取資料庫伺服器
-
使用 netcat 命令
nc
(或您作業系統的對等命令),檢查您是否可以連線到指定連接埠上的主機。請注意,不同的資料庫預設使用不同的連接埠。 -
如果您執行的是 Metabase Cloud,請檢查您是否已將我們的 IP 位址加入允許清單。
-
檢查您的資料庫認證是否正確。
範例命令
若要驗證預設 PostgreSQL 組態中使用的連接埠(監聽連接埠 5432)
nc -v your-db-host 5432
若要驗證 PostgreSQL 資料庫的認證(如果資料庫名稱或使用者/密碼不正確,您會看到錯誤)
psql -h HOSTNAME -p PORT -d DATABASENAME -U DATABASEUSER
測試連線狀態
- 前往 Metabase SQL 編輯器。
- 執行以下命令以測試與資料庫的連線
SELECT 1
相關問題
您仍然遇到困難嗎?
如果您無法使用疑難排解指南解決您的問題
- 搜尋或詢問 Metabase 社群。
- 搜尋已知錯誤或限制。
- 聘請 Metabase 專家。
閱讀其他版本的 Metabase 文件。