設定資料庫擴充功能

如要為 AlloyDB for PostgreSQL 資料庫新增額外功能 (例如向量搜尋、地理空間索引或查詢稽核)，您可以啟用、更新及停用支援的 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. 如果擴充功能要求在使用的執行個體上設定資料庫旗標，請按照「設定執行個體的資料庫旗標」中的操作說明，從每個使用的執行個體中移除旗標。

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