volumes 명령 그룹

Note

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

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

volumes 내의 명령 그룹에는 Unity 카탈로그에서 볼륨을 관리하는 명령이 포함되어 있습니다. 볼륨은 파일 액세스, 저장, 관리, 구성 및 처리를 위한 기능을 제공합니다. Unity 카탈로그 볼륨이란 무엇인가?를 참조하십시오.

databricks에서 볼륨 생성

새 볼륨을 만듭니다.

사용자는 외부 볼륨 또는 관리되는 볼륨을 만들 수 있습니다. 외부 볼륨은 지정된 외부 위치에 생성되고 관리되는 볼륨은 부모 스키마 또는 부모 카탈로그 또는 메타스토어로 지정된 기본 위치에 있습니다.

볼륨 생성이 성공하려면 사용자가 다음 조건을 충족해야 합니다.

• 호출자는 메타스토어 관리자이거나 부모 카탈로그 및 스키마 USE_CATALOG 의 소유자이거나 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
• 호출자는 부모 스키마에 대한 권한이 있어야 합니다 CREATE VOLUME .

외부 볼륨의 경우 다음 조건도 충족해야 합니다.

• 호출자는 외부 위치에 대한 권한이 있어야 합니다 CREATE EXTERNAL VOLUME .
• 지정된 스토리지 위치에 다른 테이블이나 볼륨이 존재하지 않습니다. - 지정된 스토리지 위치가 다른 테이블이나 볼륨, 카탈로그 또는 스키마의 위치에 있지 않습니다.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    스키마와 볼륨이 있는 카탈로그의 이름

SCHEMA_NAME

    볼륨이 있는 스키마의 이름입니다.

NAME

    볼륨의 이름

VOLUME_TYPE

    볼륨의 형식입니다. 외부 볼륨은 지정된 외부 위치에 있습니다. 관리되는 볼륨은 부모 스키마 또는 부모 카탈로그 또는 Metastore에 의해 지정된 기본 위치에 있습니다. 관리 볼륨과 외부 볼륨을 참조하세요. 지원되는 값: EXTERNAL, MANAGED

Options

--comment string

    볼륨에 첨부된 주석입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--storage-location string

    클라우드의 스토리지 위치입니다.

전역 플래그

Examples

다음 예제에서는 관리되는 볼륨을 만듭니다.

databricks volumes create my_catalog my_schema my_volume MANAGED

다음 예제에서는 주석이 있는 외부 볼륨을 만듭니다.

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

데이터브릭스 볼륨 삭제

지정된 부모 카탈로그 및 스키마에서 볼륨을 삭제합니다.

호출자는 메타스토어 관리자 또는 볼륨의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.

databricks volumes delete NAME [flags]

Arguments

NAME

    볼륨의 세 수준(정규화된) 이름

Options

전역 플래그

Examples

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

databricks volumes delete my_catalog.my_schema.my_volume

databricks 볼륨 목록

부모 카탈로그 및 스키마 아래의 현재 메타스토어에 대한 볼륨을 나열합니다.

반환된 볼륨은 호출하는 사용자의 권한에 따라 필터링됩니다. 예를 들어 metastore 관리자는 모든 볼륨을 나열할 수 있습니다. 일반 사용자는 소유자이거나 READ VOLUME 볼륨에 대한 권한이 있어야 응답에서 볼륨을 받을 수 있습니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.

배열에 있는 요소의 특정 순서는 보장되지 않습니다.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    카탈로그의 식별자입니다.

SCHEMA_NAME

    스키마의 식별자입니다.

Options

--include-browse

    주체가 선택적 메타데이터에만 접근할 수 있는 경우 응답에 볼륨을 포함할지의 여부입니다.

--max-results int

    반환할 최대 볼륨 수(페이지 길이)입니다.

--page-token string

    이전 요청에서 반환된 불투명 토큰입니다.

전역 플래그

Examples

다음 예제에서는 카탈로그 및 스키마의 모든 볼륨을 나열합니다.

databricks volumes list my_catalog my_schema

databricks 데이터 볼륨 읽기

특정 카탈로그 및 스키마에 대한 메타스토어에서 볼륨을 가져옵니다.

호출자는 메타스토어 관리자이거나, 볼륨의 소유자이거나, READ VOLUME 권한을 가지고 있어야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.

databricks volumes read NAME [flags]

Arguments

NAME

    볼륨의 세 수준(정규화된) 이름

Options

--include-browse

    주체가 선택적 메타데이터에만 접근할 수 있는 경우 응답에 볼륨을 포함할지의 여부입니다.

전역 플래그

Examples

다음 예제에서는 볼륨에 대한 정보를 가져옵니다.

databricks volumes read my_catalog.my_schema.my_volume

다음 예제에서는 찾아보기 메타데이터를 비롯한 볼륨 정보를 가져옵니다.

databricks volumes read my_catalog.my_schema.my_volume --include-browse

databricks 볼륨 업데이트

지정된 부모 카탈로그 및 스키마에서 지정된 볼륨을 업데이트합니다.

호출자는 메타스토어 관리자 또는 볼륨의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.

현재는 볼륨의 이름, 소유자 또는 주석만 업데이트할 수 있습니다.

databricks volumes update NAME [flags]

Arguments

NAME

    볼륨의 세 수준(정규화된) 이름

Options

--comment string

    볼륨에 첨부된 주석입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--new-name string

    볼륨의 새로운 이름

--owner string

    볼륨을 소유한 사용자의 식별자입니다.

전역 플래그

Examples

다음 예제에서는 볼륨의 코멘트를 업데이트합니다.

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

다음 예제에서는 볼륨의 소유자를 변경합니다.

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

다음 예제에서는 볼륨의 이름을 바꿉니다.

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

전역 플래그

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

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