Snowflake Information Schema¶

什么是 INFORMATION_SCHEMA？¶

在账户中创建的每个数据库都会自动包含一个名为 INFORMATION_SCHEMA 的内置只读架构。该架构包含以下对象：

• 数据库中包含的所有对象的视图，以及账户级对象（即角色、仓库和数据库等非数据库对象）的视图

• 整个账户的历史数据和使用情况数据的表函数。

Information Schema 视图和表函数¶

一般使用说明¶

• 每个 INFORMATION_SCHEMA 架构都是只读的（即架构以及架构中的所有视图和表函数都不能修改或删除）。

• 对 INFORMATION_SCHEMA 视图的查询不能保证并发 DDL 的一致性。例如，如果在执行长时间运行 INFORMATION_SCHEMA 的查询时创建了一组表，则查询结果可能包括创建的部分表、无表或所有表。

• 视图或表函数的输出取决于是否对用户当前角色授予权限。查询 INFORMATION_SCHEMA 视图或表函数时，仅返回当前角色已获得访问权限的对象。

• 为了防止出现性能问题，如果 INFORMATION_SCHEMA 查询中指定的筛选器没有足够选择性，则返回以下错误：

  Information schema query returned too much data. Please repeat query with more selective predicates.

• Snowflake 特定的视图可能会发生变化。避免从这些视图中选择所有列。相反，请选择所需的列。例如，如果您想选择 name 列，请使用 SELECT name，而不是 SELECT *。

将 SHOW 命令替换为 Information Schema 视图的注意事项¶

这些 INFORMATION_SCHEMA 视图为 SHOW <objects> 命令提供的相同信息提供了一个 SQL 接口。您可以使用视图来替代这些命令；但是，在切换之前需要考虑一些关键差异：

限定查询中 Information Schema 视图和表函数的名称¶

查询 INFORMATION_SCHEMA 视图或表函数时，您必须使用视图/表函数的限定名称，或者 INFORMATION_SCHEMA 架构必须用于会话。

例如：

• 若使用视图和表函数的完全限定名称（database.information_schema.name 格式）进行查询，请执行以下操作：

  SELECT table_name, comment FROM testdb.INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(testdb.INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• 若使用视图和表函数的限定名称（information_schema.name 格式）进行查询，请执行以下操作：

  USE DATABASE testdb;
  
  SELECT table_name, comment FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• 若要使用用于会话的 INFORMATION_SCHEMA 架构进行查询，请执行以下操作：

  USE SCHEMA testdb.INFORMATION_SCHEMA;
  
  SELECT table_name, comment FROM TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(LOGIN_HISTORY( ... ));
  

  Copy

  备注

  如果您使用从共享创建的数据库，并且已选择 INFORMATION_SCHEMA 作为会话的当前架构，则 SELECT 语句可能会失败，并出现以下错误：

  INFORMATION_SCHEMA does not exist or is not authorized

  如果发生这种情况，请为会话的当前架构选择其他架构。

有关更多详细示例，请参阅每个视图/表函数的参考文档。