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_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 stockés 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).

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB

NETWORK_POLICY

C’est le seul paramètre de compte qui peut être défini par les administrateurs de compte (ACCOUNTADMIN) ou les administrateurs de sécurité (SECURITYADMIN).

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

MAX_CONCURRENCY_LEVEL

Entrepôt

PIPE_EXECUTION_PAUSED

Schéma, Canal

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 de compte qui peut être défini par les administrateurs de compte (ACCOUNTADMIN) ou les administrateurs de sécurité (SECURITYADMIN).

SHARE_RESTRICTIONS

Partager

Ce paramètre peut être défini soit par les administrateurs de compte (ACCOUNTADMIN) soit par un rôle disposant du privilège OVERRIDE SHARE RESTRICTIONS.

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;

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;

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;

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%';
    
  • Pour afficher tous les paramètres dont le nom commence par le mot « time » :

    SHOW PARAMETERS LIKE 'time%' IN ACCOUNT;
    

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 en cours sont immédiatement interrompues, quelle que soit la valeur du paramètre.

  • 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_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 (Facultatif) Utilisation de la mise en cache de connexion pour réduire le nombre d’invites pour l’authentification.

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 d’entrée des valeurs binaires.

Valeurs

HEX , BASE64 ou UTF8 / UTF-8

Par défaut

HEX

BINARY_OUTPUT_FORMAT

Type

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

Type de données

Chaîne (constante)

Description

Format d’affichage des valeurs binaires.

Valeurs

HEX ou BASE64

Par défaut

HEX

CLIENT_ENABLE_LOG_INFO_STATEMENT_PARAMETERS

Type

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

Type de données

Booléen

Clients

JDBC

Description

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

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

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

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

Valeurs

TRUE ou FALSE.

Par défaut

FALSE

CLIENT_ENCRYPTION_KEY_SIZE

Type

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

Type de données

Entier

Clients

N’importe quel

Description

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

Valeurs

128 ou 256

Par défaut

128

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

Description

Paramètre qui spécifie la quantité maximale de mémoire que le pilote JDBC doit utiliser pour le jeu de résultats des requêtes (en MB). 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.

Notez que CLIENT_RESULT_CHUNK_SIZE spécifie la taille maximale de chaque ensemble (ou partie) 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.

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 (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, mais gère également sa mémoire de manière prudente pour éviter d’utiliser toute la mémoire disponible.

CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX

Type

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

Type de données

Booléen

Clients

JDBC, ODBC

Description

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

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

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

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

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

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

Pour plus de détails, voir ci-dessous.

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

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

    • getColumns

    • getCrossReference

    • getExportedKeys

    • getForeignKeys

    • getFunctions

    • getImportedKeys

    • getPrimaryKeys

    • getSchemas

    • getTables

  • Fonctions du pilote ODBC :

    • SQLTables

    • SQLColumns

    • SQLPrimaryKeys

    • SQLForeignKeys

    • SQLGetFunctions

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, voir ci-dessous.

Valeurs

TRUE :

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

FALSE :

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

Par défaut

FALSE

Remarques complémentaires

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

CLIENT_METADATA_USE_SESSION_DATABASE

Comportement

FALSE

Tous les schémas de toutes les bases de données sont recherchés.

TRUE

Tous les schémas de la base de données actuelle sont recherchés.

CLIENT_PREFETCH_THREADS

Type

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

Type de données

Entier

Clients

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

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 peut pas être défini au niveau de la session en exécutant la commande ALTER 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

Nombre

Description

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

Valeurs

0 ou 1 (pour l’édition Standard)

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

Par défaut

1

DATE_INPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

Tout format de date valide et pris en charge ou AUTO

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

Par défaut

AUTO

DATE_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

Tout format de date valide et pris en charge

Par défaut

YYYY-MM-DD

DEFAULT_DDL_COLLATION

Type

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

Type de données

Chaîne

Description

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

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

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

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

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

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

Par défaut

Chaîne vide

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

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

GEOGRAPHY_OUTPUT_FORMAT

Type

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

Type de données

Chaîne (constante)

Description

Format d’affichage des valeurs géospatiales.

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

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). Cette limite de taille permet d’empêcher les comptes d’engager accidentellement des frais de réplication de base de données importants.

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

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

Valeurs

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

Par défaut

10.0

JDBC_TREAT_DECIMAL_AS_INT

Type

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

Type de données

Booléen

Description

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

Valeurs

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

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

Par défaut

TRUE

JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC

Type

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

Type de données

Booléen

Description

Spécifie comment JDBC traite les valeurs TIMESTAMP_NTZ.

Par défaut, lorsque le pilote JDBC récupère une valeur de type TIMESTAMP_NTZ dans Snowflake, le pilote convertit la valeur UTC dans le fuseau horaire actuel, en fonction de la session de l’utilisateur.

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

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

Valeurs

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

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

l’utilisateur.

Par défaut

FALSE

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érer 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 chronométrer et d’annuler l’instruction.

Valeurs

0 pour n’importe quel nombre (c.-à-d. aucune 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 annuler ; si plusieurs ressources doivent être verrouillées par l’instruction, le délai s’applique séparément lors de chaque tentative de verrouillage)

