CREATE STAGE¶

Zones de préparation externes¶

Amazon S3

REFRESH_ON_CREATE = TRUE | FALSE

Spécifie s’il faut actualiser automatiquement les métadonnées de la table de répertoire une fois, immédiatement après la création de la zone de préparation. L’actualisation des métadonnées de la table de répertoire synchronise les métadonnées avec la liste actuelle des fichiers de données dans le chemin de zone de préparation spécifié. Cette action est requise pour que les métadonnées enregistrent tout fichier de données existant dans la zone de préparation nommée spécifiée dans le paramètre URL =.

TRUE

Snowflake actualise automatiquement les métadonnées de la table de répertoire une fois, après la création de la zone de préparation.

Note

Si l’URL de stockage Cloud spécifié contient près d’un million de fichiers ou plus, nous vous recommandons de définir REFRESH_ON_CREATE = FALSE. Après avoir créé la zone de préparation, actualisez les métadonnées de la table de répertoire de manière incrémentielle en exécutant les instructions ALTER STAGE … REFRESH qui spécifient des sous-chemins dans l’emplacement de stockage (c’est-à-dire des sous-ensembles de fichiers à inclure dans l’actualisation) jusqu’à ce que les métadonnées incluent tous les fichiers de l’emplacement.

FALSE

Snowflake n’actualise pas automatiquement les métadonnées de la table de répertoire. Pour enregistrer des fichiers de données qui existent dans la zone de préparation, vous devez actualiser manuellement les métadonnées de la table de répertoire une fois à l’aide de ALTER STAGE … REFRESH.

Par défaut : TRUE

AUTO_REFRESH = TRUE | FALSE

Spécifie si Snowflake doit activer le déclenchement des actualisations automatiques des métadonnées de la table de répertoire lorsque de nouveaux fichiers de données ou des fichiers de données mis à jour sont disponibles dans la zone de préparation externe nommée spécifiée dans le paramètre [ WITH ] LOCATION =.

TRUE

Snowflake permet de déclencher des actualisations automatiques des métadonnées de la table de répertoire.

FALSE

Snowflake n’active pas le déclenchement d’actualisations automatiques des métadonnées de la table de répertoire. Vous devez actualiser manuellement les métadonnées de la table de répertoire de façon périodique avec ALTER STAGE … REFRESH pour synchroniser les métadonnées avec la liste actuelle des fichiers dans le chemin de la zone de préparation.

Par défaut : FALSE

Google Cloud Storage

REFRESH_ON_CREATE = TRUE | FALSE

Spécifie s’il faut actualiser automatiquement les métadonnées de la table de répertoire une fois, immédiatement après la création de la zone de préparation. L’actualisation des métadonnées de la table de répertoire synchronise les métadonnées avec la liste actuelle des fichiers de données dans le chemin de zone de préparation spécifié. Cette action est requise pour que les métadonnées enregistrent tout fichier de données existant dans la zone de préparation nommée spécifiée dans le paramètre URL =.

TRUE

Snowflake actualise automatiquement les métadonnées de la table de répertoire une fois, après la création de la zone de préparation.

Note

Si l’URL de stockage Cloud spécifié contient près d’un million de fichiers ou plus, nous vous recommandons de définir REFRESH_ON_CREATE = FALSE. Après avoir créé la zone de préparation, actualisez les métadonnées de la table de répertoire de manière incrémentielle en exécutant les instructions ALTER STAGE … REFRESH qui spécifient des sous-chemins dans l’emplacement de stockage (c’est-à-dire des sous-ensembles de fichiers à inclure dans l’actualisation) jusqu’à ce que les métadonnées incluent tous les fichiers de l’emplacement.

FALSE

Snowflake n’actualise pas automatiquement les métadonnées de la table de répertoire. Pour enregistrer des fichiers de données qui existent dans la zone de préparation, vous devez actualiser manuellement les métadonnées de la table de répertoire une fois à l’aide de ALTER STAGE … REFRESH.

Par défaut : TRUE

AUTO_REFRESH = TRUE | FALSE

Spécifie si Snowflake doit activer le déclenchement des actualisations automatiques des métadonnées de la table de répertoire lorsque de nouveaux fichiers de données ou des fichiers de données mis à jour sont disponibles dans la zone de préparation externe nommée spécifiée dans le paramètre [ WITH ] LOCATION =.

TRUE

Snowflake permet de déclencher des actualisations automatiques des métadonnées de la table de répertoire.

FALSE

Snowflake n’active pas le déclenchement d’actualisations automatiques des métadonnées de la table de répertoire. Vous devez actualiser manuellement les métadonnées de la table de répertoire de façon périodique avec ALTER STAGE … REFRESH pour synchroniser les métadonnées avec la liste actuelle des fichiers dans le chemin de la zone de préparation.

NOTIFICATION_INTEGRATION = '<nom_intégration_notification>'

Spécifie le nom de l’intégration de notification utilisée pour actualiser automatiquement les métadonnées de la table de répertoire à l’aide des notifications GCS Pub/Sub. Une intégration de notification est un objet Snowflake qui fournit une interface entre Snowflake et des services tiers de mise en file d’attente de messages dans le Cloud.

Microsoft Azure

REFRESH_ON_CREATE = TRUE | FALSE

Spécifie s’il faut actualiser automatiquement les métadonnées de la table de répertoire une fois, immédiatement après la création de la zone de préparation. L’actualisation des métadonnées de la table de répertoire synchronise les métadonnées avec la liste actuelle des fichiers de données dans le chemin de zone de préparation spécifié. Cette action est requise pour que les métadonnées enregistrent tout fichier de données existant dans la zone de préparation nommée spécifiée dans le paramètre URL =.

TRUE

Snowflake actualise automatiquement les métadonnées de la table de répertoire une fois, après la création de la zone de préparation.

Note

Si l’URL de stockage Cloud spécifié contient près d’un million de fichiers ou plus, nous vous recommandons de définir REFRESH_ON_CREATE = FALSE. Après avoir créé la zone de préparation, actualisez les métadonnées de la table de répertoire de manière incrémentielle en exécutant les instructions ALTER STAGE … REFRESH qui spécifient des sous-chemins dans l’emplacement de stockage (c’est-à-dire des sous-ensembles de fichiers à inclure dans l’actualisation) jusqu’à ce que les métadonnées incluent tous les fichiers de l’emplacement.

FALSE

Snowflake n’actualise pas automatiquement les métadonnées de la table de répertoire. Pour enregistrer des fichiers de données qui existent dans la zone de préparation, vous devez actualiser manuellement les métadonnées de la table de répertoire une fois à l’aide de ALTER STAGE … REFRESH.

Par défaut : TRUE

AUTO_REFRESH = TRUE | FALSE

Spécifie si Snowflake doit activer le déclenchement des actualisations automatiques des métadonnées de la table de répertoire lorsque de nouveaux fichiers de données ou des fichiers de données mis à jour sont disponibles dans la zone de préparation externe nommée spécifiée dans le paramètre [ WITH ] LOCATION =.

TRUE

Snowflake permet de déclencher des actualisations automatiques des métadonnées de la table de répertoire.

