Функция cast

Область применения: Databricks SQL Databricks Runtime

Приводит значение expr к типу данных type. Этот оператор является синонимом оператора ::.

Синтаксис

cast(sourceExpr AS targetType)

Аргументы

• sourceExpr: любое выражение, допускающее приведение.
• targetType — тип данных результата.

Возвраты

Результат имеет тип targetType.

Допустимы следующие сочетания приведения типов данных:

Правила и ограничения на основе targetType.

числовой

Если targetType является числом, а sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULL заданного числового типа.

• числовой

  Если targetType это целочисленное число, результат sourceExprусечен до целого числа.

  В противном случае результат округляется sourceExpr до подходящего масштабаtargetType.

  Если значение выходит за диапазон targetType, возникает ошибка переполнения.

  Используйте try_cast для преобразования ошибок переполнения в NULL.

• СТРУНА

  sourceExpr считывается как литеральное значение targetType.

  Если sourceExpr не соответствует формату литеральных значений, возникает ошибка.

  Если значение не входит в диапазон targetType, возникает ошибка переполнения.

  Используйте try_cast, чтобы преобразовать ошибки переполнения и недопустимого формата в NULL.

• TIMESTAMP

  Результатом будет число секунд между 1970-01-01 00:00:00 UTC и sourceExpr.

  Если targetType является целочисленным, результат усекается до целого числа.

  В противном случае результат округляется, чтобы соответствовать доступной шкале targetType.

  Если результат не входит в диапазон targetType, возникает ошибка переполнения.

  Используйте try_cast для преобразования ошибок переполнения в NULL.

• ИНТЕРВАЛ

  Область применения: Databricks SQL Databricks Runtime 11.3 LTS и выше

  Целевой тип должен быть точным числовым значением.

  Учитывая INTERVAL upper_unit TO lower_unit, результат измеряется в общем числе lower_unit. Если lower_unit равно SECOND, дробные секунды хранятся справа от десятичной запятой. Для всех остальных интервалов результатом всегда является целое число.

• БУЛЕВ

  Если sourceExpr равно:

  • true — результатом будет 1.
  • false — результатом будет 0.
  • NULL — результатом будет NULL.

• ВАРИАНТ

  Правила типа фактического VARIANT значения типа применяются.

Примеры

> SELECT cast(NULL AS INT);
  NULL

> SELECT cast(5.6 AS INT);
  5

> SELECT cast(5.6 AS DECIMAL(2, 0));
  6

> SELECT cast(-5.6 AS INT);
  -5

> SELECT cast(-5.6 AS DECIMAL(2, 0));
  -6

> SELECT cast(128 AS TINYINT);
  Overflow

> SELECT cast(128 AS DECIMAL(2, 0));
  Overflow

> SELECT cast('123' AS INT);
  123

> SELECT cast('123.0' AS INT);
  Invalid format

> SELECT cast(TIMESTAMP'1970-01-01 00:00:01' AS LONG);
  1

> SELECT cast(TIMESTAMP'1970-01-01 00:00:00.000001' AS DOUBLE);
  1.0E-6

> SELECT cast(TIMESTAMP'2022-02-01 00:00:00' AS SMALLINT);
  error: overflow
> SELECT cast(true AS BOOLEAN);
  1

> SELECT cast(INTERVAL '1-2' YEAR TO MONTH AS INTEGER);
  14

> SELECT cast(INTERVAL '1:30.5' MINUTE TO SECOND AS DECIMAL(5, 2));
  90.50

> SELECT cast(TRUE AS INT);
  1

> SELECT cast(FALSE AS INT);
  0

> SELECT cast('15'::VARIANT AS INT);
  15

СТРУНА

Если sourceExpr является STRING, результирующий STRING, наследует коллацию из sourceExpr. Во всех остальных случаях сортировка результирующего STRING — это сортировка по умолчанию .

Чтобы изменить коллацию, добавьте выражение collate.

Если targetType является типомSTRING, а sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULL строка.

• точное числовое значение

  Результатом будет литеральное число с необязательным знаком минуса и без начальных нулей, за исключением одной цифры слева от десятичной точки. Если targetType является DECIMAL(p, s), в котором s больше 0, добавляется десятичная точка и конечные нули для масштаба.

