COMMENT ON
适用于: Databricks SQL Databricks Runtime
对目录、架构、表、共享、收件人、提供程序或卷设置注释。
目录、共享、接收者和提供者仅在 Unity Catalog 中受支持。
要设置表格列的注释,请使用 ALTER TABLE。
语法
COMMENT ON
{ CATALOG catalog_name |
CONNECTION connection_name |
PROVIDER provider_name |
RECIPIENT recipient_name |
{ SCHEMA | DATABASE } schema_name |
SHARE share_name |
TABLE table_name |
VOLUME volume_name }
IS comment
parameters
-
显示注释的目录的名称。 要运行此语句,你必须是目录的所有者。
-
适用于: Databricks SQL Databricks Runtime 13.3 LTS 及更高版本 仅 Unity Catalog
显示注释的连接的名称。 要运行此语句,你必须是连接的所有者。
-
显示注释的架构的名称。
如果使用 Unity Catalog 运行此语句,则你必须是架构的所有者。
-
所注释的表的名称。 名称不得包含时态规范。
如果使用 Unity Catalog 运行此语句,则必须拥有该表的
MODIFY
权限。 -
适用于: Databricks SQL Databricks Runtime 11.3 LTS 及更高版本
显示注释的共享的名称。 要运行此语句,你必须是共享的所有者。
-
适用于: Databricks SQL Databricks Runtime 11.3 LTS 及更高版本
显示注释的收件人的名称。 要运行此语句,你必须是收件人的所有者。
-
适用于: Databricks SQL Databricks Runtime 11.3 LTS 及更高版本
显示注释的提供程序的名称。 要运行此语句,你必须是提供程序的所有者。
-
适用于: Databricks SQL Databricks Runtime 13.3 LTS 及更高版本
显示注释的卷的名称。 若要运行此语句,你必须是卷的所有者。
comment
STRING
文本或NULL
。 如果指定NULL
,则删除任何现有注释。
示例
> COMMENT ON CATALOG my_catalog IS 'This is my catalog';
> 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';
相关文章
- CREATE CATALOG
- DESCRIBE CATALOG
- DROP CATALOG
- ALTER SCHEMA
- CREATE SCHEMA
- DESCRIBE SCHEMA
- DROP SCHEMA
- ALTER TABLE
- CREATE TABLE
- DESCRIBE TABLE
- DROP TABLE
- ALTER SHARE
- CREATE SHARE
- DESCRIBE SHARE
- DROP SHARE
- ALTER RECIPIENT
- CREATE RECIPIENT
- DESCRIBE RECIPIENT
- DROP RECIPIENT
- ALTER PROVIDER
- DESCRIBE PROVIDER
- DROP PROVIDER
- ALTER VOLUME
- DESCRIBE VOLUME
- DROP VOLUME