Entrée et sortie binaires¶

hex (par défaut)¶

Le format « hex » se réfère au système hexadécimal, ou base 16. Dans ce format, chaque octet est représenté par deux caractères (chiffres de 0 à 9 et lettres de A à F). Lors de l’utilisation du format hexadécimal pour effectuer la conversion :

hex est le format binaire par défaut.

base64¶

Le format « base64 » encode les données binaires (ou les données de chaîne) sous forme de caractères ASCII imprimables (lettres, chiffres et signes de ponctuation ou opérateurs mathématiques). (Le schéma d’encodage en base64 est défini dans RFC 4648.)

Les données encodées en Base64 présentent les avantages suivants :

• Les données encodées en base64 étant du texte ASCII pur, elles peuvent être stockées dans des systèmes prenant en charge les données de type ASCII mais pas les données BINARY. Par exemple, les données binaires représentant de la musique (échantillons numériques) ou les données UTF représentant des caractères en mandarin peuvent être codées sous forme de texte ASCII et stockées dans des systèmes ne prenant en charge que les caractères ASCII.

• Comme les données encodées en base64 ne contiennent pas de caractères de contrôle (par exemple, des caractères de fin de transmission, des caractères de tabulation), les données encodées en base64 peuvent être transmises et reçues sans risque que les caractères de contrôle puissent être interprétés comme des commandes plutôt que des données. Les données encodées en Base64 sont compatibles avec les modems plus anciens et les autres équipements de télécommunication qui transmettent et reçoivent des données un caractère à la fois (sans en-têtes de paquets ni protocoles indiquant quelles parties d’un paquet sont des données et quelles parties sont des informations de contrôle ou d’en-tête).

Les données encodées en Base64 présentent les inconvénients suivants :

• La conversion des données entre les représentations binaires et imprimables ASCII consomme des ressources de calcul.

• Les données encodées en Base64 nécessitent environ 1/3 d’espace de stockage de plus que les données d’origine.

Les sections suivantes fournissent des détails techniques sur l’encodage base64.

UTF-8¶

Le format UTF-8 fait référence au codage des caractères UTF-8 pour Unicode.

UTF-8 est utilisé pour les codages binaires à texte. UTF-8 ne peut pas être utilisé pour les codages binaires à texte, car toutes les valeurs BINARY possibles ne peuvent pas être converties en chaînes UTF-8 valides.

Ce format est pratique pour effectuer une conversion simple entre un format binaire et une chaîne, pour réinterpréter les données sous-jacentes comme l’un ou l’autre type plutôt que d’encoder et décoder réellement.

Chargement des données¶

Lorsqu’il est utilisé pour le chargement des données, BINARY_FORMAT spécifie le format de valeurs binaires dans vos fichiers de données mis en zone de préparation. Cette option annule toute valeur définie pour le paramètre BINARY_INPUT_FORMAT dans la session (voir Paramètres de session pour les valeurs binaires).

Si l’option est réglée sur HEX ou BASE64, le chargement des données peut échouer lorsque les chaînes du fichier de données mis en zone de préparation ne sont pas valides par rapport au format hex ou base64. Dans ce cas, Snowflake retourne une erreur et exécute l’action spécifiée pour l’option de copie ON_ERROR.

Déchargement des données¶

Lorsqu’elle est utilisée dans le déchargement de données, l’option BINARY_FORMAT spécifie le format appliqué aux valeurs binaires déchargées dans les fichiers situés dans la zone de préparation spécifiée. Cette option annule toute valeur définie pour le paramètre BINARY_OUTPUT_FORMAT dans la session (voir Paramètres de session pour les valeurs binaires).

Si l’option est réglée sur UTF-8, le déchargement des données échoue lorsque l’une des valeurs binaires de la table contient des données UTF-8 non valides. Dans ce cas, Snowflake renvoie une erreur.

Exemple de format hexadécimal (« HEX »)¶

Pour entrer des données BINARY, vous pouvez les encoder sous la forme d’une chaîne de caractères hexadécimaux, comme indiqué dans l’exemple suivant.

Commencez par créer une table avec une colonne BINARY :

CREATE OR REPLACE TABLE demo_binary_hex (b BINARY);

