Categorias:: Funções do monitor de modelos

MODEL_MONITOR_STAT_METRIC¶

Obtém métricas de contagem de um monitor de modelos. Cada monitor de modelo monitora um modelo de aprendizado de máquina.

Consulte também:: Consultar resultados de monitoramento para obter mais informações.

Sintaxe¶

MODEL_MONITOR_STAT_METRIC(<model_monitor_name>, <stat_metric_name>, <column_name>
    [, <granularity> [, <start_time>  [, <end_time> [, <extra_args> ] ] ] ] )

Copy

Argumentos¶

Obrigatório:

MODEL_MONITOR_NAME

Nome do monitor de modelo usado para calcular a métrica.

Valores válidos:

Uma cadeia de caracteres que é o nome do monitor de modelo. Pode ser um nome simples ou totalmente qualificado.

METRIC_NAME

Nome da métrica.

Valores válidos:

'COUNT'

'COUNT_NULL'

COLUMN_NAME

Nome da coluna usada para calcular a contagem.

Valores válidos:

Qualquer cadeia de caracteres que exista como coluna de recurso, coluna de previsão ou coluna real no monitor de modelo.

Opcional:

GRANULARITY

Granularidade do intervalo de tempo que está sendo consultado. O valor padrão é 1 DAY.

Valores válidos:

'<num> DAY'

'<num> WEEK'

'<num> MONTH'

'<num> QUARTER'

'<num> YEAR'

'ALL'

NULL

START_TIME

Início do intervalo de tempo usado para calcular a métrica. O valor padrão é 60 dias antes da hora atual e é calculado sempre que você chama a função.

Valores válidos:

Uma expressão de carimbo de data/hora ou NULL.

END_TIME

Fim do intervalo de tempo usado para calcular a métrica. O valor padrão é a hora atual e é calculado sempre que você chama a função.

Valores válidos:

Uma expressão de carimbo de data/hora ou NULL.

EXTRA_ARGS

Argumentos adicionais para consultas específicas de segmento. Esse parâmetro é opcional; se não for fornecido, a consulta retornará métricas para todos os dados (consulta não segmentada).

Valores válidos: Uma cadeia de caracteres no formato JSON especificando pares de coluna e valor do segmento: '{"SEGMENTS": [{"column": "<segment_column_name>", "value": "<segment_value>"}]}'

Nota

Atualmente, as consultas de segmento aceitam apenas um par coluna:valor do segmento por consulta. Não é possível consultar vários segmentos simultaneamente em uma única chamada de função.

Para obter mais informações sobre segmentos, consulte ML Observability: monitoramento do comportamento do modelo ao longo do tempo.

Retornos¶

Coluna	Descrição
`EVENT_TIMESTAMP`	Carimbo de data/hora no início do intervalo de tempo.
`METRIC_VALUE`	Valor da métrica dentro do intervalo de tempo especificado.
`METRIC_NAME`	Nome da métrica que foi computada.
`COLUMN_NAME`	Nome da coluna para a qual a métrica de estatísticas foi calculada.
`SEGMENT_COLUMN`	Nome da coluna do segmento para a qual a métrica é calculada (ou NULL para consultas sem segmento).
`SEGMENT_VALUE`	Valor do segmento para o qual a métrica é calculada (ou NULL para consultas sem segmento).

Notas de uso¶

O monitor modelo deve ter a coluna que está sendo usada para calcular a métrica.

Se os valores especificados para column_name ou model_monitor_name diferenciam maiúsculas de minúsculas ou contêm caracteres ou espaços especiais, coloque-os entre aspas duplas. Você deve colocar as aspas duplas dentro de aspas simples. Por exemplo, '"<example_model_monitor_name>"'.

Sem as aspas duplas nesses dois campos, a diferenciação entre maiúsculas e minúsculas não será considerada em column_name ou model_monitor_name.

Para minimizar o impacto potencial das alterações no esquema, atualize suas consultas para selecionar explicitamente apenas as colunas necessárias em vez de usar um curinga (*).

Exemplos¶

O exemplo a seguir obtém métricas de contagem para o monitor de modelo e o intervalo de tempo especificados:

SELECT * FROM TABLE(MODEL_MONITOR_STAT_METRIC(
'MY_MONITOR', 'COUNT', 'MODEL_PREDICTION', '1 DAY', TO_TIMESTAMP_TZ('2024-01-01')
, TO_TIMESTAMP_TZ('2024-01-02'))
)

Copy

O exemplo a seguir obtém a métrica de contagem para MY_MONITOR nos últimos 30 dias:

SELECT * FROM TABLE(MODEL_MONITOR_STAT_METRIC(
'MY_MONITOR', 'COUNT', 'MODEL_PREDICTION', '1 DAY', DATEADD('DAY', -30, CURRENT_DATE()), CURRENT_DATE())
)

Copy