FALSE

Snowflake n’active pas le déclenchement d’actualisations automatiques des métadonnées de la table de répertoire. Vous devez actualiser manuellement les métadonnées de la table de répertoire de façon périodique avec ALTER STAGE … REFRESH pour synchroniser les métadonnées avec la liste actuelle des fichiers dans le chemin de la zone de préparation.

Par défaut : FALSE

NOTIFICATION_INTEGRATION = '<nom_intégration_notification>'

Spécifie le nom de l’intégration de notification utilisée pour actualiser automatiquement les métadonnées de la table de répertoire à l’aide des notifications Azure Event Grid. Une intégration de notification est un objet Snowflake qui fournit une interface entre Snowflake et des services tiers de mise en file d’attente de messages dans le Cloud.

TYPE = CSV¶

COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

• Lors du chargement des données, spécifie l’algorithme de compression actuel pour le fichier de données. Snowflake utilise cette option pour détecter comment un fichier de données déjà compressé a été compressé afin que les données compressées dans le fichier puissent être extraites pour le chargement.

• Lors du déchargement des données, compresse le fichier de données en utilisant l’algorithme de compression spécifié.

Valeurs:

Valeurs prises en charge	Remarques
AUTO	Lors du chargement des données, l’algorithme de compression est détecté automatiquement, sauf pour les fichiers compressés par Brotli, qui ne peuvent actuellement pas être détectés automatiquement. Lors du déchargement des données, les fichiers sont automatiquement compressés en utilisant la valeur par défaut, qui est gzip.
GZIP
BZ2
BROTLI	Doit être spécifié lors du chargement/déchargement de fichiers compressés Brotli.
ZSTD	Zstandard v0.8 (et supérieur) est pris en charge.
DEFLATE	Fichiers compressés Deflate (avec en-tête zlib, RFC1950).
RAW_DEFLATE	Fichiers bruts compressés Deflate (sans en-tête, RFC1951).
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Par défaut:

AUTO

RECORD_DELIMITER = 'character' | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

Un ou plusieurs caractères à un octet ou à plusieurs octets qui séparent les enregistrements dans un fichier d’entrée (chargement de données) ou un fichier déchargé (déchargement de données). Accepte les séquences d’échappement courantes ou les caractères à un octet ou à plusieurs octets suivants :

Caractères à un octet:

Valeurs octales (préfixées par \\) ou les valeurs hexadécimales (préfixées par \x ou 0x). Par exemple, pour les enregistrements délimités par le caractère accent circonflexe (^), spécifiez la valeur octale (\\136) ou hexadécimale (0x5e).

Caractères multi-octets:

Valeurs hexagonales (préfixées par \x). Par exemple, pour les enregistrements délimités par le caractère cent (¢), spécifiez la valeur hexadécimale (\xC2\xA2).

Le délimiteur pour RECORD_DELIMITER ou FIELD_DELIMITER ne peut pas être une sous-chaîne du délimiteur pour l’autre option de format de fichier (par exemple FIELD_DELIMITER = 'aa' RECORD_DELIMITER = 'aabb').

Le délimiteur spécifié doit être un caractère UTF-8 valide et non une séquence aléatoire d’octets. Notez également que le délimiteur est limité à un maximum de 20 caractères.

Accepte également une valeur de NONE.

Par défaut:

Chargement des données:

Caractère de nouvelle ligne. Notez que « nouvelle ligne » fait sens, de sorte que \r\n sera compris comme une nouvelle ligne pour les fichiers sur une plate-forme Windows.

Déchargement des données:

Caractère de nouvelle ligne (\n).

FIELD_DELIMITER = 'character' | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

Un ou plusieurs caractères à un octet ou à plusieurs octets qui séparent les champs d’un fichier d’entrée (chargement de données) ou d’un fichier déchargé (déchargement de données). Accepte les séquences d’échappement courantes ou les caractères à un octet ou à plusieurs octets suivants :

Caractères à un octet:

Valeurs octales (préfixées par \\) ou les valeurs hexadécimales (préfixées par \x ou 0x). Par exemple, pour les enregistrements délimités par le caractère accent circonflexe (^), spécifiez la valeur octale (\\136) ou hexadécimale (0x5e).

Caractères multi-octets:

Valeurs hexagonales (préfixées par \x). Par exemple, pour les enregistrements délimités par le caractère cent (¢), spécifiez la valeur hexadécimale (\xC2\xA2).

Le délimiteur pour RECORD_DELIMITER ou FIELD_DELIMITER ne peut pas être une sous-chaîne du délimiteur pour l’autre option de format de fichier (par exemple FIELD_DELIMITER = 'aa' RECORD_DELIMITER = 'aabb').

Note

Pour les caractères autres que ASCII, vous devez utiliser la valeur de la séquence d’octets hexagonale pour obtenir un comportement déterministe.

Le délimiteur spécifié doit être un caractère UTF-8 valide et non une séquence aléatoire d’octets. Notez également que le délimiteur est limité à un maximum de 20 caractères.

Accepte également une valeur de NONE.

Par défaut:

virgule (,)

FILE_EXTENSION = 'string' | NONE

Utilisation:

Déchargement des données uniquement

Définition:

Spécifie l’extension des fichiers déchargés dans une zone de préparation. Accepte toute extension. L’utilisateur est chargé de spécifier une extension de fichier qui peut être lue par tout logiciel ou service désiré.

Par défaut:

null, ce qui signifie que l’extension du fichier est déterminée par le type de format : .csv[compression], où compression est l’extension ajoutée par la méthode de compression, si COMPRESSION est défini.

Note

Si l’option de copie SINGLE est TRUE, alors la commande COPY décharge un fichier sans extension par défaut. Pour spécifier une extension de fichier, fournissez un nom et une extension de fichier dans le chemin internal_location ou external_location (par ex. copy into @stage/data.csv).

PARSE_HEADER = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut utiliser les en-têtes de la première ligne des fichiers de données pour déterminer les noms des colonnes.

Cette option de format de fichier s’applique uniquement aux actions suivantes :

• Détection automatique des définitions de colonnes à l’aide de la fonction INFER_SCHEMA.

• Chargement de données CSV dans des colonnes séparées en utilisant la fonction INFER_SCHEMA et l’option de copie MATCH_BY_COLUMN_NAME.

Si l’option est définie sur TRUE, les en-têtes de la première ligne seront utilisés pour déterminer les noms des colonnes. La valeur par défaut FALSE renvoie les noms de colonnes sous la forme c , où est la position de la colonne.

Notez que l’option SKIP_HEADER n’est pas prise en charge avec PARSE_HEADER = TRUE.

Par défaut : FALSE

SKIP_HEADER = integer

Utilisation:

Chargement de données et tables externes

Définition:

Nombre de lignes au début du fichier à ignorer.

Notez que SKIP_HEADER n’utilise pas les valeurs RECORD_DELIMITER ou FIELD_DELIMITER pour déterminer la nature d’une ligne d’en-tête. Au lieu de cela, il ignore simplement le nombre spécifié de lignes délimitées par CRLF (retour chariot, saut de ligne) dans le fichier. RECORD_DELIMITER et FIELD_DELIMITER sont ensuite utilisés pour déterminer les lignes de données à charger.