• бинарный с плавающей запятой

  Если абсолютное число меньше 10,000,000 и больше или равно 0.001, результат выражается без экспоненциального представления по меньшей мере с одной цифрой на обеих сторонах десятичной точки.

  В противном случае Azure Databricks использует мантиссу, за которой следует E и экспонент. Мантисса имеет необязательный начальный знак минуса, за которым следует одна цифра слева от десятичной точки, и минимальное число цифр больше нуля справа. Экспонента имеет необязательный начальный знак минуса.

• ДАТА

  Если год находится в диапазоне от 9999 г. до нашей эры до 9999 г. нашей эры, результатом будет dateString в виде -YYYY-MM-DD и YYYY-MM-DD соответственно.

  Для лет до или после этого диапазона к компоненту года добавляется необходимое количество цифр, и для обозначения нашей эры используется +.

• TIMESTAMP

  Если год находится в диапазоне от 9999 г. до нашей эры до 9999 г. нашей эры, результатом будет timestampString в виде -YYYY-MM-DD hh:mm:ss и YYYY-MM-DD hh:mm:ss соответственно.

  Для лет до или после этого диапазона к компоненту года добавляется необходимое количество цифр, и для обозначения нашей эры используется +.

  При необходимости добавляются доли секунд .f....

• TIMESTAMP_NTZ

  Если год находится в диапазоне от 9999 г. до нашей эры до 9999 г. нашей эры, результатом будет timestampString в виде -YYYY-MM-DD hh:mm:ss и YYYY-MM-DD hh:mm:ss соответственно.

  Для лет до или после этого диапазона к компоненту года добавляется необходимое количество цифр, и для обозначения нашей эры используется +.

  При необходимости добавляются доли секунд .f....

• годично-месячный интервал

  Результатом будет его самое краткое представление как литерала интервала. Если интервал отрицательный, знак вставляется в interval-string. Для единиц меньше 10 начальные нули опускаются.

  Типичная строка year-month interval имеет следующий вид:

  • INTERVAL 'Y' YEAR
  • INTERVAL 'Y-M' YEAR TO MONTH
  • INTERVAL 'M' MONTH

• интервал дня

  Результатом будет его самое краткое представление как литерала интервала. Если интервал отрицательный, знак вставляется в interval-string. Для единиц меньше 10 начальные нули опускаются.

  Типичная строка day-time interval имеет следующий вид:

  • INTERVAL 'D' DAY
  • INTERVAL 'D h' DAY TO HOUR
  • INTERVAL 'D h:m' DAY TO MINUTE
  • INTERVAL 'D h:m:s' DAY TO SECOND
  • INTERVAL 'h' HOUR
  • INTERVAL 'h:m' HOUR TO MINUTE
  • INTERVAL 'm:s' MINUTE TO SECOND
  • INTERVAL 's' SECOND

• БУЛЕВ

  Результат true является логическим значением STRING литерала true. Для false это строковый литерал false. Для NULL это NULL-строка.

• ДВОИЧНЫЙ

  Результатом будет двоичное свойство sourceExpr, которое интерпретируется как последовательность символов UTF-8.

  Azure Databricks не проверяет символы UTF-8. Приведение от BINARY к STRING никогда не приводит к внедрению символов подстановки или не вызывает ошибок.

• МАССИВ

  Результатом будет разделенный запятыми список приведенных элементов, которые заключаются в квадратные скобки [ ]. За каждой запятой следует один пробел. Элемент NULL переводится в литерал null.

  Azure Databricks не заключает отдельные элементы в кавычки и не выделяет их, даже если они содержат скобки или запятые.

• КАРТА

  Результатом будет разделенный запятыми список приведенных пар "ключ — значение", которые заключаются в фигурные скобки { }. За каждой запятой следует один пробел. Каждая пара "ключ — значение" разделяется ->. Значение отображения NULL преобразуется в буквальное значение null.

  Azure Databricks не берет в кавычки или иначе помечает отдельные ключи или значения, которые сами могут содержать фигурные скобки, -> или запятые.

• СТРУКТУРА

  Результат представляет собой список значений полей приведения, разделенных запятыми и заключенных в фигурные скобки { }. За каждой запятой следует один пробел. Значение поля NULL преобразуется в литеральное значение null.

  Azure Databricks не цитирует или помечает отдельные значения полей, которые могут содержать фигурные скобки или запятые.

• ВАРИАНТ

  Правила типа фактического VARIANT значения типа применяются.

