Instala funciones definidas por el usuario de MySQL

En este documento, se describe cómo instalar una biblioteca predefinida de funciones de MySQL en una base de datos de Spanner. Puedes agregar estas funciones a tu base de datos con la consola de Google Cloud o Google Cloud CLI.

La instalación de estas funciones de MySQL extiende las capacidades de Spanner, lo que te permite realizar operaciones que son comunes en los entornos de MySQL directamente en Spanner.

Para obtener más información sobre las funciones de MySQL que admite Spanner, consulta Funciones de MySQL.

Roles requeridos

Para obtener los permisos que necesitas para instalar las funciones de MySQL, pídele a tu administrador que te otorgue el rol de IAM de administrador de bases de datos de Cloud Spanner (roles/spanner.databaseAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Instala las funciones definidas por el usuario de MySQL

Puedes instalar las funciones definidas por el usuario de MySQL en una base de datos de Spanner de las siguientes maneras:

Consola de Google Cloud

  1. En la consola de Google Cloud , ve a la página Instancias de Spanner.

    Ir a la página Instancias

  2. Haz clic en la instancia que contiene la base de datos.

  3. Haz clic en la base de datos.

  4. Haz clic en el botón Write DDL para abrir Spanner Studio.

  5. Copia todo el contenido del archivo DDL en el archivo mysql_udfs.sql.

  6. En una pestaña del editor de SQL, pega el contenido copiado del archivo DDL.

  7. Haz clic en Ejecutar.

gcloud

Puedes usar el comando gcloud spanner database ddl update para instalar las UDF de MySQL.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • DATABASE_ID: Es el ID de la base de datos a la que se agregarán las UDF de MySQL.
  • INSTANCE_ID: Es el ID de la instancia en la que se encuentra la base de datos.
  • DDL_FILE_PATH: Es la ruta de acceso a un archivo que contiene todas las sentencias CREATE OR REPLACE FUNCTION del archivo mysql_udfs.sql.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

¿Qué sigue?