Par défaut:

0

SKIP_BLANK_LINES = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui indique d’ignorer toutes les lignes vides rencontrées dans les fichiers de données ; sinon, les lignes vides produisent une erreur de fin d’enregistrement (comportement par défaut).

Par défaut : FALSE

DATE_FORMAT = 'string' | AUTO

Utilisation:

Chargement et déchargement des données

Définition:

Définit le format des valeurs de date dans les fichiers de données (chargement des données) ou la table (déchargement des données). Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre DATE_INPUT_FORMAT (chargement de données) ou DATE_OUTPUT_FORMAT (déchargement de données) est utilisée.

Par défaut:

AUTO

TIME_FORMAT = 'string' | AUTO

Utilisation:

Chargement et déchargement des données

Définition:

Définit le format des valeurs temporelles dans les fichiers de données (chargement des données) ou la table (déchargement des données). Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre TIME_INPUT_FORMAT (chargement de données) ou TIME_OUTPUT_FORMAT (déchargement de données) est utilisée.

Par défaut:

AUTO

TIMESTAMP_FORMAT = string' | AUTO

Utilisation:

Chargement et déchargement des données

Définition:

Définit le format des valeurs d’horodatage dans les fichiers de données (chargement des données) ou la table (déchargement des données). Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre TIMESTAMP_INPUT_FORMAT (chargement de données) ou TIMESTAMP_OUTPUT_FORMAT (déchargement de données) est utilisée.

Par défaut:

AUTO

BINARY_FORMAT = HEX | BASE64 | UTF8

Utilisation:

Chargement et déchargement des données

Définition:

Définit le format d’encodage pour l’entrée ou la sortie binaire. L’option peut être utilisée pour charger ou décharger des données à partir de colonnes binaires dans une table.

Par défaut:

HEX

ESCAPE = 'character' | NONE

Utilisation:

Chargement et déchargement des données

Définition:

Chaîne de caractères à un octet utilisée comme caractère d’échappement pour les valeurs de champs délimitées ou non délimitées. Un caractère d’échappement appelle une autre interprétation sur les caractères suivants dans une séquence de caractères. Vous pouvez utiliser le caractère ESCAPE pour interpréter les instances du caractère FIELD_OPTIONALLY_ENCLOSED_BY ou dans les données comme des littéraux.

Accepte les séquences d’échappement, les valeurs octales ou les valeurs hexadécimales courantes.

Chargement des données:

Spécifie le caractère d’échappement pour les champs délimités uniquement. Spécifiez le caractère utilisé pour délimiter les champs en définissant FIELD_OPTIONALLY_ENCLOSED_BY.

Note

Cette option de format de fichier ne prend en charge que les caractères à un seul octet. Notez que le codage des caractères UTF-8 représente les caractères ASCII d’ordre supérieur comme des caractères à plusieurs octets. Si votre fichier de données est codé avec le jeu de caractères UTF-8, vous ne pouvez pas spécifier un caractère ASCII d’ordre supérieur comme valeur d’option.

En outre, si vous spécifiez un caractère ASCII d’ordre élevé, nous vous recommandons de définir l’option de format de fichier ENCODING = 'string' comme codage de caractères pour vos fichiers de données afin de garantir la bonne interprétation du caractère.

Déchargement des données:

Si cette option est activée, elle remplace le jeu de caractères d’échappement pour ESCAPE_UNENCLOSED_FIELD.

Par défaut:

NONE

ESCAPE_UNENCLOSED_FIELD = 'character' | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

Chaîne de caractères à un octet utilisée comme caractère d’échappement pour les valeurs de champs non délimitées uniquement. Un caractère d’échappement appelle une autre interprétation sur les caractères suivants dans une séquence de caractères. Vous pouvez utiliser le caractère ESCAPE pour interpréter les instances des caractères FIELD_DELIMITER ou RECORD_DELIMITER dans les données comme des littéraux. Le caractère d’échappement peut également être utilisé pour échapper les instances de lui-même dans les données.

Accepte les séquences d’échappement, les valeurs octales ou les valeurs hexadécimales courantes.

Chargement des données:

Spécifie le caractère d’échappement pour les champs non délimités uniquement.

Note

• La valeur par défaut est \\. Si une ligne d’un fichier de données se termine par une barre oblique inverse (\), ce caractère échappe le caractère de nouvelle ligne ou de retour chariot spécifié pour l’option de format de fichier RECORD_DELIMITER. Par conséquent, l’opération de chargement considère cette ligne et la suivante comme une seule ligne de données. Pour éviter ce problème, définissez la valeur sur NONE.

• Cette option de format de fichier ne prend en charge que les caractères à un seul octet. Notez que le codage des caractères UTF-8 représente les caractères ASCII d’ordre supérieur comme des caractères à plusieurs octets. Si votre fichier de données est codé avec le jeu de caractères UTF-8, vous ne pouvez pas spécifier un caractère ASCII d’ordre supérieur comme valeur d’option.

  En outre, si vous spécifiez un caractère ASCII d’ordre élevé, nous vous recommandons de définir l’option de format de fichier ENCODING = 'string' comme codage de caractères pour vos fichiers de données afin de garantir la bonne interprétation du caractère.

Déchargement des données:

Si ESCAPE est défini, le jeu de caractères d’échappement pour cette option de format de fichier l’emporte sur cette option.

Par défaut:

barre oblique inverse (\\)

TRIM_SPACE = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui spécifie s’il faut supprimer les espaces blancs des champs.

Par exemple, si votre logiciel de base de données externe contient des champs entre guillemets, mais insère un espace d’en-tête, Snowflake lit l’espace d’en-tête plutôt que le caractère guillemet comme début du champ (c’est-à-dire que les guillemets sont interprétés comme faisant partie de la chaîne des données du champ). Définissez cette option sur TRUE pour supprimer les espaces indésirables pendant le chargement des données.

Comme autre exemple, si les espaces d’en-tête ou de fin entourent des guillemets qui délimitent les chaînes de caractères, vous pouvez supprimer les espaces environnants en utilisant cette option et le caractère guillemet en utilisant l’option FIELD_OPTIONALLY_ENCLOSED_BY. Notez que tous les espaces entre les guillemets sont préservés. Par exemple, en supposant que FIELD_DELIMITER = '|' et FIELD_OPTIONALLY_ENCLOSED_BY = '"' :

|"Hello world"|    /* loads as */  >Hello world<
|" Hello world "|  /* loads as */  > Hello world <
| "Hello world" |  /* loads as */  >Hello world<

Copy

(les parenthèses dans cet exemple ne sont pas chargées ; elles sont utilisées pour délimiter le début et la fin des chaînes chargées)

Par défaut:

FALSE

FIELD_OPTIONALLY_ENCLOSED_BY = 'character' | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