Примеры

> SELECT cast(NULL AS STRING);
  NULL

> SELECT cast(-3Y AS STRING);
  -3

> SELECT cast(5::DECIMAL(10, 5) AS STRING);
  5.00000

> SELECT cast(12345678e-4 AS STRING);
  1234.5678

> SELECT cast(1e7 as string);
  1.0E7

> SELECT cast(1e6 as string);
  1000000.0

> SELECT cast(1e-4 as string);
  1.0E-4

> SELECT cast(1e-3 as string);
  0.001

> SELECT cast(12345678e7 AS STRING);
  1.2345678E14

> SELECT cast(DATE'1900-12-31' AS STRING);
  1900-12-31

-- Caesar no more
> SELECT cast(DATE'-0044-03-15' AS STRING);
  -0044-03-15

> SELECT cast(DATE'100000-12-31' AS STRING);
  +100000-12-31

> SELECT cast(current_timestamp() AS STRING);
  2022-04-02 22:29:09.783

> SELECT cast(TIMESTAMP_NTZ'2023-01-01' AS STRING);
  2023-01-01 00:00:00

> SELECT cast(INTERVAL -'13-02' YEAR TO MONTH AS STRING);
  INTERVAL '-13-2' YEAR TO MONTH

> SELECT cast(INTERVAL '12:04.9900' MINUTE TO SECOND AS STRING);
  INTERVAL '12:04.99' MINUTE TO SECOND

> SELECT cast(true AS STRING);
  true

> SELECT cast(false AS STRING);
  false

-- A bad UTF-8 string
> SELECT cast(x'33800033' AS STRING);
  3�3

> SELECT hex(cast(x'33800033' AS STRING));
  33800033

> SELECT cast(array('hello', NULL, 'world') AS STRING);
  [hello, null, world]

> SELECT cast(array('hello', 'wor, ld') AS STRING);
  [hello, wor, ld]

> SELECT cast(array() AS STRING);
  []

> SELECT cast(map('hello', 1, 'world', null) AS STRING);
  {hello -> 1, world -> null}

> SELECT cast(map('hello -> 1', DATE'2022-01-01') AS STRING);
  {hello -> 1 -> 2022-01-01}

> SELECT cast(map() AS STRING);
  {}

> SELECT cast(named_struct('a', 5, 'b', 6, 'c', NULL) AS STRING);
  {5, 6, null}

> SELECT cast(named_struct() AS STRING);
  {}

> SELECT cast(DATE'2024-01-05'::VARIANT AS STRING);
  2024-01-05

> SELECT cast(5 AS STRING) COLLATE UNICODE;
  5

Дата

Если targetType является типомDATE, а sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLDATE.

• СТРУНА

  sourceExpr должно быть допустимым значением dateString.

  Если sourceExpr не является допустимым dateString, Azure Databricks возвращает ошибку.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• TIMESTAMP

  Результатом будет дата из временной метки sourceExpr.

• TIMESTAMP_NTZ

  Результатом является часть даты timestamp_ntz sourceExpr.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

Примеры

> SELECT cast(NULL AS DATE);
  NULL

> SELECT cast('1900-10-01' AS DATE);
  1900-10-01

> SELECT cast('1900-10-01' AS DATE);
  1900-10-01

-- There is no February 30.
> SELECT cast('1900-02-30' AS DATE);
  Error

> SELECT cast(TIMESTAMP'1900-10-01 12:13:14' AS DATE);
  1900-10-01

> SELECT cast(TIMESTAMP_NTZ'1900-10-01 12:13:14' AS DATE);
  1900-10-01

> SELECT cast(TIMESTAMP_NTZ'1900-10-01 12:13:14'::VARIANT AS DATE);
  1900-10-01

TIMESTAMP

Если targetType является типомTIMESTAMP, а sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLDATE.

• числовой

  sourceExpr — это количество секунд с момента 1970-01-01 00:00:00 UTC.

  Доли времени меньше микросекунды усекаются.

  Если значение не входит в диапазон TIMESTAMP, возникает ошибка переполнения.

  Используйте try_cast для преобразования ошибок переполнения в NULL.

• СТРУНА

  sourceExpr должно быть допустимым значением timestampString.

  Если sourceExpr не является допустимым timestampString, Azure Databricks возвращает ошибку.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• ДАТА

  Результатом является sourceExprDATE в 00:00:00 часах.