Par défaut

43200 (c.-à-d. 12 heures)

MAX_CONCURRENCY_LEVEL

Type

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

Type de données

Nombre

Description

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

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

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

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

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

Le nombre réel d’instructions exécutées simultanément par un cluster d’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 serveurs dans un cluster d’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 simultanéité pour un entrepôt augmente la distribution des ressources de calcul par instruction pour des performances d’interrogation potentiellement plus rapides, en particulier pour les requêtes complexes/de grande taille et les requêtes multi-instruction.

  • L’augmentation du niveau de simultanéité pour un entrepôt réduit la distribution des ressources de calcul 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’améliore 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 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.

MULTI_STATEMENT_COUNT

Type

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

Type de données

Entier (constant)

Clients

JDBC, ODBC

Description

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

Valeurs

0: Variable number of statements.

1: One statement.

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

Par défaut

1

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é ou les administrateurs ayant un rôle supérieur (SECURITYADMIN).

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

Valeurs

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

FALSE : les données ne sont pas resaisies.

Par défaut

FALSE

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

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

Table — Peut être définie pour la table » Schéma » Base de données

Type de données

Booléen

Description

Indique si la casse des lettres est ignorée pour tous les identificateurs d’objet entre guillemets doubles.

Valeurs

TRUE : les identificateurs entre guillemets doubles sont insensibles à la casse (c.-à-d. que la casse est ignorée et que toutes les lettres sont traitées comme des majuscules).

FALSE : les identificateurs entre guillemets doubles sont sensibles à la casse ; Snowflake résout et stocke les identificateurs dans la casse spécifiée.

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

Par défaut

FALSE

Par exemple :

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

Description

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

Valeurs

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

Par défaut

0

SAML_IDENTITY_PROVIDER

Type

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

Type de données

JSON

Description

Active l’authentification fédérée. Le paramètre accepte un objet JSON, délimité par des guillemets simples, avec les champs suivants :

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

Où :

certificate

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

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 Configuration de Snowflake pour l’utilisation de l’authentification fédérée.

Par défaut

Aucun

SIMULATED_DATA_SHARING_CONSUMER

Type

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

Type de données

Chaîne

Description

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

Note

Pour le moment, le paramètre de session SIMULATED_DATA_SHARING_CONSUMER ne prend en charge que les vues sécurisées et les vues matérialisées sécurisées, mais ne prend pas en charge les UDFs sécurisés.

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

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://<nom_compte>.snowflakecomputing.com/console/login?fedpreview=true

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

Pour plus d’informations, voir Configuration de Snowflake pour l’utilisation de l’authentification fédérée.

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

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

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

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

TIMESTAMP_INPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

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

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

Par défaut

AUTO

TIMESTAMP_LTZ_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

Spécifie le format d’affichage pour le type de données TIMESTAMP_LTZ. Si aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. Pour plus d’informations, voir Entrée/sortie de date et d’heure.

Valeurs

Tout format d’horodatage valide et pris en charge

Par défaut

Aucun

TIMESTAMP_NTZ_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

Spécifie le format d’affichage pour le type de données TIMESTAMP_NTZ.

Valeurs

Tout format d’horodatage valide et pris en charge

Par défaut

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

TIMESTAMP_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

Tout format d’horodatage valide et pris en charge

Par défaut

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

TIMESTAMP_TYPE_MAPPING

Type

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

Type de données

Chaîne

Description

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

Valeurs

TIMESTAMP_LTZ , TIMESTAMP_NTZ ou TIMESTAMP_TZ

Par défaut

TIMESTAMP_NTZ

TIMESTAMP_TZ_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

Spécifie le format d’affichage pour le type de données TIMESTAMP_TZ. Si aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. Pour plus d’informations, voir Entrée/sortie de date et d’heure.

Valeurs

Tout format d’horodatage valide et pris en charge

Par défaut

Aucun

TIMEZONE

Type

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

Type de données

Chaîne (constante)

Description

Indique le fuseau horaire de la session. Pour obtenir une liste des fuseaux horaires, voir la liste des fuseaux horaires de la base de données tz (dans Wikipedia).

Valeurs

Fuseaux horaires standards iana.org :

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').

De plus, certains fuseaux horaires simples, tels que PDT, ne sont pas actuellement pris en charge.

TIME_INPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

Tout format horaire valide et pris en charge ou AUTO

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

Par défaut

AUTO

TIME_OUTPUT_FORMAT

Type

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

Type de données

Chaîne

Description

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

Valeurs

Tout format horaire valide et pris en charge

Par défaut

HH24:MI:SS

TRANSACTION_ABORT_ON_ERROR

Type

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

Type de données

BOOLEAN

Description

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

Valeurs

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

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

Par défaut

FALSE

TRANSACTION_DEFAULT_ISOLATION_LEVEL

Type

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

Type de données

Chaîne

Description

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

Valeurs

READ COMMITTED (uniquement la valeur actuellement prise en charge)

Par défaut

READ COMMITTED

TWO_DIGIT_CENTURY_START

Type

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

Type de données

Nombre

Description

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

Valeurs

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

Par défaut

1970

Par exemple :

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

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.