snow logs

Recupera os logs de um determinado objeto.

Sintaxe

snow logs
  <object_type>
  <object_name>
  --from <from_>
  --to <to>
  --refresh <refresh_time>
  --table <event_table>
  --log-level <log_level>
  --partial
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --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
Copy

Argumentos

object_type

Tipo de objeto. Por exemplo, tabela, banco de dados, pool de computação.

object_name

Nome do objeto.

Opções

--from TEXT

A hora de início dos logs a serem recuperados. Aceita todos os formatos ISO8061.

--to TEXT

A hora de término dos logs a serem recuperados. Aceita todos os formatos ISO8061.

--refresh INTEGER

Se definido, os logs serão transmitidos com o tempo de atualização fornecido em segundos.

--table TEXT

A tabela para consultar os logs. Se não for fornecida, será usada a tabela padrão.

--log-level TEXT

O nível de log a ser filtrado. Se não for fornecido, será usado INFO. Padrão: INFO.

--partial

Ativar a correspondência parcial e sem distinção entre maiúsculas e minúsculas para nomes de objetos. Padrão: False.

--connection, -c, --environment TEXT

Nome da conexão, conforme definido no arquivo config.toml. Padrão: default.

--host TEXT

Endereço do host da conexão. Substitui o valor especificado para a conexão.

--port INTEGER

Porta para a conexão. Substitui o valor especificado para a conexão.

--account, --accountname TEXT

Nome atribuído à sua conta Snowflake. Substitui o valor especificado para a conexão.

--user, --username TEXT

Nome de usuário para se conectar ao Snowflake. Substitui o valor especificado para a conexão.

--password TEXT

Senha do Snowflake. Substitui o valor especificado para a conexão.

--authenticator TEXT

Autenticador Snowflake. Substitui o valor especificado para a conexão.

--workload-identity-provider TEXT

Provedor de identidade de carga de trabalho (AWS, AZURE, GCP, OIDC). Substitui o valor especificado para a conexão.

--private-key-file, --private-key-path TEXT

Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.

--token TEXT

Token OAuth a ser usado ao se conectar ao Snowflake.

--token-file-path TEXT

Caminho para o arquivo com um token OAuth a ser usado ao se conectar ao Snowflake.

--database, --dbname TEXT

Banco de dados a ser usado. Substitui o valor especificado para a conexão.

--schema, --schemaname TEXT

Esquema de banco de dados a ser usado. Substitui o valor especificado para a conexão.

--role, --rolename TEXT

Função a ser usada. Substitui o valor especificado para a conexão.

--warehouse TEXT

Warehouse a ser usado. Substitui o valor especificado para a conexão.

--temporary-connection, -x

Usa uma conexão definida com parâmetros de linha de comando, em vez de uma definida na configuração. Padrão: falso.

--mfa-passcode TEXT

Token a ser usado para autenticação multifator (MFA).

--enable-diag

Se deve gerar um relatório de diagnóstico de conexão. Padrão: falso.

--diag-log-path TEXT

Caminho para o relatório gerado. O padrão é o diretório temporário do sistema. Padrão: <system_temporary_directory>.

--diag-allowlist-path TEXT

Caminho para um arquivo JSON que contém parâmetros da lista de permissões.

--oauth-client-id TEXT

Valor do ID de cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-client-secret TEXT

Valor do segredo do cliente fornecido pelo provedor de identidade para integração com o Snowflake.

--oauth-authorization-url TEXT

Ponto de extremidade do provedor de identidade que fornece o código de autorização ao driver.

--oauth-token-request-url TEXT

Ponto de extremidade do provedor de identidade que fornece os tokens de acesso ao driver.

--oauth-redirect-uri TEXT

URI a ser usado para redirecionamento de código de autorização.

--oauth-scope TEXT

Escopo solicitado na solicitação de autorização do provedor de identidade.

--oauth-disable-pkce

Desativa o Proof Key for Code Exchange (PKCE). Padrão: False.

--oauth-enable-refresh-tokens

Permite uma reautenticação silenciosa quando o token de acesso real fica desatualizado. Padrão: False.

--oauth-enable-single-use-refresh-tokens

Se o usuário deve optar pela semântica de token de atualização de uso único. Padrão: False.

--client-store-temporary-credential

Armazena a credencial temporária.

--format [TABLE|JSON|JSON_EXT|CSV]

Especifica o formato de saída. Padrão: TABLE.

--verbose, -v

Exibe entradas de log para os níveis de log info e superiores. Padrão: falso.

--debug

Exibe entradas de log para níveis de log de depuração e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.

--silent

Desliga a saída intermediária para o console. Padrão: falso.

--enhanced-exit-codes

Diferencia os códigos de erro de saída com base no tipo de falha. Padrão: falso.

--help

Exibe o texto de ajuda para este comando.

Notas de uso

O comando snow logs acessa uma tabela de eventos e recupera os logs de uma entidade especificada. O comando procura os logs na tabela de eventos padrão, que é SNOWFLAKE.TELEMETRY.EVENTS; no entanto, é possível selecionar uma tabela diferente usando a opção --table. Para mais informações sobre tabelas de evento e valores padrão, consulte Criação de uma tabela de eventos.

Você pode usar as opções --from e -to para filtrar o período durante o qual os logs serão recuperados. Você pode usar uma ou ambas as opções, mas se usar ambas, o horário de --from deve ser anterior ao horário de --to. Os valores de tempo fornecidos por você devem estar em conformidade com a norma ISO 8601. Para obter mais informações, você também pode consultar a documentação do método Python datetime.fromisoformat().

A opção --log-level permite que você filtre as mensagens pelo nível de gravidade. Alguns logs não incluem um nível de gravidade. Nesses casos, as mensagens são exibidas para todos os valores --log-level.

A opção --partial permite recuperar logs com uma cadeia de caracteres específica usando uma correspondência que não diferencia maiúsculas de minúsculas. Por exemplo, se você pesquisar logs contendo myDb usando essa opção, os resultados incluirão logs de bancos de dados chamados mydb, MYDB e MyDb. Sem essa opção, seriam retornados apenas logs de bancos de dados com o nome exato myDb.

Se quiser atualizações contínuas para os logs, você pode usar a opção --refresh e fornecer o número de segundos entre as recuperações. Você não pode usar as opções --refresh e --to juntas. Para interromper a transmissão dos logs, use a tecla padrão do sistema Keyboardinterrupt, como CTRL-c em um Terminal Mac.

Exemplos

  • Exibir os logs do pool de computação para um período desde um horário inicial especificado até agora:

    snow logs compute_pool MY_COMPUTE_POOL --from '2025-04-01 09:00:31'
    Copy
    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 -

  • Exibir os logs de uma tabela de eventos específica:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --table "my_db.my_schema.my_events"
    Copy

  • Exibir os logs de todos os bancos de dados com myDb usando uma correspondência parcial que não diferencia maiúsculas e minúsculas:

    snow logs database myDb --partial
    Copy

  • Exibir os logs para um intervalo de tempo em que a hora de início é posterior à hora de término, o que causa um erro:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --from '2025-03-24 12:00:31' --to "2024-01-03 00:00:00"
    Copy
    ╭─ Error ─────────────────────────────────────────────────────────
│ From_time cannot be later than to_time. Please check the values
╰─────────────────────────────────────────────────────────────────
Linguagem: Português