Função `cast`

Aplica-se a: Sim assinalado Databricks SQL Databricks Runtime

Converte o valor expr para o tipo typede dados de destino. Este operador é sinónimo de :: operador (sinal de dois pontos)

Sintaxe

cast(sourceExpr AS targetType)

Argumentos

sourceExpr: Qualquer expressão convertível.
targetType: O tipo de dados do resultado.

Devoluções

O resultado é o tipo targetType.

As seguintes combinações de conversão de tipos de dados são válidas:

Origem (linha) Destino (coluna)	VAZIO	numérico	STRING	DATA	Carimbo de data e hora	TIMESTAMP_NTZ	intervalo ano-mês	intervalo diurno	BOOLEANO	BINÁRIO	MATRIZ	MAPA	ESTRUTURA	VARIANTE	OBJETO
VAZIO	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	Y	N
numérico	N	Y	Y	N	Y	N	Y	Y	Y	N	N	N	N	Y	N
STRING	N	Y	Y	Y	Y	Y	Y	Y	Y	Y	N	N	N	Y	N
DATA	N	N	Y	Y	Y	Y	N	N	N	N	N	N	N	Y	N
Carimbo de data e hora	N	Y	Y	Y	Y	Y	N	N	N	N	N	N	N	Y	N
TIMESTAMP_NTZ	N	N	Y	Y	Y	Y	N	N	N	N	N	N	N	Y	N
intervalo ano-mês	N	Y	Y	N	N	N	Y	N	N	N	N	N	N	N	N
intervalo diurno	N	Y	Y	N	N	N	N	Y	N	N	N	N	N	N	N
BOOLEANO	N	Y	Y	N	Y	N	N	N	Y	N	N	N	N	Y	N
BINÁRIO	N	Y	Y	N	N	N	N	N	N	Y	N	N	N	Y	N
MATRIZ	N	N	Y	N	N	N	N	N	N	N	Y	N	N	Y	N
MAPA	N	N	Y	N	N	N	N	N	N	N	N	Y	N	N	N
ESTRUTURA	N	N	Y	N	N	N	N	N	N	N	N	N	Y	N	N
VARIANTE	N	Y	Y	Y	Y	Y	N	N	Y	Y	Y	Y	Y	Y	N
OBJETO	N	N	N	N	N	N	N	N	N	N	N	Y	Y	N	N

Regras e limitações baseadas em targetType

Aviso

No Databricks Runtime, se spark.sql.ansi.enabled estiver definido como false verdadeiro, um overflow não causará um erro, mas envolverá o resultado.

Um sourceExpr valor com um formato inválido ou caracteres inválidos para targetType resultará em um NULL.

numérico

Se o targetType é numérico e sourceExpr é do tipo:

VAZIO

O resultado é um NULL do tipo numérico especificado.
numérico

Se targetType for um número integral, o resultado é sourceExprtruncado para se tornar um número inteiro.

Caso contrário, o resultado é sourceExprarredondado para ajustar à escala disponível de targetType.

Se o valor estiver fora do intervalo de targetType, será gerado um erro de estouro.

Use try_cast para converter erros de estouro em NULL.
STRING

sourceExpr é lido como um valor literal do targetType.

Se sourceExpr não estiver em conformidade com o formato para valores literais, um erro será gerado.

Se o valor estiver fora do intervalo de targetType, será gerado um erro de overflow.

Use try_cast para transformar erros de formato inválidos e de estouro em NULL.
MARCA DE DATA/HORA

O resultado é o número de segundos decorridos entre 1970-01-01 00:00:00 UTC e sourceExpr.

Se targetType for um número numérico integral, o resultado é truncado para um número inteiro.

Caso contrário, o resultado é arredondado para se ajustar à escala disponível de targetType.

Se o resultado estiver fora do intervalo de targetType, um erro de estouro será gerado.

Use try_cast para converter erros de estouro em NULL.
INTERVALO

Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

O tipo de destino deve ser um número exato.

