Paramètres¶

Hiérarchie des paramètres et types¶

Cette section décrit les différents types de paramètres (Compte, Session et Objet) et les niveaux auxquels chaque type peut être défini.

Le diagramme suivant illustre la relation hiérarchique entre les différents types de paramètres et la manière dont les paramètres individuels peuvent être remplacés à chaque niveau :

Affichage des paramètres et de leurs valeurs¶

Snowflake fournit la commande SHOW PARAMETERS, qui affiche une liste des paramètres, ainsi que les valeurs actuelles et par défaut de chaque paramètre. La commande peut être appelée avec différentes options pour déterminer le type de paramètre affiché.

ABORT_DETACHED_QUERY¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie l’action que Snowflake effectue pour les requêtes en cours si la connectivité est perdue en raison d’une interruption abrupte d’une session (p. ex. panne de réseau, arrêt du navigateur, interruption de service).

Valeurs:

TRUE : les requêtes en cours sont interrompues 5 minutes après la perte de connexion.

FALSE : les requêtes en cours sont terminées.

Par défaut:

FALSE

ALLOW_CLIENT_MFA_CACHING¶

Type:

Compte — Peut uniquement être défini pour Compte

Type de données:

Booléen

Description:

Spécifie si un jeton MFA peut être enregistré dans le keystore du système d’exploitation côté client pour promouvoir une connectivité continue et sécurisée sans que les utilisateurs aient besoin de répondre à une invitation MFA au début de chaque tentative de connexion à Snowflake. Pour plus de détails et la liste des clients fournis par Snowflake et pris en charge, voir Utilisation de la mise en cache des jetons MFA pour réduire le nombre d’invites lors de l’authentification — Facultatif.

Valeurs:

TRUE : stocke un jeton MFA dans le keystore du système d’exploitation côté client pour permettre à l’application cliente d’utiliser le jeton MFA chaque fois qu’une nouvelle connexion est établie. Bien que cela soit vrai, les utilisateurs ne sont pas invités à répondre à des invites MFA supplémentaires.

FALSE : ne stocke pas un jeton MFA. Les utilisateurs doivent répondre à une invite MFA chaque fois que l’application cliente établit une nouvelle connexion avec Snowflake.

Par défaut:

FALSE

ALLOW_ID_TOKEN¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie si un jeton de connexion peut être enregistré dans le magasin de clés du système d’exploitation côté client pour promouvoir une connectivité continue et sécurisée sans que les utilisateurs n’aient besoin d’entrer des informations de connexion au début de chaque tentative de connexion à Snowflake. Pour plus de détails et la liste des clients fournis par Snowflake et pris en charge, voir Utilisation de la mise en cache de connexion pour réduire le nombre d’invites pour l’authentification — Facultatif.

Valeurs:

TRUE : stocke un jeton de connexion dans le magasin de clés du système d’exploitation côté client pour permettre à l’application cliente d’exécuter SSO sur navigateur sans inviter les utilisateurs à s’authentifier chaque fois qu’une nouvelle connexion est établie.

FALSE : ne stocke pas de jeton de connexion. Les utilisateurs sont invités à s’authentifier chaque fois que l’application cliente établit une nouvelle connexion avec Snowflake. SSO à Snowflake est toujours possible si ce paramètre est défini sur false.

Par défaut:

FALSE

AUTOCOMMIT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique si la fonction de validation automatique est activée pour la session. La validation automatique détermine si une instruction DML, lorsqu’elle est exécutée sans transaction active, est automatiquement validée une fois l’instruction terminée avec succès. Pour plus d’informations, voir Transactions.

Valeurs:

TRUE : la validation automatique est activée.

FALSE : la validation automatique est désactivée, ce qui signifie que les instructions DML doivent être explicitement validées ou annulées.

Par défaut:

TRUE

AUTOCOMMIT_API_SUPPORTED (affichage seul)¶

Type:

N/A

Type de données:

Booléen

Description:

Réservé à l’usage interne de Snowflake. Paramètre d’affichage seul qui indique si la prise en charge de l’API pour la validation automatique est activée pour votre compte. Si la valeur est TRUE, vous pouvez activer ou désactiver la validation automatique via les APIs pour les pilotes/connecteurs suivants :

• Pilote JDBC

• Pilote ODBC

• Connecteur Snowflake pour Python

BINARY_INPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Format des valeurs VARCHAR passées en entrée des fonctions de conversion VARCHAR vers BINARY. Pour plus d’informations, voir Entrée et sortie binaires.

Valeurs:

HEX , BASE64 ou UTF8 / UTF-8

Par défaut:

HEX

BINARY_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Le format des valeurs VARCHAR renvoyées en sortie par les fonctions de conversion BINARY vers VARCHAR. Pour plus d’informations, voir Entrée et sortie binaires.

Valeurs:

HEX ou BASE64

Par défaut:

HEX

CATALOG¶

Type:

Objet (pour les bases de données, schémas et tables Apache Iceberg™) — Peut être défini pour Compte » Base de données » Schéma » Table Iceberg

Type de données:

Chaîne

Description:

Spécifie le catalogue des tables Apache Iceberg™. Pour plus d’informations, voir la documentation de tables Iceberg.

Valeurs:

SNOWFLAKE ou tout identificateur d’intégration de catalogue valide.

Par défaut:

Aucun

CLIENT_ENABLE_LOG_INFO_STATEMENT_PARAMETERS¶

Type:

Session — Ne peut être défini que pour Session

Type de données:

Booléen

Clients:

JDBC

Description:

Permet aux utilisateurs de consigner les valeurs de données liées à PreparedStatements.

Pour voir les valeurs, vous devez non seulement définir ce paramètre au niveau de la session sur TRUE, mais également définir le paramètre de connexion nommé TRACING sur INFO ou ALL.

• Définissez TRACING sur ALL pour afficher toutes les informations de débogage et toutes les informations de liaison.

• Définissez TRACING sur INFO pour afficher les valeurs des paramètres de liaison et moins d’informations annexes de débogage.

Prudence

Si vous liez des informations confidentielles, telles que des diagnostics médicaux ou des mots de passe, ces informations sont enregistrées. Snowflake recommande de s’assurer que le fichier journal est sécurisé ou d’utiliser uniquement des données de test lorsque vous définissez ce paramètre sur TRUE.

Valeurs:

TRUE ou FALSE.

Par défaut:

FALSE

CLIENT_ENCRYPTION_KEY_SIZE¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Entier

Clients:

N’importe quel

Description:

Indique la taille de la clé de chiffrement AES, en bits, utilisée par Snowflake pour chiffrer/déchiffrer les fichiers stockés sur des zones de préparation internes (pour charger/décharger des données), lorsque vous utilisez le type de chiffrement SNOWFLAKE_FULL.

Valeurs:

128 ou 256

Par défaut:

128

CLIENT_MEMORY_LIMIT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Clients:

JDBC, ODBC

Description:

Paramètre qui spécifie la quantité maximale de mémoire que le pilote JDBC ou ODBC doit utiliser pour le jeu de résultats des requêtes (en MB).

Pour le pilote JDBC :

• Pour simplifier la gestion de mémoire JVM, le paramètre définit une limite globale d’utilisation de la mémoire maximale pour toutes les requêtes.

• CLIENT_RESULT_CHUNK_SIZE spécifie la taille maximale de chaque ensemble (ou morceau) de résultats de requête à télécharger (en MB). Le pilote pourrait avoir besoin de mémoire supplémentaire pour traiter un morceau ; si tel est le cas, il ajustera l’utilisation de la mémoire au moment de l’exécution pour traiter au moins un thread/une requête. Vérifiez que CLIENT_MEMORY_LIMIT est défini sur une valeur nettement supérieure à CLIENT_RESULT_CHUNK_SIZE pour vous assurer qu’une mémoire suffisante est disponible.

Pour le pilote ODBC :

• Ce paramètre est pris en charge à partir de la version 2.22.0.

• CLIENT_RESULT_CHUNK_SIZE n’est pas pris en charge.

Valeurs:

Tout nombre valide de mégaoctets.

Par défaut:

1536 (effectivement 1,5 GB)

La plupart des utilisateurs ne devraient pas avoir besoin de définir ce paramètre. Si ce paramètre n’est pas défini par l’utilisateur, le pilote démarre avec la valeur par défaut spécifiée ci-dessus.

En outre, le pilote JDBC gère activement sa mémoire de manière prudente pour éviter d’utiliser toute la mémoire disponible.

CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX¶

Type:

Session — Peut être défini pour Utilisateur » Session

Type de données:

Booléen

Clients:

JDBC, ODBC

Description:

Pour certaines fonctions ODBC et méthodes JDBC, ce paramètre peut modifier la portée de la recherche par défaut pour qu’elle s’applique uniquement à la base de données/au schéma actuel et non plus à l’ensemble des bases de données/schémas. La recherche plus étroite renvoie généralement moins de lignes et s’exécute plus rapidement.

Par exemple, la méthode JDBC getTables() accepte un nom de base de données et un nom de schéma comme arguments et renvoie les noms des tables de la base de données et du schéma. Si les arguments de base de données et de schéma sont null, la méthode recherche par défaut l’ensemble des bases de données et schémas dans le compte. Définir CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX sur TRUE restreint la recherche à la base de données et au schéma actuels spécifiés par le contexte de connexion.

En substance, la définition de ce paramètre sur TRUE crée la priorité suivante pour la base de données et le schéma :

1. Valeurs transmises comme arguments aux fonctions/méthodes.

2. Valeurs spécifiées dans le contexte de connexion (le cas échéant).

3. Par défaut (toutes les bases de données et tous les schémas).

Pour plus de détails, consultez les informations ci-dessous.

Ce paramètre s’applique aux éléments suivants :

• Méthodes de pilote JDBC (pour la classe DatabaseMetaData) :

  • getColumns

  • getCrossReference

  • getExportedKeys

  • getForeignKeys

  • getFunctions

  • getImportedKeys

  • getPrimaryKeys

  • getSchemas

  • getTables

• Fonctions du pilote ODBC :

  • SQLTables

  • SQLColumns

  • SQLPrimaryKeys

  • SQLForeignKeys

  • SQLGetFunctions

  • SQLProcedures

Valeurs:

