다음을 통해 공유


Git을 사용하는 버전 제어 대시보드

이 페이지에서는 버전 제어 및 공동 작업 대시보드 개발에 Databricks Git 폴더를 사용하는 방법을 설명합니다. 또한 CI/CD 프로세스를 구현하여 다양한 작업 영역에서 대시보드를 개발하고 배포하는 방법을 설명합니다.

중요하다

이 기능은 공개 미리보기 단계에 있습니다.

개요

Databricks Git 폴더는 대시보드 변경 내용 및 기록을 추적하고, 팀 공동 작업을 지원하며, 프로덕션에 대시보드를 배포하고 이전 버전을 복구할 수 있습니다.

대시보드 소스 제어 활성화

작업 영역 관리자는 미리 보기 페이지에서 공개 미리 보기에 대한 작업 영역 액세스를 제어할 수 있습니다. 기본적으로 Git 폴더 미리 보기의 지원 대시보드집니다.

Git 통합이 대시보드와 작동하는 방식

Databricks Git 폴더는 초안 대시보드에 대한 변경 내용을 추적하고 관리합니다. 대시보드 초안은 추적된 대시보드의 모든 변경 내용을 반영합니다. Git은 웨어하우스 선택 및 일정 만들기와 같은 게시 및 예약 구성을 추적하지 않습니다. 이러한 구성을 관리하려면 UI를 사용하거나 Databricks 자산 번들 또는 AI/BI REST API를 사용하여 변경 내용을 자동화합니다.

  • 대시보드 관리에 번들을 사용하려면 대시보드를 참조 하세요.
  • REST API를 사용하여 대시보드를 게시하고 예약하려면 Lakeview API 참조를 참조하세요.

비고

Lakeview API는 AI/BI 대시보드에 이전 이름을 사용합니다.

Databricks Git 폴더는 대시보드 및 기타 작업 영역 개체에 대한 일반적인 Git 작업을 관리합니다. 자세한 내용은 Azure Databricks Git 폴더를 참조하세요.

대시보드에 소스 제어 적용

Git을 사용하여 대시보드를 추적하려면 Databricks Git 폴더에 배치합니다. 다음 옵션 중 하나를 사용합니다.

  • 새 대시보드: 기존 Databricks Git 폴더 내에 대시보드를 만들어 처음부터 소스 제어를 적용합니다.
  • 기존 대시보드: 기존 대시보드를 Databricks Git 폴더로 이동하여 Git을 사용하여 추적합니다.

원본 제어 대시보드에 대한 권한 관리

폴더 수준 권한은 대시보드를 포함하여 해당 폴더 내의 모든 개체에 적용됩니다. Git 폴더의 대시보드는 대시보드 관련 권한 외에도 부모 폴더의 사용 권한을 상속합니다. 대부분의 Git 작업에는 CAN MANAGE 권한이 필요합니다. 자세한 내용은 폴더 ACLGit 폴더 ACL을 참조하세요.

리포지토리를 사용자 고유의 Databricks Git 폴더에 복제하고, 기능 분기를 사용하고, 끌어오기 요청을 제출합니다. 다음 표에서는 다양한 개발 및 배포 단계에서 Git 폴더를 사용하여 대시보드를 관리하는 방법을 간략하게 설명합니다.

중요하다

Git 분기를 전환하는 것은 대시보드에 대한 파괴적인 작업입니다. Azure Databricks는 대상 분기에 존재하지 않는 대시보드를 제거합니다. 다시 전환하면 대시보드가 게시된 링크, 책갈피 및 API 통합을 중단하는 새 URL 및 ID로 다시 나타납니다. 전환하기 전에 대상 분기를 확인하고 나중에 모든 참조를 업데이트합니다.

프로젝트 단계 워크플로 예상되는 결과 알려진 제한 사항
초기 커밋
  • 대시보드를 작업 영역의 Git 폴더로 이동합니다.
  • 원격 Git 리포지토리에 커밋하고 푸시합니다.
Git은 원격 리포지토리에서 대시보드를 추적합니다.
발달
  • 개발자는 일반적으로 홈 폴더에 별도의 개발 분기에 Git 폴더를 만듭니다.
  • 개발 브랜치에 변경 내용을 커밋합니다.
  • 끌어오기 요청을 사용하여 개발 분기를 메인에 병합합니다.
  • 개발자는 독립적으로 작업합니다.
  • Git은 대시보드 버전을 추적합니다.
대시보드 파일은 형식을 사용합니다 JSON . SQL 쿼리는 단일 줄로 표시되며, 이로 인해 diffs가 끌어오기 요청에서 검토하기 어려울 수 있습니다.
배치
  • 사용자가 아닌 최상위 폴더의 배포 분기에 Git 폴더를 만듭니다. Databricks Git 폴더가 있는 CI/CD를 참조하세요.
  • 변경 내용을 배포 폴더로 끌어오기.
  • 이 폴더에서 대시보드를 게시합니다.
  • edit+ 액세스를 제거하고 Git에 대한 업데이트를 제한합니다.
  • 소비자와 대시보드를 공유합니다.
  • 소비자는 일관된 게시된 버전의 대시보드에 액세스합니다.
  • 동일한 폴더의 대시보드를 다른 대상 그룹과 공유할 수 있습니다.
Databricks는 작업 영역의 Git 폴더와 원격 분기를 동기화하거나 원격의 대시보드 리소스를 사용하여 Databricks 자산 번들을 배포하기 위한 기본 제공 지원을 제공하지 않습니다. 자동화하도록 CI/CD 자동화 를 설정합니다.
  • 원격 리포지토리에서 업데이트를 끌어옵니다.
  • 동기화 후 대시보드 게시
  • 업데이트 후 Databricks 자산 번들 배포

Databricks Git 폴더의 공동 작업에 대한 자세한 모범 사례는 Git 폴더를 사용하여 공동 작업을 참조하세요.

제한

AI/BI 대시보드를 사용하는 소스 제어에는 다음과 같은 제한 사항이 있습니다.

  • 단일 Git 폴더에서 최대 100개의 대시보드를 커밋할 수 있습니다. 이 제한은 공개 미리 보기 중에 변경될 수 있습니다.
  • 작업 영역 자산 ID 또는 경로 대신 Git URL을 참조하는 작업과 같은 Git 기반 작업은 대시보드에서 작동하지 않습니다.
  • 대시보드 serialization은 긴 문자열을 생성하므로 끌어오기 요청 중에 차이를 읽고 검토하기가 어렵습니다.
  • 대시보드 파일 형식은 새 필드 및 기타 개선 사항을 포함하도록 주기적으로 변경됩니다. 공개 미리 보기 중에 이러한 변경 내용은 시작하지 않은 Git의 차이로 나타날 수 있습니다.