Important
이 기능은 베타 버전으로 제공됩니다. 계정 관리자는 계정 콘솔 미리 보기 페이지에서 이 기능에 대한 액세스를 관리할 수 있습니다. 계정 수준 미리 보기 관리를 참조하세요.
위키는 팀이 테이블의 의미, 의도된 용도, 출처를 문서화하고 해당 정보에 대해 카탈로그 탐색기에서 직접 협업할 수 있게 해줍니다. 데이터 소유자와 관리자는 정의나 알려진 주의사항 등 표와 관련된 비즈니스 맥락을 포착하기 위해 위키를 작성하고 게시합니다. 표의 메타데이터를 볼 수 있는 누구나 게시된 위키를 읽고, 댓글을 달고, 편집을 제안하며, 이에 반응할 수 있습니다.
위키에는 표 하나가 기록되어 있습니다. 페이지는 여러 자산을 아우르는 비즈니스 개념을 정의합니다. 특정 표에 대한 맥락은 위키를 사용하고, 공유 정의는 페이지를 사용하세요.
위키는 테이블의 기존 주석과 함께 작동합니다. 위키 및 표 댓글을 참고하세요.
위키의 내용
위키에는 다음과 같은 필드가 포함되어 있습니다:
| Field | Description |
|---|---|
| Description | 위키 상단에 표시된 표의 한 줄 요약입니다. |
| 페이지 본문 | Unity 카탈로그 보안 가능한 객체와 작업 공간 객체에 대한 헤딩, 링크, 이미지, 인라인 언급을 지원하는 리치 텍스트 문서입니다. |
| Sources | 위키 콘텐츠가 기반한 페이지 나 외부 출처에 대한 링크. |
지원되는 보안 가능 개체
다음 Unity 카탈로그 보안 대상 객체에 대해 위키를 만들 수 있습니다:
Note
OpenSharing을 통해 공유되는 보안 설정 가능 항목에는 위키를 사용할 수 없습니다.
Permissions
위키는 보안 설정 가능한 개체가 아닙니다. 해당 테이블의 메타데이터이기 때문에, 해당 테이블에 대한 기존 Unity 카탈로그 권한이 그 위키를 어떻게 활용할 수 있는지를 결정합니다. Unity 카탈로그 권한에 대한 배경은 Unity 카탈로그 권한 부여 모델 개념을 참조하세요.
다음에 나오는 권한 테이블에서는 부모 객체에 대한 사용 권한을 , READ_METADATA 또는 소유권이 효력을 갖기 위해 필요한 MANAGE이라는 의미로 사용합니다. 이들은 대상에 따라 다릅니다:
-
테이블: 부모 스키마의
USE SCHEMA및 부모 카탈로그의USE CATALOG. -
스키마: 부모 카탈로그의
USE CATALOG - 카탈로그: 없음.
| Action | 필수 권한 |
|---|---|
| 게시된 위키를 보고 협업하기: 게시된 위키를 보기, 자신의 댓글을 추가, 편집 또는 삭제, 편집 제안 및 반응 추가하기. | 다음 중 하나입니다.
|
| 초안 위키 보기 | 다음 중 하나입니다.
|
| 위키 및 댓글 관리: 위키를 생성, 편집, 게시 또는 게시 취소하고, 제안된 편집을 수락하거나 거부하며, 댓글을 삭제하세요 | 다음 중 하나입니다.
|
위키 만들기
위키를 만들려면 테이블에서 위키를 관리할 권한이 필요합니다. 사용 권한을 참조하세요.
위키를 수동으로 작성하거나 Genie Code로 초안을 작성할 수 있습니다.
Warning
위키 데이터는 Microsoft가 관리하는 키로 저장 시 암호화되어 있습니다. 위키는 고객 관리 키(CMK) 암호화를 지원하지 않습니다. 위키 설명이나 페이지 본문에 개인 식별 정보(PII), 규제 대상 데이터 또는 기타 민감한 정보를 포함하지 마십시오.
카탈로그 탐색기에서 테이블을 열어보세요.
개요 탭에서 위키 만들기를 클릭하세요. 위키 생성 배너를 무시했다면, 페이지 오른쪽 상단의
을 클릭한 다음 위키 생성을 선택하세요. 테이블에 기존 주석이 있으면 위키 페이지 본문의 초기 내용으로 사용합니다.
위키 콘텐츠 추가:
- 수동으로 작성하려면 설명과 페이지 본문을 작성하고 출처를 추가하세요.
- Genie Code로 초안을 작성하려면 위키 편집기의 Genie Code 창을 사용하세요. Genie Code가 활용할 수 있도록 파일이나 다른 맥락을 첨부하세요. 지니 코드를 참조하세요.
위키 작업을 계속하려면 초안으로 저장 을 클릭하거나, 테이블의 메타데이터를 볼 수 있는 모든 사람이 볼 수 있도록 게시 를 클릭하세요.
위키를 게시하면 테이블의 개요 탭 상단에 나타나고, 테이블의 설명 은 세부 정보 탭으로 이동합니다.
위키를 편집하고 게시하기
위키를 편집, 게시 또는 게시 취소하려면 테이블에서 위키를 관리할 권한이 필요합니다. 사용 권한을 참조하세요.
카탈로그 탐색기에서 테이블을 열어보세요.
위키에서 편집을 클릭하세요.
변경한 후 저장을 클릭하거나, 초안 위키를 보이게 하려면 게시를 클릭하세요.
게시된 위키를 내용을 잃지 않고 숨기려면 편집을 클릭한 뒤 케밥 메뉴를 클릭한 후 공개 취소를 클릭하세요. 위키는 초안을 볼 수 있는 사용자에게만 표시되는 초안으로 되돌아갑니다. 위키를 다시 게시하기 전까지는 테이블의 설명 이 개요 탭 상단에 나타납니다.
위키를 함께 작성하세요
게시된 위키를 볼 수 있는 사람은 누구나 협업할 수 있습니다. 사용 권한을 참조하세요.
- 댓글: 질문을 하거나 맥락을 추가하세요. 자신의 댓글을 수정하거나 삭제할 수 있습니다.
- 편집 제안: 위키 페이지 본문에 변경 사항을 제안하세요. 제안하기를 클릭하고, 페이지 본문을 편집한 후 저장을 클릭하세요. 위키를 관리할 권한이 있는 사용자는 제안을 수락하거나 거부합니다.
- React: 위키가 도움이 되었는지 표시하기 위해 추천(upvote)이나 다운보트(downvote)를 하세요.
위키 및 테이블 주석
위키는 테이블의 주석을 대체하지 않으므로, 주석을 읽거나 쓰는 기존 파이프라인은 계속 작동합니다:
-
COMMENT ON TABLE또는ALTER TABLE로도 댓글을 설정할 수 있습니다. 이 댓글은 여전히 카탈로그 탐색기의 및information_schema필드에 나타납니다. - 위키를 만들 때, 테이블의 기존 주석이 위키 페이지 본문의 초기 내용으로 사용됩니다. 그 이후로는 위키와 댓글이 독립적입니다. 한쪽을 변경해도 다른 쪽이 업데이트되지 않습니다.
테이블 댓글에 대해 더 알고 싶으시다면, 데이터 및 AI 자산에 댓글 추가를 참조하세요.
REST API로 위키를 관리하세요
위키의 REST API를 이용해 테이블의 위키를 프로그래밍적으로 읽고 업데이트하세요. API는 다음과 같은 연산을 지원합니다:
- 위키 가져오기: 표의 위키를 가져옵니다.
- 위키 업데이트: 테이블의 위키를 업데이트하거나, 테이블에 위키가 없으면 생성합니다. 위키의 상태를 게시됨으로 설정하면 게시됩니다.
API는 UI와 동일한 권한을 요구합니다. 사용 권한을 참조하세요. Databricks 개인 액세스 토큰으로 워크스페이스 사용자 또는 OAuth를 사용해 요청을 인증하세요.
요청 및 응답 세부 사항은 위키의 REST API 참고 자료를 참조하세요.
Limitations
- 위키는 지원 보안 객체에 나열된 보안 대상 객체에서만 제공됩니다. 열, 스키마, 카탈로그 및 기타 보안 가능한 객체에 관한 위키는 지원되지 않습니다.
- 각 테이블은 위키 하나씩 가질 수 있습니다.
- 위키는 Azure Government, Azure China 또는 FedRAMP 지역에서는 이용할 수 없습니다.