Categorias:: Funções do monitor de modelos

MODEL_MONITOR_DRIFT_METRIC¶

Obtém métricas de desvio 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_DRIFT_METRIC(
  <model_monitor_name>, <drift_metric_name>, <column_name>
  [ , <granularity> [ , <start_time>  [ , <end_time> ] ] ]
)

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.

drift_metric_name

Nome da métrica.

Valores válidos:

'JENSEN_SHANNON'
'DIFFERENCE_OF_MEANS'
'WASSERSTEIN'

column_name

Nome da coluna usada para calcular o desvio.

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.

Retornos¶

Coluna	Descrição	Exemplo de valores
`EVENT_TIMESTAMP`	Carimbo de data/hora no início do intervalo de tempo.	`2024-01-01 00:00:00.000`
`METRIC_VALUE`	Valor da métrica dentro do intervalo de tempo especificado.	`5`
`COL_COUNT_USED`	Número de registros usados para calcular a métrica.	`100`
`COL_COUNT_UNUSED`	Número de registros excluídos do cálculo da métrica.	`10`
`BASELINE_COL_COUNT_USED`	Número de registros usados para calcular a métrica.	`10`
`BASELINE_COL_COUNT_UNUSED`	Número de registros excluídos do cálculo da métrica.	`0`
`METRIC_NAME`	Nome da métrica de desvio que foi computada.	`DIFFERENCE_OF_MEANS`
`COLUMN_NAME`	Nome da coluna para a qual a métrica de desvio foi calculada.	`FEATURE_NAME`

Notas de uso¶

O monitor de modelo deve ter uma linha de base definida para que a métrica de desvio seja calculada.

Você poderá encontrar erros se:

Não definir uma linha de base para o monitor do modelo.
Solicitar uma métrica de desvio numérico para um recurso não numérico.
Usar uma métrica de desvio que não existe no monitor de modelo.

Exemplos¶

O exemplo a seguir obtém as diferenças de métrica de desvio de médias para MY_MONITOR em um período de um dia:

SELECT * FROM TABLE(MODEL_MONITOR_DRIFT_METRIC(
'MY_MONITOR', 'DIFFERENCE_OF_MEANS', '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 desvio de Jensen-Shannon para MY_MONITOR nos últimos 30 dias:

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

Copy