MySQL ユーザー定義関数をインストールする

このドキュメントでは、MySQL 関数の事前定義されたライブラリを Spanner データベースにインストールする方法について説明します。これらの関数は、 Google Cloud コンソールまたは Google Cloud CLI を使用してデータベースに追加できます。

これらの MySQL 関数をインストールすると、Spanner の機能が拡張され、MySQL 環境で一般的なオペレーションを Spanner 内で直接実行できるようになります。

Spanner がサポートする MySQL 関数については、MySQL 関数をご覧ください。

必要なロール

MySQL 関数をインストールするために必要な権限を取得するには、プロジェクトに対する Cloud Spanner データベース管理者 （roles/spanner.databaseAdmin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

MySQL ユーザー定義関数をインストールする

MySQL ユーザー定義関数は、次の方法で Spanner データベースにインストールできます。

Google Cloud コンソール

  1. Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。

    インスタンス ページに移動

  2. データベースがあるインスタンスをクリックします。

  3. データベースをクリックします。

  4. [DDL を作成] ボタンをクリックして、Spanner Studio を開きます。

  5. mysql_udfs.sql ファイルの DDL ファイルの内容全体をコピーします。

  6. SQL エディタのタブで、DDL ファイルからコピーした内容を貼り付けます。

  7. [実行] をクリックします。

gcloud

MySQL UDF をインストールするには、gcloud spanner database ddl update コマンドを使用します。

後述のコマンドデータを使用する前に、次のように置き換えます。

  • DATABASE_ID: MySQL UDF を追加するデータベースの ID。
  • INSTANCE_ID: データベースが配置されているインスタンスの ID。
  • DDL_FILE_PATH: mysql_udfs.sql ファイル内のすべての CREATE OR REPLACE FUNCTION ステートメントを含むファイルへのパス。

次のコマンドを実行します。

Linux、macOS、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

次のステップ