Paramètres

Snowflake fournit des paramètres qui vous permettent de contrôler le comportement de votre compte, des sessions utilisateur individuelles et des objets. Tous les paramètres ont des valeurs par défaut, qui peuvent être définies puis remplacées à différents niveaux selon le type de paramètre (Compte, Session ou Objet).

Dans ce chapitre :

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 :

Hierarchy of account, session, and object parameters

Paramètres du compte

Les paramètres du compte peuvent être définis seulement au niveau du compte par les utilisateurs ayant le rôle d’administrateur approprié. Les paramètres de compte se définissent à l’aide de la commande ALTER ACCOUNT.

Snowflake fournit les paramètres de compte suivants :

Paramètre

Remarques

ALLOW_CLIENT_MFA_CACHING

ALLOW_ID_TOKEN

Utilisé pour activer la mise en cache de connexion dans la connexion unique basée sur un navigateur (SSO) pour les clients fournis par Snowflake

CLIENT_ENCRYPTION_KEY_SIZE

Utilisé pour le chiffrement des fichiers mis en zone de préparation pour le chargement ou le déchargement des données ; pourrait nécessiter une installation et une configuration supplémentaires (voir description pour plus de détails).

ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_IMAGE_REPOSITORY

Utilisé pour spécifier le choix pour un référentiel d’images de refuser d’utiliser Tri-Secret Secure et Periodic Rekeying.

ENABLE_INTERNAL_STAGES_PRIVATELINK

Permet à la fonction SYSTEM$GET_PRIVATELINK_CONFIG de retourner la clé private-internal-stages dans le résultat de la requête.

EVENT_TABLE

Permet de définir une table d’événements comme table d’événements active pour le compte.

ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES

EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB

MIN_DATA_RETENTION_TIME_IN_DAYS

Permet de définir la période minimale de conservation des données dans le cadre de la conservation des données historiques pour les opérations Time Travel.

NETWORK_POLICY

C’est le seul paramètre de compte qui peut être défini par les administrateurs de compte (c’est-à-dire les utilisateurs avec le rôle système ACCOUNTADMIN) ou les administrateurs de sécurité (c’est-à-dire les utilisateurs avec le rôle système SECURITYADMIN). . Pour plus d’informations, voir Paramètres d’objet.

OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST

PERIODIC_DATA_REKEYING

PREVENT_UNLOAD_TO_INLINE_URL

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION

SSO_LOGIN_PAGE

Note

Les paramètres de compte ne sont pas affichés dans la sortie par défaut de SHOW PARAMETERS. Pour plus d’informations sur l’affichage des paramètres de compte, voir Affichage des paramètres et de leurs valeurs (dans ce chapitre).

Paramètres de session

La plupart des paramètres sont des paramètres de session, qui peuvent être réglés aux niveaux suivants :

Compte

Les administrateurs de compte peuvent utiliser la commande ALTER ACCOUNT pour définir les paramètres de session du compte. Les valeurs définies pour le compte par défaut pour les utilisateurs individuels et leurs sessions.

Utilisateur

Les administrateurs disposant des privilèges appropriés (en général, le rôle SECURITYADMIN) peuvent utiliser la commande ALTER USER pour remplacer les paramètres de session des utilisateurs individuels. Les valeurs définies pour un utilisateur par défaut pour toutes les sessions lancées par l’utilisateur. En outre, les utilisateurs peuvent remplacer les paramètres de session pour eux-mêmes à l’aide de la commande ALTER USER.

Session

Les utilisateurs peuvent utiliser ALTER SESSION pour définir explicitement des paramètres de session dans leurs sessions.

Note

Par défaut, seuls les paramètres de session sont affichés dans la sortie de SHOW PARAMETERS. Pour plus d’informations sur l’affichage des paramètres de compte et d’objet, voir Affichage des paramètres et de leurs valeurs (dans cette rubrique).

Paramètres d’objet

Les paramètres d’objet peuvent être réglés aux niveaux suivants :

Compte

Les administrateurs de compte peuvent utiliser la commande ALTER ACCOUNT pour définir les paramètres d’objet du compte. Les valeurs définies pour le compte correspondent par défaut aux objets créés dans le compte.

Objet

