다음을 통해 공유

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

  • 아티클

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

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

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

유니티 카탈로그 테이블(또는 기존 하이브 전이점의 델타 레이크 테이블)에 대한 의견을 수정하면 테이블 기록의 SET TBLPROPERTIES 작업이 테이블 의견을 정의하는 데 사용된 SQL 쿼리를 기록합니다.

시작하기 전에

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

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

메모 추가 및 편집

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

카탈로그 탐색기

  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 참조 문서를 참조하세요.