使用英语阅读

通过

注释

  • 2025/05/29

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

对目录、架构、表、共享、收件人、提供程序或卷设置注释。

目录、共享、接收者和提供者仅在 Unity Catalog 中受支持。

要设置表格列的注释，请使用 ALTER TABLE。

语法

COMMENT ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      CONNECTION connection_name |
      PROVIDER provider_name |
      RECIPIENT recipient_name |
      { SCHEMA | DATABASE } schema_name |
      SHARE share_name |
      TABLE relation_name |
      VOLUME volume_name }
    IS comment

parameters

  • catalog_name

    显示注释的目录的名称。 若要运行此语句，你必须是目录的所有者，或者拥有该目录的 MANAGE 权限。

  • relation_name 。 column_name

    适用于 勾选“是” Databricks SQL 勾选“是” Databricks Runtime 16.1 及更高版本

    你对其添加注释的列的限定名称。 relation_name 必须标识视图或表。 relation_name 不得包含 时态规范或选项规范。

    如果使用 Unity Catalog 运行此语句，则必须拥有该表的 MODIFY 权限。

  • 连接名称

    适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 13.3 LTS 及更高版本 勾选“是” 仅 Unity Catalog

    显示注释的连接的名称。 若要运行此语句，您必须是连接的所有者，或者具有针对它的 MANAGE 权限。

  • schema_name

    显示注释的架构的名称。

    如果使用 Unity 目录来运行此语句，则必须是架构的所有者，或者拥有该架构的 MANAGE 权限。

  • 关系名称

    您评论的表或视图的名称。 表名称不得包含 临时规范或选项规范。

    如果使用 Unity Catalog 运行此语句，则必须拥有该表的 MODIFY 权限。

  • share_name

    适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 11.3 LTS 及更高版本

    显示注释的共享的名称。 要运行此语句，你必须是共享的所有者。

  • recipient_name

    适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 11.3 LTS 及更高版本

    显示注释的收件人的名称。 要运行此语句，你必须是收件人的所有者。

  • provider_name

    适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 11.3 LTS 及更高版本

    显示注释的提供程序的名称。 要运行此语句，你必须是提供程序的所有者。

  • 卷名称

    适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 13.3 LTS 及更高版本

    显示注释的卷的名称。 要运行此语句，你必须是卷的所有者，或者拥有该卷的 MANAGE 权限。

  • 评论

    STRING 文本或 NULL。 如果指定 NULL，则删除任何现有注释。

示例

> COMMENT ON CATALOG my_catalog IS 'This is my catalog';

> COMMENT ON COLUMN my_table.c1 IS 'This is my column';

> COMMENT ON CONNECTION mysql_connection IS 'this is a mysql connection';

> COMMENT ON SCHEMA my_schema IS 'This is my schema';

> COMMENT ON TABLE my_table IS 'This is my table';

> COMMENT ON TABLE my_table IS NULL;

> COMMENT ON SHARE my_share IS 'A good share';

> COMMENT ON RECIPIENT my_recipient IS 'A good recipient';

> COMMENT ON PROVIDER my_provider IS 'A good provider';

> COMMENT ON PROVIDER my_volume IS 'Huge volume';