TRUE: si les arguments de base de données et de schéma sont null, le pilote récupère uniquement les métadonnées pour la base de données et le schéma spécifiés par le contexte de connexion.

L’interaction est décrite plus en détail dans le tableau ci-dessous.

FALSE : si les arguments de base de données et de schéma sont null, le pilote récupère les métadonnées de l’ensemble des bases de données et schémas du compte.

Par défaut:

FALSE

Remarques complémentaires:

Le contexte de connexion fait simplement référence à la base de données et au schéma actuels de la session, qui peuvent être définis à l’aide de l’une des options suivantes :

1. Spécifiez l’espace de noms par défaut pour l’utilisateur qui se connecte à Snowflake (et lance la session). Ceci peut être défini pour l’utilisateur à l’aide de la commande CREATE USER ou ALTER USER, mais doit être défini avant que l’utilisateur ne se connecte.

2. Spécifiez la base de données et le schéma lors de la connexion à Snowflake via le pilote.

3. Émettez une commande USE DATABASE ou USE SCHEMA dans la session.

Si la base de données ou le schéma a été spécifié par plusieurs de ces options, l’option la plus récente s’applique.

Lorsque CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX est défini sur TRUE :

argument de base de données	argument de schéma	Base de données utilisée	Schéma utilisé
Non nul	Non nul	Argument	Argument
Non nul	Nul	Argument	Tous les schémas
Nul	Non nul	Contexte de connexion	Argument
Nul	Nul	Contexte de connexion	Contexte de la session

Si vous souhaitez rechercher uniquement la base de données du contexte de connexion, mais souhaitez rechercher tous les schémas de cette base de données, consultez CLIENT_METADATA_USE_SESSION_DATABASE.

CLIENT_METADATA_USE_SESSION_DATABASE¶

Type:

Session — Peut être défini pour Session

Type de données:

Booléen

Clients:

JDBC

Description:

Ce paramètre s’applique uniquement aux méthodes affectées par CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX.

Ce paramètre s’applique uniquement lorsque les deux conditions suivantes sont remplies :

• CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX est FALSE ou non défini.

• Aucune base de données ou schéma n’est transmis à la fonction ODBC ou à la méthode JDBC correspondante.

Pour certaines fonctions ODBC et méthodes JDBC, ce paramètre peut modifier la portée de la recherche par défaut pour qu’elle s’applique uniquement à la base de données actuelle et non plus à l’ensemble des bases de données. La recherche plus étroite renvoie généralement moins de lignes et s’exécute plus rapidement.

Pour plus de détails, consultez les informations ci-dessous.

Valeurs:

TRUE :

Le pilote recherche tous les schémas dans la base de données du contexte de connexion. (Pour plus d’informations sur le contexte de connexion, consultez la documentation concernant CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX.)

FALSE :

Le pilote recherche tous les schémas dans toutes les bases de données.

Par défaut:

FALSE

Remarques complémentaires:

Lorsque la base de données est null, le schéma est null et CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX est FALSE :

CLIENT_METADATA_USE_SESSION_DATABASE	Comportement
FALSE	Tous les schémas de toutes les bases de données sont recherchés.
TRUE	Tous les schémas de la base de données actuelle sont recherchés.

CLIENT_PREFETCH_THREADS¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Clients:

JDBC, ODBC, Python, .NET

Description:

Paramètre qui spécifie le nombre de threads utilisés par le client pour pré-extraire des ensembles de résultats volumineux. Le pilote tentera de respecter la valeur du paramètre, mais définira des valeurs minimum et maximum (en fonction des ressources de votre système) pour améliorer les performances.

Valeurs:

1 jusqu’à 10

Par défaut:

4

La plupart des utilisateurs ne devraient pas avoir besoin de définir ce paramètre. Si ce paramètre n’est pas défini par l’utilisateur, le pilote démarre avec la valeur par défaut spécifiée ci-dessus, mais gère également son nombre de threads de manière prudente pour éviter d’utiliser toute la mémoire disponible.

CLIENT_RESULT_CHUNK_SIZE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Clients:

JDBC, Node.js, SQL API

Description:

Paramètre spécifiant la taille maximale de chaque ensemble (ou morceau) de résultats de requête à télécharger (en MB). Le pilote JDBC télécharge les résultats de la requête en morceaux.

Voir aussi CLIENT_MEMORY_LIMIT.

Valeurs:

16 jusqu’à 160

Par défaut:

160

La plupart des utilisateurs ne devraient pas avoir besoin de définir ce paramètre. Si ce paramètre n’est pas défini par l’utilisateur, le pilote démarre avec la valeur par défaut spécifiée ci-dessus, mais gère également sa mémoire de manière prudente pour éviter d’utiliser toute la mémoire disponible.

CLIENT_RESULT_COLUMN_CASE_INSENSITIVE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Clients:

JDBC

Description:

Paramètre qui indique s’il faut faire correspondre le nom de colonne de façon insensible à la casse dans des méthodes ResultSet.get* dans JDBC.

Valeurs:

TRUE : correspond aux noms des colonnes de façon insensible à la casse.

FALSE : correspond aux noms des colonnes de façon sensible à la casse.

Par défaut:

FALSE

CLIENT_SESSION_KEEP_ALIVE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Clients:

JDBC, ODBC, Python, Node.js

Description:

Paramètre qui indique s’il faut forcer un utilisateur à se reconnecter après une période d’inactivité dans une session.

Valeurs:

TRUE : Snowflake garde la session active indéfiniment, tant que la connexion est active même s’il n’y a aucune activité de l’utilisateur.

FALSE : l’utilisateur doit se reconnecter après quatre heures d’inactivité.

Par défaut:

FALSE

CLIENT_SESSION_KEEP_ALIVE_HEARTBEAT_FREQUENCY¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Clients:

SnowSQL, JDBC, Python, Node.js

Description:

Nombre de secondes entre les tentatives du client pour mettre à jour le jeton pour la session.

Valeurs:

900 jusqu’à 3600

Par défaut:

3600

CLIENT_TIMESTAMP_TYPE_MAPPING¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Clients:

N’importe quel

Description:

Spécifie la variation TIMESTAMP_* à utiliser lors de la liaison de variables d’horodatage pour les applications JDBC ou ODBC qui utilisent l’API de liaison pour charger les données.

Valeurs:

TIMESTAMP_LTZ ou TIMESTAMP_NTZ

Par défaut:

TIMESTAMP_LTZ

CORTEX_ENABLED_CROSS_REGION¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Chaîne

Description:

Spécifie les régions dans lesquelles une demande d’inférence peut être traitée au cas où la demande ne peut pas être traitée dans la région où la demande est initialement placée. Spécifier DISABLED désactive l’inférence interrégionale. Pour des exemples et des détails, voir Inférence interrégionale.

Valeurs:

Ce paramètre peut être défini sur l’une des valeurs suivantes :

• DISABLED

• ANY_REGION

• Liste séparée par des virgules comprenant une ou plusieurs des valeurs suivantes :

  • AWS_APJ

  • AWS_EU

  • AWS_US

Explication de chaque valeur de paramètre¶

Valeur	Comportement
DISABLED	Les demandes d’inférence ne seront traitées que dans la région où la demande est placée.
ANY_REGION	Les demandes d’inférence peuvent être acheminées vers n’importe quelle région prenant en charge l’inférence interrégionale (répertoriée dans cette table) et disposant d’une disponibilité, y compris la région où la demande est placée.
AWS_APJ	Les demandes d’inférence seront traitées de l’une des manières suivantes : La région où la demande est placée. AWS ap-northeast-1
AWS_EU	Les demandes d’inférence seront traitées de l’une des manières suivantes : La région où la demande est placée. AWS eu-central-1
AWS_US	Les demandes d’inférence seront traitées de l’une des manières suivantes : La région où la demande est placée. L’une des régions cloud AWS suivantes situées physiquement aux États-Unis : AWS us-west-2 AWS us-east-1

Par défaut:

DISABLED

CSV_TIMESTAMP_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format des valeurs TIMESTAMP dans les fichiers CSV téléchargés depuis Snowsight.

Si ce paramètre n’est pas défini, TIMESTAMP_LTZ_OUTPUT_FORMAT sera utilisé pour les valeurs TIMESTAMP_LTZ, TIMESTAMP_TZ_OUTPUT_FORMAT sera utilisé pour les valeurs TIMESTAMP_TZ et TIMESTAMP_NTZ_OUTPUT_FORMAT pour les valeurs TIMESTAMP_NTZ.

Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure ou Télécharger les résultats de votre requête.

Valeurs:

Tout format d’horodatage valide et pris en charge.

Par défaut:

Aucune valeur.

DATA_METRIC_SCHEDULE¶

Type:

Objet (pour les tables)

Type de données:

Chaîne

Description:

Spécifie la planification d’exécution des fonctions de métrique des données associées à la table.

Valeurs:

La planification peut être basée sur un nombre défini de minutes, une expression cron ou un événement de DML sur la table qui n’implique pas de reclustering. Pour plus de détails, voir :

• Actions de la fonction de métrique des données (dataMetricFunctionAction).

• Planifiez l’exécution de vos DMFs.

Par défaut:

Aucune valeur.

DATA_RETENTION_TIME_IN_DAYS¶

Type:

Objet (pour bases de données, schémas et tables) — Peut être défini pour Compte » Base de données » Schéma » Table

Type de données:

Entier

Description:

Nombre de jours pendant lesquels Snowflake conserve les données historiques pour effectuer des actions Time Travel (SELECT, CLONE, UNDROP) sur l’objet. Une valeur de 0 désactive efficacement Time Travel pour la base de données, le schéma ou la table spécifiés. Pour plus d’informations, voir Compréhension et utilisation de la fonction Time Travel.

Valeurs:

0 ou 1 (pour l’édition Standard)

0 à 90 (pour l’édition Enterprise ou ultérieure)

Par défaut:

1

DATE_INPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’entrée pour le type de données DATE. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format de date valide et pris en charge ou AUTO

(AUTO spécifie que Snowflake tente de détecter automatiquement le format des dates stockées dans le système pendant la session)

Par défaut:

AUTO

DATE_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage pour le type de données DATE. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format de date valide et pris en charge

Par défaut:

YYYY-MM-DD

DEFAULT_DDL_COLLATION¶

Type:

Objet (pour bases de données, schémas et tables) — Peut être défini pour Compte » Base de données » Schéma » Table

