apps 명령 그룹

Note

Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.

apps Databricks CLI 내의 명령 그룹을 사용하면 앱을 관리할 수 있습니다. 앱은 고객의 Databricks 인스턴스에서 직접 실행되고, 데이터와 통합되고, Databricks 서비스를 사용 및 확장하며, 사용자가 Single Sign-On을 통해 상호 작용할 수 있도록 합니다. Databricks 앱을 참조하세요.

databricks 앱 만들기

새 앱 만들기

databricks apps create NAME [flags]

Arguments

NAME

    앱의 이름입니다. 이름에는 소문자 영숫자 및 하이픈만 포함되어야 합니다. 작업 영역 내에서 고유해야 합니다.

Options

--budget-policy-id string

    앱의 예산 정책 ID입니다.

--compute-size ComputeSize

    앱의 컴퓨팅 크기입니다. 지원되는 값: LARGE, MEDIUM.

--description string

    앱에 대한 설명입니다.

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

--no-compute

    true이면 만든 후에 앱이 시작되지 않습니다.

--no-wait

    활성 상태에 도달할 때까지 기다리지 마세요.

--space string

    이 앱이 속한 공간의 이름입니다.

--timeout duration

    ACTIVE 상태에 도달하는 최대 시간(기본값: 20m0s)입니다.

--usage-policy-id string

    앱의 사용 정책 ID입니다.

전역 플래그

Examples

다음 예제에서는 기본 앱을 만듭니다.

databricks apps create my-analytics-app --description "Analytics dashboard app"

다음 예제에서는 앱을 시작하지 않고 만듭니다.

databricks apps create my-data-app --description "Data processing app" --no-compute

다음 예제에서는 사용자 지정 시간 제한으로 앱을 만듭니다.

databricks apps create my-ml-app --description "Machine learning app" --timeout 30m

databricks 앱 만들기-업데이트

앱 업데이트를 만들고 업데이트 프로세스를 시작합니다. 업데이트 프로세스는 비동기이며 GetAppUpdate 메서드를 사용하여 업데이트 상태를 확인할 수 있습니다.

databricks apps create-update APP_NAME UPDATE_MASK [flags]

Arguments

APP_NAME

    앱의 이름입니다.

UPDATE_MASK

    필드 마스크는 쉼표(공백 없음)로 구분된 여러 필드가 있는 단일 문자열이어야 합니다. 필드 경로는 점(.)을 사용하여 하위 필드(예: author.given_name)를 탐색하는 리소스 개체를 기준으로 합니다. 전체 컬렉션 필드만 지정할 수 있으므로 시퀀스 또는 맵 필드의 요소 사양은 허용되지 않습니다. 필드 이름은 리소스 필드 이름과 정확히 일치해야 합니다.

    *의 필드 마스크는 전체 교체를 나타냅니다. API가 나중에 변경될 경우 의도하지 않은 결과가 발생할 수 있으므로 항상 업데이트되는 필드를 명시적으로 나열하고 * 와일드카드를 사용하지 않는 것이 좋습니다.

Options

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

--no-wait

    SUCCEEDED 상태에 도달할 때까지 기다리지 마십시오.

--timeout duration

    SUCCEEDED 상태에 도달하는 최대 시간(기본값 20m0s)입니다.

전역 플래그

Examples

다음 예제에서는 특정 필드 마스크를 사용하여 앱 업데이트를 만듭니다.

databricks apps create-update my-analytics-app "description" --json '{"description": "Updated app description"}'

다음 예제에서는 완료를 기다리지 않고 앱 업데이트를 만듭니다.

databricks apps create-update my-data-app "budget_policy_id" --json '{"budget_policy_id": "new-policy-123"}' --no-wait

다음 예제에서는 사용자 지정 시간 제한으로 앱 업데이트를 만듭니다.

databricks apps create-update my-ml-app "description,budget_policy_id" --json '{"description": "Updated ML app", "budget_policy_id": "ml-policy-456"}' --timeout 30m

databricks 앱 삭제

앱을 삭제합니다.

