apps 명령 그룹

Note

이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.

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입니다.

--description string

    앱에 대한 설명입니다.

--json JSON

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

--no-compute

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

--no-wait

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

--timeout duration

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

전역 플래그

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 앱 삭제

앱을 삭제합니다.

databricks apps delete NAME [flags]

Arguments

NAME

    앱의 이름입니다.

Options

전역 플래그

Examples

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

databricks apps delete my-analytics-app

Databricks 앱 배포

제공된 이름으로 앱의 배포를 설정합니다.

databricks apps deploy APP_NAME [flags]

Arguments

APP_NAME

    앱의 이름입니다.

Options

--deployment-id string

    배포의 고유 ID입니다.

--json JSON

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

--mode AppDeploymentMode

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

--no-wait

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

--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 앱 목록

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

databricks apps list [flags]

Arguments

None

Options

--page-size int

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

--page-token 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입니다.

--description string

    앱에 대한 설명입니다.

--json JSON

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

전역 플래그

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 문자열

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