LOGIN_HISTORY 视图¶
此 Account Usage 视图可用于查询过去 365 天(1 年)内 Snowflake 用户的登录尝试。
有关登录尝试失败的错误代码/消息的详细信息,请参阅以下文档:
列¶
列名称 |
数据类型 |
描述 |
---|---|---|
READER_ACCOUNT_NAME |
TEXT |
用户身份验证事件的阅读者账户名称。仅包含在 READER_ACCOUNT_USAGE 架构视图内的列。 |
EVENT_ID |
NUMBER |
内部/系统生成的登录尝试标识符。 |
EVENT_TIMESTAMP |
TIMESTAMP_LTZ |
事件发生时的时间(采用 UTC 时区)。 |
EVENT_TYPE |
TEXT |
事件类型,例如身份验证事件 LOGIN。 |
USER_NAME |
TEXT |
与此事件关联的用户。 |
CLIENT_IP |
TEXT |
请求的来源 IP 地址。 |
REPORTED_CLIENT_TYPE |
TEXT |
报告的客户端软件类型,如 JDBC_DRIVER、ODBC_DRIVER 等。此信息未经身份验证。 |
REPORTED_CLIENT_VERSION |
TEXT |
客户端软件的报告版本。此信息未经身份验证。 |
FIRST_AUTHENTICATION_FACTOR |
TEXT |
用于对用户进行身份验证的方法(如果使用多重身份验证,则为第一个因素)。 |
SECOND_AUTHENTICATION_FACTOR |
TEXT |
第二个因素(如果使用多重身份验证或 NULL)。 |
IS_SUCCESS |
TEXT |
用户的请求是否成功。 |
ERROR_CODE |
NUMBER |
如果请求不成功,则为错误代码。 |
ERROR_MESSAGE |
TEXT |
如果请求不成功,则向用户返回错误消息。 |
RELATED_EVENT_ID |
NUMBER |
保留以供将来使用。 |
CONNECTION |
TEXT |
客户端使用的连接名称,如果客户端未使用连接 URL,则为 NULL。连接是一个 Snowflake 对象,它是 Client Redirect 的一部分。它表示连接 URL,可以跨账户进行故障转移以实现业务连续性和灾难恢复。. , NOTE:如果客户端通过配置了账户 URL (而不是连接 URL)的身份提供商 (IdP) 进行身份验证,则 IdP 会在身份验证完成后将客户端定向到账户 URL。此登录事件的 CONNECTION 列为 NULL。请参阅 身份验证和 Client Redirect。 |
CLIENT_PRIVATE_LINK_ID |
TEXT |
如果用户通过 专用连接 登录,则指定请求源自的端点的标识符。 |
使用说明¶
视图的延迟时间最长可达 120 分钟(2 小时)。
INTERNAL_SNOWFLAKE_IP/0.0.0.0
显示为支持您使用的内部 Snowflake 操作触发的登录事件的客户端 IP。例如,当用户访问 Snowsight 中的工作表时,由于工作表作为唯一会话存在,Snowflake 会创建一个源自INTERNAL_SNOWFLAKE_IP/0.0.0.0
的登录事件。该视图不记录系统定义的执行各种操作的内部用户的活动(例如维护 Snowsight 工作表)。