Conversão do tipo de dados¶

Conversão explícita vs. Conversão implícita¶

Os usuários podem converter explicitamente um valor de um tipo de dados em outro. Isto é chamado de conversão explícita.

Em algumas situações, o Snowflake converte automaticamente um valor em outro tipo de dados. Isto é chamado de conversão implícita ou coerção.

Conversão e precedência¶

Ao converter dentro de uma expressão, o código deve levar em conta a precedência do operador de conversão em relação aos outros operadores da expressão.

Considere o seguinte exemplo:

SELECT height * width::VARCHAR || " square meters"
    FROM dimensions;

Copy

O operador de conversão tem maior precedência do que o operador aritmético * (multiplicar), portanto a instrução é interpretada como:

... height * (width::VARCHAR) ...

Copy

Para converter o resultado da expressão height * width, use parênteses, como mostrado abaixo:

SELECT (height * width)::VARCHAR || " square meters"
    FROM dimensions;

Copy

Como outro exemplo, considere a seguinte instrução:

SELECT -0.0::FLOAT::BOOLEAN;

Copy

É de se esperar que isto seja interpretado como:

SELECT (-0.0::FLOAT)::BOOLEAN;

Copy

e, portanto, retornar FALSE (0 = FALSE, 1 = TRUE).

Entretanto, o operador de conversão tem maior precedência do que o operador de menos unário (negação), portanto, a instrução é interpretada como:

SELECT -(0.0::FLOAT::BOOLEAN);

Copy

e, portanto, resulta em uma mensagem de erro porque o operador de menos unário não pode ser aplicado a um BOOLEAN.

Tipos de dados que podem ser convertidos¶

A tabela abaixo mostra as conversões de tipos de dados válidas no Snowflake. A tabela também mostra quais coerções o Snowflake pode executar automaticamente.

Para obter detalhes sobre conversões entre tipos semiestruturados e tipos estruturados, consulte Conversão de tipos estruturados e semiestruturados.

Notas:

• Para cada tipo de dados listado (por exemplo, FLOAT), as regras se aplicam a todos os aliases para aquele tipo de dado (por exemplo, as regras para FLOAT se aplicam a DOUBLE, que é um alias para FLOAT).

Notas de uso¶

Exceto onde indicado de outra forma, as seguintes regras se aplicam tanto para conversão explícita quanto para conversão implícita.

• A conversão depende não apenas do tipo de dados, mas também do valor de origem. Por exemplo:

  • O VARCHAR ‘123’ pode ser convertido em um valor numérico, mas o VARCHAR ‘xyz’ não pode ser convertido em um valor numérico.

  • A capacidade de converter um valor específico do tipo VARIANT depende do tipo dos dados dentro do VARIANT. Por exemplo, se o VARIANT contém um valor do tipo TIME, então não é possível converter a VARIANT em um TIMESTAMP porque não é possível converter TIME em TIMESTAMP.

• Se possível, passe em argumentos do mesmo tipo. Evite passar em argumentos de diferentes tipos.

• Se um dos argumentos for um número, a função aplica a coerção aos argumentos de cadeia de caracteres não numéricos (por exemplo, 'a string') e argumentos de cadeia de caracteres que não são constantes do tipo NUMBER(18,5).

  Para argumentos de cadeia de caracteres numérica que não são constantes, se NUMBER(18,5) não for suficiente para representar o valor numérico, você deve converter o argumento em um tipo que possa representar o valor.

• Para alguns pares de tipos de dados, a conversão pode resultar em perda de precisão. Por exemplo:

  • A conversão de FLOAT em INTEGER arredonda o valor.

  • A conversão de um valor de ponto fixo numérico (por exemplo, NUMBER(38, 0)) em ponto flutuante (por exemplo, FLOAT) pode resultar em arredondamento ou truncamento se o número de ponto fixo não puder ser representado com precisão em um número de ponto flutuante.

  • A conversão de TIMESTAMP em DATE remove as informações sobre a hora do dia.