Type de données:

Chaîne

Description:

Définit le classement par défaut utilisé pour les opérations DDL suivantes :

• CREATE TABLE

• ALTER TABLE … ADD COLUMN

La définition de ce paramètre oblige toutes les colonnes créées ultérieurement dans les objets affectés (table, schéma, base de données ou compte) à disposer du classement spécifié par défaut, sauf si le classement de la colonne est explicitement mentionné dans DDL.

Par exemple, si DEFAULT_DDL_COLLATION = 'en-ci', les deux instructions suivantes sont équivalentes :

create table test(c1 integer, c2 string, c3 string collate 'en-cs');

create table test(c1 integer, c2 string collate 'en-ci', c3 string collate 'en-cs');

Copy

Valeurs:

Toute spécification de classement valide et prise en charge.

Par défaut:

Chaîne vide

ENABLE_IDENTIFIER_FIRST_LOGIN¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Détermine le flux de connexion pour les utilisateurs. Lorsque cette option est activée, Snowflake demande aux utilisateurs leur nom d’utilisateur ou leur adresse e-mail avant de leur présenter des méthodes d’authentification. Pour plus de détails, voir Connexion avec identificateur d’abord.

Valeurs:

TRUE : Snowflake utilise un flux de connexion avec identificateur d’abord pour authentifier les utilisateurs.

FALSE : Snowflake présente toutes les options de connexion possibles, même si ces options ne s’appliquent pas à un utilisateur particulier.

Par défaut:

FALSE

ENABLE_INTERNAL_STAGES_PRIVATELINK¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Indique si la fonction SYSTEM$GET_PRIVATELINK_CONFIG renvoie la clé private-internal-stages dans le résultat de la requête. La valeur correspondante dans le résultat de la requête est utilisée pendant le processus de configuration pour la connectivité privée à des zones de préparation.

Valeurs:

TRUE : renvoie la clé et la valeur private-internal-stages dans le résultat de la requête.

FALSE : ne renvoie pas la clé et la valeur private-internal-stages dans le résultat de la requête.

Par défaut:

FALSE

ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_IMAGE_REPOSITORY¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie le choix pour le référentiel d’images de refuser d’utiliser Tri-Secret Secure et Periodic Rekeying.

Valeurs:

TRUE : annule Tri-Secret Secure et Periodic Rekeying pour le référentiel d’images.

FALSE : interdit la création d’un référentiel d’images pour les comptes Tri-Secret Secure et Periodic Rekeying. De même, interdit l’activation de Tri-Secret Secure et de Periodic Rekeying pour les comptes qui ont activé le référentiel d’images.

Par défaut:

FALSE

ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_SPCS_BLOCK_STORAGE¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie le choix du volume de stockage de blocs Snowpark Container Services de se retirer de Tri-Secret Secure et de Periodic Rekeying.

Valeurs:

TRUE : désactive Tri-Secret Secure et Periodic Rekeying pour les volumes de stockage de blocs Snowpark Container Services.

FALSE : interdit la création de volumes de stockage de blocs pour les comptes Tri-Secret Secure et Periodic Rekeying. De même, interdit l’activation de Tri-Secret Secure et de Periodic Rekeying pour les comptes qui ont activé les volumes de stockage de blocs.

Par défaut:

FALSE

ENABLE_UNHANDLED_EXCEPTIONS_REPORTING¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie si Snowflake peut capturer – dans une table d’événements – les messages du journal ou les données d’événement de trace pour les exceptions non gérées dans la procédure ou le code du gestionnaire des UDF. Pour plus d’informations, voir Capturer des messages provenant d’exceptions non gérées.

Valeurs:

TRUE : les données relatives aux exceptions non gérées sont capturées en tant que données d’enregistrement ou de trace si l’enregistrement et le traçage sont activés.

FALSE : les données relatives aux exceptions non gérées ne sont pas capturées.

Par défaut:

TRUE

ENABLE_UNLOAD_PHYSICAL_TYPE_OPTIMIZATION¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie s’il faut définir le schéma pour les fichiers Parquet déchargés en fonction des types de données de colonne logiques (c’est-à-dire les types dans la requête de déchargement SQL ou la table source) ou des valeurs de colonne déchargées (c’est-à-dire les plus petits types de données et la précision qui prend en charge les valeurs dans les colonnes de sortie de la table source ou de l’instruction de déchargement SQL).

Valeurs:

TRUE : le schéma des fichiers de données Parquet déchargés est déterminé par les valeurs des colonnes de la table source ou de la requête de déchargement SQL. Snowflake optimise les colonnes de la table en réglant la plus petite précision qui accepte toutes les valeurs. Le déchargeur suit ce schéma lors de l’écriture des valeurs dans les fichiers Parquet. Le type de données et la précision d’une colonne de sortie sont réglés sur le plus petit type de données et la précision qui prennent en charge ses valeurs dans l’instruction de déchargement SQL ou la table source. Acceptez ce paramètre pour de meilleures performances et des fichiers de données plus petits.

FALSE : le schéma est déterminé par les types de données des colonnes logiques. Définissez cette valeur pour un schéma de fichier de sortie cohérent.

Par défaut:

TRUE

ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR¶

Type:

Utilisateur — Peut être défini pour Compte » Utilisateur

Type de données:

Booléen

Description:

Contrôle si le texte de la requête est rédigé si une requête SQL échoue en raison d’une erreur de syntaxe ou d’analyse. Si FALSE, le contenu d’une requête qui a échoué est rédigé dans les vues, les pages et les fonctions qui fournissent un historique des requêtes.

Seuls les utilisateurs dont le rôle est doté du privilège AUDIT ou qui en héritent peuvent définir le paramètre ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR.

Lorsque vous utilisez la commande ALTER USER pour définir le paramètre sur TRUE pour un utilisateur particulier, modifiez l’utilisateur qui doit voir le texte de la requête, et non l’utilisateur qui a exécuté la requête (s’il s’agit d’utilisateurs différents).

Valeurs:

TRUE : désactive la rédaction du texte de la requête pour les requêtes qui échouent en raison d’une erreur de syntaxe ou d’analyse.

FALSE : rédige le contenu d’une requête à partir de vues, de pages et de fonctions qui fournissent un historique des requêtes lorsqu’une requête échoue en raison d’une erreur de syntaxe ou d’analyse.

Par défaut:

FALSE

ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie si une politique réseau qui utilise des règles de réseau peut restreindre l’accès aux zones de préparation internes AWS.

Ce paramètre n’a aucun effet sur les politiques réseau qui n’utilisent pas de règles de réseau.

Ce paramètre au niveau du compte affecte à la fois les politiques réseau au niveau du compte et au niveau de l’utilisateur.

Pour plus de détails sur l’utilisation des politiques réseau et des règles de réseau pour restreindre l’accès à des zones de préparation internes AWS, y compris sur l’utilisation de ce paramètre, consultez Protection des zones de préparation internes sur AWS.

Valeurs:

TRUE : autorise les politiques réseau qui utilisent des règles de réseau pour restreindre l’accès aux zones de préparation internes AWS. La règle de réseau doit également utiliser les MODE et TYPE appropriés pour restreindre l’accès à la zone de préparation interne.

FALSE : les politiques réseau ne limitent jamais l’accès aux zones de préparation internes.

Par défaut:

FALSE

ERROR_ON_NONDETERMINISTIC_MERGE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique s’il faut retourner une erreur lorsque la commande MERGE est utilisée pour mettre à jour ou supprimer une ligne cible qui joint plusieurs lignes sources et que le système ne peut pas déterminer l’action à effectuer sur la ligne cible.

Valeurs:

TRUE : une erreur est retournée qui inclut les valeurs d’une des lignes cibles qui a causé l’erreur.

FALSE : aucune erreur n’est renvoyée et la fusion se termine avec succès, mais les résultats de la fusion ne sont pas déterministes.

Par défaut:

TRUE

ERROR_ON_NONDETERMINISTIC_UPDATE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique s’il faut retourner une erreur lorsque la commande UPDATE est utilisée pour mettre à jour une ligne cible qui joint plusieurs lignes sources et que le système ne peut pas déterminer l’action à effectuer sur la ligne cible.

Valeurs:

TRUE : une erreur est retournée qui inclut les valeurs d’une des lignes cibles qui a causé l’erreur.

FALSE : aucune erreur n’est retournée et la mise à jour est terminée, mais les résultats de la mise à jour ne sont pas déterministes.

Par défaut:

FALSE

EVENT_TABLE¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Chaîne

Description:

Spécifie le nom de la table d’événements pour l’enregistrement des messages provenant des procédures stockées et des UDFs dans ce compte.

Valeurs:

Toute table d’événements existante créée par l’exécution de la commande CREATE EVENT TABLE.

Par défaut:

Aucun

EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Détermine si les rôles ACCOUNTADMIN, ORGADMIN et SECURITYADMIN peuvent être utilisés comme rôle principal lors de la création d’une session Snowflake basée sur le jeton d’accès du serveur d’autorisation External OAuth.

Valeurs:

TRUE : ajoute les rôles ACCOUNTADMIN, ORGADMIN et SECURITYADMINà la propriété EXTERNAL_OAUTH_BLOCKED_ROLES_LIST de l’intégration de sécurité External OAuth, ce qui signifie que ces rôles ne peuvent pas être utilisés comme rôle principal lors de la création d’une session Snowflake utilisant l’authentification External OAuth.

FALSE : retire ACCOUNTADMIN, ORGADMIN et SECURITYADMIN de la liste des rôles bloqués définis par la propriété EXTERNAL_OAUTH_BLOCKED_ROLES_LIST de l’intégration de sécurité External OAuth.

Par défaut:

TRUE

EXTERNAL_VOLUME¶

Objet (pour les bases de données, schémas et tables Apache Iceberg™) — Peut être défini pour Compte » Base de données » Schéma » Table Iceberg

Type de données:

Chaîne

Description:

Spécifie le volume externe des tables Apache Iceberg™. Pour plus d’informations, voir la documentation de tables Iceberg.

Valeurs:

Tout identificateur de volume externe valide.

Par défaut:

Aucun

GEOGRAPHY_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Format d’affichage pour les valeurs GEOGRAPHY.

Pour EWKT et EWKB, le SRID est toujours 4326 dans la sortie. Consultez la note sur le traitement d’EWKT et d’EWKB.

