Installer les fonctions définies par l'utilisateur MySQL

Ce document explique comment installer une bibliothèque prédéfinie de fonctions MySQL dans une base de données Spanner. Vous pouvez ajouter ces fonctions à votre base de données à l'aide de la console Google Cloud ou de la Google Cloud CLI.

L'installation de ces fonctions MySQL étend les capacités de Spanner, ce qui vous permet d'effectuer des opérations courantes dans les environnements MySQL directement dans Spanner.

Pour en savoir plus sur les fonctions MySQL compatibles avec Spanner, consultez Fonctions MySQL.

Rôles requis

Pour obtenir les autorisations nécessaires pour installer les fonctions MySQL, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de bases de données Cloud Spanner (roles/spanner.databaseAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Installer les fonctions définies par l'utilisateur MySQL

Vous pouvez installer les fonctions définies par l'utilisateur MySQL dans une base de données Spanner de l'une des manières suivantes :

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page Instances de Spanner.

    Accéder à la page Instances

  2. Cliquez sur l'instance contenant la base de données.

  3. Cliquez sur la base de données.

  4. Cliquez sur le bouton Écrire du DDL pour ouvrir Spanner Studio.

  5. Copiez l'intégralité du contenu du fichier LDD dans le fichier mysql_udfs.sql.

  6. Dans un onglet de l'éditeur SQL, collez le contenu copié du fichier LDD.

  7. Cliquez sur Exécuter.

gcloud

Vous pouvez utiliser la commande gcloud spanner database ddl update pour installer les UDF MySQL.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • DATABASE_ID : ID de la base de données à laquelle ajouter les UDF MySQL.
  • INSTANCE_ID : ID de l'instance dans laquelle se trouve la base de données.
  • DDL_FILE_PATH : chemin d'accès à un fichier contenant toutes les instructions CREATE OR REPLACE FUNCTION du fichier mysql_udfs.sql.

Exécutez la commande suivante :

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

Étapes suivantes