架构：: ORGANIZATION_USAGE

LOGIN_HISTORY 视图¶

重要

此视图仅在组织账户中可用。有关更多信息，请参阅组织账户中的高级视图。

此 Organization Usage 视图可用于查询 Snowflake 用户的登录尝试。

有关登录尝试失败的错误代码/消息的详细信息，请参阅以下文档：

列¶

组织级列

列名称	数据类型	描述
ORGANIZATION_NAME	VARCHAR	组织的名称。
ACCOUNT_LOCATOR	VARCHAR	系统为账户生成的标识符。
ACCOUNT_NAME	VARCHAR	用户定义的账户标识符。

其他列

列名称	数据类型	描述
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	如果用户通过专用连接登录，则指定请求源自的端点的标识符。

使用说明¶

视图的延迟时间最长可达 24 小时。

INTERNAL_SNOWFLAKE_IP/0.0.0.0 显示为支持您使用的内部 Snowflake 操作触发的登录事件的客户端 IP。例如，当用户访问 Snowsight 中的工作表时，由于工作表作为唯一会话存在，Snowflake 会创建一个源自 INTERNAL_SNOWFLAKE_IP/0.0.0.0 的登录事件。
该视图不记录系统定义的执行各种操作的内部用户的活动（例如维护 Snowsight 工作表）。