<service_name>!SPCS_GET_METRICS¶

Renvoie les métriques que Snowflake a collectées pour le service spécifié. Pour plus d’informations, voir Accéder aux métriques de la plateforme.

Note

La fonction n’est prise en charge que pour les services et les tâches créés dans la version 9.20 ou ultérieure.

Voir aussi :: Surveiller les services

Syntaxe¶

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

Copy

Arguments¶

START_TIME => constant_expr

Heure de début (au format TIMESTAMP_LTZ) pour la plage de temps à partir de laquelle récupérer des métriques. Pour les fonctions disponibles pour créer des données, des heures et des horodatages, voir Fonctions de date et d’heure.

Si START_TIME n’est pas spécifié, la valeur par défaut est un jour auparavant.

END_TIME => constant_expr

Heure de fin (au format TIMESTAMP_LTZ) pour la plage de temps à partir de laquelle récupérer des métriques.

Si END_TIME n’est pas spécifié, la valeur par défaut est l’horodatage actuel.

Sortie¶

La fonction renvoie les colonnes suivantes :

Colonne	Type de données	Description
`TIMESTAMP`	TIMESTAMP_NTZ	Horodatage temps universel coordonné (UTC) du moment où Snowflake a collecté la métrique.
`METRIC_NAME`	VARCHAR	Nom de la métrique.
`VALUE`	VARCHAR	Valeur de la métrique.
`UNIT`	VARCHAR	Unité de la métrique renvoyée.
`INSTANCE_ID`	NUMBER	Nom de l’instance de service si la métrique est liée à l’instance de service.
`CONTAINER_NAME`	VARCHAR	Nom du conteneur si la métrique est liée au conteneur. Par exemple, une métrique de volume n’aura pas de nom de conteneur.
`RESOURCE`	VARCHAR	Matériel (par exemple, GPU) auquel sont liées les métriques. Cette colonne n’est pas renseignée.
`RECORD`	OBJECT	Paires clé-valeur qui fournissent des informations sur la métrique.
`RECORD_ATTRIBUTES`	OBJECT	Paires clé-valeur qui fournissent des informations supplémentaires sur la métrique.

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
OWNERSHIP	Service

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. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce 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.

Notes sur l’utilisation¶

Plusieurs minutes peuvent s’écouler avant que les métriques n’apparaissent dans la sortie.

Exemples¶

Récupérer les métriques que Snowflake a collectées pour la tâche my_test_job au cours de la journée écoulée, valeur par défaut.

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

Copy

Récupérer les métriques que Snowflake a collectées pour la tâche my_test_job au cours des trois derniers jours.

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

Copy

Récupérer les métriques de la journée écoulée pour l’instance 0 de la tâche spcs_get_metrics dans le conteneur nommé main.

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

Copy