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 Google Cloud console ou de 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 attribuer 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 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 différentes manières :

Google Cloud Console

  1. Dans la Google Cloud console, accédez à la page Instances 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 le LDD pour ouvrir Spanner Studio.

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

  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 gcloud spanner database ddl update commande pour installer les fonctions définies par l'utilisateur 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 fonctions définies par l'utilisateur 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 CREATE OR REPLACE FUNCTION instructions 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

Étape suivante