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

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 dans des zones de préparation internes (pour charger/décharger des données).

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, voir 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, voir 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

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, 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

48 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

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 Comprendre et utiliser 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 Entrée/sortie de date et d’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 Entrée/sortie de date et d’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');

Valeurs

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

Par défaut

Chaîne vide

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 Connectivité privée aux zones de préparation internes de Snowflake.

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_STREAM_TASK_REPLICATION¶

Type

Objet (pour les bases de données, les groupes de réplication et les groupes de basculement) — Peut être défini pour la base de données » du compte, le groupe de réplication » du compte, et le groupe de basculement » du compte

Type de données

Booléen

Description

Permet la réplication des flux et des tâches d’un compte source vers un ou plusieurs comptes cibles. Ce paramètre doit être défini pour le compte source ou l’objet primaire.

Valeurs

TRUE : active la réplication des flux et des tâches.

FALSE : désactive la réplication des flux et des tâches.

Par défaut

FALSE

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

ENFORCE_SESSION_POLICY¶

TYPE

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

Type de données

Booléen

Description

Applique une politique de session dans l’interface Web classique et au moment de l’exécution des requêtes.

Valeurs

TRUE : active l’application de la politique de session.

FALSE : désactive l’application de la politique de session.

Par défaut

FALSE

Pour plus d’informations, voir Application d’une politique de session.

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

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 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 : les rôles ACCOUNTADMIN et SECURITYADMIN sont ajoutés à 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 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

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

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_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 dans Snowflake, le pilote convertit la valeur UTC dans le fuseau horaire actuel, en fonction de la session de l’utilisateur.

Les utilisateurs qui souhaitent conserver les valeurs de TIMESTAMP_NTZ dans le fuseau horaire UTC peuvent définir ce paramètre sur TRUE.

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

Valeurs

TRUE : le pilote ne modifie pas la valeur TIMESTAMP_NTZ ; la valeur UTC est conservée.

FALSE : le pilote convertit la valeur TIMESTAMP_NTZ UTC vers celle du fuseau horaire actuel de l’utilisateur.

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

Nombre

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 quelconque (c’est-à-dire 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). 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 (c.-à-d. 12 heures)

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.

Notez que ce paramètre ne limite pas le nombre d’instructions qui peuvent être exécutées simultanément par un cluster d’entrepôt. Il sert plutôt de plafond pour se protéger contre la surallocation des ressources. Au fur et à mesure que chaque instruction est soumise à un entrepôt, Snowflake distribue des ressources pour exécuter l’instruction ; s’il n’y a pas assez de ressources disponibles, l’instruction est mise en file d’attente ou des clusters supplémentaires sont démarrés, selon l’entrepôt virtuel.

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 Suivi des modifications à l’aide de flux de table.

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

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 Comprendre et utiliser 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 Politiques réseau.

Valeurs

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

Par défaut

Aucun

SHARE_RESTRICTIONS¶

Type

Objet (pour les partages) — Peut être défini pour Partager.

Type de données

Booléen

Description

Ce paramètre s’applique uniquement au partage de données. Il active/désactive l’ajout d’un compte de consommateur non Business Critical à un partage appartenant à un compte de fournisseur Business Critical. Pour plus d’informations, voir Activation du partage depuis un compte Business Critical vers un compte non Business Critical.

Valeurs

FALSE : un compte de consommateur non Business Critical peut être ajouté à un partage appartenant à un compte de fournisseur Business Critical.

TRUE : un compte de consommateur non Business Critical ne peut pas être ajouté à un partage appartenant à un compte de fournisseur Business Critical.

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 Chiffrement des données.

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. Voir 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, voir Résolution de l’identificateur.

Par défaut

FALSE

Par exemple :

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

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" : ""
}

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 en Okta et ADFS, voir Migration vers 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 vers une intégration de sécurité SAML2.

Par défaut

Aucun

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.

Pour plus d’informations, voir Présentation de Secure Data Sharing et Utilisation 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 vers 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)

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 DAG 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 à une valeur supérieure à 0, le comportement suivant s’applique aux exécutions de tâches autonomes ou de tâches racines du DAG :

• 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 DAG ou après le nombre spécifié d’exécutions consécutives.

Ce paramètre s’applique aux tâches qui s’appuient sur des ressources informatiques gérées par Snowflake (c’est-à-dire le modèle de calcul sans serveur) ou sur des ressources informatiques gérées par l’utilisateur (c’est-à-dire un entrepôt virtuel).

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 DAG en cours).

La suspension d’une tâche autonome réinitialise son compte d’échecs d’exécution. La suspension d’une tâche de DAG racine réinitialise le compte de chaque tâche dans les DAG.

Valeurs

0 - Pas de limite supérieure.

Par défaut

0 (pas de suspension automatique)

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 Entrée/sortie de date et d’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 aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. Pour plus d’informations, voir Entrée/sortie de date et d’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.

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 Entrée/sortie de date et d’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 aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. Pour plus d’informations, voir Entrée/sortie de date et d’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 Entrée/sortie de date et d’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 Entrée/sortie de date et d’heure.

Valeurs

Tout format horaire valide et pris en charge

Par défaut

HH24:MI:SS

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

Indique 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)