Caractère utilisé pour délimiter des chaînes. La valeur peut être NONE, un caractère guillemet simple (') ou un caractère guillemet double ("). Pour utiliser le caractère guillemet simple, utilisez la représentation octale ou hexadécimale (0x27) ou le double échappement en guillemet simple ('').

Lorsqu’un champ contient ce caractère, effectuez un échappement en utilisant le même caractère. Par exemple, si la valeur est le caractère de guillemet double et qu’un champ contient la chaîne A "B" C, effectuez un échappement des guillemets doubles comme suit :

A ""B"" C

Par défaut:

NONE

NULL_IF = ( 'string1' [ , 'string2' , ... ] )

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

Chaîne utilisée pour les conversions entrante et sortante de SQL NULL :

• Lors du chargement des données, Snowflake remplace ces valeurs de la source de chargement des données par SQL NULL. Pour spécifier plus d’une chaîne, mettez la liste des chaînes entre parenthèses et utilisez des virgules pour séparer chaque valeur.

  Notez que Snowflake convertit toutes les instances de la valeur en NULL, quel que soit le type de données. Par exemple, si 2 est spécifié comme valeur, toutes les instances de 2 sous forme de chaîne ou de nombre sont converties.

  Par exemple :

  NULL_IF = ('\N', 'NULL', 'NUL', '')

  Notez que cette option peut inclure des chaînes vides.

• Lors du déchargement des données, Snowflake convertit les valeurs NULL SQL vers la première valeur de la liste.

Par défaut:

\\N (c.-à-d. NULL, qui suppose que la valeur ESCAPE_UNENCLOSED_FIELD est \\)

ERROR_ON_COLUMN_COUNT_MISMATCH = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut générer une erreur d’analyse si le nombre de colonnes délimitées (c’est-à-dire de champs) dans un fichier d’entrée ne correspond pas au nombre de colonnes de la table correspondante.

Si ce paramètre est réglé sur FALSE, aucune erreur n’est générée et le chargement continue. Si le fichier est chargé correctement :

• Si le fichier d’entrée contient des enregistrements contenant plus de champs que de colonnes dans la table, les champs correspondants sont chargés par ordre d’occurrence dans le fichier et les autres champs ne sont pas chargés.

• Si le fichier d’entrée contient des enregistrements avec moins de champs que de colonnes dans la table, les colonnes qui ne correspondent pas dans la table sont chargées avec des valeurs NULL.

Cette option suppose que tous les enregistrements du fichier d’entrée ont la même longueur (c’est-à-dire qu’un fichier contenant des enregistrements de longueur variable renvoie une erreur quelle que soit la valeur spécifiée pour ce paramètre).

Par défaut:

TRUE

Note

Lors de la transformation des données pendant le chargement (c’est-à-dire, en utilisant une requête comme source pour la commande COPY), cette option est ignorée. Il n’est pas nécessaire que vos fichiers de données aient le même nombre et le même ordre de colonnes que votre table cible.

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�).

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

EMPTY_FIELD_AS_NULL = TRUE | FALSE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

• Lors du chargement de données, spécifie s’il faut insérer SQL NULL pour les champs vides dans un fichier d’entrée, qui sont représentés par deux délimiteurs successifs (par ex., ,,).

  Si l’option est définie sur FALSE, Snowflake essaie de placer un champ vide dans le type de colonne correspondant. Une chaîne vide est insérée dans les colonnes de type STRING. Pour les autres types de colonne, la commande COPY produit une erreur.

• Lors du déchargement des données, cette option est utilisée en combinaison avec FIELD_OPTIONALLY_ENCLOSED_BY. Lorsque FIELD_OPTIONALLY_ENCLOSED_BY = NONE, le paramètre EMPTY_FIELD_AS_NULL = FALSE spécifie de décharger les chaînes vides dans les tables pour vider les valeurs de chaîne sans guillemets entourant les valeurs de champ.

  S’il est défini sur TRUE, FIELD_OPTIONALLY_ENCLOSED_BY doit spécifier un caractère pour entourer les chaînes.

Par défaut:

TRUE

SKIP_BYTE_ORDER_MARK = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut ignorer le BOM (marque d’ordre d’octet), s’il est présent dans un fichier de données. Une marque BOM est un code de caractère placé au début d’un fichier de données qui définit l’ordre des octets et la forme de l’encodage.

S’il est réglé sur FALSE, Snowflake reconnaît n’importe quel BOM dans les fichiers de données, ce qui pourrait entraîner une erreur BOM ou une fusion dans la première colonne du tableau.

Par défaut:

TRUE

ENCODING = 'string'

Utilisation:

Chargement de données et tables externes

Définition:

Chaîne (constante) qui spécifie le jeu de caractères des données sources lors du chargement des données dans une table.

Jeu de caractères	Valeur ENCODING	Langues acceptées	Remarques
Big5	BIG5	Chinois traditionnel
EUC-JP	EUCJP	Japonais
EUC-KR	EUCKR	Coréen
GB18030	GB18030	Chinois
IBM420	IBM420	Arabe
IBM424	IBM424	Hébreu
IBM949	IBM949	Coréen
ISO-2022-CN	ISO2022CN	Chinois simplifié
ISO-2022-JP	ISO2022JP	Japonais
ISO-2022-KR	ISO2022KR	Coréen
ISO-8859-1	ISO88591	Allemand, anglais, danois, français, italien, norvégien, néerlandais, portugais, suédois
ISO-8859-2	ISO88592	Tchèque, hongrois, polonais, roumain
ISO-8859-5	ISO88595	Russe
ISO-8859-6	ISO88596	Arabe
ISO-8859-7	ISO88597	Grec
ISO-8859-8	ISO88598	Hébreu
ISO-8859-9	ISO88599	Turc
ISO-8859-15	ISO885915	Allemand, anglais, danois, français, italien, norvégien, néerlandais, portugais, suédois	Identique à ISO-8859-1 à l’exception des 8 caractères, y compris le symbole monétaire Euro.
KOI8-R	KOI8R	Russe
Shift_JIS	SHIFTJIS	Japonais
UTF-8	UTF8	Toutes les langues	Pour charger des données à partir de fichiers délimités (CSV, TSV, etc.), UTF-8 est la valeur par défaut. . . Pour charger des données à partir de tous les autres formats de fichier pris en charge (JSON, Avro, etc.), ainsi que pour décharger des données, UTF-8 est le seul jeu de caractères pris en charge.
UTF-16	UTF16	Toutes les langues
UTF-16BE	UTF16BE	Toutes les langues
UTF-16LE	UTF16LE	Toutes les langues
UTF-32	UTF32	Toutes les langues
UTF-32BE	UTF32BE	Toutes les langues
UTF-32LE	UTF32LE	Toutes les langues
windows-949	WINDOWS949	Coréen
windows-1250	WINDOWS1250	Tchèque, hongrois, polonais, roumain
windows-1251	WINDOWS1251	Russe
windows-1252	WINDOWS1252	Allemand, anglais, danois, français, italien, norvégien, néerlandais, portugais, suédois
windows-1253	WINDOWS1253	Grec
windows-1254	WINDOWS1254	Turc
windows-1255	WINDOWS1255	Hébreu
windows-1256	WINDOWS1256	Arabe

Par défaut:

UTF8

Note

Snowflake stocke toutes les données en interne dans le jeu de caractères UTF-8. Les données sont converties en UTF-8 avant d’être chargées dans Snowflake.