인수 없이 databricks.yml Databricks Apps 프로젝트 디렉터리(포함NAME)에서 실행하면 이 명령은 프로젝트에서 배포된 모든 리소스를 삭제합니다. 인수가 NAME 제공되거나 프로젝트 디렉터리에 없는 경우 API를 사용하여 지정된 앱을 직접 삭제합니다.

databricks apps delete [NAME] [flags]

Arguments

NAME

    앱의 이름입니다. 프로젝트 디렉터리에 없는 경우 필요합니다. 프로젝트 디렉터리에 제공된 경우 프로젝트 삭제 대신 API 삭제를 사용합니다.

Options

--auto-approve

    리소스 및 파일 삭제에 대한 대화형 승인을 건너뜁니다.

--force-lock

    배포 잠금을 강제로 획득합니다.

전역 플래그

Examples

다음 예제에서는 앱을 삭제합니다.

databricks apps delete my-analytics-app

다음 예제에서는 프로젝트 디렉터리에서 모든 프로젝트 리소스를 삭제합니다.

databricks apps delete

다음 예제에서는 자동 승인을 사용하여 프로젝트 리소스를 삭제합니다.

databricks apps delete --auto-approve

Databricks 앱 배포

앱 배포를 만듭니다.

인수 없이 databricks.yml Databricks Apps 프로젝트 디렉터리(포함APP_NAME)에서 실행하는 경우 이 명령은 프로젝트의 유효성을 검사하고 작업 영역에 배포하고 앱을 실행하는 향상된 배포 파이프라인을 실행합니다. 인수가 APP_NAME 제공되거나 프로젝트 디렉터리에 없는 경우 API를 사용하여 직접 앱 배포를 만듭니다.

databricks apps deploy [APP_NAME] [flags]

Arguments

APP_NAME

    앱의 이름입니다. 프로젝트 디렉터리에 없는 경우 필요합니다. 프로젝트 디렉터리에 제공된 경우 프로젝트 배포 대신 API 배포를 사용합니다.

Options

--deployment-id string

    배포의 고유 ID입니다.

--force

    Git 분기 유효성 검사를 강제로 재정의합니다.

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

--mode AppDeploymentMode

    배포에서 소스 코드를 관리하는 모드입니다. 지원되는 값: AUTO_SYNC, SNAPSHOT.

--no-wait

    SUCCEEDED 상태에 도달할 때까지 기다리지 마십시오.

--skip-tests

    유효성 검사 중에 테스트 실행을 건너뜁니다(기본값 true).

--skip-validation

    프로젝트 유효성 검사(빌드, typecheck, lint)를 건너뜁니다.

--source-code-path string

    앱 배포를 만드는 데 사용되는 소스 코드의 작업 영역 파일 시스템 경로입니다.

--timeout duration

    SUCCEEDED 상태에 도달하는 최대 시간(기본값 20m0s)입니다.

전역 플래그

Examples

다음 예제에서는 자동 동기화 모드를 사용하여 배포를 만듭니다.

databricks apps deploy my-analytics-app --source-code-path /Workspace/Users/someone@example.com/my-app --mode AUTO_SYNC

다음 예제에서는 스냅샷 모드를 사용하여 배포를 만듭니다.

databricks apps deploy my-data-app --source-code-path /Workspace/Users/someone@example.com/data-app --mode SNAPSHOT

다음 예제에서는 사용자 지정 배포 ID를 사용하여 배포를 만듭니다.

databricks apps deploy my-ml-app --deployment-id "v1.2.3" --source-code-path /Workspace/Users/someone@example.com/ml-app

databricks 앱 가져오기

제공된 이름으로 앱에 대한 정보를 가져옵니다.

databricks apps get NAME [flags]

Arguments

NAME

    앱의 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 앱 정보를 가져옵니다.

databricks apps get my-analytics-app

다음 예제에서는 JSON 형식으로 앱 정보를 가져옵니다.

databricks apps get my-data-app --output json

다음 예제에서는 특정 프로필을 사용하여 앱 정보를 가져옵니다.

databricks apps get my-ml-app --profile production

databricks 앱 배포

제공된 이름 및 배포 ID를 사용하여 앱 배포에 대한 정보를 가져옵니다.

databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]

Arguments

