メインコンテンツまでスキップ
バージョン: 26.x

UNSET VARIABLE

説明​

このステートメントは、Dorisシステム変数を復元するために使用されます。これらのシステム変数は、グローバルレベルまたはセッションレベルで変更できます。

構文​

UNSET [<effective_scope>] VARIABLE (<variable_name>)

必須パラメータ​

1. <variable_name>

変数名を指定するか、すべての変数を設定解除したい場合は、このパラメータにキーワードALLを指定できます。

オプションパラメータ​

1. <effective_scope>

有効範囲はGLOBAL、SESSION、LOCALのいずれかです。有効範囲が指定されていない場合、デフォルト値はSESSIONです。LOCALはSESSIONのエイリアスです。

アクセス制御要件​

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持っている必要があります：

権限オブジェクト注記
ADMIN_PRIVSessionグローバル変数の設定解除には管理者権限が必要

使用上の注意​

  • ADMINユーザーのみがグローバルに効果を持つ変数の設定解除を行うことができます
  • GLOBALで変数を復元する場合、現在使用中のセッションと新しく開かれるセッションにのみ影響します。現在開かれている他のセッションには影響しません。

例​

  • タイムゾーンの値を復元

    UNSET VARIABLE time_zone;

  • グローバル実行メモリサイズを復元する

    UNSET GLOBAL VARIABLE exec_mem_limit;

  • すべての変数をグローバルに復元する

    UNSET GLOBAL VARIABLE ALL;