다음을 통해 공유

구성 참조

  • 아티클

이 문서에서는 YAML(Databricks Asset Bundles 구성)에서 지원하는 키에 대한 참조를 제공합니다. Databricks 자산 번들이란?.

전체 번들 예제는 번들 구성 예제 및 번들 예제 GitHub 리포지토리참조하세요.

유물

아티팩트를 빌드하는 설정을 정의합니다.

열쇠 유형 설명
build 문자열 배포 전에 로컬에서 실행할 비기본 빌드 명령의 선택적 set.
executable 문자열 실행 파일 형식입니다. 유효한 values은(는) bash, sh및 cmd입니다.
files 지도 아티팩트의 원본 파일은 artifact_file로 정의됩니다.
path 문자열 빌드된 아티팩트 where 위치가 저장됩니다.
type 문자열 필수. 아티팩트의 유형 values이(가) 유효한 whl입니다.

유물

아티팩트를 빌드할 특성을 정의합니다. 각 키는 아티팩트 이름이고, 값은아티팩트 빌드 설정을 정의하는 Map입니다. artifacts 매핑에 대한 자세한 내용은 아티팩트참조하세요.

번들 구성의 최상위 수준에 정의된 아티팩트 설정은 targets 매핑에서 재정의할 수 있습니다. Databricks 자산 번들에서 아티팩트 설정 정의를 보려면 을 참조하세요.

artifacts:
  <artifact-name>:
      <artifact-field-name>: <artifact-field-value>

본보기

artifacts:
  default:
    type: whl
    build: poetry build
    path: .

아티팩트_파일

번들 내 아티팩트 파일을 정의합니다.

열쇠 타입 설명
source 문자열 필수. 아티팩트 빌드에 사용되는 파일의 경로입니다.

보따리

번들의 특성 번들을 참조하십시오.

열쇠 유형 묘사
cluster_id 문자열 번들을 실행하는 데 사용할 클러스터의 ID입니다. cluster_id참조하세요.
databricks_cli_version 문자열 번들에 사용할 Databricks CLI 버전입니다. databricks_cli_version을 참조하세요.
deployment 지도 번들 배포의 정의입니다. 지원되는 특성은 배포 및 Databricks Asset Bundle 배포 모드참조하세요.
git 지도 귀하의 번들과 관련된 Git 버전 관리 세부 정보입니다. 지원되는 특성은 git 및 git참조하세요.
name 문자열 필수. 번들의 이름입니다.

배치

번들 배포 특성을 정의합니다.

열쇠 유형 묘사
fail_on_active_runs 불리언 활성 실행에서 실패할지 여부입니다. 이 작업이 set에서 true까지 실행 중인 배포라면, 중단될 수 있습니다.
lock 지도 배포 잠금의 속성입니다. 잠금참조하세요.

실험적인

실험적 기능에 대한 특성을 정의합니다.

열쇠 유형 묘사
python_wheel_wrapper 부울 Python 휠 래퍼를 사용할지의 여부입니다.
scripts 명령(문자열) 실행할 명령
use_legacy_run_as 부울 레거시 run_as 동작을 사용할지 여부입니다.

git

번들과 연결된 Git 버전 제어 세부 정보를 정의합니다. git참조하세요.

열쇠 유형 묘사
origin_url 문자열 리포지토리의 원본 URL입니다. git참조하세요.
branch 문자열 Git 브랜치 이름입니다. git참조하세요.

grant

Unity Catalog 개체에 대한 액세스를 정의합니다. 자세한 내용은 Unity를 사용하여 클라우드 객체 스토리지 및 서비스에 연결하는 방법을 참조하십시오 Catalog.

열쇠 타입 묘사
principal 문자열 필수. 권한이 부여될 사용자의 이름입니다.
privileges 문자열 필수. 지정된 엔터티에 grant 권한을 부여합니다.

예시

다음 예제에서는 Unity Catalogschema을 권한과 함께 정의합니다.

resources:
  schemas:
    my_schema:
      name: test-schema
      grants:
        - principal: users
          privileges:
            - CAN_MANAGE
        - principal: my_team
          privileges:
            - CAN_READ
      catalog_name: main
      comment: "my schema with grants"

자물쇠

번들 배포 잠금 특성을 정의합니다.

열쇠 유형 설명
enabled 부울 이 잠금을 사용할 수 있는지 여부입니다.
force 부울 사용 설정 시 이 잠금을 강제할지 여부입니다.

허가

