Instalar 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 añadir estas funciones a tu base de datos con la Google Cloud consola o la CLI de Google Cloud.

Al instalar estas funciones de MySQL, se amplían las funciones de Spanner, lo que te permite realizar operaciones habituales en 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 obligatorios

Para obtener los permisos que necesitas para instalar las funciones de MySQL, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de bases de datos de Cloud Spanner (roles/spanner.databaseAdmin) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Instalar 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 formas:

Google Cloud consola

  1. En la Google Cloud consola, 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 Escribir 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 UDFs de MySQL.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • DATABASE_ID: el ID de la base de datos a la que se añadirán las funciones definidas por el usuario de MySQL.
  • INSTANCE_ID: el ID de la instancia en la que se encuentra la base de datos.
  • DDL_FILE_PATH: ruta a un archivo que contiene todas las instrucciones 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

Siguientes pasos