APP_NAME

    앱의 이름입니다.

DEPLOYMENT_ID

    배포의 고유 ID입니다.

Options

전역 플래그

Examples

다음 예제에서는 배포 정보를 가져옵니다.

databricks apps get-deployment my-analytics-app v1.0.0

다음 예제에서는 JSON 형식으로 배포 정보를 가져옵니다.

databricks apps get-deployment my-data-app v2.1.0 --output json

다음 예제에서는 특정 프로필을 사용하여 배포 정보를 가져옵니다.

databricks apps get-deployment my-ml-app latest --profile production

databricks 앱 get-update

앱 업데이트의 상태를 가져옵니다.

databricks apps get-update APP_NAME [flags]

Arguments

APP_NAME

    앱의 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 앱 업데이트의 상태를 가져옵니다.

databricks apps get-update my-analytics-app

다음 예제에서는 JSON 형식으로 업데이트 상태를 가져옵니다.

databricks apps get-update my-data-app --output json

다음 예제에서는 특정 프로필을 사용하여 업데이트 상태를 가져옵니다.

databricks apps get-update my-ml-app --profile production

databricks 앱 가져오기

(실험적) 기존 Databricks 앱을 번들로 가져옵니다.

기존 Databricks 앱을 가져와서 번들 구성으로 변환합니다. 이 명령은 앱 구성을 사용하여 새 번들 디렉터리를 만들고, 앱 소스 코드를 다운로드하고, 번들을 기존 앱에 바인딩하고, 직접 배포 모드를 사용하여 배포합니다.

databricks apps import [flags]

Arguments

None

Options

--cleanup

    이전 앱 폴더 및 모든 내용을 정리합니다.

--force-import

    이미 가져온 앱을 강제로 다시 가져옵니다(소유한 앱에 대해서만 작동).

--name string

    가져올 앱의 이름입니다. 지정하지 않으면 대화형 선택을 위한 모든 앱을 나열합니다.

--output-dir string

    번들을 출력할 디렉터리입니다. 기본값은 앱 이름입니다.

-q, --quiet

    정보 메시지를 표시하지 않습니다(오류 및 프롬프트만 표시).

전역 플래그

Examples

다음 예제에서는 앱을 가져와서 앱의 이름을 딴 디렉터리를 만듭니다.

databricks apps import --name my-streamlit-app

다음 예제에서는 사용자 지정 출력 디렉터리가 있는 앱을 가져옵니다.

databricks apps import --name my-app --output-dir ~/my-apps/analytics

다음 예제에서는 앱을 가져오고 이전 앱 폴더를 정리합니다.

databricks apps import --name my-app --cleanup

databricks 앱 목록

작업 영역의 모든 앱을 나열합니다.

databricks apps list [flags]

Arguments

None

Options

--page-size int

    반환된 항목의 상한입니다.

--page-token string

    앱의 다음 페이지로 이동하는 페이지 매김 토큰입니다.

--space string

    앱 공간 이름을 사용하여 앱을 필터링합니다.

전역 플래그

Examples

다음 예제에서는 모든 앱을 나열합니다.

databricks apps list

다음 예제에서는 특정 페이지 크기의 앱을 나열합니다.

databricks apps list --page-size 10

다음 예제에서는 페이지 매김이 있는 앱을 나열합니다.

databricks apps list --page-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

databricks 앱 배포 목록

제공된 이름으로 앱에 대한 모든 앱 배포를 나열합니다.

databricks apps list-deployments APP_NAME [flags]

Arguments

APP_NAME

    앱의 이름입니다.

Options

--page-size int

    반환된 항목의 상한입니다.

--page-token string

    앱의 다음 페이지로 이동하는 페이지 매김 토큰입니다.

전역 플래그

Examples

다음 예제에서는 앱에 대한 모든 배포를 나열합니다.

databricks apps list-deployments my-analytics-app

다음 예제에서는 특정 페이지 크기의 배포를 나열합니다.

databricks apps list-deployments my-data-app --page-size 10

databricks 앱 로그

