다음을 통해 공유

데이터 및 AI 자산에 주석 추가

이 문서에서는 데이터 및 AI 자산에 대한 주석을 소개하고 추가하는 방법을 설명합니다. 주석은 사용자와 다른 사용자가 필요한 데이터 및 AI 자산을 찾고 관리하는 데 도움이 될 수 있습니다.

주석은 보안 개체에 주석을 달기 위한 메타데이터 필드를 제공합니다. 카탈로그, 스키마, 테이블, 볼륨, AI 모델 등 Unity 카탈로그의 보안 개체에 주석을 추가할 수 있습니다. 테이블 열에 주석을 추가할 수도 있습니다.

보안 개체에 주석을 추가한 후 권한이 있는 BROWSE 모든 사용자는 주석을 볼 수 있습니다. 이렇게 하면 카탈로그 전체에서 데이터 검색 가능성이 향상됩니다.

주석을 수동으로 추가하거나 Databricks에서 AI 생성 주석을 만들도록 할 수 있습니다. AI에서 생성된 주석(AI 생성 설명서라고도 함)은 테이블 및 테이블 열에 사용할 수 있습니다. Unity 카탈로그 개체에 AI 생성 주석 추가 참조하세요.

Unity 카탈로그 테이블(또는 레거시 Hive 메타스토어의 Delta Lake 테이블)에 대한 주석을 수정할 때 테이블 기록의 SET TBLPROPERTIES 작업은 테이블 주석을 정의하는 데 사용된 SQL 쿼리를 기록합니다.

시작하기 전에

주석을 추가하거나 편집하려면 다음 요구 사항을 충족해야 합니다.

  • 카탈로그, 스키마, 볼륨, 모델, 공유, 받는 사람, 공급자, 스토리지 자격 증명, 외부 위치 또는 연결에 대한 주석을 추가하거나 편집하려면 개체의 소유자이거나 개체에 대한 MANAGE 권한이 있어야 합니다.
  • 테이블 또는 열에 주석을 추가하거나 편집하려면 소유자이거나 다음 권한이 있어야 합니다.
    • 테이블에 MODIFY와 SELECT.
    • 부모 카탈로그 및 스키마에서 USE CATALOG 및 USE SCHEMA.
  • Unity 카탈로그를 지원하는 SQL 웨어하우스 또는 기타 컴퓨팅을 사용해야 합니다.
  • AI에서 생성된 주석을 사용하려면 AI 지원 기능에 대해 작업 영역을 사용하도록 설정해야 합니다. Unity 카탈로그 개체에 AI 생성 주석 추가 참조하세요.

메모 추가 및 편집

보안 개체에 주석을 추가하거나 SQL 명령 또는 카탈로그 탐색기를 사용하여 편집할 수 있습니다.

카탈로그 탐색기

중요합니다

주석을 저장하면 ALTER SQL 명령이 트리거되어 Azure Databricks 파이프라인 및 작업이 중단됩니다.

  1. 작업 영역 사이드바에서 데이터 아이콘을 클릭하여 카탈로그 탐색기를 엽니다.

  2. 메모할 개체를 검색하여 선택합니다.

    데이터 및 AI 개체는 카탈로그 창에 나열되고 검색할 수 있습니다. 기어 아이콘 을 클릭하면 열리는 메뉴를 사용하여 공유, 스토리지 자격 증명, 외부 위치 및 연결에 액세스할 수 있습니다.

  3. 메모를 추가하거나 기존 메모를 편집합니다.

    • AI 생성 주석사용하여 테이블에 메모를 추가하려면 개요 탭의 오른쪽 창에서 AI 추천 메모 봅니다. 표시되는 데 몇 초 정도 걸릴 수 있습니다. 그대로 적용하거나 편집하여 저장합니다.
    • AI에서 생성된 주석사용하여 테이블 열에 주석을 추가하려면 열 목록 위의 AI 생성 단추를 클릭합니다. Databricks는 각 열에 대한 주석을 생성합니다. 그대로 수락하거나 편집합니다. 확인 표시를 클릭하여 주석을 저장합니다.
    • AI 생성 메모를 지원하지 않는 개체에 메모를 추가하려면 메모추가 를 클릭하여 메모를 추가합니다.
    • AI에서 생성된 주석사용하지 않고 테이블 열에 주석을 추가하려면 아이콘을 클릭하여 열 행에 메모 아이콘 추가열 태그 또는 주석을 추가합니다.
    • 주석이 이미 있는 경우개요 탭의 오른쪽 창이나 개체 이름 아래에 표시됩니다. AI 생성이 아닌 경우 편집 아이콘 편집 아이콘을 클릭하여 편집합니다.

기본 Markdown을 사용하여 카탈로그 탐색기 UI에서 주석의 스타일을 지정할 수 있습니다. DESCRIBE 문에서 반환할 때 Markdown 스타일링은 렌더링되지 않습니다. 이미지를 제외한 카탈로그 탐색기에서 모든 기본 구문이 지원됩니다. 자세한 내용은 기본 구문을 참조하세요.

AI에서 생성된 주석에 대한 자세한 내용은Unity 카탈로그 개체에 AI 생성 주석 추가 참조하세요.

SQL

SQL 명령을 사용하여 Unity 카탈로그의 보안 개체 및 레거시 Hive 메타스토어에서 관리되는 테이블에 주석으로 문자열 리터럴을 추가할 수 있습니다. 사용하는 SQL 명령은 주석을 추가하거나 편집하려는 개체에 따라 달라집니다.

  • 테이블 열을 제외한 기존 보안 개체에 대한 주석을 추가하거나 업데이트하려면 COMMENT ON 명령을 사용합니다. COMMENT ON을 참조하세요.

    개체에 대한 COMMENT 명령과 함께 ALTER <object> 옵션을 사용할 수도 있습니다(예: ALTER TABLE). ALTER <object> 명령에 대한 SQL 참조 문서를 참조하세요.

  • 기존 테이블에 대한 열 주석을 추가하거나 업데이트하려면 ALTER TABLE 절과 함께 ALTER COLUMN 명령을 사용하고 열의 COMMENT 옵션을 사용합니다. ALTER TABLE 및 ALTER TABLE ... COLUMN 절을 참조하십시오.

  • 개체를 만들 때 주석을 추가하려면 COMMENT 명령과 함께 CREATE <object> 옵션을 사용합니다. 사용하려는 CREATE <object> 명령에 대한 SQL 참조 문서를 참조하세요.

  • Last updated on