특정 엔터티에 대한 권한을 정의합니다. Databricks 자산 번들리소스에 대한 권한 및 권한을 참조하세요.

열쇠 유형 묘사
group_name 문자열 level에서 권한 set을 가진 그룹의 이름입니다.
level 문자열 필수. 이 권한은 사용자, 그룹, 서비스 주체에 대해 정의된 허용 가능한 권한입니다.
service_principal_name 문자열 set 사용 권한이 있는 서비스 주체의 이름은 level입니다.
user_name 문자열 level에서 사용 권한 set의 사용자 이름입니다.

권한

시퀀스의 각 항목이 특정 엔터티에 대한 권한where 번들에 정의된 실험, 작업, 파이프라인 및 모델에 적용할 권한을 정의하는 시퀀스입니다.

Databricks 자산 번들리소스에 대한 권한 및 권한을 참조하세요.

예시

permissions:
  - level: CAN_VIEW
    group_name: test-group
  - level: CAN_MANAGE
    user_name: someone@example.com
  - level: CAN_RUN
    service_principal_name: 123456-abcdef

프리셋 설정

번들 배포 사전 설정을 정의합니다. 사용자 지정 사전 설정참조하세요.

열쇠 유형 묘사
jobs_max_concurrent_runs 정수 작업의 최대 동시 실행 수입니다.
name_prefix 문자열 번들 내 작업 실행 인스턴스에 대한 접두사입니다.
pipelines_development 불리언 파이프라인 배포를 개발 모드에서 잠가야 하는지 여부입니다.
source_linked_deployment 불리언 (부울) 배포를 번들 원본에 연결할지 여부입니다.
tags 지도 번들 배포에 대한 태그입니다.
trigger_pause_status 문자열 모든 작업 트리거 및 일정에 적용할 일시 중지 상태입니다. 유효한 values는 PAUSED 또는 UNPAUSED입니다.

리소스

번들이 사용할 리소스를 정의하는 맵입니다. where 각 키는 리소스의 이름이며, 값은 리소스를 정의하는 맵입니다. Databricks 자산 번들 지원 리소스 및 리소스 정의 참조에 대한 자세한 내용은 Databricks Asset Bundles 리소스참조하세요.

resources:
  <resource-type>s:
    <resource-name>:
      <resource-field-name>: <resource-field-value>
열쇠 타입 묘사
clusters 지도 번들에 대한 클러스터 정의 where 각 키는 클러스터의 이름입니다. 클러스터를 참조하세요.
dashboards 지도 각 키에 where 번들에 대한 대시보드 정의는 대시보드의 이름입니다. 대시보드를에서 확인하세요
experiments 지도 번들에 대한 실험 정의는 where이며, 각 키는 실험의 이름입니다. 실험 참조
jobs 지도 번들에 대한 작업 정의 where 각 키는 작업의 이름입니다. 작업 참조
model_serving_endpoints 지도 번들에 대한 엔드포인트 정의를 제공하는 모델 where 각 키는 엔드포인트를 제공하는 모델의 이름입니다. model_serving_endpoint 참조
models 지도 where 번들에 대한 모델 정의로, 각 키는 모델의 이름입니다. 모델(레거시) 참조
pipelines 지도 번들에 대한 파이프라인 정의 where 각 키는 파이프라인의 이름입니다. 파이프라인 확인하세요
quality_monitors 지도 번들에 대한 품질 모니터 정의에서, 각 키 where는 품질 모니터의 이름입니다. quality_monitor (Unity Catalog)를 참조.
registered_models 지도 번들에 등록된 모델 정의는 where이며, 각 키는 Unity Catalog에 등록된 모델의 이름입니다. 등록된 모델(Unity Catalog)을 참조하십시오.
schemas 지도 번들에 대한 schema 정의입니다. where 각 키는 schema이름입니다. schema(Unity Catalog) 참조
volumes 지도 번들의 볼륨 정의에서, where는 각 키가 볼륨의 이름임을 나타냅니다. 볼륨(Unity Catalog) 참조

run_as

Databricks 자산 번들 워크플로를 실행할 때 사용할 ID입니다. Databricks Asset Bundles 워크플로대한 실행 ID 지정을 참조하세요.

열쇠 타입 묘사
service_principal_name 문자열 활성 서비스 주체의 애플리케이션 ID입니다. 이 필드를 설정하려면 servicePrincipal/user 역할이 필요합니다.
user_name 문자열 활성 작업 영역 사용자의 전자 메일입니다. 관리자가 아닌 사용자는 이 필드를 자신의 전자 메일로만 set 수 있습니다.