• TIMESTAMP_NTZ

Результатом является значение метки времени с полями года, месяца, дня, часа, минуты и секунды из timestamp_ntz sourceExpr.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

Примеры

> SELECT cast(NULL AS TIMESTAMP);
  NULL

> SET TIME ZONE '+00:00';
> SELECT cast(0.0 AS TIMESTAMP);
  1970-01-01 00:00:00

> SELECT cast(0.0000009 AS TIMESTAMP);
  1970-01-01 00:00:00

> SELECT cast(1e20 AS TIMESTAMP);
  Error: overflow

> SELECT cast('1900' AS TIMESTAMP);
  1900-01-01 00:00:00

> SELECT cast('1900-10-01 12:13:14' AS TIMESTAMP);
  1900-10-01 12:13:14

> SELECT cast('1900-02-30 12:13:14' AS TIMESTAMP);
  Error

> SELECT cast(DATE'1900-10-01' AS TIMESTAMP);
  1900-10-01 00:00:00

> SELECT cast(TIMESTAMP_NTZ'2023-01-01 02:03:04.567' as TIMESTAMP)
  2023-01-01 02:03:04.567

> SELECT cast(DATE'1900-10-01'::VARIANT AS TIMESTAMP);
  1900-10-01 00:00:00

TIMESTAMP_NTZ

Если targetType является типомTIMESTAMP_NTZ, а sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLDATE.

• СТРУНА

  sourceExpr должно быть допустимым значением timestampString.

  Если sourceExpr не является допустимым timestampString, Azure Databricks возвращает ошибку.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• ДАТА

  Результатом будет DATE для sourceExpr в 00:00:00 ч.

• TIMESTAMP

  Результатом является локальное время как sourceExpr в часовом поясе сеанса.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

Примеры

> SELECT cast(NULL AS TIMESTAMP_NTZ);
  NULL

> SELECT cast('1900' AS TIMESTAMP_NTZ);
  1900-01-01 00:00:00

> SELECT cast('1900-10-01 12:13:14' AS TIMESTAMP_NTZ);
  1900-10-01 12:13:14

> SELECT cast('1900-02-30 12:13:14' AS TIMESTAMP_NTZ);
  Error

> SELECT cast(DATE'1900-10-01' AS TIMESTAMP_NTZ);
  1900-10-01 00:00:00

> SELECT current_timezone(), CAST(TIMESTAMP'2021-7-1T8:43:28' as TIMESTAMP_NTZ);
  America/Los_Angeles 2021-07-01 08:43:28

> SELECT current_timezone(), CAST(TIMESTAMP'2021-7-1T8:43:28UTC+3' as TIMESTAMP_NTZ);
  America/Los_Angeles 2021-06-30 22:43:28

> SELECT cast(DATE'1900-10-01'::VARIANT AS TIMESTAMP_NTZ);
  1900-10-01 00:00:00

Интервал год-месяц

Если targetType является интервалом "год-месяц", а sourceExpr — типа:

• ПУСТОТА

  Результатом является годо-месячный NULL интервал.

• integral_numeric

  Область применения: Databricks SQL Databricks Runtime 11.3 LTS и выше

  Числовое значение интерпретируется как число нижних единиц targetTypeгодаmonthIntervalQualifier.

• СТРУНА

  sourceExpr должно быть допустимым значением yearMonthIntervalString.

  Если sourceExpr не является допустимым yearMonthIntervalString, Azure Databricks возвращает ошибку.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• годично-месячный интервал

  targetType Если yearMonthIntervalQualifier содержит MONTH значение остается неизменным, но переосмыслено для соответствия целевому типу.

  В противном случае, если yearMonthIntervalQualifier исходного типа включает MONTH, то результат усекается до целого числа лет.

Примеры

> SELECT cast(NULL AS INTERVAL YEAR);
  NULL

> SELECT cast('1-4' AS INTERVAL YEAR TO MONTH)::STRING;
  INTERVAL '1-4' YEAR TO MONTH

> SELECT cast('1' AS INTERVAL YEAR TO MONTH);
  error

> SELECT cast(INTERVAL '1-4' YEAR TO MONTH AS INTERVAL MONTH)::STRING;
  INTERVAL '16' MONTH