Les utilisateurs disposant des privilèges appropriés peuvent utiliser les commandes CREATE <objet> ou ALTER <objet> correspondantes pour remplacer les paramètres d’objet d’un objet individuel.

Snowflake fournit les paramètres d’objet suivants :

Paramètre

Type d’objet

Remarques

DATA_RETENTION_TIME_IN_DAYS

Base de données, Schéma, Table

DEFAULT_DDL_COLLATION

Base de données, Schéma, Table

ENABLE_ETL_REPLICATION

Groupe de réplication, groupe de basculement

Obsolète. Pour plus d’informations, voir ENABLE_ETL_REPLICATION.

ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR

Utilisateur

Affecte l’historique des requêtes qui échouent en raison d’erreurs de syntaxe ou d’analyse.

LOG_LEVEL

Base de données, schéma, procédure stockée, fonction

MAX_CONCURRENCY_LEVEL

Entrepôt

MAX_DATA_EXTENSION_TIME_IN_DAYS

Base de données, Schéma, Table

PIPE_EXECUTION_PAUSED

Schéma, canal

PREVENT_UNLOAD_TO_INTERNAL_STAGES

Utilisateur

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS

Entrepôt

Un paramètre de session peut également être défini, (c’est-à-dire qu’il peut être défini au niveau de l’objet et de la session). Pour plus de détails sur l’héritage et le remplacement, voir la description des paramètres.

STATEMENT_TIMEOUT_IN_SECONDS

Entrepôt

Un paramètre de session peut également être défini, (c’est-à-dire qu’il peut être défini au niveau de l’objet et de la session). Pour plus de détails sur l’héritage et le remplacement, voir la description des paramètres.

NETWORK_POLICY

Utilisateur

C’est le seul paramètre utilisateur qui peut être défini par les administrateurs de comptes (c’est-à-dire les utilisateurs ayant le rôle système ACCOUNTADMIN) ou les administrateurs de sécurité (c’est-à-dire les utilisateurs ayant le rôle système SECURITYADMIN). . Notez que si ce paramètre est défini sur le compte et un utilisateur du même compte, la politique réseau au niveau de l’utilisateur prévaut sur la politique réseau au niveau du compte.

SHARE_RESTRICTIONS

Partager

Ce paramètre peut être défini soit par les administrateurs de compte (c’est-à-dire les utilisateurs avec le rôle système ACCOUNTADMIN) soit par un rôle disposant du privilège OVERRIDE SHARE RESTRICTIONS.

SUSPEND_TASK_AFTER_NUM_FAILURES

Base de données, Schéma, Tâche

TRACE_LEVEL

Base de données, schéma, procédure stockée, fonction

USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE

Base de données, Schéma, Tâche

USER_TASK_TIMEOUT_MS

Base de données, Schéma, Tâche

Note

Par défaut, les paramètres d’objet ne sont pas affichés dans la sortie de SHOW PARAMETERS. Pour plus d’informations sur l’affichage des paramètres d’objet, voir Affichage des paramètres et de leurs valeurs (dans cette rubrique).

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é.

Affichage des paramètres de session et d’objet

Par défaut, la commande affiche les paramètres de session seulement :

SHOW PARAMETERS;
Copy

Pour afficher les paramètres d’objet d’un objet spécifique, ajoutez une clause IN avec le type et le nom de l’objet. Par exemple :

SHOW PARAMETERS IN DATABASE mydb;

SHOW PARAMETERS IN WAREHOUSE mywh;
Copy

Affichage de tous les paramètres

Pour afficher tous les paramètres, y compris les paramètres de compte et d’objet, inclure une clause IN ACCOUNT :

SHOW PARAMETERS IN ACCOUNT;
Copy

Limitation de la liste des paramètres par nom

La commande accepte également l’utilisation d’une clause LIKE pour limiter la liste des paramètres par leur nom. Par exemple :

  • Pour afficher les paramètres de session dont les noms contiennent le mot « time » :

    SHOW PARAMETERS LIKE '%time%';
    
    Copy
  • Pour afficher tous les paramètres dont le nom commence par le mot « time » :

    SHOW PARAMETERS LIKE 'time%' IN ACCOUNT;
    
    Copy

Note

La clause LIKE doit précéder la clause IN.

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