sync

번들에 포함하거나 제외할 파일 및 파일 경로입니다. sync참조하십시오.

열쇠 유형 묘사
exclude 순서 번들에서 제외할 list 파일 또는 폴더.
include 순서 파일 또는 폴더의 list을(를) 번들에 포함합니다.
paths 순서 배포 시 번들 루트 외부에 있을 수 있는 로컬 폴더 경로를 작업 영역과 동기화합니다.

과녁

번들에 대한 배포 대상을 정의합니다. 의 대상을 참조하세요.

열쇠 유형 묘사
artifacts 지도 대상 배포에 포함될 아티팩트입니다. 아티팩트참조하세요.
bundle 지도 이 대상에 배포할 때의 번들 특성입니다.
cluster_id 문자열 이 대상에 사용할 클러스터의 ID입니다.
compute_id 문자열 더 이상 사용되지 않음. 이 대상에 사용할 컴퓨팅의 ID입니다.
default 부울 이 대상이 기본 대상인지 여부입니다.
git 지도 대상에 대한 Git 버전 제어 설정입니다. git확인하세요.
mode 문자열 대상의 배포 모드입니다. 유효한 values는 development 또는 production입니다. Databricks 자산 번들 배포 모드를 참조하십시오.
permissions 순서 대상 시스템에서 번들을 배포하고 실행하기 위한 권한입니다. 권한참조하세요.
presets 지도 대상에 대한 배포 사전 설정입니다. 사전 설정참조하세요.
resources 지도 대상에 대한 리소스 정의입니다. 리소스를참조하세요.
run_as 지도 번들을 실행하는 데 사용할 ID입니다. run_as 보시고 Databricks 자산 번들 워크플로에 대한 실행 ID를 지정합니다.
sync 지도 번들이 실행되거나 배포될 때 sync의 로컬 경로는 대상 작업 영역으로 향합니다. sync를 참조하세요.
variables 지도 대상에 대한 사용자 지정 변수 정의입니다. Databricks 자산 번들변수 및 대체 및 변수를 참조하세요.
workspace 지도 목표 대상의 Databricks 작업 공간입니다. 작업 영역

변수

번들에 대한 사용자 지정 변수를 정의하는 맵입니다. 여기서 where은 각 키가 변수의 이름이며, 그 값은 변수를 정의하는 맵입니다. Databricks 자산 번들대체 및 변수를 참조하세요.

열쇠 유형 묘사
변수 이름 지도 변수의 정의입니다. 변수-이름참조하세요.

변수 이름

각 변수 정의에는 다음과 같은 특성이 있습니다.

열쇠 유형 묘사
description 문자열 변수에 대한 설명입니다.
lookup 문자열 ID를 검색할 alert, cluster_policy, cluster, dashboard, instance_pool, job, metastore, pipeline, query, service_principal또는 warehouse 개체의 이름입니다.
type 문자열 변수의 형식입니다. values는 유효한 complex입니다.

작업 공간

Databricks 작업 공간을 번들용으로 정의합니다. 작업 영역을 참조하십시오.

열쇠 타입 설명
artifact_path 문자열 배포 및 워크플로 실행에 대해 작업 영역 내에서 사용할 아티팩트 경로
auth_type 문자열 인증 유형입니다.
azure_client_id 문자열 Azure 클라이언트 ID입니다.
azure_environment 문자열 Azure 환경입니다.
azure_login_app_id 문자열 Azure 로그인 앱 ID입니다.
azure_tenant_id 문자열 Azure 테넌트 ID입니다.
azure_use_msi 부울 Azure에 MSI를 사용할지 여부입니다.
azure_workspace_resource_id 문자열 Azure 작업 영역 리소스 ID입니다.
client_id 문자열 작업 영역의 클라이언트 ID입니다.
file_path 문자열 배포 및 워크플로 실행 모두에 대해 작업 영역 내에서 사용할 파일 경로입니다.
google_service_account 문자열 Google 서비스 계정 이름입니다.
host 문자열 Databricks 작업 영역 호스트 URL입니다.
profile 문자열 Databricks 작업 영역 프로필 이름입니다.
resource_path 문자열 작업 영역 리소스 경로입니다.
root_path 문자열 Databricks 작업 영역 루트 경로입니다.
state_path 문자열 작업 영역 상태 경로입니다.