MODULE DATA

概要

MODULE DATA ステートメントには、以下の2つの機能があります：

• ALTER SYSTEM LOAD MODULE DATA ...：このステートメントは、特定のテナントに指定された機能をインポートするために使用されます。
• ALTER SYSTEM CHECK MODULE DATA ...：このステートメントは、特定のテナントの指定された機能がインポートされているかどうかを確認するために使用されます。

制限事項と注意点

• このステートメントは、sys（システム）テナントでのみ実行できます。
• 現在のバージョンでは、MySQLモードのテナントにのみREDISモジュール機能をインポートできます。
• 現在のバージョンでは、インポートされたREDISモジュール機能のチェック(CHECK MODULE DATA)のみサポートされています。

権限要件

このステートメントを実行するユーザーは、ALTER SYSTEM 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードにおける権限の分類を参照してください。

構文

ALTER SYSTEM {LOAD | CHECK} MODULE DATA
    MODULE = module_value
    TENANT = tenant_name
    [INFILE = file_path];

module_value:
    REDIS
    | GIS
    | TIMEZONE

パラメータの説明

module_value

• REDIS：REDISモジュール機能の操作を表します。
• GIS：GISモジュール機能の操作を表します。
• TIMEZONE：TIMEZONEモジュール機能の操作を表します。

例

LOAD MODULE DATA例

1. テナント mysql001 に REDIS モジュール機能をインポートします。現在、REDIS モジュール機能では INFILE パスを使用することはサポートされていないため、エラーが発生します。

   ALTER SYSTEM LOAD MODULE DATA
       MODULE = REDIS
       TENANT = mysql001
       INFILE = '/home/admin/test.sql';
   

   実行結果は次のとおりです：

   ERROR 4025 (HY000): loading redis module does not need to specify infile
   

2. テナント mysql001 に REDIS モジュール機能をインポートします。

   ALTER SYSTEM LOAD MODULE DATA
       MODULE = REDIS
       TENANT = mysql001;
   

   実行結果は次のとおりです：

   Query OK, 0 rows affected
   

3. テナント mysql001 に GIS モジュール機能をインポートします。この場合、INFILE パラメータは省略可能であり、デフォルト値は etc/ です。対応するファイルはデプロイメントディレクトリ内の etc ディレクトリにあります。

   ALTER SYSTEM LOAD MODULE DATA
       MODULE = GIS
       TENANT = mysql001
       INFILE = 'etc/';
   

   実行結果は次のとおりです：

   Query OK, 0 rows affected
   

4. テナント mysql001 に TIMEZONE モジュール機能をインポートします。この場合、INFILE パラメータは省略可能であり、デフォルト値は etc/ です。対応するファイルはデプロイメントディレクトリ内の etc ディレクトリにあります。

   ALTER SYSTEM LOAD MODULE DATA
       MODULE = TIMEZONE
       TENANT = mysql001
       INFILE = 'etc/';
   

   実行結果は次のとおりです：

   Query OK, 0 rows affected
   

CHECK MODULE DATAの例

• テナントに機能がインポートされていない場合、CHECK MODULE DATA ステートメントの実行時にエラーが発生します。テナント mysql002 に REDIS モジュール機能がインポートされているかどうかを確認します。

  ALTER SYSTEM CHECK MODULE DATA
      MODULE = REDIS
      TENANT = mysql002;
  

  実行結果は次のとおりです：

  ERROR 4025 (HY000): redis info is not complete，please retry loading
  

• テナントに機能をインポートした後で、インポートされた機能の状況を確認します。

  1. テナント mysql002 に REDIS モジュール機能をインポートします。

     ALTER SYSTEM LOAD MODULE DATA
         MODULE = REDIS
         TENANT = 'mysql002';
     

     実行結果は次のとおりです：

     Query OK, 0 rows affected
     

  2. テナント mysql002 に REDIS モジュール機能がインポートされているかどうかを確認します。

     ALTER SYSTEM CHECK MODULE DATA
         MODULE = REDIS
         TENANT = mysql002;
     

     実行結果は次のとおりです：

     Query OK, 0 rows affected