Valeurs:

GeoJSON, WKT, WKB, EWKT, ou EWKB

Par défaut:

GeoJSON

GEOMETRY_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Format d’affichage pour les valeurs GEOMETRY.

Valeurs:

GeoJSON, WKT, WKB, EWKT, ou EWKB

Par défaut:

GeoJSON

HYBRID_TABLE_LOCK_TIMEOUT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Description:

Nombre de secondes à attendre lors de la tentative d’acquisition de verrous au niveau des lignes sur une table hybride, avant l’expiration du délai et l’abandon de l’instruction.

Valeurs:

0 à un nombre entier quelconque (sans limite). Une valeur de 0 désactive le verrouillage d’attente (c’est-à-dire que l’instruction doit acquérir le verrouillage immédiatement ou s’arrêter). Cette valeur spécifie la durée pendant laquelle l’instruction attendra tous les verrous au niveau des lignes qu’elle doit acquérir après chaque tentative d’exécution (1 heure par défaut). Si l’instruction ne peut pas acquérir tous les verrous, elle peut être réessayée et la même période d’attente est appliquée.

Par défaut:

3600 (1 heure)

Voir aussi LOCK_TIMEOUT.

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Nombre.

Description:

Définit la limite de taille maximale estimée lors de la réplication initiale d’une base de données principale vers une base de données secondaire (dans TB). Définissez ce paramètre sur tout compte qui stocke une base de données secondaire. Cette limite de taille permet d’empêcher les comptes d’engager accidentellement des frais de réplication de base de données importants.

Pour supprimer la taille limite, définissez la valeur sur 0.0.

Notez qu’aucune limite de taille par défaut n’est actuellement appliquée aux actualisations suivantes d’une base de données secondaire.

Valeurs:

0.0 et au-dessus avec une échelle d’au moins 1 (par exemple 20.5, 32.25, 33.333, etc.).

Par défaut:

10.0

JDBC_ENABLE_PUT_GET¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique s’il faut autoriser les commandes PUT et GET à accéder aux systèmes de fichiers locaux.

Valeurs:

TRUE: JDBC active les commandes PUT et GET.

FALSE: JDBC désactive les commandes PUT et GET.

Par défaut:

TRUE

JDBC_TREAT_DECIMAL_AS_INT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique comment JDBC traite les colonnes ayant une échelle de zéro (0).

Valeurs:

TRUE : JDBC traite une colonne dont l’échelle est nulle comme BIGINT.

FALSE : JDBC traite une colonne dont l’échelle est nulle comme DECIMAL.

Par défaut:

TRUE

JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie comment JDBC traite les valeurs TIMESTAMP_NTZ.

Par défaut, lorsque le pilote JDBC récupère une valeur de type TIMESTAMP_NTZ à partir de Snowflake, il convertit la valeur en durée chronométrée en utilisant le fuseau horaire JVM du client.

Les utilisateurs qui souhaitent conserver le fuseau horaire UTC pour la conversion peuvent régler ce paramètre sur TRUE.

Ce paramètre s’applique uniquement au pilote JDBC.

Valeurs:

TRUE : le pilote utilise UTC pour obtenir la valeur de TIMESTAMP_NTZ en durée chronométrée.

FALSE : le pilote utilise le fuseau horaire actuel JVM du client pour obtenir la valeur de TIMESTAMP_NTZ en durée chronométrée.

Par défaut:

FALSE

JDBC_USE_SESSION_TIMEZONE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Précise si le pilote JDBC utilise le fuseau horaire du JVM ou le fuseau horaire de la session (spécifié par le paramètre TIMEZONE) pour les méthodes getDate(), getTime() et getTimestamp() de la classe ResultSet.

Valeurs:

TRUE : le pilote JDBC utilise le fuseau horaire de la session.

FALSE : le pilote JDBC utilise le fuseau horaire du JVM.

Par défaut:

TRUE

JSON_INDENT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Description:

Indique le nombre d’espaces vides pour indenter chaque nouvel élément dans une sortie JSON de la session. Spécifie également s’il faut insérer des caractères de nouvelle ligne après chaque élément.

Valeurs:

0 jusqu’à 16

(une valeur de 0 retourne une sortie compacte en supprimant tous les espaces vides et les caractères de nouvelle ligne de la sortie)

Par défaut:

2

JS_TREAT_INTEGER_AS_BIGINT¶

Type:

Session — Peut être défini pour Session

Type de données:

Booléen

Description:

Indique comment le pilote Snowflake Node.js traite les colonnes numériques ayant une échelle de zéro (0), par exemple INTEGER ou NUMBER(p, 0).

Valeurs:

TRUE : JavaScript traite une colonne dont l’échelle est nulle comme Bigint.

FALSE : JavaScript traite une colonne dont l’échelle est nulle comme Number.

Par défaut:

FALSE

LOCK_TIMEOUT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier

Description:

Nombre de secondes à attendre avant d’essayer de verrouiller une ressource, avant de faire expirer et d’annuler l’instruction.

Valeurs:

0 à un nombre entier quelconque (sans limite). Une valeur de 0 désactive le verrouillage d’attente (l’instruction doit acquérir le verrouillage immédiatement ou s’arrêter). Si plusieurs ressources doivent être verrouillées par l’instruction, le délai d’attente s’applique séparément à chaque tentative de verrouillage.

Par défaut:

43200 (12 heures)

Voir aussi HYBRID_TABLE_LOCK_TIMEOUT.

LOG_LEVEL¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type:

Objet (pour les bases de données, les schémas, les procédures stockées et les UDFs) — Peut être défini pour le compte » Base de données » Schéma » Procédure et compte » Base de données » Schéma » Fonction

Type de données:

Chaîne (constante)

Description:

Spécifie le niveau de gravité des messages qui doivent être ingérés et mis à disposition dans la table des événements actifs. Les messages du niveau spécifié (et des niveaux plus sévères) sont ingérés. Pour plus d’informations sur les niveaux de journalisation, consultez Définition des niveaux de journalisation, des métriques et du traçage.

Valeurs:

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• OFF

Par défaut:

OFF

Remarques complémentaires:

Le tableau suivant énumère les niveaux de messages ingérés lorsque vous attribuez un niveau au paramètre LOG_LEVEL.

Réglage des paramètres de LOG_LEVEL	Niveaux de messages ingérés
TRACE	TRACE DEBUG INFO WARN ERROR FATAL
DEBUG	DEBUG INFO WARN ERROR FATAL
INFO	INFO WARN ERROR FATAL
WARN	WARN ERROR FATAL
ERROR	ERROR FATAL
FATAL	ERROR (Uniquement pour les procédures stockées Scala, les UDFs Java et les UDTFs Java. Pour plus d’informations, voir Présentation des niveaux de journalisation, de métriques et de traçage) FATAL

Si ce paramètre est défini à la fois dans la session et dans l’objet (ou schéma, base de données ou compte), la valeur la plus verbeuse est utilisée. Voir Comprendre comment Snowflake détermine le niveau en vigueur.

MAX_CONCURRENCY_LEVEL¶

Type:

Objet (pour entrepôts) — Peut être défini pour Compte » Entrepôt virtuel

Type de données:

Nombre

Description:

Spécifie le niveau de simultanéité des instructions SQL (requêtes et DML) exécutées par un entrepôt. Lorsque le niveau est atteint, l’opération exécutée varie selon que l’entrepôt virtuel est à un ou plusieurs clusters :

• Simple cluster ou multi-clusters (en mode Maximisé) : Les instructions sont mises en file d’attente jusqu’à ce que les ressources déjà allouées soient libérées ou que des ressources supplémentaires soient fournies, ce qui peut être réalisé en augmentant la taille de l’entrepôt.

• Multi-cluster (en mode Mise à l’échelle automatique) : Des clusters supplémentaires sont démarrés.

MAX_CONCURRENCY_LEVEL peut être utilisé conjointement avec le paramètre STATEMENT_QUEUED_TIMEOUT_IN_SECONDS pour s’assurer qu’un entrepôt n’est jamais en attente.

En général, cela limite le nombre d’instructions qui peuvent être exécutées simultanément par un cluster d’entrepôts, mais il y a des exceptions. Dans les cas suivants, le nombre réel d’instructions exécutées simultanément par un entrepôt peut être supérieur ou inférieur au niveau spécifié :

• Instructions plus petites et plus basiques : D’autres instructions peuvent s’exécuter simultanément parce que des petites instructions s’exécutent généralement sur un sous-ensemble de ressources de calcul disponibles dans un entrepôt. Cela signifie qu’elles ne comptent que pour une fraction du niveau de concurrence.

• Instructions plus grandes et plus complexes : Moins d’instructions peuvent être exécutées simultanément.

Par défaut:

8

MAX_DATA_EXTENSION_TIME_IN_DAYS¶

Type:

Objet (pour bases de données, schémas et tables) — Peut être défini pour Compte » Base de données » Schéma » Table

Type de données:

Entier

Description:

Nombre maximum de jours pendant lesquels Snowflake peut prolonger la période de conservation des données des tables pour éviter que les flux sur les tables ne deviennent obsolètes. Par défaut, si le paramètre DATA_RETENTION_TIME_IN_DAYS d’une table source est inférieur à 14 jours, et qu’un flux n’a pas été consommé, Snowflake prolonge temporairement cette période jusqu’au décalage du flux, jusqu’à un maximum de 14 jours, quelle que soit l”édition de Snowflake pour votre compte. Le paramètre MAX_DATA_EXTENSION_TIME_IN_DAYS vous permet de limiter cette période de prolongation automatique afin de contrôler les coûts de stockage pour la conservation des données ou pour des raisons de conformité.

Le paramètre peut être défini au niveau du compte, de la base de données, du schéma ou de la table. Notez que la définition du paramètre au niveau du compte ou du schéma n’affecte que les tables pour lesquelles le paramètre n’a pas encore été explicitement défini à un niveau inférieur (par exemple, au niveau de table par le propriétaire de la table). Une valeur de 0 désactive efficacement l’extension automatique pour la base de données, le schéma ou la table spécifiés. Pour plus d’informations sur les flux et l’obsolescence, voir Présentation des flux.

Valeurs:

0 à 90 (c’est-à-dire 90 jours) — une valeur de 0 désactive l’extension automatique de la période de conservation des données. Pour augmenter la valeur maximale des tables pour votre compte, contactez l’assistance Snowflake.

Par défaut:

14

METRIC_LEVEL¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type:

Objet (pour les bases de données, les schémas, les procédures stockées et les UDFs) — Peut être défini pour le compte » Base de données » Schéma » Procédure et compte » Base de données » Schéma » Fonction

Type de données:

Chaîne (constante)

Description:

Contrôle la manière dont les données de métriques sont ingérées dans la table des événements. Pour plus d’informations sur les niveaux des métriques, voir Définition des niveaux de journalisation, des métriques et du traçage.

Valeurs:

ALL : toutes les données de métriques seront enregistrées dans la table des événements.

NONE : aucune donnée de métriques ne sera enregistrée dans la table des événements.

Par défaut:

NONE

MULTI_STATEMENT_COUNT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Entier (constant)

Clients:

SQL API, JDBC, .NET, ODBC

Description:

Nombre d’instructions à exécuter lors de l’utilisation de la fonctionnalité multi-instructions.

Valeurs:

0 : nombre variable d’instructions.

1 : une instruction.

Plus que 1 : lorsque MULTI_STATEMENT_COUNT est défini comme paramètre de session, vous pouvez spécifier le nombre exact d’instructions à exécuter.

Les nombres négatifs ne sont pas autorisés.

Par défaut:

1

MIN_DATA_RETENTION_TIME_IN_DAYS¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Entier

Description:

Nombre de jours pendant lesquels Snowflake conserve les données historiques pour effectuer des actions de Time Travel (SELECT, CLONE, UNDROP) sur un objet. Si un nombre minimum de jours pour la conservation des données est défini sur un compte, la période de conservation des données pour un objet est déterminée par MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS).

Pour plus d’informations, voir Compréhension et utilisation de la fonction Time Travel.

Valeurs:

0 ou 1 (pour l’édition Standard)

0 à 90 (pour l’édition Enterprise ou ultérieure)

Par défaut:

0

NETWORK_POLICY¶

Type:

Compte — Ne peut être défini que pour le compte (peut être défini par les administrateurs de compte et les administrateurs de sécurité)

Type:

Objet (pour les utilisateurs) — Peut être défini pour Compte » Utilisateur

Type de données:

Chaîne

Description:

Spécifie la stratégie réseau à appliquer pour votre compte. Les stratégies réseau permettent de restreindre l’accès à votre compte en fonction de l’adresse IP des utilisateurs. Pour plus de détails, voir Contrôle du trafic réseau avec des politiques réseau.

Valeurs:

Toute stratégie réseau existante (créée à l’aide de CREATE NETWORK POLICY)

Par défaut:

Aucun

NOORDER_SEQUENCE_AS_DEFAULT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie si la propriété ORDER ou NOORDER est définie par défaut lorsque vous créez une nouvelle séquence ou ajoutez une nouvelle colonne de table.

Les propriétés ORDER et NOORDER déterminent si les valeurs sont générées pour la séquence ou la colonne auto-incrémentée dans l’ordre croissant ou décroissant.

Valeurs:

• TRUE : lorsque vous créez une nouvelle séquence ou que vous ajoutez une nouvelle colonne de table, la propriété NOORDER est définie par défaut.

  NOORDER précise que l’ordre croissant des valeurs n’est pas garanti.

  Par exemple, si une séquence comporte START 1 INCREMENT 2, les valeurs générées peuvent être 1, 3, 101, 5, 103, etc.

  NOORDER peut améliorer les performances lorsque plusieurs opérations INSERT doivent être effectuées simultanément (par exemple, lorsque plusieurs clients exécutent plusieurs instructions INSERT).

• FALSE : lorsque vous créez une nouvelle séquence ou que vous ajoutez une nouvelle colonne de table, la propriété ORDER est définie par défaut.

  ORDER spécifie que les valeurs générées pour une séquence ou une colonne auto-incrémentée sont dans l’ordre croissant sont en ordre croissant (ou, si l’intervalle est une valeur négative, en ordre décroissant).

  Par exemple, si une séquence ou une colonne auto-incrémentée comporte START 1 INCREMENT 2, les valeurs générées peuvent être 1, 3, 5, 7, 9, etc.

Si vous définissez ce paramètre, la valeur que vous définissez remplace la valeur du bundle de changements de comportement 2024_01.

Par défaut:

TRUE

ODBC_TREAT_DECIMAL_AS_INT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique comment ODBC traite les colonnes ayant une échelle de zéro (0).

Valeurs:

TRUE : ODBC traite une colonne dont l’échelle est nulle comme BIGINT.

FALSE : ODBC traite une colonne dont l’échelle est nulle comme DECIMAL.

Par défaut:

FALSE

OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Détermine si les rôles ACCOUNTADMIN, ORGADMIN et SECURITYADMIN peuvent être utilisés comme rôle principal lors de la création d’une session Snowflake basée sur le jeton d’accès du serveur d’autorisation de Snowflake.

Valeurs:

TRUE : ajoute les rôles ACCOUNTADMIN, ORGADMIN et SECURITYADMINà la propriété BLOCKED_ROLES_LIST de l’intégration de sécurité SnowflakeOAuth, ce qui signifie que ces rôles ne peuvent pas être utilisés comme rôle principal lors de la création d’une session Snowflake avec Snowflake OAuth.

FALSE : retire ACCOUNTADMIN, ORGADMIN et SECURITYADMIN de la liste des rôles bloqués définis par la propriété BLOCKED_ROLES_LIST de l’intégration de sécurité Snowflake OAuth.

Par défaut:

TRUE

PERIODIC_DATA_REKEYING¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Ce paramètre ne s’applique qu’à l’édition Enterprise (ou supérieure). Il active/désactive le rechiffrement des données de tables avec de nouvelles clés sur une base annuelle pour fournir des niveaux supplémentaires de protection des données.

Vous pouvez activer et désactiver la saisie à tout moment. L’activation/désactivation de la re-saisie n’entraîne pas d’écarts dans vos données chiffrées :

• Si la re-saisie est activée pendant un certain temps puis désactivée, toutes les données déjà étiquetées pour la nouvelle saisie sont re-saisies, mais aucune autre donnée n’est re-saisie jusqu’à ce que vous renouveliez l’opération.

• Si la re-saisie est réactivée, Snowflake re-saisit automatiquement toutes les données qui ont des clés et qui répondent aux critères (c.-à-d. que la clé date de plus d’un an).

Pour plus d’informations sur la nouvelle saisie des données chiffrées, voir Comprendre la gestion des clés de chiffrement dans Snowflake.

Valeurs:

TRUE : les données sont resaisies après un an à compter de la date du dernier chiffrement des données. La resaisie se fait en arrière-plan, de sorte qu’aucun temps d’arrêt ne soit observé et que les données/tables concernées soient toujours disponibles.

FALSE : les données ne sont pas resaisies.

Par défaut:

FALSE

PIPE_EXECUTION_PAUSED¶

Type:

Objet — Peut être défini pour Compte » Schéma » Canal

Type de données:

Booléen

Description:

Indique s’il faut interrompre ou non le fonctionnement d’un canal, principalement en vue du transfert de propriété du canal vers un autre rôle :

• Un administrateur de compte (utilisateur avec le rôle ACCOUNTADMIN) peut définir ce paramètre au niveau du compte, mettant en pause ou reprenant effectivement tous les canaux du compte.

• De même, un utilisateur avec le privilège MODIFY sur le schéma peut interrompre ou reprendre tous les canaux au niveau du schéma.

• Le propriétaire du canal peut définir ce paramètre pour un canal.

Notez que la définition du paramètre au niveau du compte ou du schéma n’affecte que les canaux pour lesquels le paramètre n’a pas encore été explicitement défini à un niveau inférieur (par exemple, au niveau du canal par le propriétaire du canal).

Ceci permet le cas d’utilisation pratique dans lequel un administrateur de compte peut mettre en pause tous les canaux au niveau du compte, alors qu’un propriétaire de canal peut toujours avoir un canal individuel en cours de fonctionnement.

Valeurs:

TRUE : interrompt le canal. Lorsque le paramètre est réglé sur cette valeur, la fonction SYSTEM$PIPE_STATUS affiche executionState en tant que PAUSED. Notez que le propriétaire du canal peut continuer à soumettre des fichiers dans un canal mis en pause ; cependant, les fichiers ne sont pas traités avant la reprise du canal.

FALSE : reprend le canal, mais seulement si la propriété du canal n’a pas été transférée alors qu’il était en pause. Lorsque le paramètre est réglé sur cette valeur, la fonction SYSTEM$PIPE_STATUS affiche executionState en tant que RUNNING.

Si la propriété du canal a été transférée à un autre rôle après la pause du canal, ce paramètre ne peut pas être utilisé pour reprendre le canal. Au lieu de cela, utilisez la fonction SYSTEM$PIPE_FORCE_RESUME pour explicitement forcer la reprise du canal.

Cela permet au nouveau propriétaire d’utiliser SYSTEM$PIPE_STATUS pour évaluer le statut du canal (par exemple, déterminer combien de fichiers sont en attente de chargement) avant de reprendre le canal.

Par défaut:

FALSE (les canaux fonctionnent par défaut)

PREVENT_UNLOAD_TO_INLINE_URL¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie s’il faut empêcher les opérations de déchargement de données ad hoc vers des emplacements de stockage Cloud externes (c’est-à-dire des instructions COPY INTO <emplacement> qui spécifient l” URL de stockage Cloud et les paramètres d’accès directement dans l’instruction). Pour un exemple, voir Déchargement des données d’une table directement dans des fichiers d’un emplacement externe.

Valeurs:

TRUE : les instructions COPY INTO <location> doivent référencer soit une zone de préparation interne (Snowflake) ou externe nommée soit une zone de préparation interne utilisateur ou table. Une zone de préparation externe nommée doit stocker l’URL de stockage Cloud et les paramètres d’accès dans sa définition.

FALSE : les opérations de déchargement de données ad hoc vers des emplacements de stockage Cloud externes sont autorisées.

Par défaut:

FALSE

PREVENT_UNLOAD_TO_INTERNAL_STAGES¶

Type:

Utilisateur — Peut être défini pour Compte » Utilisateur

Type de données:

