스키마 객체 설명은 데이터 소스 스키마 내 테이블, 컬럼 및 기타 요소에 대한 데이터 에이전트의 비즈니스 맥락을 제공합니다. 이 맥락은 에이전트가 비슷한 이름이거나 모호한 객체를 구분하고, 각 객체의 목적을 이해하며, 더 정확한 쿼리를 생성하는 데 도움을 줍니다. 설명은 객체 이름만으로는 의미를 명확히 전달하지 못하는 대규모 스키마에서 특히 유용합니다.
스키마 객체 설명은 레이크하우스, 웨어하우스, Fabric SQL 데이터베이스, 미러링 데이터베이스 등 SQL 데이터 소스에 대해 지원합니다.
참고
스키마 객체 설명은 현재 공개 미리보기 상태입니다.
참고
스키마 객체 설명은 데이터 에이전트가 미리보기 런타임을 사용할 때만 제공됩니다.
설명을 추가하거나 편집하기
기본적으로 데이터 에이전트는 데이터 소스로부터 사용 가능한 설명을 상속받아 자동으로 업데이트합니다. 데이터 에이전트에서 상속된 설명을 수정하면, 변경 사항은 데이터 에이전트에만 적용됩니다. 소스의 설명을 덮어쓰지 않고, 그 객체는 더 이상 소스로부터 설명 업데이트를 받지 않습니다.
- 데이터 에이전트를 열고 설정(Setup)을 선택하세요.
- 데이터 소스에서 스키마 객체 설명을 선택하세요.
- 스키마를 확장하여 설명하고자 하는 객체를 찾으세요.
- 객체 옆에 있는 편집 아이콘을 선택하세요.
- 설명을 입력한 후 완료를 선택하세요.
Python SDK로 설명을 추가하세요
Fabric 데이터 에이전트 Python SDK를 사용해 스키마 객체 설명을 프로그래밍적으로 관리하세요. 다음 예시는 기존 데이터 에이전트의 첫 번째 데이터 소스에 있는 한 테이블에 대한 설명을 제시합니다:
from fabric.dataagent.client import FabricDataAgentManagement
agent = FabricDataAgentManagement("<data-agent-name>")
datasource = agent.get_datasources()[0]
table_path = ("Schemas", "dbo", "Tables", "adoptions")
datasource.update_description({
table_path: "Contains one row for each pet adoption transaction."
})
튜플은 데이터 소스 내 경로로 스키마 요소를 식별합니다. 열을 설명하려면 테이블 경로에 그 이름을 추가하세요. 예를 들어 table_path + ("adoption_date",)을 사용하십시오. 경로 이름은 대문자에 구분되며, 데이터 소스에 표시된 계층 구조와 일치해야 합니다.
효과적인 설명 작성
설명을 사용해 물건 이름으로는 알 수 없는 비즈니스 의미를 설명하세요. 각 설명은 간결하고 구체적으로 유지하세요.
- 테이블의 경우, 대표되는 비즈니스 엔터티나 이벤트, 테이블의 세부 수준, 그리고 주요 목적을 설명하세요.
- 열의 경우, 값의 비즈니스 의미, 형식, 단위, 또는 불명확할 수 있는 기대값을 정의하세요.
- 다른 스키마 요소에 대해서는 그 역할과 데이터 에이전트가 언제 사용해야 하는지 설명하세요.
- 약어, 내부 용어, 그리고 유사한 이름의 객체를 명확히 해주세요.
- 에이전트가 쿼리를 생성할 때 올바른 객체와 관계를 선택할 수 있도록 돕는 맥락을 포함하세요.