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 :
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 |
---|---|
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 |
|
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). |
|
Permet à la fonction SYSTEM$GET_PRIVATELINK_CONFIG de retourner la clé |
|
Utilisé pour appliquer une politique de session dans l’interface Web classique et au moment de l’exécution de la requête. |
|
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. |
|
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. |
|
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 |
---|---|---|
Base de données, Schéma, Table |
||
Base de données, Schéma, Table |
||
Base de données, réplication ou groupe de basculement |
Cette fonctionnalité préliminaire est ouverte à tous les comptes. |
|
Entrepôt |
||
Base de données, Schéma, Table |
||
Schéma, canal |
||
Utilisateur |
||
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. |
|
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. |
|
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. |
|
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. |
|
Base de données, Schéma, Tâche |
||
Base de données, Schéma, Tâche |
||
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;
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 synchrones en cours sont immédiatement abandonnées, quelle que soit la valeur du paramètre.
Lorsque la valeur est
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’à l’expiration de la durée d’exécution maximale de 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 Entrée et sortie binaires.
- Valeurs
HEX
,BASE64
ouUTF8
/UTF-8
- Par défaut
HEX
BINARY_OUTPUT_FORMAT¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne (constante)
- Description
Le format des valeurs VARCHAR renvoyées en sortie par les fonctions de conversion BINARY vers VARCHAR. Pour plus d’informations, voir Entrée et sortie binaires.
- Valeurs
HEX
ouBASE64
- 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
surINFO
ouALL
.Définissez
TRACING
surALL
pour afficher toutes les informations de débogage et toutes les informations de liaison.Définissez
TRACING
surINFO
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
ouFALSE
.- 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
ou256
- 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 sontnull
, 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 surTRUE
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 :Valeurs transmises comme arguments aux fonctions/méthodes.
Valeurs spécifiées dans le contexte de connexion (le cas échéant).
Par défaut (toutes les bases de données et tous les schémas).
Pour plus de détails, voir ci-dessous.
Ce paramètre s’applique aux éléments suivants :
Méthodes de pilote JDBC (pour la classe
DatabaseMetaData
) :getColumns
getCrossReference
getExportedKeys
getForeignKeys
getFunctions
getImportedKeys
getPrimaryKeys
getSchemas
getTables
Fonctions du pilote ODBC :
SQLTables
SQLColumns
SQLPrimaryKeys
SQLForeignKeys
SQLGetFunctions
SQLProcedures
- Valeurs
TRUE
: si les arguments de base de données et de schéma sontnull
, 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 sontnull
, 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 :
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.
Spécifiez la base de données et le schéma lors de la connexion à Snowflake via le pilote.
É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 :
CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX est
FALSE
ou non défini.Aucune base de données ou schéma n’est transmis à la fonction ODBC ou à la méthode JDBC correspondante.
Pour certaines fonctions ODBC et méthodes JDBC, ce paramètre peut modifier la portée de la recherche par défaut pour qu’elle s’applique uniquement à la base de données actuelle et non plus à l’ensemble des bases de données. La recherche plus étroite renvoie généralement moins de lignes et s’exécute plus rapidement.
Pour plus de détails, voir ci-dessous.
- Valeurs
TRUE
:Le pilote recherche tous les schémas dans la base de données du contexte de connexion. (Pour plus d’informations sur le contexte de connexion, consultez la documentation concernant CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX.)
FALSE
:Le pilote recherche tous les schémas dans toutes les bases de données.
- Par défaut
FALSE
- Remarques complémentaires
Lorsque la base de données est null
, le schéma est null
et CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX est FALSE :
CLIENT_METADATA_USE_SESSION_DATABASE
Comportement
FALSE
Tous les schémas de toutes les bases de données sont recherchés.
TRUE
Tous les schémas de la base de données actuelle sont recherchés.
CLIENT_PREFETCH_THREADS¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Entier
- Clients
JDBC, ODBC, Python
- Description
Paramètre qui spécifie le nombre de threads utilisés par le client pour pré-extraire des ensembles de résultats volumineux. Le pilote tentera de respecter la valeur du paramètre, mais définira des valeurs minimum et maximum (en fonction des ressources de votre système) pour améliorer les performances.
- Valeurs
1
jusqu’à10
- Par défaut
4
La plupart des utilisateurs ne devraient pas avoir besoin de définir ce paramètre. Si ce paramètre n’est pas défini par l’utilisateur, le pilote démarre avec la valeur par défaut spécifiée ci-dessus, mais gère également son nombre de threads de manière prudente pour éviter d’utiliser toute la mémoire disponible.
CLIENT_RESULT_CHUNK_SIZE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Entier
- Clients
JDBC, SQL API
- Description
Paramètre spécifiant la taille maximale de chaque ensemble (ou morceau) de résultats de requête à télécharger (en MB). Le pilote JDBC télécharge les résultats de la requête en morceaux.
Voir aussi CLIENT_MEMORY_LIMIT.
- Valeurs
48
jusqu’à160
- Par défaut
160
La plupart des utilisateurs ne devraient pas avoir besoin de définir ce paramètre. Si ce paramètre n’est pas défini par l’utilisateur, le pilote démarre avec la valeur par défaut spécifiée ci-dessus, mais gère également sa mémoire de manière prudente pour éviter d’utiliser toute la mémoire disponible.
CLIENT_RESULT_COLUMN_CASE_INSENSITIVE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Clients
JDBC
- Description
Paramètre qui indique s’il faut faire correspondre le nom de colonne de façon insensible à la casse dans des méthodes
ResultSet.get*
dans JDBC.- Valeurs
TRUE
: correspond aux noms des colonnes de façon insensible à la casse.FALSE
: correspond aux noms des colonnes de façon sensible à la casse.- Par défaut
FALSE
CLIENT_SESSION_KEEP_ALIVE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Clients
JDBC, ODBC, Python, Node.js
- Description
Paramètre qui indique s’il faut forcer un utilisateur à se reconnecter après une période d’inactivité dans une session.
- Valeurs
TRUE
: Snowflake garde la session active indéfiniment, tant que la connexion est active même s’il n’y a aucune activité de l’utilisateur.FALSE
: l’utilisateur doit se reconnecter après quatre heures d’inactivité.- Par défaut
FALSE
CLIENT_SESSION_KEEP_ALIVE_HEARTBEAT_FREQUENCY¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Entier
- Clients
SnowSQL, JDBC, Python, Node.js
- Description
Nombre de secondes entre les tentatives du client pour mettre à jour le jeton pour la session.
- Valeurs
900
jusqu’à3600
- Par défaut
3600
CLIENT_TIMESTAMP_TYPE_MAPPING¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne (constante)
- Clients
N’importe quel
- Description
Spécifie la variation TIMESTAMP_* à utiliser lors de la liaison de variables d’horodatage pour les applications JDBC ou ODBC qui utilisent l’API de liaison pour charger les données.
- Valeurs
TIMESTAMP_LTZ
ouTIMESTAMP_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
ou1
(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 :
ALTER TABLE … ADD COLUMN
La définition de ce paramètre oblige toutes les colonnes créées ultérieurement dans les objets affectés (table, schéma, base de données ou compte) à disposer du classement spécifié par défaut, sauf si le classement de la colonne est explicitement mentionné dans DDL.
Par exemple, si
DEFAULT_DDL_COLLATION = 'en-ci'
, les deux instructions suivantes sont équivalentes :create table test(c1 integer, c2 string, c3 string collate 'en-cs'); create table test(c1 integer, c2 string collate 'en-ci', c3 string collate 'en-cs');
- Valeurs
Toute spécification de classement valide et prise en charge.
- Par défaut
Chaîne vide
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_INTERNAL_STAGES_PRIVATELINK¶
- Type
Compte — Ne peut être défini que pour le compte
- Type de données
Booléen
- Description
Indique si la fonction SYSTEM$GET_PRIVATELINK_CONFIG renvoie la clé
private-internal-stages
dans le résultat de la requête. La valeur correspondante dans le résultat de la requête est utilisée pendant le processus de configuration pour Connectivité privée aux zones de préparation internes de Snowflake.- Valeurs
TRUE
: renvoie la clé et la valeurprivate-internal-stages
dans le résultat de la requête.FALSE
: ne renvoie pas la clé et la valeurprivate-internal-stages
dans le résultat de la requête.- Par défaut
FALSE
ENABLE_STREAM_TASK_REPLICATION¶
- Type
Objet (pour les bases de données, les groupes de réplication et les groupes de basculement) — Peut être défini pour la base de données » du compte, le groupe de réplication » du compte, et le groupe de basculement » du compte
- Type de données
Booléen
- Description
Permet la réplication des flux et des tâches d’un compte source vers un ou plusieurs comptes cibles. Ce paramètre doit être défini pour le compte source ou l’objet primaire.
- Valeurs
TRUE
: active la réplication des flux et des tâches.FALSE
: désactive la réplication des flux et des tâches.- Par défaut
FALSE
ENABLE_UNLOAD_PHYSICAL_TYPE_OPTIMIZATION¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Spécifie s’il faut définir le schéma pour les fichiers Parquet déchargés en fonction des types de données de colonne logiques (c’est-à-dire les types dans la requête de déchargement SQL ou la table source) ou des valeurs de colonne déchargées (c’est-à-dire les plus petits types de données et la précision qui prend en charge les valeurs dans les colonnes de sortie de la table source ou de l’instruction de déchargement SQL).
- Valeurs
TRUE
: le schéma des fichiers de données Parquet déchargés est déterminé par les valeurs des colonnes de la table source ou de la requête de déchargement SQL. Snowflake optimise les colonnes de la table en réglant la plus petite précision qui accepte toutes les valeurs. Le déchargeur suit ce schéma lors de l’écriture des valeurs dans les fichiers Parquet. Le type de données et la précision d’une colonne de sortie sont réglés sur le plus petit type de données et la précision qui prennent en charge ses valeurs dans l’instruction de déchargement SQL ou la table source. Acceptez ce paramètre pour de meilleures performances et des fichiers de données plus petits.FALSE
: le schéma est déterminé par les types de données des colonnes logiques. Définissez cette valeur pour un schéma de fichier de sortie cohérent.- Par défaut
TRUE
ENFORCE_SESSION_POLICY¶
- TYPE
Compte — Ne peut être défini que pour le compte
- Type de données
Booléen
- Description
Applique une politique de session dans l’interface Web classique et au moment de l’exécution des requêtes.
- Valeurs
TRUE
: active l’application de la politique de session.FALSE
: désactive l’application de la politique de session.- Par défaut
FALSE
Pour plus d’informations, voir Application d’une politique de session.
ERROR_ON_NONDETERMINISTIC_MERGE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Indique s’il faut retourner une erreur lorsque la commande MERGE est utilisée pour mettre à jour ou supprimer une ligne cible qui joint plusieurs lignes sources et que le système ne peut pas déterminer l’action à effectuer sur la ligne cible.
- Valeurs
TRUE
: une erreur est retournée qui inclut les valeurs d’une des lignes cibles qui a causé l’erreur.FALSE
: aucune erreur n’est renvoyée et la fusion se termine avec succès, mais les résultats de la fusion ne sont pas déterministes.- Par défaut
TRUE
ERROR_ON_NONDETERMINISTIC_UPDATE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Indique s’il faut retourner une erreur lorsque la commande UPDATE est utilisée pour mettre à jour une ligne cible qui joint plusieurs lignes sources et que le système ne peut pas déterminer l’action à effectuer sur la ligne cible.
- Valeurs
TRUE
: une erreur est retournée qui inclut les valeurs d’une des lignes cibles qui a causé l’erreur.FALSE
: aucune erreur n’est retournée et la mise à jour est terminée, mais les résultats de la mise à jour ne sont pas déterministes.- Par défaut
FALSE
EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶
- Type
Compte — Ne peut être défini que pour le compte
- Type de données
Booléen
- Description
Détermine si les rôles ACCOUNTADMIN et SECURITYADMIN peuvent être utilisés comme rôle principal lors de la création d’une session Snowflake basée sur le jeton d’accès du serveur d’autorisation External OAuth.
- Valeurs
TRUE
: les rôles ACCOUNTADMIN et SECURITYADMIN sont ajoutés à la propriétéEXTERNAL_OAUTH_BLOCKED_ROLES_LIST
de l’intégration de sécurité External OAuth, ce qui signifie que ces rôles ne peuvent pas être utilisés comme rôle principal lors de la création d’une session Snowflake utilisant l’authentification External OAuth.FALSE
: retire ACCOUNTADMIN et SECURITYADMIN de la liste des rôles bloqués définis par la propriétéEXTERNAL_OAUTH_BLOCKED_ROLES_LIST
de l’intégration de sécurité External OAuth.- Par défaut
TRUE
GEOGRAPHY_OUTPUT_FORMAT¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne (constante)
- Description
Format d’affichage pour les valeurs GEOGRAPHY.
Pour EWKT et EWKB, le SRID est toujours 4326 dans la sortie. Consultez la note sur le traitement d” EWKT et d” EWKB.
- Valeurs
GeoJSON
,WKT
,WKB
,EWKT
, ouEWKB
- 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
, ouEWKB
- 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 exemple20.5
,32.25
,33.333
, etc.).- Par défaut
10.0
JDBC_TREAT_DECIMAL_AS_INT¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Indique comment JDBC traite les colonnes ayant une échelle de zéro (
0
).- Valeurs
TRUE
: JDBC traite une colonne dont l’échelle est nulle comme BIGINT.FALSE
: JDBC traite une colonne dont l’échelle est nulle comme DECIMAL.- Par défaut
TRUE
JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Spécifie comment JDBC traite les valeurs TIMESTAMP_NTZ.
Par défaut, lorsque le pilote JDBC récupère une valeur de type TIMESTAMP_NTZ dans Snowflake, le pilote convertit la valeur UTC dans le fuseau horaire actuel, en fonction de la session de l’utilisateur.
Les utilisateurs qui souhaitent conserver les valeurs de TIMESTAMP_NTZ dans le fuseau horaire UTC peuvent définir ce paramètre sur TRUE.
Ce paramètre s’applique uniquement au pilote JDBC.
- Valeurs
TRUE
: le pilote ne modifie pas la valeur TIMESTAMP_NTZ ; la valeur UTC est conservée.FALSE
: le pilote convertit la valeur TIMESTAMP_NTZ UTC vers celle du fuseau horaire actuel de l’utilisateur.- Par défaut
FALSE
JDBC_USE_SESSION_TIMEZONE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Précise si le pilote JDBC utilise le fuseau horaire du JVM ou le fuseau horaire de la session (spécifié par le paramètre TIMEZONE) pour les méthodes
getDate()
,getTime()
etgetTimestamp()
de la classeResultSet
.- 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é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 faire expirer et d’annuler l’instruction.
- Valeurs
0
à un nombre quelconque (c’est-à-dire sans limite) Une valeur de0
désactive le verrouillage d’attente (c’est-à-dire que l’instruction doit acquérir le verrouillage immédiatement ou s’arrêter). Si plusieurs ressources doivent être verrouillées par l’instruction, le délai d’attente s’applique séparément à chaque tentative de verrouillage- Par défaut
43200
(c.-à-d. 12 heures)
MAX_CONCURRENCY_LEVEL¶
- Type
Objet (pour entrepôts) — Peut être défini pour Compte » Entrepôt virtuel
- Type de données
Nombre
- Description
Spécifie le niveau de simultanéité des instructions SQL (requêtes et DML) exécutées par un entrepôt. Lorsque le niveau est atteint, l’opération exécutée varie selon que l’entrepôt virtuel est à un ou plusieurs clusters :
Simple cluster ou multi-clusters (en mode Maximisé) : Les instructions sont mises en file d’attente jusqu’à ce que les ressources déjà allouées soient libérées ou que des ressources supplémentaires soient fournies, ce qui peut être réalisé en augmentant la taille de l’entrepôt.
Multi-cluster (en mode Mise à l’échelle automatique) : Des clusters supplémentaires sont démarrés.
MAX_CONCURRENCY_LEVEL peut être utilisé conjointement avec le paramètre STATEMENT_QUEUED_TIMEOUT_IN_SECONDS pour s’assurer qu’un entrepôt n’est jamais en attente.
Notez que ce paramètre ne limite pas le nombre d’instructions qui peuvent être exécutées simultanément par un cluster d’entrepôt. Il sert plutôt de plafond pour se protéger contre la surallocation des ressources. Au fur et à mesure que chaque instruction est soumise à un entrepôt, Snowflake distribue des ressources pour exécuter l’instruction ; s’il n’y a pas assez de ressources disponibles, l’instruction est mise en file d’attente ou des clusters supplémentaires sont démarrés, selon l’entrepôt virtuel.
Le nombre réel d’instructions exécutées simultanément par un entrepôt peut être supérieur ou inférieur au niveau spécifié :
Instructions plus petites et plus basiques : D’autres instructions peuvent s’exécuter simultanément parce que des petites instructions s’exécutent généralement sur un sous-ensemble de ressources de calcul disponibles dans un entrepôt. Cela signifie qu’elles ne comptent que pour une fraction du niveau de concurrence.
Instructions plus grandes et plus complexes : Moins d’instructions peuvent être exécutées simultanément.
- Par défaut
8
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 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 de0
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, voir Comprendre et utiliser la fonction « Time Travel ».
- Valeurs
0
ou1
(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.
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 afficheexecutionState
en tant quePAUSED
. 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 afficheexecutionState
en tant queRUNNING
.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. Voir Incidence de la modification du paramètre.
Lorsqu’il est défini sur une table, un schéma ou une base de données, ce paramètre affecte uniquement l’évaluation des noms de table dans les corps des vues et des fonctions définies par l’utilisateur (UDFs). Si votre compte utilise des identificateurs à double guillemet qui doivent être traités comme insensibles à la casse et que vous prévoyez de partager une vue ou une UDF avec un compte qui traite les identificateurs à guillemet double comme sensibles à la casse, vous pouvez définir cette option sur la vue ou l’UDF que vous prévoyez de partager. Cela permet à l’autre compte de résoudre correctement les noms de table dans la vue ou l’UDF.
- Valeurs
TRUE
: les lettres des identificateurs entre guillemets doubles sont stockées et résolues comme des lettres majuscules.FALSE
: la casse des lettres dans les identificateurs entre guillemets est préservée. Snowflake résout et stocke les identificateurs dans la casse spécifiée.Pour plus d’informations, voir Résolution de l’identificateur.
- Par défaut
FALSE
Par exemple :
Identificateur |
Paramètre réglé sur |
Paramètre réglé sur |
|
---|---|---|---|
|
se résout vers : |
|
|
|
se résout vers : |
|
|
|
se résout vers : |
|
|
|
se résout vers : |
|
|
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 de0
ne spécifie aucun maximum.- Par défaut
0
SAML_IDENTITY_PROVIDER¶
- Type
Compte — Ne peut être défini que pour le compte
- Type de données
JSON
- Description
Active l’authentification fédérée. Ce paramètre obsolète permet l’authentification fédérée. Ce paramètre accepte un objet JSON, entre guillemets simples, avec les champs suivants :
{ "certificate": "", "issuer": "", "ssoUrl": "", "type" : "", "label" : "" }
Où :
certificate
Spécifie le certificat (généré par l’IdP) qui vérifie la communication entre l’IdP et Snowflake.
issuer
Indique l’émetteur/EntityID de l’IdP.
En option.
Pour savoir comment obtenir cette valeur en Okta et ADFS, voir Migration vers une intégration de sécurité SAML2.
ssoUrl
Spécifie le point de terminaison de l’URL (fourni par l’IdP) où Snowflake envoie les requêtes SAML.
type
Spécifie le type d’IdP utilisé pour l’authentification fédérée (
"OKTA"
,"ADFS"
,"Custom"
).label
Spécifie le texte du bouton de l’IdP sur la page de connexion de Snowflake. L’étiquette par défaut est
Single Sign On
. Si vous modifiez l’étiquette par défaut, celle-ci ne peut contenir que des caractères alphanumériques (en d’autres termes, les caractères spéciaux et les espaces ne sont pas pris en charge actuellement).Attention, si le champ
"type"
est"Okta"
, il n’est pas nécessaire de spécifier une valeur pour le champlabel
, car Snowflake affiche le logo Okta dans le bouton.
Pour plus d’informations, y compris des exemples de paramétrage, voir Migration vers une intégration de sécurité SAML2.
- Par défaut
Aucun
SIMULATED_DATA_SHARING_CONSUMER¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne
- Description
Spécifie le nom d’un compte consommateur à simuler pour tester/valider les données partagées, en particulier les vues sécurisées partagées. Lorsque ce paramètre est défini dans une session, les vues partagées retournent des lignes comme si elles étaient exécutées dans le compte consommateur spécifié plutôt que dans le compte fournisseur.
Note
Les simulations ne réussissent que lorsque le rôle actuel est le propriétaire de la vue. Si le rôle actuel ne possède pas la vue, les simulations échouent avec l’erreur suivante :
Shared view consumer simulation requires that the executing role owns the view.
Pour plus d’informations, voir Présentation de Secure Data Sharing et Utilisation des partages.
- Par défaut
Aucun
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 de0
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 de0
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 |
Paramètre réglé sur |
|
---|---|---|---|
|
sorties : |
|
|
|
sorties : |
|
|
|
sorties : |
|
|
|
sorties : |
|
|
SUSPEND_TASK_AFTER_NUM_FAILURES¶
- Type
Objet (pour bases de données, schémas et tâches) — Peut être défini pour Compte » Base de données » Schéma » Tâche
- Type de données
Entier
- Description
Nombre d’exécutions successives de tâches qui ont échoué après lequel une tâche autonome ou une tâche racine DAG est suspendue automatiquement. Les exécutions de tâches qui ont échoué comprennent les exécutions dans lesquelles le code SQL dans le corps de la tâche produit une erreur de l’utilisateur ou expire. Les exécutions de tâches qui sont ignorées, annulées ou qui échouent en raison d’une erreur système sont considérées comme indéterminées et ne sont pas incluses dans le compte des exécutions de tâches qui ont échoué.
Lorsque le paramètre est défini à une valeur supérieure à
0
, le comportement suivant s’applique aux exécutions de tâches autonomes ou de tâches racines du DAG :Une tâche autonome est automatiquement suspendue après que le nombre spécifié d’exécutions consécutives de la tâche ait échoué ou ait expiré.
Une tâche racine est automatiquement suspendue après l’échec de toute tâche unique dans un DAG ou après le nombre spécifié d’exécutions consécutives.
Ce paramètre s’applique aux tâches qui s’appuient sur des ressources informatiques gérées par Snowflake (c’est-à-dire le modèle de calcul sans serveur) ou sur des ressources informatiques gérées par l’utilisateur (c’est-à-dire un entrepôt virtuel).
Lorsque vous définissez explicitement la valeur du paramètre au niveau du compte, de la base de données ou du schéma, le changement est appliqué aux tâches contenues dans l’objet modifié lors de leur prochaine exécution planifiée (y compris toute tâche enfant dans une exécution de DAG en cours).
La suspension d’une tâche autonome réinitialise son compte d’échecs d’exécution. La suspension d’une tâche de DAG racine réinitialise le compte de chaque tâche dans les DAG.
- Valeurs
0
- Pas de limite supérieure.- Par défaut
0
(pas de suspension automatique)
TIMESTAMP_DAY_IS_ALWAYS_24H¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Booléen
- Description
Spécifie si la fonction DATEADD (et ses alias) considère toujours un jour comme étant exactement 24 heures pour des expressions qui couvrent plusieurs jours.
- Valeurs
TRUE
: une journée s’étale toujours exactement sur 24 heures.FALSE
: une journée ne s’étale pas toujours sur 24 heures.- Par défaut
FALSE
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
ouTIMESTAMP_TZ
- Par défaut
TIMESTAMP_NTZ
TIMESTAMP_TZ_OUTPUT_FORMAT¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne
- Description
Spécifie le format d’affichage pour le type de données TIMESTAMP_TZ. Si aucun format n’est spécifié, la valeur par défaut est TIMESTAMP_OUTPUT_FORMAT. Pour plus d’informations, voir Entrée/sortie de date et d’heure.
- Valeurs
Tout format d’horodatage valide et pris en charge
- Par défaut
Aucun
TIMEZONE¶
- Type
Session — Peut être défini pour Compte » Utilisateur » Session
- Type de données
Chaîne (constante)
- Description
Indique le fuseau horaire de la session.
- Valeurs
Vous pouvez spécifier un nom de fuseau horaire ou un nom de lien de la version 2021a de la base de données de fuseaux horaires IANA (par exemple,
America/Los_Angeles
,Europe/London
,UTC
,Etc/GMT
, etc.).- Par défaut
America/Los_Angeles
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 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 |
Paramètre réglé sur |
Paramètre réglé sur |
Paramètre réglé sur |
Paramètre réglé sur |
|
---|---|---|---|---|---|---|
|
devient : |
|
|
|
|
|
|
devient : |
|
|
|
|
|
|
devient : |
|
|
|
|
|
|
devient : |
|
|
|
|
|
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
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 deXXLARGE
.- 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.