設定資料庫擴充功能

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

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

事前準備

• 您使用的 Google Cloud 專案必須已啟用 AlloyDB 存取權。
• 您必須在使用的 Google Cloud 專案中擁有下列其中一個 IAM 角色：
  • roles/alloydb.admin (AlloyDB 管理員預先定義的 IAM 角色)
  • roles/owner (擁有者基本 IAM 角色)
  • roles/editor (編輯者基本 IAM 角色)

  如果您不具備上述任一角色，請與機構管理員聯絡，並要求存取權。

啟用擴充功能

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

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

程序

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

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

2. 按照「將 psql 用戶端連線至執行個體」一文的說明，將 psql 用戶端連線至叢集的主要執行個體。

   注意：即使您要在讀取集區執行個體上啟用擴充功能，也必須連線至主要執行個體。
3. 在 psql 命令提示字元中，連線至資料庫並建立擴充功能：

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   注意：如要建立 auto_explain 擴充功能，請使用 `LOAD` 指令。
4. 如有需要，請重複上一個步驟，連線至其他資料庫，並在每個資料庫中建立擴充功能。

停用擴充功能

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

1. 按照「將 psql 用戶端連線至執行個體」一文的說明，將 psql 用戶端連線至叢集的主要執行個體。

   注意：即使您要停用的擴充功能只在讀取集區執行個體上使用，也必須連線至主要執行個體。
2. 在 psql 指令提示中，連線至已啟用擴充功能的資料庫，然後捨棄擴充功能：

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. 重複上一個步驟，連線至已啟用擴充功能的其他資料庫，並在每個資料庫中捨棄擴充功能。

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

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