Instalar funções definidas pelo usuário do MySQL

Este documento descreve como instalar uma biblioteca predefinida de funções do MySQL em um banco de dados do Spanner. É possível adicionar essas funções ao seu banco de dados usando o console do Google Cloud ou a Google Cloud CLI.

A instalação dessas funções do MySQL amplia os recursos do Spanner, permitindo que você realize operações comuns em ambientes MySQL diretamente no Spanner.

Para mais informações sobre as funções do MySQL compatíveis com o Spanner, consulte Funções do MySQL.

Funções exigidas

Para receber as permissões necessárias para instalar as funções do MySQL, peça ao administrador para conceder a você o papel Administrador do banco de dados do Cloud Spanner (roles/spanner.databaseAdmin) do IAM no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Instalar as funções definidas pelo usuário do MySQL

É possível instalar as funções definidas pelo usuário do MySQL em um banco de dados do Spanner das seguintes maneiras:

Console do Google Cloud

  1. No console Google Cloud , acesse a página Instâncias do Spanner.

    Acessar a página "Instâncias"

  2. Clique na instância que contém o banco de dados.

  3. Clique no banco de dados.

  4. Clique no botão Escrever DDL para abrir o Spanner Studio.

  5. Copie todo o conteúdo do arquivo DDL em mysql_udfs.sql file.

  6. Em uma guia do editor de SQL, cole o conteúdo copiado do arquivo DDL.

  7. Clique em Executar.

gcloud

É possível usar o comando gcloud spanner database ddl update para instalar as UDFs do MySQL.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • DATABASE_ID: o ID do banco de dados em que as UDFs do MySQL serão adicionadas.
  • INSTANCE_ID: o ID da instância em que o banco de dados está localizado.
  • DDL_FILE_PATH: caminho para um arquivo que contém todas as instruções CREATE OR REPLACE FUNCTION no arquivo mysql_udfs.sql.

Execute o seguinte comando:

Linux, macOS ou 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

A seguir