Booléen

Description:

Indique s’il faut empêcher les opérations de déchargement de données vers des zones de préparation internes (Snowflake) à l’aide d’instructions COPY INTO <emplacement>.

Valeurs:

TRUE : le déchargement des données des tables Snowflake vers une zone de préparation interne, y compris les zones de préparation utilisateur, les zones de préparation de table ou les zones de préparation internes nommées est évité.

FALSE : le déchargement des données vers des zones de préparation internes est autorisé, mais se limite uniquement par les restrictions par défaut du type de zone de préparation :

• L’utilisateur actuel ne peut décharger des données que sur sa propre zone de préparation utilisateur.

• Les utilisateurs ne peuvent décharger des données sur des zones de préparation de table que lorsque leur rôle actif dispose du privilège OWNERSHIP sur la table.

• Les utilisateurs ne peuvent décharger des données sur des zones de préparation internes nommées que si leur rôle actif dispose du privilège WRITE sur la zone de préparation.

Par défaut:

FALSE

QUERY_TAG¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (jusqu’à 2 000 caractères)

Description:

Chaîne optionnelle qui peut être utilisée pour baliser les requêtes et autres instructions SQL exécutées dans une session. Les balises sont affichées dans la sortie des fonctions QUERY_HISTORY , QUERY_HISTORY_BY_*.

Par défaut:

Aucun

QUOTED_IDENTIFIERS_IGNORE_CASE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Objet — Peut être défini pour Compte » Base de données » Schéma » Table

Type de données:

Booléen

Description:

Spécifie si les lettres dans les identificateurs d’objet à double guillemet sont stockées et résolues comme des lettres majuscules. Par défaut, Snowflake préserve la casse des caractères alphabétiques lors du stockage et de la résolution des identificateurs entre guillemets doubles (voir Résolution de l’identificateur). Vous pouvez utiliser ce paramètre dans les situations où les applications tierces utilisent toujours des guillemets autour des identificateurs.

Note

Si vous modifiez ce paramètre par rapport à la valeur par défaut, vous risquez de ne pas pouvoir retrouver les objets qui ont été créés auparavant avec des identificateurs entre guillemets doubles et à casse mixte. Reportez-vous à Incidence de la modification du paramètre.

Lorsqu’il est défini sur une table, un schéma ou une base de données, ce paramètre affecte uniquement l’évaluation des noms de table dans les corps des vues et des fonctions définies par l’utilisateur (UDFs). Si votre compte utilise des identificateurs à double guillemet qui doivent être traités comme insensibles à la casse et que vous prévoyez de partager une vue ou une UDF avec un compte qui traite les identificateurs à guillemet double comme sensibles à la casse, vous pouvez définir cette option sur la vue ou l’UDF que vous prévoyez de partager. Cela permet à l’autre compte de résoudre correctement les noms de table dans la vue ou l’UDF.

Valeurs:

TRUE : les lettres des identificateurs entre guillemets doubles sont stockées et résolues comme des lettres majuscules.

FALSE : la casse des lettres dans les identificateurs entre guillemets est préservée. Snowflake résout et stocke les identificateurs dans la casse spécifiée.

Pour plus d’informations, consultez Résolution de l’identificateur.

Par défaut:

FALSE

Par exemple :

REPLACE_INVALID_CHARACTERS¶

Type:

Objet — Peut être défini pour Compte » Base de données » Schéma » Table Iceberg

Type de données:

Booléen

Description:

Spécifie s’il faut remplacer les caractères UTF-8 non valides par le caractère de remplacement Unicode (�) dans les résultats de requête des tables Iceberg qui utilisent un catalogue externe.

Valeurs:

TRUE : Snowflake remplace les caractères UTF-8 non valides par le caractère de remplacement Unicode.

FALSE : Snowflake laisse les caractères UTF-8 non valides inchangés. Snowflake renvoie un message d’erreur utilisateur s’il rencontre un caractère UTF-8 non valide.

Par défaut:

FALSE

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie s’il faut exiger un objet d’intégration de stockage comme informations d’identification Cloud lors de la création d’une zone de préparation externe nommée (à l’aide de CREATE STAGE) pour accéder à un emplacement de stockage dans un Cloud privé.

Valeurs:

TRUE : la création d’une zone de préparation externe pour accéder à un emplacement de stockage dans le Cloud privé nécessite de référencer un objet d’intégration de stockage en tant qu’identifiants de Cloud.

FALSE : la création d’une zone de préparation externe ne nécessite pas de référencer un objet d’intégration de stockage. Les utilisateurs peuvent à la place référencer des informations d’identification de fournisseur de Cloud explicites, telles que des clés secrètes ou des jetons d’accès, s’ils ont été configurés pour l’emplacement de stockage.

Par défaut:

FALSE

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Spécifie s’il faut utiliser une zone de préparation externe nommée faisant référence à un objet d’intégration de stockage en tant qu’informations d’identification Cloud lors du chargement ou du déchargement de données vers un emplacement de stockage Cloud privé.

Valeurs:

TRUE : le chargement ou le déchargement de données vers un emplacement de stockage dans le Cloud privé nécessite l’utilisation d’une zone de préparation externe nommée qui référence un objet d’intégration de stockage ; la spécification d’une zone de préparation externe nommée faisant référence à des informations d’identification de fournisseur de Cloud explicites, telles que des clés secrètes ou des jetons d’accès, génère une erreur utilisateur.

FALSE : les utilisateurs peuvent charger ou décharger des données vers un emplacement de stockage Cloud privé à l’aide d’une zone de préparation externe nommée qui fait référence aux informations d’identification du fournisseur de Cloud explicites.

Si PREVENT_UNLOAD_TO_INLINE_URL est FALSE, les utilisateurs peuvent spécifier les informations d’identification du fournisseur de Cloud explicites directement dans l’instruction COPY.

Par défaut:

FALSE

ROWS_PER_RESULTSET¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Nombre

Clients:

SQL API

Description:

Indique le nombre maximum de lignes retournées dans un jeu de résultats.

Valeurs:

0 à n’importe quel nombre (c.-à-d. aucune limite) — une valeur de 0 ne spécifie aucun maximum.

Par défaut:

0

S3_STAGE_VPCE_DNS_NAME¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le nom DNS d’un point de terminaison d’interface Amazon S3. Les demandes envoyées à la zone de préparation interne d’un compte via AWS PrivateLink pour Amazon S3 utilisent ce point de terminaison pour se connecter.

Pour plus d’informations, consultez Accès à des zones de préparation internes avec des points de terminaison d’interface dédiés.

Valeurs:

Nom DNS valide à l’échelle de la région d’un point de terminaison d’interface S3.

Le format standard commence par un astérisque (*) et se termine par vpce.amazonaws.com (par exemple *.vpce-sd98fs0d9f8g.s3.us-west-2.vpce.amazonaws.com). Pour plus de détails sur l’obtention de cette valeur, consultez Configuration d’AWS.

Les formats alternatifs incluent bucket.vpce-xxxxxxxx.s3.<région>.vpce.amazonaws.com et vpce-xxxxxxxx.s3.<région>.vpce.amazonaws.com.

Par défaut:

Chaîne vide

SAML_IDENTITY_PROVIDER¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

JSON

Description:

Active l’authentification fédérée. Ce paramètre obsolète permet l’authentification fédérée. Ce paramètre accepte un objet JSON, entre guillemets simples, avec les champs suivants :

{
  "certificate": "",
  "issuer": "",
  "ssoUrl": "",
  "type"  : "",
  "label" : ""
}

Copy

Où :

certificate

Spécifie le certificat (généré par l’IdP) qui vérifie la communication entre l’IdP et Snowflake.

issuer

Indique l’émetteur/EntityID de l’IdP.

En option.

Pour savoir comment obtenir cette valeur dans Okta et AD FS, consultez Migration d’une intégration de sécurité SAML2.

ssoUrl

Spécifie le point de terminaison de l’URL (fourni par l’IdP) où Snowflake envoie les requêtes SAML.

type

Spécifie le type d’IdP utilisé pour l’authentification fédérée ("OKTA" , "ADFS" , "Custom").

label

Spécifie le texte du bouton de l’IdP sur la page de connexion de Snowflake. L’étiquette par défaut est Single Sign On. Si vous modifiez l’étiquette par défaut, celle-ci ne peut contenir que des caractères alphanumériques (en d’autres termes, les caractères spéciaux et les espaces ne sont pas pris en charge actuellement).

Attention, si le champ "type" est "Okta", il n’est pas nécessaire de spécifier une valeur pour le champ label, car Snowflake affiche le logo Okta dans le bouton.

Pour plus d’informations, y compris des exemples de paramétrage, voir Migration d’une intégration de sécurité SAML2.

Par défaut:

Aucun

SEARCH_PATH¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le chemin à rechercher pour résoudre les noms d’objets non qualifiés dans les requêtes. Pour plus d’informations, consultez Résolution des noms dans les requêtes.

Valeurs:

Liste de sujets séparés par des identificateurs. Un identificateur peut être un nom de schéma entièrement ou partiellement qualifié.

Par défaut:

$current, $public

Pour plus d’informations sur les paramètres par défaut, reportez-vous à chemin de recherche par défaut.

SIMULATED_DATA_SHARING_CONSUMER¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le nom d’un compte consommateur à simuler pour tester/valider les données partagées, en particulier les vues sécurisées partagées. Lorsque ce paramètre est défini dans une session, les vues partagées retournent des lignes comme si elles étaient exécutées dans le compte consommateur spécifié plutôt que dans le compte fournisseur.

Note

Les simulations ne réussissent que lorsque le rôle actuel est le propriétaire de la vue. Si le rôle actuel ne possède pas la vue, les simulations échouent avec l’erreur suivante :

Shared view consumer simulation requires that the executing role owns the view.

Copy

Pour plus d’informations, voir À propos de Secure Data Sharing et Créer et configurer des partages.

Par défaut:

Aucun

SSO_LOGIN_PAGE¶

Type:

Compte — Ne peut être défini que pour le compte

Type de données:

Booléen

Description:

Ce paramètre obsolète désactive le mode de prévisualisation pour tester SSO (après avoir activé l’authentification fédérée) avant de le déployer aux utilisateurs :

Valeurs:

TRUE : le mode de prévisualisation est désactivé et les utilisateurs verront le bouton pour SSO initié par Snowflake pour votre fournisseur d’identité (tel que spécifié dans SAML_IDENTITY_PROVIDER) sur la page de connexion principale de Snowflake.

FALSE : le mode de prévisualisation est activé et SSO peut être testé à l’aide de l’URL suivante :

• Si votre compte est basé dans l’ouest US : https://<identificateur_de_compte>.snowflakecomputing.com/console/login?fedpreview=true

• Si votre compte est situé dans une autre région : https://<identificateur_de_compte>.<id_région>.snowflakecomputing.com/console/login?fedpreview=true

Pour plus d’informations, voir :

• Migration d’une intégration de sécurité SAML2

• Identificateurs de compte

Par défaut:

FALSE

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS¶

Type:

Session et objet (pour les entrepôts)

Peut être défini pour Compte » Utilisateur » Session ; peut également être défini pour des entrepôts individuels

Type de données:

Nombre

Description:

Durée, en secondes, pendant laquelle une instruction SQL (requête, DDL, DML, etc.) reste en file d’attente pour un entrepôt virtuel avant d’être annulée par le système. Ce paramètre peut être utilisé conjointement avec le paramètre MAX_CONCURRENCY_LEVEL pour s’assurer qu’un entrepôt n’est jamais en attente.

Le paramètre peut être défini dans la hiérarchie des sessions. Il peut également être configuré pour un entrepôt afin de contrôler le délai d’attente pour toutes les instructions SQL traitées par l’entrepôt. Lorsque le paramètre est défini pour un entrepôt et une session, la valeur minimale non nulle est appliquée. Par exemple :

• Un entrepôt présente un délai d’attente de 120 secondes.

• Le délai d’attente pour la session est fixé à 60 secondes.

Le délai d’attente de la session est prioritaire (c’est-à-dire que toute instruction soumise au cours de la session est annulée après avoir été mise en file d’attente pendant plus de 60 secondes).

Note

Pour les exécutions de tâches, le paramètre de tâche USER_TASK_TIMEOUT_MS est prioritaire sur le paramètre STATEMENT_QUEUED_TIMEOUT_IN_SECONDS.

Lorsque vous comparez les valeurs de ces deux paramètres, notez que STATEMENT_QUEUED_TIMEOUT_IN_SECONDS est défini en unités de secondes, alors que USER_TASK_TIMEOUT_MS utilise des unités de millisecondes.

Pour plus d’informations sur USER_TASK_TIMEOUT_MS, voir la section Paramètres facultatifs de CREATE TASK.

Valeurs:

0 à n’importe quel nombre (c’est-à-dire aucune limite) — une valeur de 0 spécifie qu’aucun délai d’attente n’est appliqué. Une instruction restera en file d’attente tant que la file d’attente persistera.

Par défaut:

0 (c.-à-d. pas de délai d’attente)

STATEMENT_TIMEOUT_IN_SECONDS¶

Type:

Session et objet (pour les entrepôts)

Peut être défini pour Compte » Utilisateur » Session ; peut également être défini pour des entrepôts individuels

Type de données:

Nombre

Description:

Temps, en secondes, après lequel une instruction SQL en cours d’exécution (requête, DDL, DML, etc.) est annulée par le système.

Le paramètre peut être défini dans la hiérarchie des sessions. Il peut également être paramétré pour un entrepôt individuel afin de contrôler la durée d’exécution de toutes les instructions SQL traitées par l’entrepôt virtuel. Lorsque le paramètre est défini pour un entrepôt et une session, la valeur minimale non nulle est appliquée. Par exemple :

• Un entrepôt présente un délai d’attente de 1000 secondes.

• Le délai d’attente pour la session est fixé à 500 secondes.

Le délai d’attente de la session est prioritaire (c’est-à-dire que toute instruction soumise au cours de la session est annulée après avoir été exécutée pendant plus de 500 secondes).

Note

Pour les séries de tâches :

• Si une tâche dépend d’un entrepôt virtuel pour ses ressources de calcul et que STATEMENT_TIMEOUT_IN_SECONDS est défini au niveau de l’entrepôt, le délai effectif est le plus court des paramètres suivants :

  • STATEMENT_TIMEOUT_IN_SECONDS

  • USER_TASK_TIMEOUT_MS (paramètre défini sur la tâche)

• Sinon, le paramètre de tâche USER_TASK_TIMEOUT_MS a la priorité sur le paramètre STATEMENT_TIMEOUT_IN_SECONDS pour les exécutions de tâches.

Lorsque vous comparez les valeurs de ces deux paramètres, notez que STATEMENT_TIMEOUT_IN_SECONDS est défini en unités de secondes, alors que USER_TASK_TIMEOUT_MS utilise des unités de millisecondes.

Pour plus d’informations sur USER_TASK_TIMEOUT_MS, voir la section Paramètres facultatifs de CREATE TASK.

Valeurs:

0 à 604800 (c’est-à-dire 7 jours) — une valeur de 0 spécifie que la valeur de délai d’attente maximum est appliquée.

Par défaut:

172800 (c.-à-d. 2 jours)

STORAGE_SERIALIZATION_POLICY¶

Type:

Objet (pour les bases de données, schémas et tables Apache Iceberg™) — Peut être défini pour Compte » Base de données » Schéma » Table Iceberg

Type de données:

Chaîne (constante)

Description:

Spécifie la politique de sérialisation de stockage des Tables Apache Iceberg™ gérées par Snowflake.

Valeurs:

COMPATIBLE : Snowflake effectue un encodage et une compression qui garantissent l’interopérabilité avec les moteurs de calcul tiers.

OPTIMIZED : Snowflake effectue un encodage et une compression qui garantissent les performances optimales des tables au sein de Snowflake.

Par défaut:

OPTIMIZED