TYPE = JSON¶

COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE

Utilisation:

Chargement de données et tables externes

Définition:

• Lors du chargement des données, spécifie l’algorithme de compression actuel pour le fichier de données. Snowflake utilise cette option pour détecter comment un fichier de données déjà compressé a été compressé afin que les données compressées dans le fichier puissent être extraites pour le chargement.

• Lors du déchargement des données, compresse le fichier de données en utilisant l’algorithme de compression spécifié.

Valeurs:

Valeurs prises en charge	Remarques
AUTO	Lors du chargement des données, l’algorithme de compression est détecté automatiquement, sauf pour les fichiers compressés par Brotli, qui ne peuvent actuellement pas être détectés automatiquement. Lors du déchargement des données, les fichiers sont automatiquement compressés en utilisant la valeur par défaut, qui est gzip.
GZIP
BZ2
BROTLI	Doit être spécifié lors du chargement/déchargement de fichiers compressés Brotli.
ZSTD	Zstandard v0.8 (et supérieur) est pris en charge.
DEFLATE	Fichiers compressés Deflate (avec en-tête zlib, RFC1950).
RAW_DEFLATE	Fichiers bruts compressés Deflate (sans en-tête, RFC1951).
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Par défaut:

AUTO

DATE_FORMAT = 'string' | AUTO

Utilisation:

Chargement des données uniquement

Définition:

Définit le format des valeurs de chaîne de date dans les fichiers de données. Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre DATE_INPUT_FORMAT est utilisée.

Cette option de format de fichier s’applique uniquement aux actions suivantes :

• Chargement des données JSON dans des colonnes séparées en utilisant l’option de copie MATCH_BY_COLUMN_NAME.

• Chargement des données JSON dans des colonnes distinctes en spécifiant une requête dans l’instruction COPY (c’est-à-dire une transformation COPY).

Par défaut:

AUTO

TIME_FORMAT = 'string' | AUTO

Utilisation:

Chargement des données uniquement

Définition:

Définit le format des valeurs de la chaîne de temps dans les fichiers de données. Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre TIME_INPUT_FORMAT est utilisée.

Cette option de format de fichier s’applique uniquement aux actions suivantes :

• Chargement des données JSON dans des colonnes séparées en utilisant l’option de copie MATCH_BY_COLUMN_NAME.

• Chargement des données JSON dans des colonnes distinctes en spécifiant une requête dans l’instruction COPY (c’est-à-dire une transformation COPY).

Par défaut:

AUTO

TIMESTAMP_FORMAT = string' | AUTO

Utilisation:

Chargement des données uniquement

Définition:

Définit le format des valeurs de chaîne d’horodatage dans les fichiers de données. Si une valeur n’est pas spécifiée ou est AUTO, la valeur du paramètre TIMESTAMP_INPUT_FORMAT est utilisée.

Cette option de format de fichier s’applique uniquement aux actions suivantes :

• Chargement des données JSON dans des colonnes séparées en utilisant l’option de copie MATCH_BY_COLUMN_NAME.

• Chargement des données JSON dans des colonnes distinctes en spécifiant une requête dans l’instruction COPY (c’est-à-dire une transformation COPY).

Par défaut:

AUTO

BINARY_FORMAT = HEX | BASE64 | UTF8

Utilisation:

Chargement des données uniquement

Définition:

Définit le format d’encodage des valeurs de chaînes binaires dans les fichiers de données. L’option peut être utilisée pour charger des données à partir de colonnes binaires dans une table.

Cette option de format de fichier s’applique uniquement aux actions suivantes :

• Chargement des données JSON dans des colonnes séparées en utilisant l’option de copie MATCH_BY_COLUMN_NAME.

• Chargement des données JSON dans des colonnes distinctes en spécifiant une requête dans l’instruction COPY (c’est-à-dire une transformation COPY).

Par défaut:

HEX

TRIM_SPACE = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut supprimer les espaces blancs de début et de fin des chaînes.

Par exemple, si votre logiciel de base de données externe contient des champs entre guillemets, mais insère un espace d’en-tête, Snowflake lit l’espace d’en-tête plutôt que le caractère guillemet comme début du champ (c’est-à-dire que les guillemets sont interprétés comme faisant partie de la chaîne des données du champ). Définissez cette option sur TRUE pour supprimer les espaces indésirables pendant le chargement des données.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données JSON dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Par défaut:

FALSE

NULL_IF = ( 'string1' [ , 'string2' , ... ] )

Utilisation:

Chargement des données uniquement

Définition:

Chaîne utilisée pour les conversions entrante et sortante de SQL NULL. Snowflake remplace ces chaînes de la source de chargement des données par SQL NULL. Pour spécifier plus d’une chaîne, mettez la liste des chaînes entre parenthèses et utilisez des virgules pour séparer chaque valeur.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données JSON dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Notez que Snowflake convertit toutes les instances de la valeur en NULL, quel que soit le type de données. Par exemple, si 2 est spécifié comme valeur, toutes les instances de 2 sous forme de chaîne ou de nombre sont converties.

Par exemple :

NULL_IF = ('\N', 'NULL', 'NUL', '')

Notez que cette option peut inclure des chaînes vides.

Par défaut:

\\N (c.-à-d. NULL, qui suppose que la valeur ESCAPE_UNENCLOSED_FIELD est \\)

FILE_EXTENSION = 'string' | NONE

Utilisation:

Déchargement des données uniquement

Définition:

Spécifie l’extension des fichiers déchargés dans une zone de préparation. Accepte toute extension. L’utilisateur est chargé de spécifier une extension de fichier qui peut être lue par tout logiciel ou service désiré.

Par défaut:

null, ce qui signifie que l’extension du fichier est déterminée par le type de format : .json[compression], où compression est l’extension ajoutée par la méthode de compression, si COMPRESSION est défini.

ENABLE_OCTAL = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui permet d’analyser les nombres octaux.

Par défaut:

FALSE

ALLOW_DUPLICATE = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui indique d’autoriser les noms de champs d’objets dupliqués (seul le dernier sera conservé).

Par défaut:

FALSE

STRIP_OUTER_ARRAY = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui demande à l’analyseur JSON de supprimer les crochets extérieurs (comme [ ]).

Par défaut:

FALSE

STRIP_NULL_VALUES = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui demande à l’analyseur JSON de supprimer les champs d’objets ou les éléments de tableau contenant des valeurs null. Par exemple, lorsque défini sur TRUE :

Avant	Après
[null]	[]
[null,null,3]	[,,3]
{"a":null,"b":null,"c":123}	{"c":123}
{"a":[1,null,2],"b":{"x":null,"y":88}}	{"a":[1,,2],"b":{"y":88}}

Par défaut:

FALSE

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�). Cette option permet de remplacer un caractère par un autre.

Valeurs:

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

IGNORE_UTF8_ERRORS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie si les erreurs d’encodage UTF-8 produisent des conditions d’erreur. Il s’agit d’une syntaxe alternative pour REPLACE_INVALID_CHARACTERS.

Valeurs:

