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
Copy

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
Copy
  • 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) ou 2d (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
    
    Copy
  • 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
    
    Copy
  • 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'
    
    Copy
  • Buscar eventos com mais de uma hora:

    snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
    
    Copy
  • 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
    
    Copy
    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
    
    Copy
    [
         {
             "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}"
         }
     ]