通过

COMMENT ON

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

在目录、架构、表、列、共享、接收者、提供程序或卷上设置注释。

注意

如果希望为由 Unity Catalog 管理的一张表或表列添加 AI 生成的注释，请参阅为 Unity Catalog 对象添加 AI 生成的注释。

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

语法

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

参数

  • 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 Catalog 运行此语句，您必须是架构的所有者或对其拥有 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';