設定資料庫擴充功能

本頁說明如何在 AlloyDB 中啟用及停用 PostgreSQL 擴充功能。

如需 AlloyDB 支援的擴充功能清單，請參閱「支援的資料庫擴充功能」。

啟用擴充功能

一般來說，您只要連線至 AlloyDB 叢集主要執行個體中的資料庫，然後輸入 LOAD 或 CREATE EXTENSION 指令，即可啟用擴充功能。

不過，部分擴充功能需要您先設定一或多個資料庫旗標，才能使用 LOAD 或 CREATE EXTENSION 指令啟用擴充功能。您可以在要使用擴充功能的 AlloyDB 執行個體上設定這些標記，無論該執行個體是主要執行個體或讀取集區執行個體。

程序

  1. 視需要 在要使用擴充功能的執行個體 (主要執行個體或讀取集區執行個體) 上，設定適當的資料庫標記。

    支援的擴充功能清單會顯示哪些擴充功能需要執行這個步驟，並說明必須設定哪些資料庫標記。

  2. 將 psql 用戶端連線至叢集的主要執行個體，如「將 psql 用戶端連線至執行個體」一文所述。

  3. 在 psql 命令提示字元中，連線至資料庫並建立擴充功能：
    \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
  4. 如要連線至其他資料庫並在每個資料庫中建立擴充功能，請重複上一個步驟。

更新擴充功能

雖然 AlloyDB 維護更新會在執行個體的基本軟體上自動安裝最新的擴充功能二進位檔，但不會自動更新擴充功能的資料庫目錄。 您有責任手動更新擴充功能，確保使用最新支援版本。

如要判斷哪些擴充功能需要更新，請將已安裝的版本與「支援的擴充功能參考表」中列出的最新支援版本進行比較。

連線至資料庫，然後執行下列指令，查看已安裝的版本：

SELECT * FROM pg_extension;

如要將擴充功能更新至執行個體上的最新版本，請使用 ALTER EXTENSION 指令。

使用您選擇的用戶端 (例如 AlloyDB Studio 或 psql 用戶端) 連線至叢集的主要執行個體，然後針對要更新的每個擴充功能執行下列指令：

ALTER EXTENSION EXTENSION_NAME UPDATE;

如要更新至特定版本，請使用下列語法：

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

停用擴充功能

如要停用擴充功能，請按照啟用時的步驟操作，但要反向執行。

  1. 將 psql 用戶端連線至叢集的主要執行個體，如「將 psql 用戶端連線至執行個體」一文所述。

  2. 在 psql 命令提示字元中，連線至已啟用擴充功能的資料庫，然後捨棄擴充功能：
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. 重複上一個步驟，連線至已啟用擴充功能的其他資料庫，並在每個資料庫中捨棄擴充功能。

  4. 如果擴充功能要求在執行個體上設定資料庫旗標，請按照「設定執行個體的資料庫旗標」一文中的操作說明，從使用擴充功能的每個執行個體中移除旗標。

    支援的擴充功能清單會顯示哪些擴充功能需要設定資料庫標記，並指出哪些標記。