SET

適用対象:check marked yes Databricks SQL check marked yes Databricks Runtime

セッションレベルで Azure Databricks パラメーターを設定し、既存のパラメーターの値を返すか、値と意味を持つすべてのパラメーターを返します。 Databricks Runtime を使用する場合、パラメーターは SQL Conf プロパティと呼ばれます。

SQL 変数を設定するには、SET VARIABLE を使用します。

構文

SET
SET [ -v ]
SET parameter_key [ = parameter_value ]

パラメーター

  • (なし)

    適用対象:check marked yes Databricks SQL

    変更された Azure Databricks パラメーターのキーと値を出力します。

  • -v

    既存のパラメーターのキー、値、意味を出力します。

  • parameter_key

    指定したパラメーターの値を返します。

  • parameter_key = parameter_value

    指定されたパラメーターの値を設定します。 指定されたパラメーターに古い値が存在する場合は、新しい値によってオーバーライドされます。

Databricks SQL の例

-- Set a property.
> SET ansi_mode = true;

-- List all configuration parameters with their value and description.
> SET -v;

-- List all configuration parameters with a set value for the current session.
> SET;

-- List the value of specified property key.
> SET ansi_mode;
  key        value
  ---------  -----
  ansi_mode  true

-- Use SET VARIABLE to set SQL variables
> DECLARE var INT;
> SET var = 5;
Error: UNSUPPORTED_FEATURE.SET_VARIABLE_USING_SET
> SET VAR var = 5;
> SELECT var;
  5

Databricks Runtime の例

-- Set a property.
> SET spark.sql.variable.substitute=false;

-- List all SQLConf properties with value and meaning.
> SET -v;

-- List all SQLConf properties with value for current session.
> SET;

-- List the value of specified property key.
> SET spark.sql.variable.substitute;
                           key value
 ----------------------------- -----
 spark.sql.variable.substitute false