COMMENT ON

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks 런타임

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

참고 항목

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

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

테이블 열의 주석을 설정하려면 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

매개 변수

  • catalog_name

    주석이 표시되는 카탈로그의 이름입니다. 이 명령문을 실행하려면 카탈로그의 소유자여야 합니다.

  • connection_name

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

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

  • schema_name

    주석이 표시되는 스키마의 이름입니다.

    Unity Catalog를 사용하는 경우 이 명령문을 실행하려면 스키마의 소유자여야 합니다.

  • table_name

    주석을 달고 있는 테이블의 이름입니다. 이름에는 임시 사양이 포함되지 않아야 합니다.

    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 이상

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

  • volume_name

    적용 대상:검사 '예'로 표시 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';