DESCRIBE MODEL MONITOR¶

Affiche des informations sur un moniteur de modèle spécifique. Cette commande affiche toutes les informations présentées par la commande SHOW MODEL MONITORS, ainsi que des informations supplémentaires.

DESCRIBE peut être abrégé en DESC.

Voir aussi :: CREATE MODEL MONITOR, ALTER MODEL MONITOR, SHOW MODEL MONITORS, DROP MODEL MONITOR

Syntaxe¶

{ DESCRIBE | DESC } MODEL MONITOR <monitor_name>

Copy

Paramètres¶

monitor_name

Spécifie l’identificateur du moniteur de modèle à décrire.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Sortie¶

La sortie de commande fournit les propriétés du moniteur de modèle et les métadonnées dans les colonnes suivantes :

Colonne	Description
`created_on`	Date et heure de création du moniteur de modèle.
`name`	Nom du moniteur de modèle.
`database_name`	Base de données dans laquelle le moniteur de modèle est stocké.
`schema_name`	Schéma dans lequel le moniteur de modèle est stocké.
`warehouse_name`	Entrepôt utilisé pour surveiller le modèle.
`refresh_interval`	Intervalle d’actualisation (latence cible) pour déclencher l’actualisation du moniteur de modèle.
`aggregation_window`	Fenêtre d’agrégation pour le calcul des métriques.
`model_task`	Tâche du modèle surveillé, soit TABULAR_BINARY_CLASSIFICATION ou TABULAR_REGRESSION.
`monitor_state`	État du moniteur de modèle : ACTIVE : le moniteur du modèle est actif et fonctionne correctement. SUSPENDED : la surveillance du modèle est mise en pause. PARTIALLY_SUSPENDED : une condition d’erreur dans laquelle l’une des tables sous-jacentes a cessé de s’actualiser à l’intervalle prévu. Voir DESCRIBE pour plus de détails. UNKNOWN : une condition d’erreur dans laquelle l’état des tables sous-jacentes ne peut être identifié.
`source`	Représentation sous forme de chaîne d’un objet JSON détaillant la table ou la vue source sur laquelle les agrégations sont basées. Si la table n’existe pas ou n’est pas accessible, la valeur est une chaîne vide. Voir Spécification de l’objet JSON de table.
`baseline`	Représentation sous forme de chaîne d’un objet JSON détaillant la table de base utilisée pour la surveillance, dont un clone est intégré dans l’objet du moniteur de modèle. Voir Spécification de l’objet JSON de table.
`model`	Représentation sous forme de chaîne d’un objet JSON contenant des informations spécifiques sur le modèle surveillé. Voir Spécification de l’objet JSON de modèle.
`comment`	Commentaire sur le moniteur de modèle.
Les colonnes suivantes sont les colonnes supplémentaires affichées par DESCRIBE par rapport à SHOW
`aggregation_status`	Représentation sous forme de chaîne d’un objet JSON qui contient le statut d’agrégation de chaque type de table dynamique imbriquée. La clé peut être SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. La valeur peut être ACTIVE ou SUSPENDED.
`aggregation_last_error`	Une représentation sous forme de chaîne d’un objet JSON qui contient la dernière erreur de chaque type de table dynamique imbriquée. La clé peut être SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. La valeur est un message d’erreur ou une chaîne vide si la dernière exécution s’est terminée avec succès.
`aggregation_last_data_timestamp`	Représentation sous forme de chaîne d’un objet JSON contenant la dernière mise à jour du type de la table dynamique imbriquée. La clé peut être SOURCE_AGGREGATED ou ACCURACY_AGGREGATED. La valeur est un horodatage.
`columns`	Représentation sous forme de chaîne d’un objet JSON contenant les noms des colonnes utilisées dans la table source. Voir Spécification de l’objet JSON de colonne.

Spécification de l’objet JSON de table¶

Voici le format de la représentation JSON d’une table, tel qu’il est utilisé par les colonnes source et baseline dans la sortie de la commande :

`name`	Nom de la table ou de la vue source ou de référence.
`database_name`	Base de données dans laquelle la table ou la vue est stockée.
`schema_name`	Schéma dans lequel la table ou la vue est stockée.
`status`	Statut de la table : ACTIVE : la table ou la vue est accessible par l’utilisateur. MASKED : l’utilisateur actuel n’a pas accès à la table ou à la vue. Les valeurs des autres champs apparaissent masquées (c’est-à-dire sous la forme d’une série d’astérisques). DELETED : la table ou la vue a été supprimée. NOT_SET : le statut n’a pas été défini.

name

Nom de la table ou de la vue source ou de référence.

database_name

Base de données dans laquelle la table ou la vue est stockée.

schema_name

Schéma dans lequel la table ou la vue est stockée.

status

Statut de la table :

ACTIVE : la table ou la vue est accessible par l’utilisateur.
MASKED : l’utilisateur actuel n’a pas accès à la table ou à la vue. Les valeurs des autres champs apparaissent masquées (c’est-à-dire sous la forme d’une série d’astérisques).
DELETED : la table ou la vue a été supprimée.
NOT_SET : le statut n’a pas été défini.

Spécification de l’objet JSON de modèle¶

Voici le format de la représentation JSON d’un modèle, tel qu’il est utilisé par la colonne model dans la sortie de la commande :

Champ	Description
`model_name`	Nom du modèle faisant l’objet d’une surveillance.
`version_name`	Nom de la version du modèle faisant l’objet d’une surveillance.
`function_name`	Nom de la fonction spécifique faisant l’objet d’une surveillance dans la version du modèle spécifiée.
`database_name`	Base de données dans laquelle le modèle est stocké.
`schema_name`	Schéma dans lequel le modèle est stocké.
`model_status`	Statut du modèle. Peut être ACTIVE, MASKED ou DELETED. MASKED indique que l’utilisateur n’a pas accès au modèle ; les autres champs apparaissent sous la forme d’une série d’astérisques.
`version_status`	Statut de la version du modèle. Peut être ACTIVE ou DELETED. (MASKED n’est pas un statut valide pour une version de modèle, car il n’y a pas de contrôle d’accès)

Spécification de l’objet JSON de colonne¶

Voici le format de la représentation JSON des colonnes, tel qu’il est utilisé par la colonne columns dans la sortie de la commande :

Champ	Description
`timestamp_column`	Nom de la colonne d’horodatage dans la source de données.
`id_columns`	Un tableau de noms de colonnes de chaînes qui, ensemble, identifient de manière unique chaque ligne des données source.
`prediction_class_columns`	Tableau de chaînes nommant toutes les colonnes de classe de prédiction dans la source de données.
`prediction_score_columns`	Tableau de chaînes nommant toutes les colonnes de score de prédiction dans la source de données.
`actual_class_columns`	Tableau de chaînes nommant toutes les colonnes de classe réelles dans la source de données.
`numerical_columns`	Tableau de chaînes nommant toutes les colonnes de fonctions numériques que le moniteur de modèle utilise à partir de la table source.
`string_columns`	Tableau de chaînes nommant toutes les colonnes de fonctions de chaînes (catégoriques) que le moniteur de modèle utilise à partir de la table source.
`boolean_columns`	Tableau de chaînes nommant toutes les colonnes de fonctions booléennes (catégoriques) que le moniteur de modèle utilise à partir de la table source.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège	Objet	Remarques
N’importe quel	Moniteur du modèle

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.