Dado um INTERVAL upper_unit TO lower_unit, o resultado é medido em número total de lower_unit. Se for lower_unitSECOND, os segundos fracionários são armazenados à direita da vírgula decimal. Para todos os outros intervalos, o resultado é sempre um número integral.
BOOLEANO

Se sourceExpr é:
- true: O resultado é 1.
- false: O resultado é 0.
- NULL: O resultado é NULL.
VARIANTE

Aplicam-se as regras do tipo do valor efetivo do tipo VARIANT.

Exemplos

> 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

cadeia de caracteres

Se o sourceExpr for um STRING, o STRING resultante herda a ordenação de sourceExpr. Em todos os outros casos, o agrupamento resultante STRING é, por padrão, o agrupamento .

Para alterar a ordenação, adicione a expressão collate.

Se o targetType é um STRING tipo e sourceExpr é do tipo:

VAZIO

O resultado é uma NULL cadeia de caracteres.
numérico exato

O resultado é o número literal com um sinal de menos opcional e sem zeros à esquerda, com exceção do único dígito à esquerda da vírgula decimal. Se o targetType for DECIMAL(p, s) com s maior que 0, um ponto decimal é adicionado e zeros à direita são adicionados até atingir a escala.
binário de ponto flutuante

Se o número absoluto for menor que 10,000,000 e maior ou igual a 0.001, o resultado é expresso sem notação científica, com pelo menos um algarismo de cada lado do ponto decimal.

Caso contrário, o Azure Databricks usa uma mantissa seguida por E e um expoente. A mantissa tem um sinal de menos opcional à frente, seguido por um dígito à esquerda da vírgula decimal e pelo menor número possível de dígitos, maior que zero, à direita. O expoente tem um sinal de menos opcional à esquerda.
DATA

Se o ano estiver entre 9999 a.C. e 9999 d.C., o resultado será uma dateString do formulário -YYYY-MM-DD e YYYY-MM-DD respectivamente.

Para anos anteriores ou posteriores a este intervalo, o número necessário de algarismos é adicionado ao componente ano e + é utilizado para CE.
MARCA DE DATA/HORA

Se o ano estiver entre 9999 a.C. e 9999 d.C., o resultado será um timestampString do formulário -YYYY-MM-DD hh:mm:ss e YYYY-MM-DD hh:mm:ss respectivamente.

Para anos anteriores ou posteriores a este intervalo, o número necessário de algarismos é adicionado ao componente ano e + é utilizado para CE.

Se necessário, são adicionados segundos .f... fracionários.
TIMESTAMP_NTZ

Se o ano estiver entre 9999 a.C. e 9999 d.C., o resultado será um timestampString do formulário -YYYY-MM-DD hh:mm:ss e YYYY-MM-DD hh:mm:ss respectivamente.

Para anos anteriores ou posteriores a este intervalo, o número necessário de algarismos é adicionado ao componente ano e + é utilizado para CE.

Se necessário, são adicionados segundos .f... fracionários.
intervalo ano-mês

O resultado é a sua representação mais curta do intervalo literal. Se o intervalo for negativo, o sinal será incorporado no interval-string. Para unidades menores que 10, zeros à esquerda são omitidos.

Uma cadeia de caracteres típica de intervalo ano-mês tem a forma:
- INTERVAL 'Y' YEAR
- INTERVAL 'Y-M' YEAR TO MONTH
- INTERVAL 'M' MONTH
intervalo diurno

O resultado é a sua representação mais curta do intervalo literal. Se o intervalo for negativo, o sinal será incorporado no interval-string. Para unidades menores que 10, os zeros que antecedem são omitidos.

Uma cadeia de caracteres típica de um intervalo de tempo durante o dia tem a forma:
- 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
BOOLEANO

O resultado do true booleano é o STRING literal true. Para false é o literal STRING false. Para NULL é a cadeia de caracteres NULL.
BINÁRIO

Um resultado é o binário sourceExpr interpretado como uma sequência de caracteres UTF-8.

O Azure Databricks não valida os caracteres UTF-8. Uma conversão de BINARY para STRING nunca injetará caracteres de substituição nem gerará um erro.
MATRIZ

