DESCRIBE SECRET¶

描述密钥的属性。

DESCRIBE 可以缩写为 DESC。

语法¶

{ DESC | DESCRIBE } SECRET <name>

Copy

命令输出在以下列中提供密钥属性和元数据：

列	描述
`created_on`	创建密钥的日期和时间。
`name`	密钥的名称。
`schema_name`	包含密钥的架构的名称。
`database_name`	包含密钥的数据库的名称。
`owner`	拥有密钥的角色的名称。
`comment`	密钥的注释，如果没有指定注释，则显示 NULL。
`secret_type`	`OAUTH2`、`PASSWORD`、`GENERIC` 或 `SYMMETRIC_KEY`。
`username`	存储在密钥中的用户名。
`oauth_access_token_expiry_time`	OAuth 访问令牌过期的时间戳字符串。
`oauth_refresh_token_expiry_time`	OAuth 刷新令牌过期的时间戳字符串，如果密钥没有存储这个值，则显示 NULL。
`oauth_scopes`	在以下情况下使用的以逗号分隔的范围列表：在 OAuth 客户端凭据流程期间，对集成具有 USAGE 权限的角色从 OAuth 服务器发出请求。如果没有范围，则显示 NULL。
`integration_name`	密钥中引用的外部 API 身份验证集成的名称，如果密钥没有引用外部 API 身份验证集成，则显示 NULL。
`algorithm`	用于对称密钥的算法。
`key_length`	用于对称密钥的密钥长度。

用于执行此操作的角色必须至少具有以下权限：

权限	对象	备注
USAGE	密钥

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集，请在查询中对列名使用加双引号的标识符，以确保它们与已扫描输出中的列名相匹配。例如，如果输出列的名称为 type，则为标识符指定 "type"。

描述密钥：

DESC SECRET service_now_creds_pw;

Copy