安裝 MySQL 使用者定義函式

本文說明如何在 Spanner 資料庫中安裝預先定義的 MySQL 函式程式庫。您可以使用 Google Cloud 控制台或 Google Cloud CLI，將這些函式新增至資料庫。

安裝這些 MySQL 函式可擴充 Spanner 的功能，讓您直接在 Spanner 中執行 MySQL 環境中常見的作業。

如要進一步瞭解 Spanner 支援的 MySQL 函式，請參閱「MySQL 函式」。

必要的角色

如要取得安裝 MySQL 函式所需的權限，請要求管理員為您授予專案的 Cloud Spanner 資料庫管理員 (roles/spanner.databaseAdmin) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

安裝 MySQL 使用者定義函式

您可以透過下列方式，在 Spanner 資料庫中安裝 MySQL 使用者定義函式：

Google Cloud 控制台

1. 前往 Google Cloud 控制台的 Spanner「Instances」(執行個體) 頁面。

   前往「Instances」(執行個體) 頁面

2. 按一下包含資料庫的執行個體。

3. 按一下資料庫。

4. 按一下「寫入 DDL」按鈕，開啟 Spanner Studio。

5. 複製 mysql_udfs.sql 檔案中的整個 DDL 檔案內容。

6. 在 SQL 編輯器分頁中，貼上從 DDL 檔案複製的內容，

7. 按一下「執行」。

gcloud

您可以使用 gcloud spanner database ddl update 指令安裝 MySQL UDF。

使用下列任何指令資料之前，請先替換以下項目：

• DATABASE_ID：要新增 MySQL UDF 的資料庫 ID。
• INSTANCE_ID：資料庫所在的例項 ID。
• DDL_FILE_PATH：檔案路徑，內含 mysql_udfs.sql 檔案中的所有 CREATE OR REPLACE FUNCTION 陳述式。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl-file=DDL_FILE_PATH

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud spanner databases ddl update DATABASE_ID `
--instance=INSTANCE_ID `
--ddl-file=DDL_FILE_PATH

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud spanner databases ddl update DATABASE_ID ^
--instance=INSTANCE_ID ^
--ddl-file=DDL_FILE_PATH

後續步驟

• 瞭解 Spanner 支援的所有 MySQL 使用者定義函式。