• Embora o Snowflake converta valores em algumas situações em que pode haver perda de precisão, o Snowflake não permite a conversão em outras situações em que poderia ocorrer perda de precisão. Por exemplo, o Snowflake não permite a conversão quando a conversão:

  • Trunca um valor VARCHAR. Por exemplo, o Snowflake não converte VARCHAR(10) em VARCHAR(5), seja implícita ou explicitamente.

  • Resulta na perda de dígitos, exceto dígitos menos significativos. Por exemplo, o seguinte apresenta falha:

    select 12.3::FLOAT::NUMBER(3,2);
    

    Copy

  Neste exemplo, o número 12.3 tem dois dígitos antes do ponto decimal, mas o tipo de dados NUMBER(3,2) tem espaço para apenas um dígito antes do ponto decimal.

• Ao converter de um tipo com menos precisão em um tipo com mais precisão, a conversão utiliza valores padrão. Por exemplo, a conversão de DATE em TIMESTAMP_NTZ faz com que a hora, o minuto, o segundo e os segundos fracionários sejam ajustados para 0.

• Quando um valor FLOAT é convertido em VARCHAR, os zeros finais são omitidos.

  Por exemplo, as instruções a seguir criam uma tabela e inserem uma linha que contém um VARCHAR, um FLOAT e um VARIANT. O VARIANT é criado de um JSON que contém um valor de ponto flutuante representado com zeros finais.

  create or replace table tmp (
      varchar1 varchar, 
      float1 float, 
      variant1 variant
      );
  
  insert into tmp select '5.000', 5.000, parse_json('{"Loan Number": 5.000}');
  

  Copy

  A instrução SELECT a seguir converte explicitamente tanto a coluna FLOAT como o valor FLOAT dentro da coluna VARIANT em VARCHAR. Em cada caso, o VARCHAR não contém zeros finais:

  select varchar1, 
         float1::varchar,
         variant1:"Loan Number"::varchar from tmp;
  +----------+-----------------+---------------------------------+
  | VARCHAR1 | FLOAT1::VARCHAR | VARIANT1:"LOAN NUMBER"::VARCHAR |
  |----------+-----------------+---------------------------------|
  | 5.000    | 5               | 5                               |
  +----------+-----------------+---------------------------------+
  

  Copy

• Algumas operações podem retornar diferentes tipos de dados, dependendo de uma expressão condicional. Por exemplo, as seguintes chamadas COALESCE retornam tipos de dados ligeiramente diferentes, dependendo dos valores de entrada:

  select system$typeof(ifnull(12.3, 0)),
         system$typeof(ifnull(NULL, 0));
  
  +--------------------------------+--------------------------------+
  | SYSTEM$TYPEOF(IFNULL(12.3, 0)) | SYSTEM$TYPEOF(IFNULL(NULL, 0)) |
  +--------------------------------+--------------------------------+
  | NUMBER(3,1)[SB1]               | NUMBER(1,0)[SB1]               |
  +--------------------------------+--------------------------------+
  

  Copy

  Se a expressão tiver mais de um tipo de dados possível, então o Snowflake escolhe o tipo de dados com base no resultado real. (Para obter mais informações sobre precisão e escala nos cálculos, consulte Escala e precisão em operações aritméticas). Se a consulta gerar mais de um resultado (por exemplo, várias linhas de resultados), o Snowflake escolhe um tipo de dados que é capaz de manter cada um dos resultados individuais.

• Alguns programas de aplicativo, como o SnowSQL, e algumas interfaces gráficas de usuário, como o Classic Console, aplicam suas próprias regras de conversão e formatação ao exibir dados. Por exemplo, o SnowSQL exibe valores BINARY como uma cadeia de caracteres que contém apenas dígitos hexadecimais; essa cadeia é gerada pela chamada implícita de uma função de conversão. Portanto, os dados que o SnowSQL exibe podem não indicar inequivocamente a quais conversões de dados o Snowflake aplicou coerção.