O resultado é uma lista separada por vírgulas de elementos, que está entre colchetes [ ]. Um espaço segue cada vírgula. Um NULL elemento é traduzido para um literal null.

O Azure Databricks não cita nem marca elementos individuais, que podem conter colchetes ou vírgulas.
MAPA

O resultado é uma lista separada por vírgulas de pares de chave-valor de tipo, que é delimitada por chaves { }. Um espaço segue cada vírgula. Cada par de valores de chave é separado por um ->. Um NULL valor de mapa é traduzido para literal null.

O Azure Databricks não cita ou marca chaves ou valores individuais, que podem conter chaves, vírgulas ou ->.
ESTRUTURA

O resultado é uma lista separada por vírgulas de valores de campo convertidos, que está entre chaves { }. Um espaço segue cada vírgula. Um NULL valor de campo é traduzido para um literal null.

O Azure Databricks não cita ou marca valores de campo individuais, que podem conter chaves ou vírgulas.
VARIANTE

Aplicam-se as regras do tipo do valor efetivo do tipo VARIANT.

Exemplos

> 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

DATA

Se o targetType é um DATE tipo e sourceExpr é do tipo:

VAZIO

O resultado é um arquivo NULLDATE.
STRING

sourceExprdeve ser um dateString válido.

Se sourceExpr não for válido dateString, o Azure Databricks retornará um erro.

Use try_cast para transformar erros de dados inválidos em NULL.
MARCA DE DATA/HORA

O resultado é a parte de data do carimbo de data/hora sourceExpr.
TIMESTAMP_NTZ

O resultado é a parte de data do timestamp_ntz sourceExpr.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.

Exemplos

> 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

MARCA TEMPORAL

Se o targetType é um TIMESTAMP tipo e sourceExpr é do tipo:

VAZIO

O resultado é um arquivo NULLDATE.
numérico

sourceExpr é lido como o número de segundos desde 1970-01-01 00:00:00 UTC.

Frações menores que microssegundos são truncadas.

Se o valor estiver fora do intervalo de TIMESTAMP, será gerado um erro de estouro.

Use try_cast para converter erros de estouro em NULL.
STRING

sourceExprdeve ser um timestampString válido.

Se sourceExpr não for válido timestampString, o Azure Databricks retornará um erro.

Use try_cast para transformar erros de dados inválidos em NULL.
DATA

O resultado é o sourceExprDATE às 00:00:00h.
TIMESTAMP_NTZ

O resultado é um valor de timestamp com os mesmos campos de ano/mês/dia/hora/minuto/segundo de timestamp_ntz sourceExpr.

VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.

Exemplos

> 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

Se o targetType é um TIMESTAMP_NTZ tipo e sourceExpr é do tipo:

VAZIO

O resultado é um arquivo NULLDATE.
STRING

sourceExprdeve ser um timestampString válido.

Se sourceExpr não for válido timestampString, o Azure Databricks retornará um erro.

Use try_cast para transformar erros de dados inválidos em NULL.
DATA

O resultado é a sourceExpr DATA às 00:00:00 horas.
MARCA DE DATA/HORA

O resultado é a hora local dentro do fuso sourceExpr horário da sessão.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.

Exemplos

> 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

intervalo ano-mês

Se o targetType for um intervalo de um ano e mês e sourceExpr for do tipo:

VAZIO

O resultado é um intervalo ano-mês NULL .
integral_numeric

Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

O valor numérico é interpretado como o número de unidades menores do targetTypeanomêsIntervalQualifier.
STRING

sourceExprdeve ser um yearMonthIntervalString válido.

Se sourceExpr não for válido yearMonthIntervalString, o Azure Databricks retornará um erro.

Use try_cast para transformar erros de dados inválidos em NULL.
intervalo ano-mês

Se o targetTypeyearMonthIntervalQualifier incluir MONTH o valor permanecerá inalterado, mas será reinterpretado para corresponder ao tipo de destino.

Caso contrário, se o tipo de origem yearMonthIntervalQualifier incluir MONTH, o resultado será truncado para anos completos.

