Undo file renaming for ru and zh

2024-11-21 23:21:59 +00:00 · 2024-05-09 10:57:13 +02:00 · 2024-05-09 10:57:13 +02:00 · ca5e70f424
commit ca5e70f424
parent 1aa10b1633
2 changed files with 565 additions and 0 deletions
--- a/docs/ru/sql-reference/functions/functions-for-nulls.md
+++ b/docs/ru/sql-reference/functions/functions-for-nulls.md
@ -0,0 +1,311 @@
+---
+slug: /ru/sql-reference/functions/functions-for-nulls
+sidebar_position: 63
+sidebar_label: "Функции для работы с Nullable-аргументами"
+---
+
+# Функции для работы с Nullable-аргументами {#funktsii-dlia-raboty-s-nullable-argumentami}
+
+## isNull {#isnull}
+
+Проверяет является ли аргумент [NULL](../../sql-reference/syntax.md#null-literal).
+
+``` sql
+isNull(x)
+```
+
+Синоним: `ISNULL`.
+
+**Аргументы**
+
+-   `x` — значение с не составным типом данных.
+
+**Возвращаемое значение**
+
+-   `1`, если `x` — `NULL`.
+-   `0`, если `x` — не `NULL`.
+
+**Пример**
+
+Входная таблица
+
+``` text
+┌─x─┬────y─┐
+│ 1 │ ᴺᵁᴸᴸ │
+│ 2 │    3 │
+└───┴──────┘
+```
+
+Запрос
+
+``` sql
+SELECT x FROM t_null WHERE isNull(y);
+```
+
+``` text
+┌─x─┐
+│ 1 │
+└───┘
+```
+
+## isNotNull {#isnotnull}
+
+Проверяет не является ли аргумент [NULL](../../sql-reference/syntax.md#null-literal).
+
+``` sql
+isNotNull(x)
+```
+
+**Аргументы**
+
+-   `x` — значение с не составным типом данных.
+
+**Возвращаемое значение**
+
+-   `0`, если `x` — `NULL`.
+-   `1`, если `x` — не `NULL`.
+
+**Пример**
+
+Входная таблица
+
+``` text
+┌─x─┬────y─┐
+│ 1 │ ᴺᵁᴸᴸ │
+│ 2 │    3 │
+└───┴──────┘
+```
+
+Запрос
+
+``` sql
+SELECT x FROM t_null WHERE isNotNull(y);
+```
+
+``` text
+┌─x─┐
+│ 2 │
+└───┘
+```
+
+## coalesce {#coalesce}
+
+Последовательно слева-направо проверяет являются ли переданные аргументы `NULL` и возвращает первый не `NULL`.
+
+``` sql
+coalesce(x,...)
+```
+
+**Аргументы**
+
+-   Произвольное количество параметров не составного типа. Все параметры должны быть совместимы по типу данных.
+
+**Возвращаемые значения**
+
+-   Первый не `NULL` аргумент.
+-   `NULL`, если все аргументы — `NULL`.
+
+**Пример**
+
+Рассмотрим адресную книгу, в которой может быть указано несколько способов связи с клиентом.
+
+``` text
+┌─name─────┬─mail─┬─phone─────┬──icq─┐
+│ client 1 │ ᴺᵁᴸᴸ │ 123-45-67 │  123 │
+│ client 2 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ      │ ᴺᵁᴸᴸ │
+└──────────┴──────┴───────────┴──────┘
+```
+
+Поля `mail` и `phone` имеют тип String, а поле `icq` — `UInt32`, его необходимо будет преобразовать в `String`.
+
+Получим из адресной книги первый доступный способ связаться с клиентом:
+
+``` sql
+SELECT coalesce(mail, phone, CAST(icq,'Nullable(String)')) FROM aBook;
+```
+
+``` text
+┌─name─────┬─coalesce(mail, phone, CAST(icq, 'Nullable(String)'))─┐
+│ client 1 │ 123-45-67                                            │
+│ client 2 │ ᴺᵁᴸᴸ                                                 │
+└──────────┴──────────────────────────────────────────────────────┘
+```
+
+## ifNull {#ifnull}
+
+Возвращает альтернативное значение, если основной аргумент — `NULL`.
+
+``` sql
+ifNull(x,alt)
+```
+
+**Аргументы**
+
+-   `x` — значение для проверки на `NULL`,
+-   `alt` — значение, которое функция вернёт, если `x` — `NULL`.
+
+**Возвращаемые значения**
+
+-   Значение `x`, если `x` — не `NULL`.
+-   Значение `alt`, если `x` — `NULL`.
+
+**Пример**
+
+``` sql
+SELECT ifNull('a', 'b');
+```
+
+``` text
+┌─ifNull('a', 'b')─┐
+│ a                │
+└──────────────────┘
+```
+
+``` sql
+SELECT ifNull(NULL, 'b');
+```
+
+``` text
+┌─ifNull(NULL, 'b')─┐
+│ b                 │
+└───────────────────┘
+```
+
+## nullIf {#nullif}
+
+Возвращает `NULL`, если аргументы равны.
+
+``` sql
+nullIf(x, y)
+```
+
+**Аргументы**
+
+`x`, `y` — значения для сравнивания. Они должны быть совместимых типов, иначе ClickHouse сгенерирует исключение.
+
+**Возвращаемые значения**
+
+-   `NULL`, если аргументы равны.
+-   Значение `x`, если аргументы не равны.
+
+**Пример**
+
+``` sql
+SELECT nullIf(1, 1);
+```
+
+``` text
+┌─nullIf(1, 1)─┐
+│         ᴺᵁᴸᴸ │
+└──────────────┘
+```
+
+``` sql
+SELECT nullIf(1, 2);
+```
+
+``` text
+┌─nullIf(1, 2)─┐
+│            1 │
+└──────────────┘
+```
+
+## assumeNotNull {#assumenotnull}
+
+Приводит значение типа [Nullable](../../sql-reference/functions/functions-for-nulls.md) к не `Nullable`, если значение не `NULL`.
+
+``` sql
+assumeNotNull(x)
+```
+
+**Аргументы**
+
+-   `x` — исходное значение.
+
+**Возвращаемые значения**
+
+-   Исходное значение с не `Nullable` типом, если оно — не `NULL`.
+-   Неспецифицированный результат, зависящий от реализации, если исходное значение — `NULL`.
+
+**Пример**
+
+Рассмотрим таблицу `t_null`.
+
+``` sql
+SHOW CREATE TABLE t_null;
+```
+
+``` text
+┌─statement─────────────────────────────────────────────────────────────────┐
+│ CREATE TABLE default.t_null ( x Int8,  y Nullable(Int8)) ENGINE = TinyLog │
+└───────────────────────────────────────────────────────────────────────────┘
+```
+
+``` text
+┌─x─┬────y─┐
+│ 1 │ ᴺᵁᴸᴸ │
+│ 2 │    3 │
+└───┴──────┘
+```
+
+Применим функцию `assumeNotNull` к столбцу `y`.
+
+``` sql
+SELECT assumeNotNull(y) FROM t_null;
+```
+
+``` text
+┌─assumeNotNull(y)─┐
+│                0 │
+│                3 │
+└──────────────────┘
+```
+
+``` sql
+SELECT toTypeName(assumeNotNull(y)) FROM t_null;
+```
+
+``` text
+┌─toTypeName(assumeNotNull(y))─┐
+│ Int8                         │
+│ Int8                         │
+└──────────────────────────────┘
+```
+
+## toNullable {#tonullable}
+
+Преобразует тип аргумента к `Nullable`.
+
+``` sql
+toNullable(x)
+```
+
+**Аргументы**
+
+-   `x` — значение произвольного не составного типа.
+
+**Возвращаемое значение**
+
+-   Входное значение с типом не `Nullable`.
+
+**Пример**
+
+``` sql
+SELECT toTypeName(10);
+```
+
+``` text
+┌─toTypeName(10)─┐
+│ UInt8          │
+└────────────────┘
+```
+
+``` sql
+SELECT toTypeName(toNullable(10));
+```
+
+``` text
+┌─toTypeName(toNullable(10))─┐
+│ Nullable(UInt8)            │
+└────────────────────────────┘
+```
--- a/docs/zh/sql-reference/functions/functions-for-nulls.md
+++ b/docs/zh/sql-reference/functions/functions-for-nulls.md
@ -0,0 +1,254 @@
+---
+slug: /zh/sql-reference/functions/functions-for-nulls
+---
+# Nullable处理函数 {#nullablechu-li-han-shu}
+
+## isNull {#isnull}
+
+检查参数是否为[NULL](../../sql-reference/syntax.md#null-literal)。
+
+    isNull(x)
+
+**参数**
+
+-   `x` — 一个非复合数据类型的值。
+
+**返回值**
+
+-   `1` 如果`x`为`NULL`。
+-   `0` 如果`x`不为`NULL`。
+
+**示例**
+
+存在以下内容的表
+
+```response
+┌─x─┬────y─┐
+│ 1 │ ᴺᵁᴸᴸ │
+│ 2 │    3 │
+└───┴──────┘
+```
+
+对其进行查询
+
+```sql
+SELECT x FROM t_null WHERE isNull(y)
+```
+
+```response
+┌─x─┐
+│ 1 │
+└───┘
+```
+
+## isNotNull {#isnotnull}
+
+检查参数是否不为 [NULL](../../sql-reference/syntax.md#null-literal).
+
+    isNotNull(x)
+
+**参数:**
+
+-   `x` — 一个非复合数据类型的值。
+
+**返回值**
+
+-   `0` 如果`x`为`NULL`。
+-   `1` 如果`x`不为`NULL`。
+
+**示例**
+
+存在以下内容的表
+
+```response
+┌─x─┬────y─┐
+│ 1 │ ᴺᵁᴸᴸ │
+│ 2 │    3 │
+└───┴──────┘
+```
+
+对其进行查询
+
+```sql
+SELECT x FROM t_null WHERE isNotNull(y)
+```
+
+```response
+┌─x─┐
+│ 2 │
+└───┘
+```
+
+## 合并 {#coalesce}
+
+检查从左到右是否传递了«NULL»参数并返回第一个非`'NULL`参数。
+
+    coalesce(x,...)
+
+**参数:**
+
+-   任何数量的非复合类型的参数。所有参数必须与数据类型兼容。
+
+**返回值**
+
+-   第一个非’NULL\`参数。
+-   `NULL`，如果所有参数都是’NULL\`。
+
+**示例**
+
+考虑可以指定多种联系客户的方式的联系人列表。
+
+```response
+┌─name─────┬─mail─┬─phone─────┬──icq─┐
+│ client 1 │ ᴺᵁᴸᴸ │ 123-45-67 │  123 │
+│ client 2 │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ      │ ᴺᵁᴸᴸ │
+└──────────┴──────┴───────────┴──────┘
+```
+
+`mail`和`phone`字段是String类型，但`icq`字段是`UInt32`，所以它需要转换为`String`。
+
+从联系人列表中获取客户的第一个可用联系方式：
+
+```sql
+SELECT coalesce(mail, phone, CAST(icq,'Nullable(String)')) FROM aBook
+```
+
+```response
+┌─name─────┬─coalesce(mail, phone, CAST(icq, 'Nullable(String)'))─┐
+│ client 1 │ 123-45-67                                            │
+│ client 2 │ ᴺᵁᴸᴸ                                                 │
+└──────────┴──────────────────────────────────────────────────────┘
+```
+
+## ifNull {#ifnull}
+
+如果第一个参数为«NULL»，则返回第二个参数的值。
+
+    ifNull(x,alt)
+
+**参数:**
+
+-   `x` — 要检查«NULL»的值。
+-   `alt` — 如果`x`为’NULL\`，函数返回的值。
+
+**返回值**
+
+-   价值 `x`，如果 `x` 不是 `NULL`.
+-   价值 `alt`，如果 `x` 是 `NULL`.
+
+**示例**
+
+    SELECT ifNull('a', 'b')
+
+    ┌─ifNull('a', 'b')─┐
+    │ a                │
+    └──────────────────┘
+
+    SELECT ifNull(NULL, 'b')
+
+    ┌─ifNull(NULL, 'b')─┐
+    │ b                 │
+    └───────────────────┘
+
+## nullIf {#nullif}
+
+如果参数相等，则返回`NULL`。
+
+    nullIf(x, y)
+
+**参数:**
+
+`x`, `y` — 用于比较的值。 它们必须是类型兼容的，否则将抛出异常。
+
+**返回值**
+
+-   如果参数相等，则为`NULL`。
+-   如果参数不相等，则为`x`值。
+
+**示例**
+
+    SELECT nullIf(1, 1)
+
+    ┌─nullIf(1, 1)─┐
+    │         ᴺᵁᴸᴸ │
+    └──────────────┘
+
+    SELECT nullIf(1, 2)
+
+    ┌─nullIf(1, 2)─┐
+    │            1 │
+    └──────────────┘
+
+## assumeNotNull {#assumenotnull}
+
+将[可为空](../../sql-reference/functions/functions-for-nulls.md)类型的值转换为非`Nullable`类型的值。
+
+    assumeNotNull(x)
+
+**参数：**
+
+-   `x` — 原始值。
+
+**返回值**
+
+-   如果`x`不为`NULL`，返回非`Nullable`类型的原始值。
+-   如果`x`为`NULL`，则返回任意值。
+
+**示例**
+
+存在如下`t_null`表。
+
+    SHOW CREATE TABLE t_null
+
+    ┌─statement─────────────────────────────────────────────────────────────────┐
+    │ CREATE TABLE default.t_null ( x Int8,  y Nullable(Int8)) ENGINE = TinyLog │
+    └───────────────────────────────────────────────────────────────────────────┘
+
+    ┌─x─┬────y─┐
+    │ 1 │ ᴺᵁᴸᴸ │
+    │ 2 │    3 │
+    └───┴──────┘
+
+将列`y`作为`assumeNotNull`函数的参数。
+
+    SELECT assumeNotNull(y) FROM t_null
+
+    ┌─assumeNotNull(y)─┐
+    │                0 │
+    │                3 │
+    └──────────────────┘
+
+    SELECT toTypeName(assumeNotNull(y)) FROM t_null
+
+    ┌─toTypeName(assumeNotNull(y))─┐
+    │ Int8                         │
+    │ Int8                         │
+    └──────────────────────────────┘
+
+## 可调整 {#tonullable}
+
+将参数的类型转换为`Nullable`。
+
+    toNullable(x)
+
+**参数：**
+
+-   `x` — 任何非复合类型的值。
+
+**返回值**
+
+-   输入的值，但其类型为`Nullable`。
+
+**示例**
+
+    SELECT toTypeName(10)
+
+    ┌─toTypeName(10)─┐
+    │ UInt8          │
+    └────────────────┘
+
+    SELECT toTypeName(toNullable(10))
+
+    ┌─toTypeName(toNullable(10))─┐
+    │ Nullable(UInt8)            │
+    └────────────────────────────┘