Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
external-locations 내의 명령 그룹에는 Unity 카탈로그의 외부 위치를 만들고 관리하는 명령이 포함되어 있습니다.
Unity 카탈로그 볼륨이란 무엇인가?를 참조하십시오.
databricks 외부 위치 생성하기
metastore에서 새 외부 위치 항목을 만듭니다. 호출자는 metastore 관리자이거나 CREATE_EXTERNAL_LOCATION metastore 및 연결된 스토리지 자격 증명 모두에 대한 권한이 있어야 합니다.
databricks external-locations create NAME URL CREDENTIAL_NAME [flags]
Arguments
NAME
외부 위치의 이름입니다.
URL
외부 위치의 경로 URL입니다.
CREDENTIAL_NAME
이 위치에 사용되는 스토리지 자격 증명의 이름입니다.
Options
--comment string
사용자가 제공한 자유 형식 텍스트 설명입니다.
--enable-file-events
이 외부 위치에서 파일 이벤트를 사용하도록 설정할지 여부입니다.
--fallback
이 외부 위치에 대해 대체 모드를 사용할 수 있는지 여부를 나타냅니다.
--json JSON
요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.
--read-only
외부 위치가 읽기 전용인지 여부를 나타냅니다.
--skip-validation
외부 위치와 연결된 스토리지 자격 증명의 유효성 검사를 건너뜁니다.
Examples
다음 예제에서는 주석이 있는 외부 위치를 만듭니다.
databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"
다음 예제에서는 읽기 전용 외부 위치를 만듭니다.
databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only
databricks 외부 위치 삭제
메타스토어에서 지정된 외부 위치를 삭제합니다. 호출자는 외부 위치의 소유자여야 합니다.
databricks external-locations delete NAME [flags]
Arguments
NAME
외부 위치의 이름입니다.
Options
--force
종속 외부 테이블이나 마운트가 있는 경우에도 강제로 삭제합니다.
Examples
다음 예제에서는 다음과 같은 외부 my-external-location위치를 삭제합니다.
databricks external-locations delete my-external-location
다음 예제에서는 종속성이 있더라도 외부 위치를 강제로 삭제합니다.
databricks external-locations delete my-external-location --force
databricks 외부 위치 가져오기
메타스토어에서 외부 위치를 가져옵니다. 호출자는 메타스토어 관리자, 외부 위치의 소유자 또는 외부 위치에 대한 권한이 있는 사용자여야 합니다.
databricks external-locations get NAME [flags]
Arguments
NAME
외부 위치의 이름입니다.
Options
--include-browse
보안 주체가 선택적 메타데이터에만 액세스할 수 있는 응답에 외부 위치를 포함할지 여부입니다.
Examples
다음 예제에서는 이름이 지정된 my-external-location외부 위치에 대한 정보를 가져옵니다.
databricks external-locations get my-external-location
다음 예제에서는 브라우징 메타데이터를 포함한 정보를 얻습니다.
databricks external-locations get my-external-location --include-browse
databricks 외부 위치 목록
메타스토어의 외부 위치를 나열합니다. 호출자는 메타스토어 관리자, 외부 위치의 소유자 또는 외부 위치에 대한 권한이 있는 사용자여야 합니다. 배열에 있는 요소의 특정 순서는 보장되지 않습니다.
databricks external-locations list [flags]
Options
--include-browse
보안 주체가 선택적 메타데이터에만 액세스할 수 있는 응답에 외부 위치를 포함할지 여부입니다.
--include-unbound
작업 영역에 바인딩되지 않은 외부 위치를 포함할지 여부입니다.
--max-results int
반환할 최대 외부 위치 수.
--page-token string
이전 쿼리에 따라 다음 페이지로 이동하는 불투명 페이지 매김 토큰입니다.
Examples
다음 예제에서는 모든 외부 위치를 나열합니다.
databricks external-locations list
다음 예제에서는 최대 10개의 결과가 있는 외부 위치를 나열합니다.
databricks external-locations list --max-results 10
databricks 외부 위치 업데이트
메타스토어의 외부 위치를 업데이트합니다. 호출자는 외부 위치의 소유자이거나 metastore 관리자여야 합니다. 두 번째 경우 관리자는 외부 위치의 이름만 업데이트할 수 있습니다.
databricks external-locations update NAME [flags]
Arguments
NAME
외부 위치의 이름입니다.
Options
--comment string
사용자가 제공한 자유 형식 텍스트 설명입니다.
--credential-name string
이 위치에 사용되는 스토리지 자격 증명의 이름입니다.
--enable-file-events
이 외부 위치에서 파일 이벤트를 사용하도록 설정할지 여부입니다.
--fallback
이 외부 위치에 대해 대체 모드를 사용할 수 있는지 여부를 나타냅니다.
--force
URL을 변경하면 종속 외부 테이블 또는 탑재가 무효화되더라도 강제로 업데이트합니다.
--isolation-mode IsolationMode
지원되는 값: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN
--json JSON
요청 본문이 @path 있는 인라인 JSON 문자열 또는 JSON 파일에 대한 문자열입니다.
--new-name string
외부 위치의 새 이름입니다.
--owner string
외부 위치의 소유자입니다.
--read-only
외부 위치가 읽기 전용인지 여부를 나타냅니다.
--skip-validation
외부 위치와 연결된 스토리지 자격 증명의 유효성 검사를 건너뜁니다.
--url string
외부 위치의 경로 URL입니다.
Examples
다음 예제에서는 외부 위치의 이름을 바꿉니다.
databricks external-locations update my-external-location --new-name my-renamed-location
다음 예제에서는 외부 위치의 소유자를 변경합니다.
databricks external-locations update my-external-location --owner someone@example.com
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상