Exemplos

> 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

intervalo diurno

** Se o targetType for um intervalo diurno e sourceExpr for do tipo:

VAZIO

O resultado é um NULL intervalo de tempo diurno.
exact_numeric

Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

O numérico é interpretado como o número de unidades inferiores do targetTypedayTimeIntervalQualifier. Se a unidade for SECOND, quaisquer frações são interpretadas como segundos fracionários.
STRING

sourceExprdeve ser um dayTimeIntervalString válido.

Se sourceExpr não for válido dayTimeIntervalString, o Azure Databricks retornará um erro.

Use try_cast para transformar erros de dados inválidos em NULL.
intervalo diurno

Se o targetTypedayTimeIntervalQualifier incluir a menor unidade do tipo de origem dayTimeIntervalQualifier, o valor permanecerá inalterado, mas será reinterpretado para corresponder ao tipo de destino.

Caso contrário, o sourceExpr intervalo é truncado para se ajustar ao 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

BOOLEANO

Se o targetType é um BOOLEANO e sourceExpr é do tipo:

VAZIO

O resultado é um NULL do tipo BOOLEAN.
numérico

Se sourceExpr é:
- 0: O resultado é false.
  - NULL: O resultado é NULL.
  - special floating point value: O resultado é true.
  Caso contrário, o resultado é true.
STRING

Se sourcEexpr for (sem distinção entre maiúsculas e minúsculas):
- 'T', 'TRUE', 'Y', 'YES', or '1': O resultado é true
- 'F', 'FALSE', 'N', 'NO', or '0': O resultado é false
- NULL: O resultado é NULL
Caso contrário, o Azure Databricks retorna uma sintaxe de entrada inválida para erro booleano de tipo.

Use try_cast para transformar erros de dados inválidos em NULL.
VARIANTE

Aplicam-se as regras do tipo do valor efetivo do tipo VARIANT.

Exemplos

> 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

BINÁRIO

Se o targetType é um BINÁRIO e sourceExpr é do tipo:

VAZIO

O resultado é um NULL do tipo BINARY.
STRING

O resultado é a codificação UTF-8 do surceExpr.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.

Exemplos

> 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

MATRIZ

Se o targetType é um ARRAY < targetElementType > e sourceExpr é do tipo:

VAZIO

O resultado é um NULL dos targeType.
ARRAY < sourceElementType >

Se a conversão de sourceElementType para targetElementType for suportada, o resultado será um ARRAY<targetElementType> com todos os elementos convertidos para o targetElementType.

O Azure Databricks gera um erro se a transmissão não for suportada ou se algum dos elementos não puder ser transmitido.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.

Exemplos

> 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]

MAPA

Se o targetType é um MAP < targetKeyType, targetValueType > e sourceExpr é do tipo:

VAZIO

O resultado é um NULL dos targetType.
<MAP sourceKeyType, sourceValueType>

Se as conversões de sourceKeyType para targetKeyType e sourceValueType para targetValueType forem suportadas, o resultado será um MAP<targetKeyType, targetValueType> com todas as chaves convertidas para o targetKeyType e todos os valores convertidos para o targetValueType.

O Azure Databricks apresenta um erro se a conversão não for suportada ou se alguma das chaves ou valores não puder ser convertida.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.
OBJECT < [sourceFieldName : sourceFieldType [, ...]] >

Cada sourceFieldName do tipo STRING é convertido em targetKeyType e mapeado para uma chave de mapa. Cada valor de campo de origem de sourceFieldType é convertido e mapeado para o respetivo valor de targetValueType mapa.

O Azure Databricks gera um erro se não houver suporte para quaisquer transmissões ou se algum dos valores de campo ou valores de chave não puder ser transmitido.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.

Exemplos

> 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}

ESTRUTURA

Se o targetType é um STRUCT <[targetFieldName : targetFieldType [NOT NULL] [COMMENT str] [, ...]] > e sourceExpr é do tipo:

VAZIO

O resultado é um NULL dos targetType.
STRUCT < [sourceFieldName : sourceFieldType [NOT NULL] [COMMENT str] [, ...]] >