Si ce paramètre est réglé sur TRUE, toute séquence UTF-8 non valide est remplacée discrètement par le caractère Unicode U+FFFD (c.-à-d. un « caractère de remplacement »).

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

SKIP_BYTE_ORDER_MARK = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut ignorer le BOM (marque d’ordre d’octet), s’il est présent dans un fichier de données. Une marque BOM est un code de caractère placé au début d’un fichier de données qui définit l’ordre des octets et la forme de l’encodage.

S’il est réglé sur FALSE, Snowflake reconnaît n’importe quel BOM dans les fichiers de données, ce qui pourrait entraîner une erreur BOM ou une fusion dans la première colonne du tableau.

Par défaut:

TRUE

TYPE = AVRO¶

COMPRESSION = AUTO | GZIP | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE

Utilisation:

Chargement des données uniquement

Définition:

• Lors du chargement des données, spécifie l’algorithme de compression actuel pour le fichier de données. Snowflake utilise cette option pour détecter comment un fichier de données déjà compressé a été compressé afin que les données compressées dans le fichier puissent être extraites pour le chargement.

• Lors du déchargement des données, compresse le fichier de données en utilisant l’algorithme de compression spécifié.

Valeurs:

Valeurs prises en charge	Remarques
AUTO	Lors du chargement des données, l’algorithme de compression est détecté automatiquement, sauf pour les fichiers compressés par Brotli, qui ne peuvent actuellement pas être détectés automatiquement. Lors du déchargement des données, les fichiers sont automatiquement compressés en utilisant la valeur par défaut, qui est gzip.
GZIP
BROTLI	Doit être spécifié lors du chargement/déchargement de fichiers compressés Brotli.
ZSTD	Zstandard v0.8 (et supérieur) est pris en charge.
DEFLATE	Fichiers compressés Deflate (avec en-tête zlib, RFC1950).
RAW_DEFLATE	Fichiers bruts compressés Deflate (sans en-tête, RFC1951).
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Par défaut:

AUTO.

TRIM_SPACE = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut supprimer les espaces blancs de début et de fin des chaînes.

Par exemple, si votre logiciel de base de données externe contient des champs entre guillemets, mais insère un espace d’en-tête, Snowflake lit l’espace d’en-tête plutôt que le caractère guillemet comme début du champ (c’est-à-dire que les guillemets sont interprétés comme faisant partie de la chaîne des données du champ). Définissez cette option sur TRUE pour supprimer les espaces indésirables pendant le chargement des données.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données Avro dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Par défaut:

FALSE

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�). Cette option permet de remplacer un caractère par un autre.

Valeurs:

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

NULL_IF = ( 'string1' [ , 'string2' , ... ] )

Utilisation:

Chargement des données uniquement

Définition:

Chaîne utilisée pour les conversions entrante et sortante de SQL NULL. Snowflake remplace ces chaînes de la source de chargement des données par SQL NULL. Pour spécifier plus d’une chaîne, mettez la liste des chaînes entre parenthèses et utilisez des virgules pour séparer chaque valeur.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données Avro dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Notez que Snowflake convertit toutes les instances de la valeur en NULL, quel que soit le type de données. Par exemple, si 2 est spécifié comme valeur, toutes les instances de 2 sous forme de chaîne ou de nombre sont converties.

Par exemple :

NULL_IF = ('\N', 'NULL', 'NUL', '')

Notez que cette option peut inclure des chaînes vides.

Par défaut:

\\N (c.-à-d. NULL, qui suppose que la valeur ESCAPE_UNENCLOSED_FIELD est \\)

TYPE = ORC¶

TRIM_SPACE = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui spécifie s’il faut supprimer les espaces blancs de début et de fin des chaînes.

Par exemple, si votre logiciel de base de données externe contient des champs entre guillemets, mais insère un espace d’en-tête, Snowflake lit l’espace d’en-tête plutôt que le caractère guillemet comme début du champ (c’est-à-dire que les guillemets sont interprétés comme faisant partie de la chaîne des données du champ). Définissez cette option sur TRUE pour supprimer les espaces indésirables pendant le chargement des données.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement des données Orc dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Par défaut:

FALSE

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�). Cette option permet de remplacer un caractère par un autre.

Valeurs:

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

NULL_IF = ( 'string1' [ , 'string2' , ... ] )

Utilisation:

Chargement de données et tables externes

Définition:

Chaîne utilisée pour les conversions entrante et sortante de SQL NULL. Snowflake remplace ces chaînes de la source de chargement des données par SQL NULL. Pour spécifier plus d’une chaîne, mettez la liste des chaînes entre parenthèses et utilisez des virgules pour séparer chaque valeur.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement des données Orc dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Notez que Snowflake convertit toutes les instances de la valeur en NULL, quel que soit le type de données. Par exemple, si 2 est spécifié comme valeur, toutes les instances de 2 sous forme de chaîne ou de nombre sont converties.

Par exemple :

NULL_IF = ('\N', 'NULL', 'NUL', '')

Notez que cette option peut inclure des chaînes vides.

Par défaut:

\\N (c.-à-d. NULL, qui suppose que la valeur ESCAPE_UNENCLOSED_FIELD est \\)

TYPE = PARQUET¶

COMPRESSION = AUTO | LZO | SNAPPY | NONE

Utilisation:

Chargement de données, déchargement de données et tables externes

Définition:

• Lors du chargement des données, spécifie l’algorithme de compression actuel pour les colonnes des fichiers Parquet.

• Lors du déchargement des données, compresse le fichier de données en utilisant l’algorithme de compression spécifié.

Valeurs:

Valeurs prises en charge	Remarques
AUTO	Lors du chargement des données, l’algorithme de compression est détecté automatiquement. Prend en charge les algorithmes de compression suivants : Brotli, gzip, Lempel–Ziv–Oberhumer (LZO), LZ4, Snappy ou Zstandard v0.8 (et versions ultérieures). . Lors du déchargement des données, les fichiers déchargés sont compressés en utilisant l’algorithme de compression Snappy par défaut.
LZO	Lors du déchargement des données, les fichiers sont compressés à l’aide de l’algorithme Snappy par défaut. Si vous déchargez des données dans des fichiers LZO compressés, spécifiez cette valeur.
SNAPPY	Lors du déchargement des données, les fichiers sont compressés à l’aide de l’algorithme Snappy par défaut. Vous pouvez spécifier cette valeur en option.
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Par défaut:

AUTO

SNAPPY_COMPRESSION = TRUE | FALSE

Utilisation:

Déchargement des données uniquement

Valeurs prises en charge	Remarques
AUTO	Les fichiers déchargés sont compressés à l’aide de l’algorithme de compression Snappy par défaut.
SNAPPY	Peut être spécifié si vous déchargez des fichiers compressés avec Snappy.
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Définition:

Booléen qui spécifie si les fichiers déchargés sont compressés en utilisant l’algorithme SNAPPY.

Note

Obsolète. Utilisez plutôt COMPRESSION = SNAPPY.

Limitations:

Uniquement pris en charge pour les opérations de déchargement de données.

Par défaut:

TRUE

BINARY_AS_TEXT = TRUE | FALSE

