MODEL_MONITOR_DRIFT_METRIC¶

Syntaxe¶

MODEL_MONITOR_DRIFT_METRIC(
  <model_monitor_name>, <drift_metric_name>, <column_name>
  [ , <granularity> [ , <start_time>  [ , <end_time> [ , <extra_args> ] ] ] ]
)

Arguments¶

Obligatoire :

model_monitor_name

Nom du moniteur de modèle utilisé pour calculer la métrique.

Valeurs valides : une chaîne qui est le nom du moniteur du modèle. Il peut s’agir d’un nom simple ou entièrement qualifié.

drift_metric_name

Nom de la métrique.

Valeurs valides :

• 'JENSEN_SHANNON'

• 'DIFFERENCE_OF_MEANS'

• 'WASSERSTEIN'

• 'POPULATION_STABILITY_INDEX'

column_name

Nom de la colonne utilisée pour calculer la dérive.

Valeurs valides : toute chaîne existant en tant que colonne de fonction, colonne de prédiction ou colonne réelle dans le moniteur de modèle.

Facultatif :

granularity

Granularité de l’intervalle de temps faisant l’objet de la requête. La valeur par défaut est 1 DAY.

Valeurs valides :

• '<nb> DAY'

• '<nb> WEEK'

• '<nb> MONTH'

• '<nb> QUARTER'

• '<nb> YEAR'

• 'ALL'

• NULL

start_time

Début de l’intervalle de temps utilisé pour calculer la métrique. La valeur par défaut est de 60 jours avant l’heure actuelle et est calculée chaque fois que vous appelez la fonction.

Valeurs valides : Une expression d’horodatage ou NULL.

end_time

Fin de l’intervalle de temps utilisé pour calculer la métrique. La valeur par défaut est l’heure actuelle et est calculée à chaque fois que vous appelez la fonction.

Valeurs valides : Une expression d’horodatage ou NULL.

extra_args

Arguments supplémentaires pour les requêtes spécifiques au segment. Ce paramètre est facultatif ; sil n’est pas fourni, la requête renvoie des métriques pour toutes les données (requête sans segment).

Valeurs valides : Une chaîne au format JSON spécifiant des paires colonne et valeur de segment : '{"SEGMENTS": [{"column": "<nom_colonne_segment>", "value": "<segment_value>"}]}'

Note

Actuellement, les requêtes de segment ne prennent en charge qu’une seule paire colonne et valeur de segment par requête. Vous ne pouvez pas interroger plusieurs segments simultanément dans un seul appel de fonction.

Pour plus d’informations sur les segments, consultez ML Observability : suivi du comportement du modèle dans le temps.

Renvoie¶

Notes sur l’utilisation¶

Le moniteur du modèle doit avoir un ensemble de paramètres de base pour que la mesure de la dérive soit calculée.

Vous risquez de rencontrer des erreurs si vous :

• N’établissez pas de paramètre pour le moniteur du modèle.

• Requête d’une mesure de dérive numérique pour une fonction non numérique.

• Utilisez une mesure de dérive qui n’existe pas dans le moniteur de modèle.

Si les valeurs que vous avez spécifiées pour column_name ou model_monitor_name sont sensibles à la casse ou contiennent des caractères spéciaux ou des espaces, placez-les entre des guillemets doubles. Vous devez placer les guillemets doubles entre les guillemets simples, par exemple '"<model_monitor_name>"'.

Si des guillemets doubles ne sont pas ajoutés dans ces deux champs, column_name ou model_monitor_name sera considéré comme insensible à la casse.

Pour minimiser l’impact potentiel des modifications de schéma, mettez à jour vos requêtes en sélectionnant explicitement les colonnes nécessaires au lieu d’utiliser un caractère générique (*).

Exemples¶

L’exemple suivant permet d’obtenir la métrique de dérive des différences de moyennes pour MY_MONITOR sur une période d’un jour :

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'))
)

L’exemple suivant permet d’obtenir la métrique de dérive Jensen-Shannon pour MY_MONITOR au cours des 30 derniers jours :

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