<service_name>!SPCS_GET_METRICS¶

Retorna as métricas que o Snowflake coletou para o serviço especificado. Para obter mais informações, consulte Métricas da plataforma de acesso.

Nota

A função é compatível apenas com serviços e trabalhos criados na versão 9.20 ou posterior.

Consulte também:: Serviços de monitoramento

Sintaxe¶

<service_name>!SPCS_GET_METRICS(
    [ START_TIME => <constant_expr> ],
    [ END_TIME => <constant_expr> ] )

Copy

Argumentos¶

START_TIME => constant_expr

Hora de início (no formato TIMESTAMP_LTZ) para o intervalo de tempo a partir do qual recuperar as métricas. Para as funções disponíveis para construção de dados, hora e carimbo de data/hora, consulte Funções de data e hora.

Se START_TIME não for especificado, o padrão será um dia atrás.

END_TIME => constant_expr

Hora de término (no formato TIMESTAMP_LTZ) para o intervalo de tempo a partir do qual recuperar as métricas.

Se END_TIME não for especificado, o padrão será o carimbo de data/hora atual.

Saída¶

A função retorna as seguintes colunas:

Coluna	Tipo de dados	Descrição
`TIMESTAMP`	TIMESTAMP_NTZ	Carimbo de data/hora no horário universal coordenado (UTC) em que o Snowflake coletou a métrica.
`METRIC_NAME`	VARCHAR	Nome da métrica.
`VALUE`	VARCHAR	Valor da métrica.
`UNIT`	VARCHAR	Unidade da métrica retornada.
`INSTANCE_ID`	NUMBER	Nome da instância de serviço se a métrica estiver relacionada à instância de serviço.
`CONTAINER_NAME`	VARCHAR	Nome do contêiner se a métrica estiver relacionada ao contêiner. Por exemplo, uma métrica de volume não terá o nome do contêiner.
`RESOURCE`	VARCHAR	Hardware (por exemplo, GPU) ao qual a métrica se refere. Esta coluna não é preenchida.
`RECORD`	OBJECT	Pares chave-valor que fornecem informações de métricas.
`RECORD_ATTRIBUTES`	OBJECT	Pares chave-valor que fornecem informações adicionais sobre a métrica.

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio	Objeto	Notas
OWNERSHIP	Serviço

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso¶

Pode levar alguns minutos antes que as métricas apareçam na saída.

Exemplos¶

Recuperar as métricas que o Snowflake coletou para o trabalho my_test_job no último dia, o padrão.

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS());

Copy

Recuperar as métricas que o Snowflake coletou para o trabalho my_test_job nos últimos três dias.

SELECT * from TABLE(my_test_job!SPCS_GET_METRICS(start_time => DATEADD('day', -3, CURRENT_TIMESTAMP())));

Copy

Recuperar métricas do último dia para a instância 0 do trabalho spcs_get_metrics no contêiner chamado main.

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS())
 WHERE instance_id = 0 AND container_name = 'main';

Copy