Utilisation:

Chargement de données et tables externes

Définition:

Booléen qui spécifie s’il faut interpréter les colonnes sans type de données logiques défini comme du texte UTF-8. Lorsqu’il est réglé sur FALSE, Snowflake interprète ces colonnes comme des données binaires.

Par défaut:

TRUE

Note

Snowflake vous recommande de définir BINARY_AS_TEXT sur FALSE pour éviter tout problème de conversion éventuel.

TRIM_SPACE = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut supprimer les espaces blancs de début et de fin des chaînes.

Par exemple, si votre logiciel de base de données externe contient des champs entre guillemets, mais insère un espace d’en-tête, Snowflake lit l’espace d’en-tête plutôt que le caractère guillemet comme début du champ (c’est-à-dire que les guillemets sont interprétés comme faisant partie de la chaîne des données du champ). Définissez cette option sur TRUE pour supprimer les espaces indésirables pendant le chargement des données.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données Parquet dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Par défaut:

FALSE

USE_LOGICAL_TYPE = TRUE | FALSE

Utilisation:

Chargement de données, interrogation de données dans des fichiers en zone de préparation et détection de schémas.

Définition:

Booléen qui spécifie s’il faut utiliser les types logiques Parquet. Avec cette option de format de fichier, Snowflake peut interpréter les types logiques Parquet lors du chargement des données. Pour plus d’informations, consultez Définitions de types logiques Parquet. Pour activer les types logiques Parquet, définissez USE_LOGICAL_TYPE sur TRUE lorsque vous créez une nouvelle option de format de fichier.

Limitations:

Non pris en charge pour le déchargement de données.

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�). Cette option permet de remplacer un caractère par un autre.

Valeurs:

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

NULL_IF = ( 'string1' [ , 'string2' , ... ] )

Utilisation:

Chargement des données uniquement

Définition:

Chaîne utilisée pour les conversions entrante et sortante de SQL NULL. Snowflake remplace ces chaînes de la source de chargement des données par SQL NULL. Pour spécifier plus d’une chaîne, mettez la liste des chaînes entre parenthèses et utilisez des virgules pour séparer chaque valeur.

Cette option de format de fichier est appliquée aux actions suivantes uniquement lors du chargement de données Parquet dans des colonnes séparées à l’aide de l’option de copie MATCH_BY_COLUMN_NAME.

Notez que Snowflake convertit toutes les instances de la valeur en NULL, quel que soit le type de données. Par exemple, si 2 est spécifié comme valeur, toutes les instances de 2 sous forme de chaîne ou de nombre sont converties.

Par exemple :

NULL_IF = ('\N', 'NULL', 'NUL', '')

Notez que cette option peut inclure des chaînes vides.

Par défaut:

\\N (c.-à-d. NULL, qui suppose que la valeur ESCAPE_UNENCLOSED_FIELD est \\)

TYPE = XML¶

COMPRESSION = AUTO | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE

Utilisation:

Chargement des données uniquement

Définition:

• Lors du chargement des données, spécifie l’algorithme de compression actuel pour le fichier de données. Snowflake utilise cette option pour détecter comment un fichier de données déjà compressé a été compressé afin que les données compressées dans le fichier puissent être extraites pour le chargement.

• Lors du déchargement des données, compresse le fichier de données en utilisant l’algorithme de compression spécifié.

Valeurs:

Valeurs prises en charge	Remarques
AUTO	Lors du chargement des données, l’algorithme de compression est détecté automatiquement, sauf pour les fichiers compressés par Brotli, qui ne peuvent actuellement pas être détectés automatiquement. Lors du déchargement des données, les fichiers sont automatiquement compressés en utilisant la valeur par défaut, qui est gzip.
GZIP
BZ2
BROTLI	Doit être spécifié lors du chargement/déchargement de fichiers compressés Brotli.
ZSTD	Zstandard v0.8 (et supérieur) est pris en charge.
DEFLATE	Fichiers compressés Deflate (avec en-tête zlib, RFC1950).
RAW_DEFLATE	Fichiers bruts compressés Deflate (sans en-tête, RFC1951).
NONE	Lors du chargement des données, indique que les fichiers n’ont pas été compressés. Lors du déchargement des données, spécifie que les fichiers déchargés ne sont pas compressés.

Par défaut:

AUTO

IGNORE_UTF8_ERRORS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie si les erreurs d’encodage UTF-8 produisent des conditions d’erreur. Il s’agit d’une syntaxe alternative pour REPLACE_INVALID_CHARACTERS.

Valeurs:

Si ce paramètre est réglé sur TRUE, toute séquence UTF-8 non valide est remplacée discrètement par le caractère Unicode U+FFFD (c.-à-d. un « caractère de remplacement »).

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

PRESERVE_SPACE = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie si l’analyseur XML préserve les espaces d’en-tête et de fin dans le contenu des éléments.

Par défaut:

FALSE

STRIP_OUTER_ELEMENT = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie si l’analyseur XML supprime l’élément externe XML, exposant les éléments de 2e niveau comme des documents séparés.

Par défaut:

FALSE

DISABLE_SNOWFLAKE_DATA = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie si l’analyseur XML désactive la reconnaissance des balises de données semi-structurées Snowflake.

Par défaut:

FALSE

DISABLE_AUTO_CONVERT = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie si l’analyseur XML désactive la conversion automatique des valeurs numériques et booléennes du texte en représentation native.

Par défaut:

FALSE

REPLACE_INVALID_CHARACTERS = TRUE | FALSE

Utilisation:

Chargement de données et table externe

Définition:

Booléen qui spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�). Cette option permet de remplacer un caractère par un autre.

Valeurs:

S’il est défini sur TRUE, Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

Si FALSE est défini, l’opération de chargement génère une erreur lorsqu’un codage de caractères UTF-8 non valide est détecté.

Par défaut:

FALSE

SKIP_BYTE_ORDER_MARK = TRUE | FALSE

Utilisation:

Chargement des données uniquement

Définition:

Booléen qui spécifie s’il faut sauter n’importe quel BOM (marque d’ordre d’octet) présent dans un fichier d’entrée. Une marque BOM est un code de caractère placé au début d’un fichier de données qui définit l’ordre des octets et la forme de l’encodage.

S’il est réglé sur FALSE, Snowflake reconnaît n’importe quel BOM dans les fichiers de données, ce qui pourrait entraîner une erreur BOM ou une fusion dans la première colonne du tableau.

Par défaut:

TRUE

Zones de préparation internes¶

Créez une zone de préparation interne avec le type de format de fichier par défaut (CSV) :

• Toutes les options de format de fichier par défaut CSV correspondantes sont utilisées.

• Toutes les options de copie par défaut sont utilisées, à l’exception de ON_ERROR. Si une commande COPY INTO <table> qui fait référence à cette zone de préparation rencontre une erreur de données sur l’un des enregistrements, elle ignore le fichier.

CREATE STAGE my_int_stage
  COPY_OPTIONS = (ON_ERROR='skip_file');

Similaire à l’exemple précédent, mais spécifiez le chiffrement côté serveur pour la zone de préparation :

