PostgreSQL
本頁涵蓋將 PostgreSQL 連接為資料倉儲。如需將 PostgreSQL 用作 Metabase 的應用程式資料庫，請參閱設定 Metabase 應用程式資料庫。
若要新增資料庫連線，請按一下右上角的齒輪圖示，並導覽至管理設定 > 資料庫 > 新增資料庫。
填寫該資料庫的欄位，然後按一下底部的儲存變更。
支援的版本
Metabase 支援最舊的 PostgreSQL 支援版本到最新的穩定版本。請參閱PostgreSQL 版本。
設定
您可以隨時編輯這些設定。請務必記得儲存您的變更。
顯示名稱
資料庫在 Metabase 介面中顯示的名稱。
主機
您資料庫的 IP 位址或網域名稱 (例如，esc.mydatabase.com)。
連接埠
資料庫連接埠。例如，5432。
資料庫名稱
您要連線的資料庫名稱。
使用者名稱
您想要用來連線到資料庫的帳戶的資料庫使用者名稱。您可以使用不同的使用者帳戶設定多個連線到同一個資料庫，每個帳戶都具有不同的權限集。
密碼
您用來連線到資料庫的使用者名稱的密碼。
使用驗證提供者
使用提供者驗證僅適用於 Pro 和 Enterprise 方案 (自架託管和 Metabase Cloud 皆適用)。
您可以選擇使用支援的提供者進行驗證，而非使用密碼。
僅適用於自架託管 Pro 和 Enterprise 方案。
Azure 受管理身分
若要使用 Azure 受管理身分，您需要輸入您的用戶端 ID。
Oauth
若要使用 Oauth 作為提供者，您需要輸入您的
- 驗證權杖 URL
- 驗證權杖請求標頭 (JSON 對應)
結構描述
您可以指定要同步和掃描的結構描述。選項為
- 全部
- 僅限這些…
- 除了這些以外的所有…
對於僅限這些和除了這些以外的所有選項，您可以輸入以逗號分隔的值列表，告知 Metabase 您要包含 (或排除) 的結構描述。例如
foo,bar,baz
您可以使用 * 萬用字元來比對多個結構描述。
假設您有三個結構描述：foo、bar 和 baz。
- 如果您設定僅限這些…，並輸入字串
b*，您將同步 bar 和 baz。 - 如果您設定除了這些以外的所有…，並輸入字串
b*，您將只同步 foo。
請注意，僅支援 * 萬用字元；您無法使用其他特殊字元或正規表示式。
使用安全連線 (SSL)
Metabase 會自動嘗試先使用 SSL 連線到資料庫，如果失敗，則不使用 SSL。如果可以使用 SSL 連線到您的資料庫，Metabase 會將其設為您資料庫的預設設定。如果您偏好不使用此安全層進行連線，您可以隨時稍後變更此設定，但我們強烈建議您保持開啟 SSL，以確保您的資料安全。
SSL 模式
PostgreSQL 資料庫支援不同安全等級的連線，其耗用資源也不同。
SSL 模式選項包括
- allow
- prefer
- require
- verify-ca
- verify-full
請參閱 PostgreSQL 文件，以取得關於不同SSL 模式的表格，並選取適合您的選項。
SSL 根憑證 (PEM)
如果您將 SSL 模式設定為「verify-ca」或「verify-full」，則需要指定根憑證 (PEM)。您可以選擇使用本機檔案路徑或已上傳檔案路徑。如果您使用的是 Metabase Cloud，則需要選取已上傳檔案路徑並上傳您的憑證。
驗證用戶端憑證
切換為開啟以顯示用戶端憑證選項。
SSL 用戶端憑證 (PEM)
您可以選擇使用本機檔案路徑或已上傳檔案路徑。如果您使用的是 Metabase Cloud，則需要選取已上傳檔案路徑並上傳您的憑證。
SSL 用戶端金鑰 (PKCS-8/DER)
同樣地，您可以選擇使用本機檔案路徑或已上傳檔案路徑。如果您使用的是 Metabase Cloud，則需要選取已上傳檔案路徑並上傳您的憑證。您也需要輸入您的 SSL 用戶端金鑰密碼。
私密金鑰必須為 PKCS8 格式並儲存為 DER 格式。
如果您改為擁有 PEM SSL 用戶端金鑰，您可以使用 openssl 將該金鑰轉換為 PKCS-8/DER 格式。命令看起來會像這樣
openssl pkcs8 -topk8 -inform PEM -outform DER -in client-key.pem -out client-key.der -nocrypt
注意：如果您使用的是 GCP，並且您成功發行用戶端憑證，則所有內容都將以 PEM 格式提供，您只需要將 client-key.pem 轉換為「SSL 用戶端金鑰」的 client-key.der 即可
使用 SSH 通道
請參閱我們的SSH 通道指南。
進階設定
展開 JSON 欄
對於 PostgreSQL 資料庫，Metabase 可以將 JSON 欄展開為元件欄位，以產生一個表格，其中每個 JSON 金鑰都會變成一個欄。JSON 展開預設為開啟，但如果效能緩慢，您可以關閉 JSON 展開。
如果您開啟 JSON 展開，您也可以在表格 metadata 中切換個別欄的展開。
其他 JDBC 連線字串選項
您可以將選項附加到 Metabase 用於連線到資料庫的連線字串。使用格式
options=-c%20key=value
PostgreSQL 連線 URI 預期會針對空白字元和符號進行百分比編碼。
重新執行簡單探索的查詢
如果使用者想要在套用任何摘要或篩選條件選取項目之前按一下執行 (播放按鈕)，請將此選項關閉。
預設情況下，當您從摘要選單中選擇分組選項或從鑽取選單中選擇篩選條件時，Metabase 就會執行查詢。如果您的資料庫速度緩慢，您可能會想要停用重新執行，以避免在每次點擊時載入資料。
選擇 Metabase 同步和掃描的時間
將此選項開啟以管理 Metabase 用來與您的資料庫保持同步的查詢。如需詳細資訊，請參閱同步和掃描資料庫。
資料庫同步
如果您已選取選擇同步和掃描發生的時間 > 開啟，您將可以設定
- 同步的頻率：每小時 (預設) 或每天。
- 執行同步的時間，以執行 Metabase 應用程式的伺服器的時區為準。
掃描篩選條件值
Metabase 可以掃描此資料庫中每個欄位中存在的值，以在儀表板和問題中啟用核取方塊篩選條件。這可能是一個相當耗用資源的程序，特別是當您擁有非常龐大的資料庫時。
如果您已選取選擇同步和掃描發生的時間 > 開啟，您會在掃描篩選條件值下方看到下列選項
- 定期，依排程可讓您以符合資料庫變更速率的頻率執行掃描查詢。時間設定為執行 Metabase 應用程式的伺服器的時區。對於小型資料庫，或經常更新相異值的表格，這是最佳選項。
- 如果您想要依需求執行掃描查詢，僅在新增篩選條件小工具時是一個絕佳的選項。將此選項開啟表示 Metabase 只會掃描和快取在將新篩選條件新增至儀表板或 SQL 問題時使用的欄位值。
- 永不，如果需要，我會手動執行是適用於過於龐大或永遠不會新增值的資料庫的選項。使用立即重新掃描欄位值按鈕執行手動掃描，並將您的篩選條件值更新至最新狀態。
定期重新指紋識別表格
定期重新指紋識別將增加資料庫的負載。
將此選項開啟以在 Metabase 每次執行同步時掃描值的範例。
指紋識別查詢會檢查每個欄的前 10,000 列，並使用該資料來猜測每個欄有多少相異值、數值和時間戳記欄的最小值和最大值等等。如果您將此選項關閉，Metabase 將只會在設定期間對您的欄進行一次指紋識別。
延伸閱讀
閱讀其他Metabase 版本的文件。