Catégories :

Fonctions système (Informations système)

SYSTEM$DECODE_PAT

Renvoie des informations sur un jeton d’accès programmatique, d’après le secret du jeton. Ces informations comprennent le nom du jeton, l’état du jeton et l’utilisateur associé au jeton.

Vous pouvez appeler cette fonction si vous devez désactiver un jeton d’accès programmatique et que vous souhaitez savoir quel utilisateur est associé au jeton.

Syntaxe

SYSTEM$DECODE_PAT( '<secret_for_programmatic_access_token>' )
Copy

Arguments

'secret_for_programmatic_access_token'

Secret du jeton d’accès programmatique.

Renvoie

Renvoie une valeur VARCHAR contenant les informations relatives au jeton dans un objet JSON. L’objet JSON comporte les champs suivants :

Champ

Description

STATE

État du jeton d’accès programmatique. Ce champ contient l’une des valeurs suivantes :

  • ACTIVE : le jeton d’accès programmatique peut être utilisé pour l’authentification, et la valeur de la colonne expires_at est supérieure à la date actuelle.

  • EXPIRED : le jeton d’accès programmatique ne peut pas être utilisé pour l’authentification, et la valeur de la colonne expires_at est inférieure ou égale à la date actuelle.

  • DISABLED : le jeton d’accès programmatique est désactivé parce que l’accès à la connexion utilisateur a été désactivé ou que la connexion de l’utilisateur est bloquée.

PAT_NAME

Nom du jeton d’accès programmatique.

USER_NAME

Nom de l’utilisateur associé au jeton d’accès programmatique.

Exemples

L’exemple suivant renvoie des informations sur le jeton d’accès programmatique avec le secret abC...Y5Z :

SELECT SYSTEM$DECODE_PAT('abC...Y5Z');
Copy
+------------------------------------------------------------------------+
| SYSTEM$DECODE_PAT('☺☺☺...☺☺☺')                                         |
|------------------------------------------------------------------------|
| {"STATE":"ACTIVE","PAT_NAME":"MY_EXAMPLE_TOKEN","USER_NAME":"MY_USER"} |
+------------------------------------------------------------------------+