snow spcs service events¶
Nota
Você pode usar os Snowpark Container Services da Snowflake CLI somente se você tiver as permissões necessárias para usar o Snowpark Container Services.
Recupere eventos de plataforma para um contêiner de serviço.
Sintaxe¶
snow spcs service events
<name>
--container-name <container_name>
--instance-id <instance_id>
--since <since>
--until <until>
--first <first>
--last <last>
--all
--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>
--format <format>
--verbose
--debug
--silent
Argumentos¶
name
Identificador do serviço; por exemplo: meu_serviço.
Opções¶
--container-name TEXT
Nome do contêiner.
--instance-id TEXT
ID da instância de serviço, começando com 0.
--since TEXT
Busque eventos que ocorreram após esse horário, na sintaxe de intervalo do Snowflake.
--until TEXT
Busque eventos que ocorreram antes desse horário, na sintaxe de intervalo do Snowflake.
--first INTEGER
Busque apenas os primeiros N eventos. Não pode ser usado com –last.
--last INTEGER
Buscar apenas os últimos N eventos. Não pode ser usado com –first.
--all
Obtenha todas as colunas. Padrão: falso.
--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.
--private-key-file, --private-key-path TEXT
Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token-file-path TEXT
Caminho para o arquivo que contém o 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
Execução do teste de diagnóstico do conector Python. Padrão: falso.
--diag-log-path TEXT
Caminho do relatório de diagnóstico. Padrão: <temporary_directory>.
--diag-allowlist-path TEXT
Caminho do relatório de diagnóstico para a lista de permissões opcional.
--format [TABLE|JSON]
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.
--help
Exibe o texto de ajuda para este comando.
Notas de uso¶
Nota
Para usar esse comando, você deve ativar o recurso enable_spcs_service_events
no seu arquivo config.toml
, conforme mostrado:
[cli.features]
enable_spcs_service_events = true
Os seguintes parâmetros são necessários:
name
--container-name <name>
--instance-id <ID>
Você pode usar os filtros baseados em tempo
--since
e--until
para retornar eventos de um período de tempo específico. Você pode especificar a hora como uma hora relativa, como, por exemplo,1h
(hora) ou2d
(dias).Você pode usar as opções
--first
e--last
para retornar apenas um número específico de eventos. Observe que essas opções são mutuamente exclusivas.
Exemplos¶
Recuperar todos os eventos de um serviço específico:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
Recuperar um subconjunto de eventos para um serviço específico:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --first 5 snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 5
Buscar eventos mais recentes do que os últimos cinco minutos:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'
Buscar eventos com mais de uma hora:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
Recuperar todos os eventos com todas as colunas exibidas:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1
TIMESTAMP | DATABASE NAME | SCHEMA NAME | SERVICE NAME | INSTANCE NAME | CONTAINER NAME | SEVERITY | EVENT NAME | EVENT VALUE -- | -- | -- | -- | -- | -- | -- | -- | -- 2024-12-13 10:01:52.808692 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" } 2024-12-14 22:27:25.420489 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
Recuperar eventos formatados para a saída JSON:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json
[ { "TIMESTAMP": "2024-12-14T22:27:25.420489", "DATABASE NAME": "TESTDB", "SCHEMA NAME": "PUBLIC", "SERVICE NAME": "LOG_EVENT", "INSTANCE NAME": "0", "CONTAINER NAME": "log-printer", "SEVERITY": "INFO", "EVENT NAME": "CONTAINER.STATUS_CHANGE", "EVENT VALUE": "{\n \"message\": \"Running\",\n \"status\": \"READY\"\n}" } ]