價格
登入 開始使用
文件 學習
首頁
分析
嵌入
管理
其他資源

Oracle

若要新增資料庫連線，請按一下右上角的齒輪圖示，並導覽至管理設定 > 資料庫 > 新增資料庫。

支援的版本

Metabase 支援最舊的支援版本到最新的穩定版本。請參閱 Oracle 的目前資料庫版本發行排程。

設定

您可以隨時編輯這些設定。請務必儲存變更。

顯示名稱

資料庫在 Metabase 介面中顯示的名稱。

主機

您資料庫的 IP 位址，或其網域名稱 (例如 esc.mydatabase.com)。

連接埠

資料庫連接埠。例如：1521。

Oracle 系統 ID (SID)

通常類似 ORCL 或 XE。若使用服務名稱則為選填。

Oracle 服務名稱

選填 TNS 別名。

使用者名稱

您想要用來連線至資料庫的帳戶的資料庫使用者名稱。您可以設定多個連線至相同資料庫，使用不同的使用者帳戶連線至相同資料庫，每個連線皆具有不同的權限集。

密碼

您用來連線至資料庫的使用者名稱密碼。

使用安全連線 (SSL)

您可以使用用戶端與伺服器驗證 (稱為相互驗證)。

連線至 Oracle Cloud Autonomous Database

如果您已將資料庫設定為需要相互 TLS (mTLS)，則需要錢包。若要下載您的錢包

  1. 前往您的 Oracle Autonomous Database。
  2. 前往資料庫的詳細資訊。
  3. 按一下資料庫連線。
  4. 下載錢包。
  5. 建立金鑰檔案的密碼。
  6. 將 keystore.jks 檔案複製到您儲存 Metabase 設定資料的任何位置。
  7. 使用 JAVA_OPTS 讓 Metabase 知道金鑰儲存庫的位置與密碼 (如需金鑰儲存庫的更多資訊，請參閱下一節)。
  8. 在 Metabase 中，於資料連線頁面上，輸入您的 host、port 與 service_name。您可以在 tsnnames.ora 檔案中找到這些值。

使用金鑰儲存庫的用戶端驗證

若要設定伺服器 (Oracle 伺服器) 驗證用戶端 (Metabase) 的身分，您需要設定金鑰儲存庫檔案，其中包含用戶端的私密金鑰。

您將用戶端的私密金鑰匯入金鑰儲存庫 (而非根 CA 匯入信任儲存庫檔案)。為 Metabase 新增下列 JVM 選項

-Djavax.net.ssl.keyStore=/path/to/keystore.jks
-Djavax.net.ssl.keyStoreType=JKS \
-Djavax.net.ssl.keyStorePassword=<keyStorePassword>

您可以使用 JAVA_OPTS 環境變數定義這些選項，如下所示

JAVA_OPTS: "-Djavax.net.ssl.keyStore=/scripts/keystore.jks -Djavax.net.ssl.keyStoreType=JKS -Djavax.net.ssl.keyStorePassword=<keyStorePassword>"

完成此步驟後，當 Metabase 嘗試透過 SSL 連線時，Oracle 伺服器將使用私密金鑰驗證 Metabase。

使用信任儲存庫的伺服器驗證

若要設定用戶端 (Metabase) 驗證伺服器 (Oracle 伺服器) 的身分，您可能需要設定信任儲存庫檔案，其中包含伺服器的根 CA，讓執行 Metabase 的 JVM 信任其憑證鏈。請參閱 Oracle 文件，以瞭解如何使用 keytool 管理金鑰與信任儲存庫檔案、匯入憑證等。

如需有關為 AWS RDS Oracle 執行個體設定信任儲存庫的更多資訊，請參閱 Amazon 提供的指示。

如果您需要使用 SSL 連線至其他資料庫，您可能會想要將 RDS CA 新增至您現有的信任儲存庫檔案 (可能名為 cacerts)，而不是建立新的信任儲存庫。

支援的 Oracle 資料庫與 Oracle 驅動程式版本

  • 驅動程式版本：最低 Oracle 驅動程式版本應為 19c，無論您擁有的 Java 版本或 Oracle 資料庫版本為何。
  • 資料庫版本：最低資料庫版本應為 19c 版，因為 Oracle 不再支援 19 之前的資料庫版本。

下載 Oracle JDBC 驅動程式 JAR

您可以從Oracle 的 JDBC 驅動程式下載頁面下載 JDBC 驅動程式。

我們建議使用 ojdbc8.jar JAR。

將 Oracle JDBC 驅動程式 JAR 新增至 Metabase 外掛程式目錄

在您的 Metabase 目錄 (您保留並執行 metabase.jar 的目錄) 中，建立名為 plugins 的目錄 (如果尚不存在)。

將您剛下載的 JAR (ojdbc8.jar) 移至 plugins 目錄，並重新啟動 Metabase。Metabase 將在重新啟動時自動提供 Oracle 驅動程式。

從 JAR 執行時

依預設，外掛程式目錄名為 plugins，並位於與 Metabase JAR 相同的目錄中。

例如，如果您從名為 /app/ 的目錄執行 Metabase，您應將 Oracle JDBC 驅動程式 JAR 移至 /app/plugins/

# example directory structure for running Metabase with Oracle support
/app/metabase.jar
/app/plugins/ojdbc8.jar

從 Docker 執行時

透過 Docker 執行時新增外掛程式的程序類似，但您需要掛載 plugins 目錄。請參閱此處的指示以取得更多詳細資訊。

延伸閱讀

閱讀其他Metabase 版本的文件。