로그 스트림을 사용하여 Databricks 앱에 대한 stdout/stderr 로그를 스트리밍합니다. 기본적으로 이 명령은 가장 최근의 로그를 최대로 --tail-lines 가져오고 종료합니다. 서버 쪽 필터링을 사용할 --search 수 있으며 클라이언트 쪽 필터링은 .를 사용하여 --source APP|SYSTEM사용할 수 있습니다.

databricks apps logs [NAME] [flags]

Arguments

NAME

    앱의 이름입니다.

Options

-f, --follow

    취소되거나 지정된 시간 제한에 도달할 때까지 스트리밍 로그를 계속합니다.

--tail-lines int

    스트리밍하기 전에 표시할 최근 로그 줄의 수입니다. 모든 항목을 표시하도록 0 설정합니다. 기본값: 200

--timeout duration

    설정된 경우, --follow의 최대 스트리밍 시간입니다. 0로 설정하여 시간 제한을 사용하지 않도록 합니다.

--search string

    스트리밍하기 전에 로그 서비스에 검색어를 보냅니다.

--source strings

     APP 또는 SYSTEM 소스에 로그를 제한합니다.

--output-file string

    stdout 외에도 로그를 작성하는 선택적 파일 경로입니다.

전역 플래그

Examples

다음 예제에서는 앱에 대한 최신 로그를 가져옵니다.

databricks apps logs my-analytics-app

다음 예제에서는 중단될 때까지 로그를 지속적으로 스트리밍합니다.

databricks apps logs my-analytics-app --follow

다음 예제에서는 마지막 500줄의 로그를 가져옵니다.

databricks apps logs my-data-app --tail-lines 500

다음 예제에서는 시간 제한이 10분인 로그를 스트리밍합니다.

databricks apps logs my-ml-app --follow --timeout 10m

다음 예제에서는 검색 용어로 로그를 필터링합니다.

databricks apps logs my-analytics-app --search "error"

다음 예제에서는 로그를 앱 수준 출력으로만 제한합니다.

databricks apps logs my-data-app --source APP

다음 예제에서는 stdout 및 파일 모두에 로그를 씁니다.

databricks apps logs my-ml-app --output-file /tmp/app-logs.txt

databricks 앱 로컬 실행

로컬에서 앱을 시작합니다.

databricks apps run-local [flags]

Arguments

None

Options

--app-port int

    앱을 실행할 포트입니다(기본값 8000).

--debug

    디버그 모드를 사용하도록 설정합니다.

--debug-port string

    디버거를 실행할 포트입니다.

--entry-point string

    앱에 대한 구성(.yml 파일)을 사용하여 사용자 지정 진입점을 지정합니다. 기본값은 app.yml입니다.

--env strings

    환경 변수를 설정합니다.

--port int

    앱 프록시를 실행할 포트입니다(기본값 8001).

--prepare-environment

    앱을 실행하기 위한 환경을 준비합니다. uv를 설치해야 합니다.

전역 플래그

Examples

다음 예제에서는 기본 설정을 사용하여 로컬로 앱을 실행합니다.

databricks apps run-local

다음 예제에서는 특정 포트에서 로컬로 앱을 실행합니다.

databricks apps run-local --app-port 9000 --port 9001

databricks 앱 시작

작업 영역에서 앱의 마지막 활성 배포를 시작합니다.

databricks apps start [NAME] [flags]

Arguments

NAME

    앱의 이름입니다.

Options

--no-wait

    활성 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

    ACTIVE 상태에 도달하는 최대 시간(기본값: 20m0s)입니다.

전역 플래그

Examples

다음 예제에서는 앱을 시작합니다.

databricks apps start my-analytics-app

다음 예제에서는 기다리지 않고 앱을 시작합니다.

databricks apps start my-data-app --no-wait

다음 예제에서는 사용자 지정 시간 제한으로 앱을 시작합니다.

databricks apps start my-ml-app --timeout 30m

databricks 앱 중지

작업 영역에서 앱의 활성 배포를 중지합니다.

databricks apps stop [NAME] [flags]

Arguments

NAME

    앱의 이름입니다.

Options

--no-wait

    STOPPED 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

    STOPPED 상태에 도달하는 최대 시간(기본값 20m0s)입니다.

전역 플래그

Examples

