다음을 통해 공유


COMMENT ON

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

카탈로그, 스키마, 테이블, 공유, 받는 사람, 공급자 또는 볼륨에 대한 주석을 설정합니다.

참고 항목

Unity 카탈로그에서 관리하는 테이블 또는 테이블 열에 대한 AI 생성 주석을 추가하려면Unity 카탈로그 개체에 AI 생성 주석 추가 참조하세요.

카탈로그, 공유, 받는 사람 및 공급자는 Unity 카탈로그에서만 지원됩니다.

테이블 열의 주석을 설정하려면 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 table_name |
      VOLUME volume_name }
    IS comment

매개 변수

  • catalog_name

    메모가 표시되는 카탈로그의 이름입니다. 이 문을 실행하려면 카탈로그의 소유자이거나 카탈로그에 대한 MANAGE 권한이 있어야 합니다.

  • relation_name . column_name

    적용 대상: 체크 마크 예 Databricks SQL 체크 마크 예 Databricks Runtime 16.1 이상

    열에 대해 댓글을 다는 사용자가 지정한 이름입니다. relation_name 뷰 또는 테이블을 식별해야 합니다. relation_name임시 사양이나 옵션 사양를 포함해서는 안 됩니다.

    Unity 카탈로그를 사용하는 경우 이 문을 실행하려면 테이블에 대한 MODIFY 권한이 있어야 합니다.

  • connection_name

    적용 대상:확인 표시 예 Databricks SQL 확인 표시 예 Databricks Runtime 13.3 LTS 이상 확인 표시 예 Unity 카탈로그만 표시

    메모가 표시되는 연결의 이름입니다. 이 문을 실행하려면 연결의 소유자이거나 연결에 대한 MANAGE 권한이 있어야 합니다.

  • schema_name

    메모가 표시되는 스키마의 이름입니다.

    Unity 카탈로그를 사용하는 경우 이 문을 실행하려면 스키마의 소유자이거나 스키마에 대한 MANAGE 권한이 있어야 합니다.

  • table_name

    주석을 달고 있는 테이블의 이름입니다. 이름에는 임시 사양 또는 옵션 사양이 포함되어서는 안됩니다.

    Unity 카탈로그를 사용하는 경우 이 문을 실행하려면 테이블에 대한 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 이상

    메모가 표시되는 공급자의 이름입니다. 이 명령문을 실행하려면 공급자의 소유자여야 합니다.

  • volume_name

    적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 13.3 LTS 이상

    메모가 표시되는 볼륨의 이름입니다. 이 문을 실행하려면 볼륨의 소유자이거나 볼륨에 대한 MANAGE 권한이 있어야 합니다.

  • comment

    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';