資料庫連線疑難排解

如果您無法連線到資料庫,您需要找出問題是出在 Metabase 還是資料庫伺服器。

如果您的資料庫連線成功,但在資料瀏覽器中看不到表格,請前往看不到表格的疑難排解

Metabase 連線疑難排解

  1. 前往「管理」>「資料庫」,然後選取您的資料庫,確認您的連線未變更或刪除。

    • 如果 Metabase 尚未開始與您的資料庫同步,請按一下「立即同步資料庫結構描述」。

    • 如果 Metabase 同步時間過長,請前往同步和掃描疑難排解

  2. 前往「管理」>「疑難排解」>「日誌」,檢查 Metabase 是否因錯誤而同步失敗。

如果您無法存取 Metabase 管理面板,您需要詢問設定 Metabase 的人員。

資料庫伺服器連線疑難排解

  1. 檢查資料倉儲伺服器是否正在執行.

  2. 檢查您是否可以使用執行 Metabase 的機器,從另一個用戶端連線到資料倉儲。

  3. 確認 Metabase 使用的角色具有連線到資料倉儲的必要權限。請參閱授予資料庫權限

上述步驟將協助您偵測問題是否發生在 Metabase 之外。若要修正資料庫伺服器的問題,您需要參考您的資料庫或雲端服務的文件。請記得在進行變更後測試您的資料庫連線

如果您無法存取資料倉儲伺服器,您需要詢問管理您的資料庫或資料倉儲的人員。

BigQuery 和 Google 雲端硬碟連線疑難排解

請參閱BigQuery 和 Google 雲端硬碟連線疑難排解

常見的資料庫連線錯誤

您的問題耗時過長

如果您在 Metabase 介面中看到此錯誤訊息,請前往逾時疑難排解

無法從基礎資料庫取得連線

如果您在日誌中看到此錯誤訊息(「管理」>「疑難排解」>「日誌」)

  1. 前往「管理」>「資料庫」,然後選取您的資料庫。
  2. 前往「進階選項」>「其他 JDBC 連線字串選項」,然後新增 trustServerCertificate=true
  3. 按一下「儲存」。

您用來連線到資料倉儲的 Metabase 版本必須支援您的資料庫版本。例如,舊於 46 的 Metabase 版本不支援 Microsoft SQL Server 2022。

測試資料庫連線

當您逐步執行本指南中的疑難排解步驟時,您可以檢查每個元件是否如預期般運作

檢查伺服器狀態

如果您使用的是託管資料庫服務,請前往主控台並驗證其狀態。

如果您可以直接存取命令列介面,請登入並確認您的資料庫正在執行且接受查詢。

檢查您的伺服器存取權

若要驗證您的 Metabase IP 位址是否可以存取資料庫伺服器

  1. 使用 netcat 命令 nc(或您作業系統的對等命令),檢查您是否可以連線到指定連接埠上的主機。請注意,不同的資料庫預設使用不同的連接埠。

  2. 如果您執行的是 Metabase Cloud,請檢查您是否已將我們的 IP 位址加入允許清單

  3. 檢查您的資料庫認證是否正確。

範例命令

若要驗證預設 PostgreSQL 組態中使用的連接埠(監聽連接埠 5432)

nc -v your-db-host 5432

若要驗證 PostgreSQL 資料庫的認證(如果資料庫名稱或使用者/密碼不正確,您會看到錯誤)

psql -h HOSTNAME -p PORT -d DATABASENAME -U DATABASEUSER

測試連線狀態

  1. 前往 Metabase SQL 編輯器
  2. 執行以下命令以測試與資料庫的連線
    SELECT 1
    

您仍然遇到困難嗎?

如果您無法使用疑難排解指南解決您的問題

閱讀其他版本的 Metabase 文件。