다음 예제에서는 앱을 중지합니다.

databricks apps stop my-analytics-app

다음 예제에서는 기다리지 않고 앱을 중지합니다.

databricks apps stop my-data-app --no-wait

다음 예제에서는 사용자 지정 시간 제한으로 앱을 중지합니다.

databricks apps stop my-ml-app --timeout 30m

databricks 앱 업데이트

제공된 이름으로 앱을 업데이트합니다.

databricks apps update NAME [flags]

Arguments

NAME

    앱의 이름입니다. 이름에는 소문자 영숫자 및 하이픈만 포함되어야 합니다. 작업 영역 내에서 고유해야 합니다.

Options

--budget-policy-id string

    앱의 예산 정책 ID입니다.

--compute-size ComputeSize

    앱의 컴퓨팅 크기입니다. 지원되는 값: LARGE, MEDIUM.

--description string

    앱에 대한 설명입니다.

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

--space string

    이 앱이 속한 공간의 이름입니다.

--usage-policy-id string

    앱의 사용 정책 ID입니다.

전역 플래그

Examples

다음 예제에서는 앱의 설명을 업데이트합니다.

databricks apps update my-analytics-app --description "Updated analytics dashboard"

databricks 앱 get-permission-levels

앱 사용 권한 수준을 가져옵니다.

databricks apps get-permission-levels APP_NAME [flags]

Arguments

APP_NAME

    사용 권한을 얻거나 관리할 앱입니다.

Options

전역 플래그

Examples

다음 예제에서는 앱에 대한 사용 권한 수준을 가져옵니다.

databricks apps get-permission-levels my-analytics-app

databricks 앱 권한 가져오기

앱의 사용 권한을 가져옵니다. 앱은 루트 개체에서 권한을 상속할 수 있습니다.

databricks apps get-permissions APP_NAME [flags]

Arguments

APP_NAME

    사용 권한을 얻거나 관리할 앱입니다.

Options

전역 플래그

Examples

다음 예제에서는 앱에 대한 권한을 가져옵니다.

databricks apps get-permissions my-analytics-app

다음 예제에서는 특정 프로필을 사용하여 사용 권한을 가져옵니다.

databricks apps get-permissions my-ml-app --profile production

databricks 앱 권한 설정

앱 사용 권한을 설정합니다.

개체에 대한 사용 권한을 설정하여 기존 사용 권한이 있는 경우 대체합니다. 지정되지 않은 경우 모든 직접 권한을 삭제합니다. 개체는 루트 개체에서 사용 권한을 상속할 수 있습니다.

databricks apps set-permissions APP_NAME [flags]

Arguments

APP_NAME

    사용 권한을 얻거나 관리할 앱입니다.

Options

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

전역 플래그

Examples

다음 예제에서는 JSON 구성을 사용하여 사용 권한을 설정합니다.

databricks apps set-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'

databricks 앱 업데이트 권한

앱에 대한 사용 권한을 업데이트합니다. 앱은 루트 개체에서 권한을 상속할 수 있습니다.

databricks apps update-permissions APP_NAME [flags]

Arguments

APP_NAME

    사용 권한을 얻거나 관리할 앱입니다.

Options

--json JSON

    요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.

전역 플래그

Examples

다음 예제에서는 JSON 구성을 사용하여 권한을 업데이트합니다.

databricks apps update-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'

전역 표시기

--debug

  디버그 로깅을 사용할지 여부입니다.

-h 또는 --help

    Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.

--log-file 문자열

    출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.

--log-format 판

    로그 형식 형식 text 또는 json. 기본값은 text입니다.

--log-level 문자열

    로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.

-o, --output 유형

    명령 출력 형식 text 또는 json. 기본값은 text입니다.

-p, --profile 문자열

    명령을 실행하는 데 사용할 파일의 프로필 ~/.databrickscfg 이름입니다. 이 플래그를 지정하지 않으면 해당 플래그가 있으면 명명 DEFAULT 된 프로필이 사용됩니다.

--progress-format 판

    진행률 로그를 표시할 형식: default, append, inplace또는 json

-t, --target 문자열

    해당하는 경우 사용할 번들 대상