Categorias:

Funções de dados semiestruturados e estruturados (Predicados de tipo)

IS_BINARY

Retorna TRUE se o argumento VARIANT contiver um valor de cadeia de caracteres binária.

Consulte também:

IS_<tipo_de_objeto>

Sintaxe

IS_BINARY( <variant_expr> )

Argumentos

variant_expr

Uma expressão que avalia como um valor do tipo VARIANT.

Retornos

Retorna um valor BOOLEAN ou NULL.

  • Retorna TRUE se o valor VARIANT contiver um valor BINARY. Caso contrário, retorna FALSE.

  • Se a entrada for NULL, retorna NULL sem relatar um erro.

Exemplos

Retorna todos os valores BINARY em uma coluna VARIANT.

Nota

O formato de saída dos valores de BINARY é definido usando o parâmetro BINARY_OUTPUT_FORMAT. A configuração padrão é HEX.

Crie e carregue uma tabela com um valor BINARY em uma coluna VARIANT:

CREATE OR REPLACE TABLE varbin (v VARIANT);

INSERT INTO varbin SELECT TO_VARIANT(TO_BINARY('snow', 'utf-8'));

Mostre os valores BINARY nos dados usando a função IS_BINARY em uma cláusula WHERE:

SELECT v AS hex_encoded_binary_value
  FROM varbin
  WHERE IS_BINARY(v);

+--------------------------+
| HEX_ENCODED_BINARY_VALUE |
|--------------------------|
| "736E6F77"               |
+--------------------------+