Catégories :

Fonctions de données semi-structurées et structurées (prédicats de type)

IS_BINARY

Renvoie TRUE si son argument VARIANT contient une valeur de chaîne binaire.

Voir aussi :

IS_<type_objet>

Syntaxe

IS_BINARY( <variant_expr> )
Copy

Arguments

variant_expr

Une expression qui correspond à une valeur de type VARIANT.

Renvoie

Renvoie une valeur BOOLEAN ou NULL.

  • Renvoie TRUE si la valeur VARIANT contient une valeur BINARY. Sinon, renvoie FALSE.

  • Si l’entrée est NULL, renvoie NULL sans signaler d’erreur.

Exemples

Renvoyer toutes les valeurs BINARY dans une colonne VARIANT.

Note

Le format de sortie des valeurs BINARY est défini à l’aide du paramètre BINARY_OUTPUT_FORMAT. Le paramètre par défaut est HEX.

Créer et charger une table avec une valeur BINARY dans une colonne VARIANT :

CREATE OR REPLACE TABLE varbin (v VARIANT);

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

Afficher les valeurs BINARY dans les données en utilisant la fonction IS_BINARY dans une clause WHERE :

SELECT v AS hex_encoded_binary_value
  FROM varbin
  WHERE IS_BINARY(v);
Copy
+--------------------------+
| HEX_ENCODED_BINARY_VALUE |
|--------------------------|
| "736E6F77"               |
+--------------------------+