Note

  • Si l’utilisateur ferme explicitement la connexion :

    • Toutes les requêtes synchrones en cours sont immédiatement abandonnées, quelle que soit la valeur du paramètre.

    • Lorsque la valeur est définie sur FALSE, les requêtes asynchrones continuent de s’exécuter jusqu’à ce qu’elles se terminent, jusqu’à ce qu’elles soient annulées ou jusqu’à la limite de temps spécifiée pour le paramètre STATEMENT_TIMEOUT_IN_SECONDS. Le paramètre STATEMENT_TIMEOUT_IN_SECONDS par défaut est deux jours.

  • La plupart des requêtes nécessitent des ressources de calcul pour être exécutées. Ces ressources sont fournies par des entrepôts virtuels, qui consomment des crédits en fonctionnement. Avec une valeur de FALSE, si la session se termine, les entrepôts virtuels pourraient continuer à exécuter et à consommer des crédits pour compléter toutes les requêtes en cours au moment où la session se termine.

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 :

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 Binary Input and Output.

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 Binary Input and Output.

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

Note

  • Ce paramètre n’est pas utilisé pour chiffrer/déchiffrer les fichiers stockés dans des zones de préparation externes (c.-à-d. les compartiments S3 ou conteneurs Azure, par ex.). Le chiffrement/déchiffrement de ces fichiers s’effectue à l’aide d’une clé de chiffrement externe explicitement spécifiée dans la commande COPY ou dans la zone de préparation externe nommée référencée dans la commande.

  • Si vous utilisez le pilote JDBC et que vous souhaitez définir ce paramètre sur 256 (pour un chiffrement fort), des fichiers de politique JCE supplémentaires doivent être installés sur chaque machine cliente à partir de laquelle les données sont chargées/déchargées. Pour plus d’informations sur l’installation des fichiers requis, voir Exigences Java pour le pilote JDBC.

  • Si vous utilisez le connecteur Python (ou SnowSQL) et que vous souhaitez définir ce paramètre sur 256 (pour un chiffrement fort), aucune installation ou tâche de configuration supplémentaire n’est nécessaire.

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.

Note

  • Le pilote tentera de respecter la valeur du paramètre, mais plafonnera l’utilisation à 80 % de la mémoire de votre système.

  • La limite d’utilisation de la mémoire définie dans ce paramètre ne s’applique pas aux autres opérations du pilote JDBC ou ODBC (par exemple, la connexion à la base de données, la préparation d’une requête ou les instructions PUT et GET).

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

Note

Pour le pilote JDBC, ce comportement s’applique à la version 3.6.27 (et ultérieure). Pour le pilote ODBC, ce comportement s’applique à la version 2.12.96 (et ultérieure).

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 :

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

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

Note

Actuellement, le paramètre ne prend effet que lors de l’ouverture de la session. Vous pouvez modifier la valeur du paramètre au niveau de la session en exécutant une commande ALTER SESSION, mais cela n’affecte pas la fonctionnalité de maintien de la session, telle que la prolongation de la session. Pour plus d’informations sur le réglage du paramètre au niveau de la session, voir la documentation du client :

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

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

Note

Pour définir le classement par défaut du compte, utilisez la commande suivante :

Le classement par défaut des colonnes de table peut être défini au niveau de la table, du schéma ou de la base de données lors de la création ou à tout moment par la suite :

ENABLE_ETL_REPLICATION

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, l’activation de Tri-Secret Secure et de Periodic Rekeying pour les comptes qui ont activé le référentiel d’images n’est pas autorisée.

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 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, consultez Capturer des messages provenant d’exceptions non gérées.

Valeurs

TRUE : les données sur les exceptions non gérées seront capturées sous forme de données de journal ou de trace si elles sont activées comme décrit dans Activer la capture des entrées d’exception non gérées.

FALSE : les données sur les exceptions non gérées peuvent ne pas être capturées.

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

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

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

Note

Ce paramètre ne concerne pas les sorties JSON déchargées d’une table dans un fichier en utilisant la commande COPY INTO <emplacement>. La commande décharge toujours les données JSON au format ndjson :

  • Chaque enregistrement de la table est séparé par un caractère de nouvelle ligne.

  • Dans chaque enregistrement, réduisez le formatage (c.-à-d. sans espaces ni caractères de nouvelle ligne).

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

