assumeNotNull
導入バージョン: v1.1
型 Nullable の値に対して、対応する非 Nullable 型の値を返します。
元の値が NULL の場合、不定の結果が返されることがあります。
関連項目: 関数 ifNull、coalesce。
構文
引数
戻り値
元の値が NULL でない場合は非 Nullable 型の値を返し、入力値が NULL の場合は任意の値を返します。Any
例
使用例
```sql title=クエリ
CREATE TABLE t_null (x Int8, y Nullable(Int8))
ENGINE=MergeTree()
ORDER BY x;
INSERT INTO t_null VALUES (1, NULL), (2, 3);
SELECT assumeNotNull(y) FROM table;
SELECT toTypeName(assumeNotNull(y)) FROM t_null;
```
┌─assumeNotNull(y)─┐
│ 0 │
│ 3 │
└──────────────────┘
┌─toTypeName(assumeNotNull(y))─┐
│ Int8 │
│ Int8 │
└──────────────────────────────┘
coalesce
導入バージョン: v1.1
最も左側にある NULL ではない引数を返します。
構文
引数
x[, y, ...] — 任意個数の非複合型パラメータ。すべてのパラメータは互いに互換性のあるデータ型である必要があります。Any
戻り値
最初の NULL ではない引数を返します。すべての引数が NULL の場合は NULL を返します。Any または NULL
例
使用例
-- 顧客への複数の連絡方法を指定可能な連絡先リストを考えます。
CREATE TABLE aBook
(
name String,
mail Nullable(String),
phone Nullable(String),
telegram Nullable(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO aBook VALUES ('client 1', NULL, '123-45-67', 123), ('client 2', NULL, NULL, NULL);
-- mailフィールドとphoneフィールドはString型ですが、telegramフィールドはUInt32型のため、String型への変換が必要です。
-- 連絡先リストから顧客の利用可能な最初の連絡方法を取得します
SELECT name, coalesce(mail, phone, CAST(telegram,'Nullable(String)')) FROM aBook;
┌─name─────┬─coalesce(mail, phone, CAST(telegram, 'Nullable(String)'))─┐
│ client 1 │ 123-45-67 │
│ client 2 │ ᴺᵁᴸᴸ │
└──────────┴───────────────────────────────────────────────────────────┘
firstNonDefault
導入バージョン: v25.9
引数の中から、デフォルト値ではない最初の値を返します。
構文
引数
arg1 — 確認する最初の引数 - arg2 — 確認する2番目の引数 - ... — 確認する追加の引数
返り値
結果の型は、すべての引数のスーパータイプになります
例
整数
SELECT firstNonDefault(0, 1, 2)
文字列
SELECT firstNonDefault('', 'hello', 'world')
NULL 値
SELECT firstNonDefault(NULL, 0 :: UInt8, 1 :: UInt8)
NULL 許容ゼロ
SELECT firstNonDefault(NULL, 0 :: Nullable(UInt8), 1 :: Nullable(UInt8))
ifNull
導入バージョン: v1.1
最初の引数が NULL の場合に、代わりの値を返します。
構文
引数
x — NULL かどうかをチェックする値。Anyalt — x が NULL の場合に関数が返す値。Any
返される値
x が NULL でない場合は x の値を返し、それ以外の場合は alt を返します。Any
例
使用例
SELECT ifNull('a', 'b'), ifNull(NULL, 'b');
┌─ifNull('a', 'b')─┬─ifNull(NULL, 'b')─┐
│ a │ b │
└──────────────────┴───────────────────┘
isNotNull
導入: v1.1
引数が NULL でないかどうかを判定します。
関連項目: 演算子 IS NOT NULL。
構文
引数
戻り値
x が NULL でない場合は 1、それ以外の場合は 0 を返します。UInt8
例
使用例
CREATE TABLE t_null
(
x Int32,
y Nullable(Int32)
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO t_null VALUES (1, NULL), (2, 3);
SELECT x FROM t_null WHERE isNotNull(y);
isNull
導入バージョン: v1.1
引数が NULL かどうかをチェックします。
関連項目: 演算子 IS NULL。
構文
引数
戻り値
x が NULL の場合は 1 を、それ以外の場合は 0 を返します。UInt8
例
使用例
CREATE TABLE t_null
(
x Int32,
y Nullable(Int32)
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO t_null VALUES (1, NULL), (2, 3);
SELECT x FROM t_null WHERE isNull(y);
isNullable
導入: v22.7
引数のデータ型が Nullable（NULL 値を許容する型）かどうかを判定します。
構文
引数
戻り値
x が Nullable データ型であれば 1 を返し、それ以外の場合は 0 を返します。UInt8
例
使用例
CREATE TABLE tab (
ordinary_col UInt32,
nullable_col Nullable(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO tab (ordinary_col, nullable_col) VALUES (1,1), (2, 2), (3,3);
SELECT isNullable(ordinary_col), isNullable(nullable_col) FROM tab;
┌───isNullable(ordinary_col)──┬───isNullable(nullable_col)──┐
│ 0 │ 1 │
│ 0 │ 1 │
│ 0 │ 1 │
└─────────────────────────────┴─────────────────────────────┘
isZeroOrNull
導入バージョン: v20.3
引数がゼロ（0）または NULL かどうかをチェックします。
構文
引数
返される値
x が NULL またはゼロに等しい場合は 1 を返し、それ以外の場合は 0 を返します。UInt8/16/32/64 または Float32/Float64
例
使用例
CREATE TABLE t_null
(
x Int32,
y Nullable(Int32)
)
ENGINE = MergeTree
ORDER BY tuple();
INSERT INTO t_null VALUES (1, NULL), (2, 0), (3, 3);
SELECT x FROM t_null WHERE isZeroOrNull(y);
nullIf
導入バージョン: v1.1
2つの引数が等しい場合、NULL を返します。
構文
引数
戻り値
両方の引数が同じ値の場合は NULL を返し、それ以外の場合は 1つ目の引数を返します。NULL または Nullable(x)
例
使用例
SELECT nullIf(1, 1), nullIf(1, 2);
┌─nullIf(1, 1)─┬─nullIf(1, 2)─┐
│ ᴺᵁᴸᴸ │ 1 │
└──────────────┴──────────────┘
toNullable
導入バージョン: v1.1
指定された引数の型を Nullable 型に変換します。
構文
引数
戻り値
入力値と同じ値を返すが、その型は Nullable となる。Nullable(Any)
例
使用例
SELECT toTypeName(10), toTypeName(toNullable(10));
┌─toTypeName(10)─┬─toTypeName(toNullable(10))─┐
│ UInt8 │ Nullable(UInt8) │
└────────────────┴────────────────────────────┘
