Benutzerdefinierte MySQL-Funktionen installieren

In diesem Dokument wird beschrieben, wie Sie eine vordefinierte Bibliothek mit MySQL-Funktionen in einer Spanner-Datenbank installieren. Sie können diese Funktionen Ihrer Datenbank über die Google Cloud Console oder die Google Cloud CLI hinzufügen.

Durch die Installation dieser MySQL-Funktionen werden die Funktionen von Spanner erweitert. Sie können dann Vorgänge, die in MySQL-Umgebungen üblich sind, direkt in Spanner ausführen.

Weitere Informationen zu den von Spanner unterstützten MySQL-Funktionen finden Sie unter MySQL-Funktionen.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Installieren der MySQL-Funktionen benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Spanner Database Admin (roles/spanner.databaseAdmin) für Ihr Projekt zu gewähren. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Benutzerdefinierte MySQL-Funktionen installieren

Sie können die benutzerdefinierten MySQL-Funktionen auf folgende Weise in einer Spanner-Datenbank installieren:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Spanner-Seite Instanzen auf.

    Zur Seite "VM-Instanzen"

  2. Klicken Sie auf die Instanz, die die Datenbank enthält.

  3. Klicken Sie auf die Datenbank.

  4. Klicken Sie auf die Schaltfläche DDL schreiben, um Spanner Studio zu öffnen.

  5. Kopieren Sie den gesamten Inhalt der DDL-Datei in die Datei mysql_udfs.sql.

  6. Fügen Sie den kopierten Inhalt aus der DDL-Datei in einen SQL-Editor-Tab ein.

  7. Klicken Sie auf Ausführen.

gcloud

Mit dem Befehl gcloud spanner database ddl update können Sie die MySQL-UDFs installieren.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • DATABASE_ID: Die ID der Datenbank, der die MySQL-UDFs hinzugefügt werden sollen.
  • INSTANCE_ID: die ID der Instanz, in der sich die Datenbank befindet.
  • DDL_FILE_PATH: Pfad zu einer Datei, die alle CREATE OR REPLACE FUNCTION-Anweisungen in der Datei mysql_udfs.sql enthält.

Führen Sie folgenden Befehl aus:

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

Nächste Schritte