Instale funções definidas pelo utilizador do MySQL

Este documento descreve como instalar uma biblioteca predefinida de funções do MySQL numa base de dados do Spanner. Pode adicionar estas funções à sua base de dados através da Google Cloud consola ou da Google Cloud CLI.

A instalação destas funções do MySQL expande as capacidades do Spanner, permitindo-lhe realizar operações comuns em ambientes do MySQL diretamente no Spanner.

Para mais informações sobre as funções do MySQL suportadas pelo Spanner, consulte o artigo Funções do MySQL.

Funções necessárias

Para obter as autorizações de que precisa para instalar as funções do MySQL, peça ao seu administrador para lhe conceder a função de IAM de administrador da base de dados do Cloud Spanner (roles/spanner.databaseAdmin) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Instale as funções definidas pelo utilizador do MySQL

Pode instalar as funções definidas pelo utilizador do MySQL numa base de dados do Spanner das seguintes formas:

Google Cloud consola

  1. Na Google Cloud consola, aceda à página Instances do Spanner.

    Aceda à página Instâncias

  2. Clique na instância que contém a base de dados.

  3. Clique na base de dados.

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

  5. Copie todo o conteúdo do ficheiro DDL no ficheiro mysql_udfs.sql.

  6. Num separador do editor de SQL, cole o conteúdo copiado do ficheiro DDL.

  7. Clique em Executar.

gcloud

Pode usar o comando gcloud spanner database ddl update para instalar as UDFs do MySQL.

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • DATABASE_ID: o ID da base de dados à qual adicionar as UDFs do MySQL.
  • INSTANCE_ID: o ID da instância onde a base de dados está localizada.
  • DDL_FILE_PATH: caminho para um ficheiro que contém todas as declarações CREATE OR REPLACE FUNCTION no ficheiro 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

O que se segue?