> SELECT cast(14 AS INTERVAL YEAR TO MONTH)::STRING;
  INTERVAL '1-2' YEAR TO MONTH

> SELECT cast(INTERVAL '1-11' YEAR TO MONTH AS INTERVAL YEAR)::STRING;
  INTERVAL '1' YEAR

Интервал времени дня

Если targetType — это дневной временной интервал, а sourceExpr относится к типу:

• ПУСТОТА

  Результатом является NULL дневной интервал.

• exact_numeric

  Область применения: Databricks SQL Databricks Runtime 11.3 LTS и выше

  Числовое значение интерпретируется как число нижних единиц targetTypedayTimeIntervalQualifier. Если единицей является SECOND, доли интерпретируются как доли секунды.

• СТРУНА

  Строка sourceExpr должна быть допустимой строкой dayTimeIntervalString.

  Если sourceExpr не является допустимым dayTimeIntervalString, Azure Databricks возвращает ошибку.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• интервал дня

  Если dayTimeIntervalQualifier targetTypeвключает наименьшую единицу исходного типа dayTimeIntervalQualifier, значение остается неизменным, но переосмыслено для соответствия целевому типу.

  В противном случае интервал sourceExpr усекается для обеспечения соответствия targetType.

> SELECT cast(NULL AS INTERVAL HOUR);
  NULL

> SELECT cast('1 4:23' AS INTERVAL DAY TO MINUTE)::STRING;
  INTERVAL '1 04:23' DAY TO MINUTE

> SELECT cast('1' AS INTERVAL DAY TO MINUTE);
  error

> SELECT cast(INTERVAL '1 4:23' DAY TO MINUTE AS INTERVAL MINUTE)::STRING;
  INTERVAL '1703' MINUTE

> SELECT cast(INTERVAL '1 4:23' DAY TO MINUTE AS INTERVAL HOUR)::STRING;
  INTERVAL '28' HOUR

> SELECT cast(125.3 AS INTERVAL MINUTE TO SECOND)::STRING;
  INTERVAL '2:5.3' MINUTE TO SECOND

Булевый

Если targetType является типом BOOLEAN, а sourceExpr — типом:

• ПУСТОТА

  Результатом является NULL типа BOOLEAN.

• числовой

  Если sourceExpr равно:

  • 0 — результатом будет false.

    • NULL — результатом будет NULL.
    • special floating point value — результатом будет true.

    В противном случае результат будет true.

• СТРУНА

  Если sourcEexpr имеет значение (без учета регистра):

  • 'T', 'TRUE', 'Y', 'YES', or '1' — результатом будет true.
  • 'F', 'FALSE', 'N', 'NO', or '0' — результатом будет false.
  • NULL — результатом будет NULL.

  В противном случае Azure Databricks возвращает ошибку недопустимого синтаксиса ввода для типа boolean.

  Используйте try_cast, чтобы преобразовать ошибки о недопустимых данных в NULL.

• ВАРИАНТ

  Правила типа фактического VARIANT значения типа применяются.

Примеры

> SELECT cast(NULL AS BOOLEAN);
  NULL

> SELECT cast('T' AS BOOLEAN);
  true

> SELECT cast('True' AS BOOLEAN);
  true

> SELECT cast('1' AS BOOLEAN);
  true

> SELECT cast('0' AS BOOLEAN);
  false

> SELECT cast('n' AS BOOLEAN);
  false

> SELECT cast('on' AS BOOLEAN);
  error: invalid input syntax for type boolean

> SELECT cast(0 AS BOOLEAN);
  false

> SELECT cast(0.0E10 AS BOOLEAN);
  false

> SELECT cast(1 AS BOOLEAN);
  true

> SELECT cast(0.1 AS BOOLEAN);
  true

> SELECT cast('NaN'::FLOAT AS BOOLEAN);
  true

> SELECT cast(1::VARIANT AS BOOLEAN);
  true

ДВОИЧНЫЙ

Если targetType имеет тип BINARY, а sourceExpr относится к типу:

• ПУСТОТА

  Результатом является NULL типа BINARY.

• СТРУНА

  Результатом будет кодирование UTF-8 для surceExpr.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

Примеры

> SELECT cast(NULL AS BINARY);
  NULL

> SELECT hex(cast('Spark SQL' AS BINARY));
  537061726B2053514C

> SELECT hex(cast('Oдesa' AS BINARY));
  4FD0B4657361

