Funções de conversão de tipo - cast, try_cast, typeof | SLS - Simple Log Service: Central de Documentação do Alibaba Cloud

Use funções de conversão de tipo em instruções de consulta e análise para converter tipos de dados.

O SLS oferece suporte às seguintes funções de conversão de tipo.

Importante

Para usar strings em instruções analíticas, coloque-as entre aspas simples (''). Strings sem aspas ou entre aspas duplas ("") indicam nomes de campos ou colunas. Por exemplo, 'status' representa a string status, enquanto status ou "status" indica o campo de log status.

Função	Sintaxe	Descrição	SQL	SPL
função cast	cast(x as type)	Converte o tipo de dados de x. Se a conversão falhar, toda a consulta falhará.	√	√
função try_cast	try_cast(x as type)	Converte o tipo de dados de x. Se a conversão falhar, retorna NULL e continua o processamento. Nota Use try_cast em vez de cast para evitar que dados incorretos interrompam toda a consulta.	√	×
função typeof	typeof(x)	Retorna o tipo de dados de x.	√	×

Função cast

Converte o tipo de dados de x. Se a conversão falhar, toda a consulta falhará.

Syntax

cast(x as type)

Parameters

Parâmetro

Descrição

Expressão a ser convertida. Aceita qualquer tipo de dados.

type

Tipo de dados SQL de destino. Valores válidos: bigint, varchar, double, boolean, timestamp, decimal, array e map.

Exemplo: cast(json_parse(key) as array(varchar)).

A seção Apêndice: Mapeamento de tipos de dados lista os mapeamentos entre tipos de índice e SQL.

Return value type

O tipo de dados especificado pelo parâmetro type.

Examples

SQL

Converta 1 para boolean.

Instrução de consulta e análise
```
* | select cast(1 as boolean)
```
A consulta retorna true.

SPL

Converta 1 para boolean.

Instrução de consulta e análise

* | extend a = cast(1 as boolean)

O valor de a é true.

Função try_cast

Converte o tipo de dados de x. Se a conversão falhar, retorna NULL e continua o processamento.

Syntax

try_cast(x as type)

Parameters

Parâmetro

Descrição

Expressão a ser convertida. Aceita qualquer tipo de dados.

type

Tipo de dados SQL de destino. Valores válidos: bigint, varchar, double, boolean, timestamp, decimal, array e map.

Exemplo: try_cast(json_parse(key) as map(varchar, varchar)).

A seção Apêndice: Mapeamento de tipos de dados lista os mapeamentos entre tipos de índice e SQL.

Return value type

O tipo de dados especificado pelo parâmetro type.

Examples

Converta o campo uid para varchar.

Instrução de consulta e análise
```
* | select try_cast(uid as varchar)
```
O resultado contém uma coluna _col0. Ambas as linhas têm o valor owner-01.

Função typeof

Retorna o tipo de dados de x.

Syntax

typeof(x)

Parameters

Parâmetro	Descrição
x	Expressão a ser avaliada. Aceita qualquer tipo de dados.

Return value type

varchar

Examples

Verifique o tipo de dados de request_time.

Instrução de consulta e análise
```
* |SELECT typeof(request_time)
```
O tipo de dados de request_time é double.

Apêndice: Mapeamento de tipos de dados

Mapeamentos entre tipos de dados de índice e SQL:

Tipo de dados do índice	Tipo de dados SQL
long	bigint
text	varchar
double	double
json	varchar