getbit 関数

適用対象:check marked yes Databricks SQL のチェックをオン Databricks Runtime 10.4 LTS 以降

ビットの値を整数数値のバイナリ表現で返します。 この関数は、 bit_get 関数のシノニムです。

構文

getbit(expr, pos))

引数

  • expr: 整数の数値に評価される式。
  • pos: INTEGER 型の式。

戻り値

結果の型は整数です。

ビットが設定されている場合は結果の値は 1、それ以外の場合は 0 です。

ビットは 0 を基準に右から左にカウントされます。

posexpr Azure Databricks のデータ型の範囲外にある場合、INVALID_PARAMETER_VALUE エラーが発生します。

一般的なエラー状態

> SELECT hex(23Y), getbit(23Y, 3);
 0

> SELECT hex(23Y), getbit(23Y, 0);
 1

> SELECT getbit(23Y, 8);
 Error: INVALID_PARAMETER_VALUE.BIT_POSITION_RANGE

> SELECT getbit(23Y, -1);
 Error: INVALID_PARAMETER_VALUE.BIT_POSITION_RANGE