> SELECT hex(cast('Oдesa'::VARIANT AS BINARY));
  4FD0B4657361

МАССИВ

Если targetType — это ARRAY < targetElementType > и sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLtargeTypeрезультат .

• ARRAY < sourceElementType >

  Если приведение sourceElementType к targetElementType поддерживается, результатом будет ARRAY<targetElementType>, в котором все элементы приведены к targetElementType.

  Azure Databricks вызывает ошибку, если приведение не поддерживается или если любой из элементов не может быть приведён.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

Примеры

> SELECT cast(NULL AS ARRAY<INT>);
  NULL

> SELECT cast(array('t', 'f', NULL) AS ARRAY<BOOLEAN>);
  [true, false, NULL]

> SELECT cast(array('t', 'f', NULL) AS INTERVAL YEAR);
  error: cannot cast array<string> to interval year

> SELECT cast(array('t', 'f', 'o') AS ARRAY<BOOLEAN>);
  error: invalid input syntax for type boolean: o.

> SELECT cast(array('t', 'f', NULL)::VARIANT AS ARRAY<BOOLEAN>);
  [true, false, NULL]

Карта

Если targetType является MAP < targetKeyType, targetValueType > и sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLtargetTypeрезультат .

• MAP <sourceKeyType, sourceValueType >

  Если приведения от sourceKeyType к targetKeyType и sourceValueType к targetValueType поддерживаются, результатом будет MAP<targetKeyType, targetValueType>, в котором все ключи приведены к targetKeyType, а все значения — к targetValueType.

  Azure Databricks вызывает ошибку, если приведение не поддерживается или если любой из ключей или значений не может быть приведен.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

• OBJECT < [sourceFieldName: sourceFieldType [, ...]] >

  Каждый sourceFieldName типа STRING приводится к targetKeyType и отображается на ключ карты. Каждое значение поля sourceFieldType преобразуется targetValueType и отображается на соответствующее значение из отображения.

  Azure Databricks вызывает ошибку, если какие-либо преобразования не поддерживаются или если какое-либо из значений полей или ключевых значений не может быть преобразовано.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

Примеры

> SELECT cast(NULL AS MAP<STRING, INT>);
  NULL

> SELECT cast(map('10', 't', '15', 'f', '20', NULL) AS MAP<INT, BOOLEAN>);
  {10 -> true, 15 -> false, 20 -> null}

> SELECT cast(map('10', 't', '15', 'f', '20', NULL) AS MAP<INT, ARRAY<INT>>);
  error: cannot cast map<string,string> to map<int,array<int>>

> SELECT cast(map('10', 't', '15', 'f', '20', 'o') AS MAP<INT, BOOLEAN>);
  error: invalid input syntax for type boolean: o.

-- Casting an OBJECT to a MAP
> SELECT schema_of_variant(parse_json('{"cars": 12, "bicycles": 5 }'));
  OBJECT<bicycles: BIGINT, cars: BIGINT>
> SELECT CAST(parse_json('{"cars": 12, "bicycles": 5 }') AS MAP<STRING, INTEGER>);
  {bicycles -> 5, cars -> 12}

структура

targetType Если используется STRUCT <[targetFieldName: targetFieldType [NOT NULL] [COMMENT str] [, ...]] > и sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULLtargetTypeрезультат .

• STRUCT < [sourceFieldName: sourceFieldType [NOT NULL] [COMMENT str] [, ...]] >

  Можно sourceExpr привести к targetType , если все эти условия истинны.

  • Тип источника имеет такое же количество полей, что и целевой объект.
  • Для всех полей sourceFieldTypeN можно привести к targetFieldTypeN.
  • Для всех значений полей: значение исходного поля N может быть приведено к типу targetFieldTypeN, и значение не равно null, если целевое поле N помечено как NOT NULL.

  Значения sourceFieldName, ограничения NOT NULL источника и COMMENT источника не обязаны соответствовать targetType и игнорируются.

  Azure Databricks вызывает исключение, если приведение не поддерживается или если какие-либо поля не могут быть приведены.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

• ВАРИАНТ

  Правила типов для фактического значения, содержащегося в типе данных VARIANT, применяются.