Si vous essayez d’insérer une chaîne « ordinaire » en utilisant la fonction TO_BINARY pour essayer de la convertir en une valeur BINARY valide, elle échoue :

INSERT INTO demo_binary_hex (b) SELECT TO_BINARY('HELP', 'HEX');

Voici le message d’erreur :

100115 (22000): The following string is not a legal hex-encoded value: 'HELP'

Cette fois, convertissez explicitement l’entrée en une chaîne de chiffres hexadécimaux avant de l’insérer (cela réussira) :

INSERT INTO demo_binary_hex (b) SELECT TO_BINARY(HEX_ENCODE('HELP'), 'HEX');

Maintenant, récupérez les données :

SELECT TO_VARCHAR(b), HEX_DECODE_STRING(TO_VARCHAR(b)) FROM demo_binary_hex;

+---------------+----------------------------------+
| TO_VARCHAR(B) | HEX_DECODE_STRING(TO_VARCHAR(B)) |
|---------------+----------------------------------|
| 48454C50      | HELP                             |
+---------------+----------------------------------+

Comme vous pouvez le constater, la sortie est affichée par défaut en hexadécimal. Pour récupérer la chaîne d’origine, utiliser la fonction HEX_DECODE_STRING (le complément de la fonction HEX_ENCODE qui était utilisée précédemment pour encoder la chaîne).

La requête suivante montre plus en détail ce qui se passe en interne :

SELECT 'HELP',
       HEX_ENCODE('HELP'),
       b,
       HEX_DECODE_STRING(HEX_ENCODE('HELP')),
       TO_VARCHAR(b),
       HEX_DECODE_STRING(TO_VARCHAR(b))
  FROM demo_binary_hex;

+--------+--------------------+----------+---------------------------------------+---------------+----------------------------------+
| 'HELP' | HEX_ENCODE('HELP') | B        | HEX_DECODE_STRING(HEX_ENCODE('HELP')) | TO_VARCHAR(B) | HEX_DECODE_STRING(TO_VARCHAR(B)) |
|--------+--------------------+----------+---------------------------------------+---------------+----------------------------------|
| HELP   | 48454C50           | 48454C50 | HELP                                  | 48454C50      | HELP                             |
+--------+--------------------+----------+---------------------------------------+---------------+----------------------------------+

Exemple de format BASE64¶

Avant de lire cette section, voir Exemple de format hexadécimal (« HEX »). Les concepts de base sont similaires et Exemple de format hexadécimal (« HEX ») les explique plus en détail.

Commencez par créer une table avec une colonne BINARY :

CREATE OR REPLACE TABLE demo_binary_base64 (b BINARY);

Insérer une ligne :

INSERT INTO demo_binary_base64 (b) SELECT TO_BINARY(BASE64_ENCODE('HELP'), 'BASE64');

Récupérer cette ligne :

SELECT 'HELP',
       BASE64_ENCODE('HELP'),
       BASE64_DECODE_STRING(BASE64_ENCODE('HELP')),
       TO_VARCHAR(b, 'BASE64'),
       BASE64_DECODE_STRING(TO_VARCHAR(b, 'BASE64'))
 FROM demo_binary_base64;

+--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------+
| 'HELP' | BASE64_ENCODE('HELP') | BASE64_DECODE_STRING(BASE64_ENCODE('HELP')) | TO_VARCHAR(B, 'BASE64') | BASE64_DECODE_STRING(TO_VARCHAR(B, 'BASE64')) |
|--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------|
| HELP   | SEVMUA==              | HELP                                        | SEVMUA==                | HELP                                          |
+--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------+

Exemple de format UTF-8¶

Commencez par créer une table avec une colonne BINARY :

CREATE OR REPLACE TABLE demo_binary_utf8 (b BINARY);

Insérer une ligne :

INSERT INTO demo_binary_utf8 (b) SELECT TO_BINARY('HELP', 'UTF-8');

Récupérer cette ligne :

SELECT 'HELP',
       TO_VARCHAR(b, 'UTF-8')
  FROM demo_binary_utf8;

+--------+------------------------+
| 'HELP' | TO_VARCHAR(B, 'UTF-8') |
|--------+------------------------|
| HELP   | HELP                   |
+--------+------------------------+