Note

Par défaut, les colonnes INTEGER Snowflake (y compris BIGINT, NUMBER(p, 0), etc.) sont converties en type de données JavaScript Number. Toutefois, les plus grandes valeurs légales entières de Snowflake sont supérieures aux plus grandes valeurs légales JavaScript. Pour convertir les colonnes INTEGER Snowflake au format JavaScript Bigint, qui peut stocker des valeurs supérieures à JavaScript Number, définissez le paramètre de session JS_TREAT_INTEGER_AS_BIGINT.

Pour des exemples d’utilisation de ce paramètre, voir Récupération des types de données entiers en tant que Bigint.

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)

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 Réglage du niveau de journalisation.

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

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 de journalisation effectif.

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

Astuce

Cette valeur est par défaut uniquement et peut être modifiée à tout moment :

  • L’abaissement du niveau de concurrence pour un entrepôt permet de limiter le nombre de requêtes simultanées exécutées dans un entrepôt. Lorsque moins de requêtes sont en concurrence pour les ressources de l’entrepôt à un moment donné, une requête peut potentiellement se voir attribuer plus de ressources, ce qui peut se traduire par des performances plus rapides, en particulier pour une requête volumineuse/complexe et à plusieurs instructions.

  • L’augmentation du niveau de simultanéité pour un entrepôt peut réduire les ressources de calcul qui sont disponibles par instruction ; toutefois, cela ne limite pas nécessairement le nombre total de requêtes simultanées pouvant être exécutées par l’entrepôt, pas plus qu’elle n’impacte nécessairement la performance totale de l’entrepôt, qui dépend de la nature des requêtes en cours d’exécution.

Notez que, comme décrit précédemment, ce paramètre impacte les entrepôts multi-clusters (en mode Mise à l’échelle automatique), car Snowflake lance automatiquement un nouveau cluster dans l’entrepôt multi-clusters pour éviter les files d’attente. Ainsi, abaisser le niveau de simultanéité pour un entrepôt multi-clusters (en mode Mise à l’échelle automatique) augmente potentiellement le nombre de clusters actifs à tout moment.

De plus, n’oubliez pas que Snowflake distribue automatiquement des ressources pour chaque instruction lorsqu’elle est soumise et que le montant alloué est dicté par les exigences individuelles de l’instruction. Sur cette base, et grâce à nos observations des modèles de requêtes des utilisateurs au fil du temps, nous avons sélectionné une valeur par défaut qui équilibre la performance et l’utilisation des ressources.

Ainsi, avant de changer la valeur par défaut, nous vous recommandons de tester le changement en ajustant le paramètre par petits incréments et en observant l’impact sur un ensemble représentatif de vos requêtes.

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

Note

Ce paramètre peut entraîner une conservation des données plus longue que la conservation par défaut. Avant de l’augmenter, vérifiez que la nouvelle valeur correspond à vos exigences de conformité.

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

Note

  • Ce paramètre s’applique uniquement aux tables permanentes et ne s’applique pas aux objets suivants :

    • Tables transitoires

    • Tables temporaires

    • Tables externes

    • Vues matérialisées

    • Flux

  • Ce paramètre ne peut être activé et désactivé que par des administrateurs de comptes (c’est-à-dire des utilisateurs ayant le rôle ACCOUNTADMIN ou un autre rôle auquel est attribué le rôle ACCOUNTADMIN).

  • La définition de la période minimale de conservation des données ne modifie aucune valeur du paramètre DATA_RETENTION_TIME_IN_DAYS existante définie sur les bases de données, les schémas ou les tables. Le durée de conservation effective sur une base de données, un schéma ou une table est MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS).

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

Note

C’est le seul paramètre de compte qui peut être défini par les administrateurs de sécurité (c’est-à-dire les utilisateurs ayant le rôle SECURITYADMIN) ou les administrateurs ayant un rôle supérieur.

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

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

Note

Ce paramètre ne peut pas être défini au niveau du compte.

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

Note

Il existe des frais associés à la ressaisie des données parce que, après la ressaisie des données, les anciennes données (avec l’ancien chiffrement par clé) sont conservées dans Fail-safe pendant la période de temps standard (7 jours). Pour cette raison, la resaisie périodique est désactivée par défaut. Pour activer la resaisie périodique, vous devez l’activer explicitement.

