类别：

系统函数 （系统信息）

SYSTEM$DECODE_PAT

根据提供的令牌密钥，返回关于该 程序访问令牌 的信息。这些信息包括令牌的名称、令牌的状态以及与令牌关联的用户。

如果您需要禁用编程访问令牌并且想知道哪个用户与该令牌相关联，则可以调用此函数。

语法

SYSTEM$DECODE_PAT( '<secret_for_programmatic_access_token>' )
Copy

实参

'secret_for_programmatic_access_token'

编程访问令牌的密钥

返回

返回一个包含 JSON 对象中令牌信息的 VARCHAR 值。JSON 对象具有以下字段：

字段

描述

STATE

编程访问令牌的状态。该字段包含以下值之一：

  • ACTIVE：编程访问令牌可用于身份验证，并且该 expires_at 列中的值大于当前日期。

  • EXPIRED：编程访问令牌不能用于身份验证，并且该 expires_at 列中的值小于或等于当前日期。

  • DISABLED：由于禁用了用户登录访问权限或用户被锁定无法登录，编程访问令牌被 禁用。

PAT_NAME

编程访问令牌的名称。

USER_NAME

与编程访问令牌关联的用户的名称。

示例

以下示例返回有关带有密钥 abC...Y5Z 的编程访问令牌的信息：

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