O sourceExpr pode ser lançado para targetType se todas estas condições forem verdadeiras:
- O tipo de origem tem o mesmo número de campos que o destino
- Para todos os campos: sourceFieldTypeN pode ser convertido para o targetFieldTypeN.
- Para todos os valores de campo: O valor do campo de origem N pode ser convertido para targetFieldTypeN e o valor não é nulo se o campo de destino N estiver marcado como NOT NULL.
sourceFieldNames, restrições de origem NOT NULL e fonte COMMENTs não precisam corresponder ao targetType e são ignorados.

O Azure Databricks gera um erro se a transmissão não for suportada ou se algum dos campos não puder ser transmitido.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.
VARIANTE

Aplicam-se as regras de tipo para o valor real mantido pelo VARIANT tipo de dados.
OBJECT < [sourceFieldName : sourceFieldType [, ...]] >

Todos os sourceFieldNames são emparelhados com sourceFieldNames. Cada valor do campo de origem de sourceFieldType é transformado para combinar com targetValueType e mapeado para o respetivo valor no mapa.

Se a targetFieldName não tiver correspondência, o valor do campo é NULL.

Se a sourceFieldName não for compatível, o campo será ignorado.

O Azure Databricks gera um erro se não houver suporte para quaisquer transmissões ou se algum dos valores de campo ou valores de chave não puder ser transmitido.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.

Exemplos

> 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"}

VARIANTE

Se o targetType é uma VARIANTE e sourceExpr é do tipo:

VAZIO

O resultado é um NULL do tipo VARIANT.
numérico

O resultado é um VARIANT, representando o valor numérico. A precisão dos DECIMAL tipos deve ser <= 38.

Todos os números integrais são mapeados para BIGINT.

Todos os valores DECIMAL são mapeados com sua precisão e escala mais estreitas.
STRING

O resultado é um VARIANT, representando o STRING valor.
DATA

O resultado é um VARIANT, representando o DATE valor.
MARCA DE DATA/HORA

O resultado é um VARIANT, representando o TIMESTAMP valor.
TIMESTAMP_NTZ

O resultado é um VARIANT, representando o TIMESTAMP NTZ valor.
BOOLEANO

O resultado é um VARIANT, representando o BOOLEAN valor.
BINÁRIO

O resultado é um VARIANT, representando o BINARY valor.
ARRAY < sourceElementType >

Se a conversão de sourceElementType para VARIANT for suportada, o resultado será VARIANT, representando ARRAY<sourceElementType>.

O Azure Databricks gera um erro se a transmissão não for suportada.
ESTRUTURA

Esta conversão não é diretamente suportada, uma vez que VARIANT não consegue preservar a ordem dos campos de struct. Use to_variant_object para converter o STRUCT em VARIANT como um OBJECT.
MAPA

Esta conversão não é suportada diretamente, pois VARIANT não pode preservar o tipo MAP. Use to_variant_object para converter o MAP em VARIANT como OBJECT. As chaves de mapa devem ser strings.

O Azure Databricks gera um erro se a transmissão não for suportada.

Use try_cast para transformar dados inválidos ou erros de estouro em NULL.

Exemplos

> SELECT cast(NULL AS VARIANT);
  NULL

> SELECT cast(5.1000 AS VARIANT);
  5.1

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

Feedback

Esta página foi útil?

Last updated on 2025-12-09

Partilhar via

Função cast

Sintaxe

Argumentos

Devoluções

Regras e limitações baseadas em targetType

numérico

Exemplos

cadeia de caracteres

Exemplos

DATA

Exemplos

MARCA TEMPORAL

Exemplos

TIMESTAMP_NTZ

Exemplos

intervalo ano-mês

Exemplos

intervalo diurno

BOOLEANO

Exemplos

BINÁRIO

Exemplos

MATRIZ

Exemplos

MAPA

Exemplos

ESTRUTURA

Exemplos

VARIANTE

Exemplos

Funções relacionadas

Feedback

Recursos adicionais

Função `cast`