STRICT_JSON_OUTPUT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Ce paramètre spécifie si la sortie JSON dans une session est compatible avec la norme standard (comme décrit par http://json.org).

De par sa conception, Snowflake autorise une entrée JSON qui contient des valeurs non standard ; cependant, ces valeurs non standard pourraient entraîner une sortie JSON dans Snowflake qui est incompatible avec d’autres plateformes et langages. Ce paramètre, lorsqu’il est activé, assure que les sorties de Snowflake sont valides/compatibles JSON.

Valeurs:

TRUE : une sortie JSON stricte est activée, ce qui permet d’appliquer le comportement suivant :

• Valeurs manquantes et non définies dans l’entrée associée à JSON NULL.

• Valeurs numériques non finies en entrée (Infini, -Infinité, NaN, etc.) mappées avec des chaînes avec des représentations JavaScript valides. Ceci permet la compatibilité avec JavaScript et permet également la conversion de ces valeurs en valeurs numériques.

FALSE : la sortie JSON stricte n’est pas activée.

Par défaut:

FALSE

Par exemple :

SUSPEND_TASK_AFTER_NUM_FAILURES¶

Type:

Objet (pour bases de données, schémas et tâches) — Peut être défini pour Compte » Base de données » Schéma » Tâche

Type de données:

Entier

Description:

Nombre d’exécutions successives de tâches qui ont échoué après lequel une tâche autonome ou une tâche racine d’un graphique de tâches est suspendue automatiquement. Les exécutions de tâches qui ont échoué comprennent les exécutions dans lesquelles le code SQL dans le corps de la tâche produit une erreur de l’utilisateur ou expire. Les exécutions de tâches qui sont ignorées, annulées ou qui échouent en raison d’une erreur système sont considérées comme indéterminées et ne sont pas incluses dans le compte des exécutions de tâches qui ont échoué.

Lorsque le paramètre est défini sur 0, la tâche défaillante n’est pas automatiquement suspendue.

Lorsque le paramètre est défini sur une valeur supérieure à 0, le comportement suivant s’applique aux exécutions de tâches autonomes ou de tâches racines d’un graphique de tâches :

• Une tâche autonome est automatiquement suspendue après que le nombre spécifié d’exécutions consécutives de la tâche ait échoué ou ait expiré.

• Une tâche racine est automatiquement suspendue après l’échec de toute tâche unique dans un graphique de tâches ou après le nombre spécifié d’exécutions consécutives.

La valeur par défaut du paramètre est 10, ce qui signifie que la tâche est automatiquement suspendue après 10 échecs consécutifs de l’exécution de la tâche.

Lorsque vous définissez explicitement la valeur du paramètre au niveau du compte, de la base de données ou du schéma, le changement est appliqué aux tâches contenues dans l’objet modifié lors de leur prochaine exécution planifiée (y compris toute tâche enfant dans une exécution de graphique de tâches en cours).

La suspension d’une tâche autonome réinitialise son compte d’échecs d’exécution. La suspension de la tâche racine d’un graphique de tâches réinitialise le compte de chaque tâche du graphique de tâches.

Valeurs:

0 - Pas de limite supérieure.

Par défaut:

10

TASK_AUTO_RETRY_ATTEMPTS¶

Type:

Objet (pour bases de données, schémas et tâches) — Peut être défini pour Compte » Base de données » Schéma » Tâche

Type de données:

Entier

Description:

Spécifie le nombre de tentatives de réessais automatiques du graphique de tâches. Si des graphiques de tâches se terminent dans un état FAILED, Snowflake peut automatiquement réessayer les graphiques de tâches à partir de la dernière tâche du graphique qui a échoué. Les exécutions de tâches qui ont échoué comprennent les exécutions dans lesquelles le code SQL dans le corps de la tâche produit une erreur de l’utilisateur ou expire. Les exécutions de tâches qui sont ignorées ou annulées sont considérées comme indéterminées et ne sont pas incluses dans le décompte des exécutions de tâches qui ont échoué.

La répétition automatique du graphique de tâches est désactivée par défaut. Pour activer cette fonction, définissez TASK_AUTO_RETRY_ATTEMPTS sur une valeur supérieure à 0.

Lorsque vous définissez la valeur de paramètre au niveau du compte, de la base de données ou du schéma, le changement est appliqué aux tâches contenues dans l’objet modifié lors de leur exécution planifiée suivante.

Valeurs:

0 - Pas de limite supérieure.

Par défaut:

0

TIMESTAMP_DAY_IS_ALWAYS_24H¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Spécifie si la fonction DATEADD (et ses alias) considère toujours un jour comme étant exactement 24 heures pour des expressions qui couvrent plusieurs jours.

Valeurs:

TRUE : une journée s’étale toujours exactement sur 24 heures.

FALSE : une journée ne s’étale pas toujours sur 24 heures.

Par défaut:

FALSE

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = true;

-- With DST beginning on 2018-03-11 at 2 AM, America/Los_Angeles time zone
select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 10:00:00.000 -0700                         | 2018-11-04 08:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = false;

select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 09:00:00.000 -0700                         | 2018-11-04 09:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

TIMESTAMP_INPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’entrée pour l’alias de type de données TIMESTAMP. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format d’horodatage valide et pris en charge, ou AUTO

(AUTO spécifie que Snowflake tente de détecter automatiquement le format des horodatages stockés dans le système pendant la session)

Par défaut:

AUTO

TIMESTAMP_LTZ_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage pour le type de données TIMESTAMP_LTZ. Si CSV_TIMESTAMP_FORMAT n’est pas défini, TIMESTAMP_LTZ_OUTPUT_FORMAT est utilisé lors du téléchargement des fichiers CSV. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format d’horodatage valide et pris en charge

Par défaut:

Aucun

TIMESTAMP_NTZ_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage pour le type de données TIMESTAMP_NTZ. Si CSV_TIMESTAMP_FORMAT n’est pas défini, TIMESTAMP_NTZ_OUTPUT_FORMAT est utilisé lors du téléchargement des fichiers CSV. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format d’horodatage valide et pris en charge

Par défaut:

YYYY-MM-DD HH24:MI:SS.FF3

TIMESTAMP_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage de l’alias de type de données TIMESTAMP. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format d’horodatage valide et pris en charge

Par défaut:

YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM

TIMESTAMP_TYPE_MAPPING¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie la variation TIMESTAMP_* à laquelle l’alias de type de données TIMESTAMP correspond.

Valeurs:

TIMESTAMP_LTZ , TIMESTAMP_NTZ ou TIMESTAMP_TZ

Par défaut:

TIMESTAMP_NTZ

TIMESTAMP_TZ_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage pour le type de données TIMESTAMP_TZ. Si CSV_TIMESTAMP_FORMAT n’est pas défini, TIMESTAMP_TZ_OUTPUT_FORMAT est utilisé lors du téléchargement des fichiers CSV. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format d’horodatage valide et pris en charge

Par défaut:

Aucun

TIMEZONE¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Indique le fuseau horaire de la session.

Valeurs:

Vous pouvez spécifier un nom de fuseau horaire ou un nom de lien de la version 2021a de la base de données de fuseaux horaires IANA (par exemple, America/Los_Angeles, Europe/London, UTC, Etc/GMT, etc.).

Par défaut:

America/Los_Angeles

TIME_INPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’entrée pour le type de données TIME. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format horaire valide et pris en charge ou AUTO

(AUTO spécifie que Snowflake tente de détecter automatiquement le format des horaires stockés dans le système pendant la session)

Par défaut:

AUTO

TIME_OUTPUT_FORMAT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Spécifie le format d’affichage pour le type de données TIME. Pour plus d’informations, voir Formats d’entrée et de sortie de la date et de l’heure.

Valeurs:

Tout format horaire valide et pris en charge

Par défaut:

HH24:MI:SS

TRACE_LEVEL¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type:

Objet (pour les bases de données, les schémas, les procédures stockées et les UDFs) — Peut être défini pour le compte » Base de données » Schéma » Procédure et compte » Base de données » Schéma » Fonction

Type de données:

Chaîne (constante)

Description:

Contrôle la manière dont les événements de trace sont intégrés dans la table des événements. Pour plus d’informations sur les niveaux de trace, consultez Définition des niveaux de journalisation, des métriques et du traçage.

Valeurs:

ALWAYS : Tous les spans et tous les événements de trace seront enregistrés dans la table des événements.

ON_EVENT : les événements de trace ne seront enregistrés dans la table des événements que lorsque vos procédures stockées ou UDFs ajouteront explicitement des événements.

OFF : aucun span ni trace ne sera enregistré(e) dans la table des événements.

Par défaut:

OFF

TRANSACTION_ABORT_ON_ERROR¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

BOOLEAN

Description:

Spécifie l’action à effectuer lorsqu’une instruction émise dans le cadre d’une transaction sans validation automatique est retournée avec une erreur.

Valeurs:

TRUE : la transaction sans validation automatique est annulée. Toutes les instructions émises à l’intérieur de cette transaction échoueront jusqu’à ce qu’une instruction de validation ou d’annulation soit exécutée pour clôturer cette transaction.

FALSE : la transaction sans validation automatique n’est pas annulée.

Par défaut:

FALSE

TRANSACTION_DEFAULT_ISOLATION_LEVEL¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne

Description:

Indique le niveau d’isolation des transactions de la session utilisateur.

Valeurs:

READ COMMITTED (uniquement la valeur actuellement prise en charge)

Par défaut:

READ COMMITTED

TWO_DIGIT_CENTURY_START¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Nombre

Description:

Indique l’année de « début du siècle » pour les années à deux chiffres, c’est-à-dire l’année la plus ancienne que ces dates peuvent représenter. Ce paramètre évite les dates ambiguës lors de l’importation ou de la conversion de données avec la composante de format de date YY (c’est-à-dire les années représentées par 2 chiffres).

Valeurs:

1900 à 2100 (toute valeur en dehors de cette plage renvoie une erreur)

Par défaut:

1970

Par exemple :

UNSUPPORTED_DDL_ACTION¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Chaîne (constante)

Description:

Détermine si une valeur non prise en charge (c’est-à-dire hors valeur par défaut) spécifiée pour une propriété de contrainte renvoie une erreur.

Valeurs:

IGNORE : Snowflake ne retourne pas d’erreur pour les valeurs non prises en charge.

FAIL : Snowflake renvoie une erreur pour les valeurs non prises en charge.

Par défaut:

IGNORE

USE_CACHED_RESULT¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Booléen

Description:

Indique s’il faut réutiliser les résultats de la requête mise en cache, le cas échéant, lorsqu’une requête correspondante est soumise.

Valeurs:

TRUE : lorsqu’une requête est soumise, Snowflake vérifie si les résultats de la requête correspondent aux requêtes déjà exécutées et, si un résultat correspondant existe, utilise le résultat au lieu d’exécuter la requête. Cela peut aider à réduire le temps de requête car Snowflake récupère le résultat directement dans le cache.

FALSE : Snowflake exécute chaque requête lorsqu’elle est soumise, qu’il existe ou non un résultat de requête correspondant.

Par défaut:

TRUE

USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE¶

Type:

Objet (pour bases de données, schémas et tâches) — Peut être défini pour Compte » Base de données » Schéma » Tâche

Type de données:

Chaîne

Description:

Spécifie la taille des ressources de calcul à provisionner pour la première exécution de la tâche, avant qu’un historique de la tâche ne soit disponible pour que Snowflake puisse déterminer une taille idéale. Une fois qu’une tâche a effectué avec succès quelques cycles, Snowflake ignore ce paramètre. Si l’historique des tâches n’est pas disponible pour une tâche donnée, les ressources de calcul reviennent à cette taille initiale.

Note

Ce paramètre s’applique uniquement aux tâches sans serveur.

La taille est équivalente aux ressources de calcul disponibles lors de la création d’un entrepôt. Si le paramètre est omis, les premières exécutions de la tâche s’effectuent en utilisant un entrepôt de taille moyenne (MEDIUM).

Vous pouvez modifier la taille initiale pour des tâches individuelles (en utilisant ALTER TASK) après la création de la tâche, mais avant qu’elle ait été exécutée avec succès une fois. La modification du paramètre après le démarrage de la première exécution de cette tâche n’a aucun effet sur les ressources de calcul pour les exécutions actuelles ou futures de la tâche.

Notez que la suspension et la reprise d’une tâche ne suppriment pas l’historique des tâches utilisé pour dimensionner les ressources de calcul. L’historique de la tâche n’est supprimé que si la tâche est recréée (en utilisant la syntaxe CREATE OR REPLACETASK).

Valeurs:

Toute taille d’entrepôt traditionnelle : SMALL, MEDIUM, LARGE, etc., avec une taille maximale de XXLARGE.

Par défaut:

MEDIUM

USER_TASK_TIMEOUT_MS¶

Type:

Objet (pour bases de données, schémas et tâches) — Peut être défini pour Compte » Base de données » Schéma » Tâche

Type de données:

Nombre

Description:

Spécifie la limite de temps sur une seule exécution de la tâche avant son expiration (en millisecondes).

Note

• Avant d’augmenter considérablement le délai de tâches, demandez-vous si les instructions SQL dans les définitions de tâches pourraient être optimisées (soit en réécrivant les instructions, soit en utilisant des procédures stockées) ou si la taille de l’entrepôt pour les tâches avec des ressources de calcul gérées par l’utilisateur devrait être augmentée.

• Dans certaines situations, le paramètre STATEMENT_TIMEOUT_IN_SECONDS a une plus grande priorité que USER_TASK_TIMEOUT_MS. Pour plus de détails, voir STATEMENT_TIMEOUT_IN_SECONDS.

Valeurs:

0 - 86400000 (1 jour)

Par défaut:

3600000 (1 heure)

WEEK_OF_YEAR_POLICY¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Nombre

Description:

Indique comment les semaines d’une année donnée sont calculées.

Valeurs:

0 : la sémantique utilisée est équivalente à la sémantique ISO, pour laquelle une semaine appartient à une année donnée si au moins 4 jours de cette semaine se situent dans cette année.

1 : le 1er janvier est inclus dans la première semaine de l’année et le 31 décembre est inclus dans la dernière semaine de l’année.

Par défaut:

0 (c.-à-d. un comportement similaire à celui d’ISO)

WEEK_START¶

Type:

Session — Peut être défini pour Compte » Utilisateur » Session

Type de données:

Nombre

Description:

Indique le premier jour de la semaine (utilisé par des fonctions de date liées à la semaine).

Valeurs:

0 : le comportement existant de Snowflake est utilisé (p. ex. comme dans la sémantique ISO).

1 (lundi) à 7 (dimanche) : toutes les fonctions liées à la semaine utilisent des semaines qui commencent le jour spécifié de la semaine.

Par défaut:

0 (c.-à-d. comportement existant de Snowflake)