De plus, les frais associés à Fail-safe pour la resaisie ne sont pas indiqués individuellement sur votre relevé mensuel ; ils sont inclus dans le total Fail-safe de votre compte chaque mois.

Pour plus d’informations sur Fail-safe, voir Compréhension et affichage de Fail-safe.

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)

Note

En général, il n’est pas nécessaire de mettre les canaux en pause, sauf pour transférer la propriété.

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 :

Identificateur

Paramètre réglé sur FALSE (par défaut)

Paramètre réglé sur TRUE

"columnname"

se résout vers :

columnname

COLUMNNAME

"columnName"

se résout vers :

columnName

COLUMNNAME

"ColumnName"

se résout vers :

ColumnName

COLUMNNAME

"COLUMNNAME"

se résout vers :

COLUMNNAME

COLUMNNAME

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, consultez 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 Présentation de Secure Data Sharing et Utilisation des partages.

Par défaut

Aucun

Important

Il s’agit d’un paramètre de session, ce qui signifie qu’il peut être défini au niveau du compte ; cependant, il ne s’applique qu’aux requêtes de test sur les vues partagées. Étant donné que le paramètre affecte toutes les requêtes d’une session, il ne doit jamais être défini au niveau du compte.

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 :

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 :

Entrée JSON non standard

Paramètre réglé sur FALSE (par défaut)

Paramètre réglé sur TRUE

[289, 2188,]

sorties :

[ 289, 2188, undefined ]

[ 289, 2188, null ]

[undefined, undefined]

sorties :

[ undefined, undefined ]

[ null, null ]

[Infinity,inf,-Infinity,-inf]

sorties :

[ Infinity, Infinity, -Infinity, -Infinity ]

[ "Infinity", "Infinity", "-Infinity", "-Infinity" ]

[NaN,nan]

sorties :

[ NaN, NaN ]

[ "NaN", "NaN" ]

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 sur 0, la tâche défaillante n’est pas automatiquement suspendue.

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.

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.

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

10

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

Important

Si défini sur TRUE, l’heure réelle de la journée pourrait ne pas être conservée lorsque l’heure d’été (DST) est en vigueur. Par exemple :

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                         |
+-------------------------------------------------------+-------------------------------------------------------+
Copy

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 aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. 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.

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 aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. 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

Note

  • Les noms de fuseaux horaires sont sensibles à la casse et doivent être entre guillemets simples (par ex. 'UTC').

  • Snowflake ne prend pas en charge la majorité des abréviations de fuseaux horaires (par exemple, PDT, EST, etc.) car une abréviation donnée peut faire référence à plusieurs fuseaux horaires différents. Par exemple, CST peut faire référence à l’heure normale centrale en Amérique du Nord (UTC-6), à l’heure normale de Cuba (UTC-5) et à l’heure normale de Chine (UTC+8).

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 Réglage du niveau de trace.

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

Note

Lors du traçage d’événements, vous devez également définir le paramètre LOG_LEVEL sur l’une des valeurs prises en charge.

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 :

Année

Paramètre réglé sur 1900

Paramètre réglé sur 1970 (par défaut)

Paramètre réglé sur 1980

Paramètre réglé sur 1990

Paramètre réglé sur 2000

00

devient :

1900

2000

2000

2000

2000

79

devient :

1979

1979

2079

2079

2079

89

devient :

1989

1989

1989

2089

2089

99

devient :

1999

1999

1999

1999

2099

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

Important

Ce paramètre ne détermine pas si la contrainte est créée. Snowflake ne crée pas de contraintes en utilisant des valeurs non prises en charge, peu importe comment ce paramètre est réglé.

Pour plus d’informations, consultez Propriétés des contraintes.

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)

Astuce

1 est la valeur la plus courante, d’après les commentaires que nous avons reçus. Pour plus d’informations, y compris des exemples, voir Semaines civiles et jours de semaine.

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)

Astuce

1 est la valeur la plus courante, d’après les commentaires que nous avons reçus. Pour plus d’informations, y compris des exemples, voir Semaines civiles et jours de semaine.