• OBJECT < [sourceFieldName: sourceFieldType [, ...]] >

  Все sourceFieldNames совпадают с sourceFieldNames. Каждое значение исходного поля sourceFieldType приводится к сопоставленной targetValueType и отображается на соответствующую карту.

  Если targetFieldName не совпадает, то значение равно NULL.

  Если sourceFieldName не совпадает, поле игнорируется.

  Azure Databricks вызывает ошибку, если какие-либо преобразования не поддерживаются или если какое-либо из значений полей или ключевых значений не может быть преобразовано.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

Примеры

> SELECT cast(NULL AS STRUCT<a:INT>);
  NULL

> SELECT cast(named_struct('a', 't', 'b', '1900-01-01') AS STRUCT<b:BOOLEAN, c:DATE NOT NULL COMMENT 'Hello'>);
  {"b":true,"c":1900-01-01}

> SELECT cast(named_struct('a', 't', 'b', NULL::DATE) AS STRUCT<b:BOOLEAN, c:DATE NOT NULL COMMENT 'Hello'>);
  error: cannot cast struct<a:string,b:date> to struct<b:boolean,c:date>

> SELECT cast(named_struct('a', 't', 'b', '1900') AS STRUCT<b:BOOLEAN, c:ARRAY<INT>>);
  error: cannot cast struct<a:string,b:string> to struct<b:boolean,c:array<int>>

> SELECT cast(named_struct('a', 't', 'b', 'hello') AS STRUCT<b:BOOLEAN, c:DATE>);
  error: Cannot cast hello to DateType

> SELECT cast(named_struct('a', 't', 'b', '1900-01-01')::VARIANT AS STRUCT<b:BOOLEAN, c:DATE NOT NULL COMMENT 'Hello'>);
  {"b":true,"c":1900-01-01}

-- Casting an OBJECT to a STRUCT
> SELECT schema_of_variant(parse_json('{"name": "jason", "age": 25 }'));
  OBJECT<age: BIGINT, name: STRING>
> SELECT CAST(parse_json('{"name": "jason", "age": 25 }') AS STRUCT<id: BIGINT, name: STRING>);
  {"id":null,"name":"jason"}

ВАРИАНТ

targetType Если используется вариант VARIANT и sourceExpr имеет тип:

• ПУСТОТА

  Результатом является NULL типа VARIANT.

• числовой

  Результатом является значение VARIANT, представляющее числовое значение. Точность типов DECIMAL должна быть равна <= 38.

  Все целочисленные числовые значения сопоставляются с BIGINT.

  Все DECIMAL значения сопоставляются с самой узкой точностью и масштабом.

• СТРУНА

  Результатом является VARIANT, представляющее собой значение STRING.

• ДАТА

  Результатом является VARIANT, представляющее собой значение DATE.

• TIMESTAMP

  Результатом является VARIANT, представляющее собой значение TIMESTAMP.

• TIMESTAMP_NTZ

  Результатом является VARIANT, представляющее собой значение TIMESTAMP NTZ.

• БУЛЕВ

  Результатом является VARIANT, представляющее собой значение BOOLEAN.

• ДВОИЧНЫЙ

  Результатом является VARIANT, представляющее собой значение BINARY.

• ARRAY < sourceElementType >

  Если приведение из sourceElementType в VARIANT поддерживается, результатом будет VARIANT, который представляет ARRAY<sourceElementType>.

  Azure Databricks возвращает ошибку, если приведение не поддерживается.

• СТРУКТУРА

  Это приведение не поддерживается напрямую, так как VARIANT не может сохранять порядок полей структуры. Используйте to_variant_object для преобразования STRUCT в VARIANT в качестве OBJECT.

• КАРТА

  Этот приведение типов не поддерживается напрямую, так как VARIANT не может сохранить тип MAP. Используйте to_variant_object для преобразования MAP в VARIANT в качестве OBJECT. Ключи карты должны быть строками.

  Azure Databricks возвращает ошибку, если приведение не поддерживается.

  Используйте try_cast, чтобы преобразовать недопустимые данные или ошибки переполнения в NULL.

Примеры

> SELECT cast(NULL AS VARIANT);
  NULL

> SELECT cast(5.1000 AS VARIANT);
  5.1

> SELECT schema_of_variant(cast(5 AS VARIANT));
  BIGINT

Связанные функции

• Оператор :: (знак двойного двоеточия)
• ?:: (оператор двойного двоеточия вопроса)
• try_cast функция