Journaux Snow¶
Récupère les journaux pour un objet donné.
Syntaxe¶
snow logs
<object_type>
<object_name>
--from <from_>
--to <to>
--refresh <refresh_time>
--table <event_table>
--log-level <log_level>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--oauth-client-id <oauth_client_id>
--oauth-client-secret <oauth_client_secret>
--oauth-authorization-url <oauth_authorization_url>
--oauth-token-request-url <oauth_token_request_url>
--oauth-redirect-uri <oauth_redirect_uri>
--oauth-scope <oauth_scope>
--oauth-disable-pkce
--oauth-enable-refresh-tokens
--oauth-enable-single-use-refresh-tokens
--client-store-temporary-credential
--format <format>
--verbose
--debug
--silent
--enhanced-exit-codes
Arguments¶
object_type
Type d’objet. Par exemple, table, base de données, pool de calcul.
object_name
Nom de l’objet.
Options¶
--from TEXT
Heure de début des journaux à récupérer. Accepte tous les formats ISO8061.
--to TEXT
Heure de fin des journaux à récupérer. Accepte tous les formats ISO8061.
--refresh INTEGER
Si définis, les journaux seront diffusés avec le temps d’actualisation donné en secondes.
--table TEXT
Table à interroger pour les journaux. Si elle n’est pas fournie, la table par défaut sera utilisée.
--log-level TEXT
Niveau de journalisation servant à filtrer. Si non fourni, INFO sera utilisé. Par défaut : INFO.
--connection, -c, --environment TEXT
Nom de la connexion, tel que défini dans votre fichier
config.toml
. Défaut :défaut
.--host TEXT
Adresse de l’hôte pour la connexion. Remplace la valeur spécifiée pour la connexion.
--port INTEGER
Port pour la connexion. Remplace la valeur spécifiée pour la connexion.
--account, --accountname TEXT
Nom attribué à votre compte Snowflake. Remplace la valeur spécifiée pour la connexion.
--user, --username TEXT
Nom d’utilisateur pour se connecter à Snowflake. Remplace la valeur spécifiée pour la connexion.
--password TEXT
Mot de passe Snowflake. Remplace la valeur spécifiée pour la connexion.
--authenticator TEXT
Authentificateur Snowflake. Remplace la valeur spécifiée pour la connexion.
--private-key-file, --private-key-path TEXT
Chemin du fichier de clé privée Snowflake. Remplace la valeur spécifiée pour la connexion.
--token-file-path TEXT
Chemin d’accès au fichier contenant un jeton OAuth à utiliser lors de la connexion à Snowflake.
--database, --dbname TEXT
Base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--schema, --schemaname TEXT
Schéma de la base de données à utiliser. Remplace la valeur spécifiée pour la connexion.
--role, --rolename TEXT
Rôle à utiliser. Remplace la valeur spécifiée pour la connexion.
--warehouse TEXT
Entrepôt à utiliser. Remplace la valeur spécifiée pour la connexion.
--temporary-connection, -x
Utilise une connexion définie avec les paramètres de la ligne de commande, au lieu d’une connexion définie dans la configuration. Par défaut : false.
--mfa-passcode TEXT
Jeton à utiliser pour l’authentification multifactorielle (MFA)
--enable-diag
Indique s’il faut générer un rapport de diagnostic de la connexion. Par défaut : false.
--diag-log-path TEXT
Chemin d’accès au rapport généré. Il s’agit du répertoire temporaire du système par défaut. Par défaut : <system_temporary_directory>.
--diag-allowlist-path TEXT
Chemin d’accès à un fichier JSON contenant les paramètres de la liste d’autorisations.
--oauth-client-id TEXT
Valeur de l’identifiant du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-client-secret TEXT
Valeur du secret du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.
--oauth-authorization-url TEXT
Point de terminaison du fournisseur d’identité fournissant le code d’autorisation au pilote.
--oauth-token-request-url TEXT
Point de terminaison du fournisseur d’identité fournissant les jetons d’accès au pilote.
--oauth-redirect-uri TEXT
URI à utiliser pour la redirection du code d’autorisation.
--oauth-scope TEXT
Champ d’application demandé dans la requête d’autorisation du fournisseur d’identité.
--oauth-disable-pkce
Désactive la clé de preuve pour l’échange de code (PKCE). Par défaut :
False
.--oauth-enable-refresh-tokens
Permet une réauthentification silencieuse lorsque le jeton d’accès actuel n’est plus valable. Par défaut :
False
.--oauth-enable-single-use-refresh-tokens
Indique s’il faut choisir une sémantique de jeton d’actualisation à usage unique. Par défaut :
False
.--client-store-temporary-credential
Enregistrez les identifiants de connexion temporaires.
--format [TABLE|JSON]
Spécifie le format de sortie. Par défaut : TABLE.
--verbose, -v
Affiche les entrées de journal pour les niveaux de journalisation
info
et supérieurs. Par défaut : false.--debug
Affiche les entrées de journal pour les niveaux de journalisation
debug
et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.--silent
Désactive la sortie intermédiaire vers la console. Par défaut : false.
--enhanced-exit-codes
Différenciez les codes d’erreur de sortie en fonction du type d’erreur. Par défaut : false.
--help
Affiche le texte d’aide de cette commande.
Notes sur l’utilisation¶
La commande snow logs accède à une table d’événements et récupère les journaux pour une entité spécifiée. Par défaut, la commande recherche les journaux dans la table d’événements par défaut, qui est SNOWFLAKE.TELEMETRY.EVENTS. Cependant, vous pouvez sélectionner une table différente avec l’option --table
. Pour plus d’informations sur les tables d’événements et les valeurs par défaut, voir Créer une table d’événements.
Vous pouvez utiliser les options --from
et -to
pour filtrer la période au cours de laquelle les journaux doivent être récupérés. Vous pouvez utiliser l’une ou l’autre de ces options, mais si vous utilisez les deux, l’heure --from
doit être antérieure à l’heure --to
. Les valeurs des temps que vous fournissez doivent être conformes à la norme ISO 8601. Pour plus d’informations, vous pouvez également consulter la documentation de la méthode Python datetime.fromisoformat().
L’option --log-level
vous permet de filtrer le message par niveau de gravité. Certains journaux ne comportent pas de niveau de gravité. Dans ce cas, les messages sont affichés pour toutes les valeurs --log-level
.
Si vous souhaitez des mises à jour continues des journaux, vous pouvez utiliser l’option --refresh
et indiquer le nombre de secondes entre les récupérations. Vous ne pouvez pas utiliser simultanément les options --refresh
et --to
. Pour arrêter la diffusion des journaux, utilisez la clé par défaut de votre système Keyboardinterrupt
, comme CTRL-c
dans un terminal Mac.
Exemples¶
Affichez les journaux du pool de calcul pour une période allant d’une heure de début spécifiée à maintenant :
snow logs compute_pool MY_COMPUTE_POOL --from '2025-04-01 09:00:31'
10.12.71.201 - - [01/Apr/2025 09:46:07] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:09] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:14] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:19] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:24] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:29] "GET /healthcheck HTTP/1.1" 200 - 10.12.71.201 - - [01/Apr/2025 09:46:34] "GET /healthcheck HTTP/1.1" 200 -
Affichez les journaux d’une table d’événements spécifique :
snow logs compute_pool SNOWCLI_COMPUTE_POOL --table "my_db.my_schema.my_events"
Affichez les journaux pour un intervalle de temps où l’heure de début est postérieure à l’heure de fin, ce qui provoque une erreur :
snow logs compute_pool SNOWCLI_COMPUTE_POOL --from '2025-03-24 12:00:31' --to "2024-01-03 00:00:00"
╭─ Error ───────────────────────────────────────────────────────── │ From_time cannot be later than to_time. Please check the values ╰─────────────────────────────────────────────────────────────────