CREATE STAGE my_int_stage
  ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE')
  COPY_OPTIONS = (ON_ERROR='skip_file');

Créez une zone de préparation interne temporaire avec toutes les mêmes propriétés que dans l’exemple précédent, à l’exception de l’option de copie permettant d’ignorer les fichiers en cas d’erreur :

CREATE TEMPORARY STAGE my_temp_int_stage;

Créez une zone de préparation interne temporaire qui fait référence à un format de fichier nommé my_csv_format (créé à l’aide de la commande CREATE FILE FORMAT) :

CREATE TEMPORARY STAGE my_int_stage
  FILE_FORMAT = my_csv_format;

Lorsque vous faites référence à la zone de préparation dans une instruction COPY INTO <table> , les options de format de fichier sont automatiquement définies.

Créez une zone de préparation interne qui comprend une table de répertoire. La zone de préparation fait référence à un format de fichier nommé myformat :

CREATE STAGE mystage
  DIRECTORY = (ENABLE = TRUE)
  FILE_FORMAT = myformat;

Zones de préparation externes¶

Amazon S3

Créez une zone de préparation externe en utilisant un compartiment S3 privé/protégé nommé load avec un chemin de dossier nommé files. Un accès sécurisé au compartiment S3 est fourni via l’intégration de stockage myint :

CREATE STAGE my_ext_stage
  URL='s3://load/files/'
  STORAGE_INTEGRATION = myint;

Copy

Créez une zone de préparation externe en utilisant un compartiment S3 privé/protégé nommé load avec un chemin de dossier nommé files. Les autorisations d’accès Snowflake pour le compartiment S3 sont associées à un utilisateur IAM ; par conséquent, des identifiants IAM sont requis :

CREATE STAGE my_ext_stage1
  URL='s3://load/files/'
  CREDENTIALS=(AWS_KEY_ID='1a2b3c' AWS_SECRET_KEY='4x5y6z');

Note that the AWS_KEY_ID and AWS_SECRET_KEY values used in this example are for illustration purposes only.

Copy

Créez une zone de préparation externe en utilisant un compartiment S3 nommé load avec un chemin de dossier nommé encrypted_files et un chiffrement côté client (type de chiffrement par défaut) avec la clé maître pour déchiffrer/chiffrer les fichiers stockés dans le compartiment :

CREATE STAGE my_ext_stage2
  URL='s3://load/encrypted_files/'
  CREDENTIALS=(AWS_KEY_ID='1a2b3c' AWS_SECRET_KEY='4x5y6z')
  ENCRYPTION=(MASTER_KEY = 'eSx...');

Copy

Créez une zone de préparation externe en utilisant un compartiment S3 nommé load avec un chemin de dossier nommé encrypted_files et un chiffrement AWS_SSE_KMS côté serveur avec l’ID pour que la clé maître déchiffre/chiffre les fichiers stockés dans le compartiment :

CREATE STAGE my_ext_stage3
  URL='s3://load/encrypted_files/'
  CREDENTIALS=(AWS_KEY_ID='1a2b3c' AWS_SECRET_KEY='4x5y6z')
  ENCRYPTION=(TYPE='AWS_SSE_KMS' KMS_KEY_ID = 'aws/key');

Copy

Même exemple que l’exemple précédent, sauf que les autorisations d’accès Snowflake sur le compartiment S3 sont associées à un rôle IAM au lieu d’un utilisateur IAM. Notez que les informations d’identification sont traitées séparément des autres paramètres de la zone de préparation tels que ENCRYPTION. La prise en charge de ces autres paramètres est identique quel que soit l’identifiant de connexion utilisé pour accéder à votre compartiment S3 externe :

CREATE STAGE my_ext_stage3
  URL='s3://load/encrypted_files/'
  CREDENTIALS=(AWS_ROLE='arn:aws:iam::001234567890:role/mysnowflakerole')
  ENCRYPTION=(TYPE='AWS_SSE_KMS' KMS_KEY_ID = 'aws/key');

Copy

Créez une zone de préparation avec une table de répertoire dans le schéma actif pour la session de l’utilisateur. L’URL de stockage Cloud inclut le chemin files. La zone de préparation fait référence à une intégration de stockage nommée my_storage_int :

CREATE STAGE mystage
  URL='s3://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (
    ENABLE = true
    AUTO_REFRESH = true
  );

Copy

Google Cloud Storage

Créez une zone de préparation externe en utilisant un compartiment GCS privé/protégé nommé load avec un chemin de dossier nommé files. L’accès sécurisé au compartiment GCS est fourni via l’intégration de stockage myint :

CREATE STAGE my_ext_stage
  URL='gcs://load/files/'
  STORAGE_INTEGRATION = myint;

Copy

Créez une zone de préparation nommée mystage avec une table de répertoire dans le schéma actif pour la session de l’utilisateur. L’URL de stockage Cloud inclut le chemin files. La zone de préparation fait référence à une intégration de stockage nommée my_storage_int :

CREATE STAGE mystage
  URL='gcs://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (
    ENABLE = true
    AUTO_REFRESH = true
    NOTIFICATION_INTEGRATION = 'MY_NOTIFICATION_INT'
  );

Copy

Microsoft Azure

Créez une zone de préparation externe en utilisant un conteneur Azure privé/protégé nommé load avec un chemin de dossier nommé files. L’accès sécurisé au conteneur est fourni via l’intégration de stockage myint :

CREATE STAGE my_ext_stage
  URL='azure://myaccount.blob.core.windows.net/load/files/'
  STORAGE_INTEGRATION = myint;

Copy

Créez une zone de préparation externe en utilisant un compte de stockage Azure nommé myaccount et un conteneur nommé mycontainer avec un chemin de dossier nommé files et le chiffrement côté client activé. La zone de préparation fait référence à un format de fichier nommé my_csv_format :

CREATE STAGE mystage
  URL='azure://myaccount.blob.core.windows.net/mycontainer/files/'
  CREDENTIALS=(AZURE_SAS_TOKEN='?sv=2016-05-31&ss=b&srt=sco&sp=rwdl&se=2018-06-27T10:05:50Z&st=2017-06-27T02:05:50Z&spr=https,http&sig=bgqQwoXwxzuD2GJfagRg7VOS8hzNr3QLT7rhS8OFRLQ%3D')
  ENCRYPTION=(TYPE='AZURE_CSE' MASTER_KEY = 'kPx...')
  FILE_FORMAT = my_csv_format;

Copy

(Les valeurs AZURE_SAS_TOKEN et MASTER_KEY utilisées dans cet exemple ne sont pas des valeurs réelles ; elles sont fournies à titre indicatif seulement.)

Créez une zone de préparation avec une table de répertoire dans le schéma actif pour la session de l’utilisateur. L’URL de stockage Cloud inclut le chemin files. La zone de préparation fait référence à une intégration de stockage nommée my_storage_int :

CREATE STAGE mystage
  URL='azure://myaccount.blob.core.windows.net/load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (
    ENABLE = true
    AUTO_REFRESH = true
    NOTIFICATION_INTEGRATION = 'MY_NOTIFICATION_INT'
  );

Copy