Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
storage-credentials 내의 명령 그룹에는 Unity 카탈로그에서 스토리지 자격 증명을 관리하는 명령이 포함되어 있습니다. 스토리지 자격 증명은 클라우드 테넌트에 저장된 데이터에 액세스하기 위한 인증 및 권한 부여 메커니즘을 나타냅니다. 각 스토리지 자격 증명에는 자격 증명에 액세스할 수 있는 사용자 및 그룹을 제어하는 Unity 카탈로그 액세스 제어 정책이 적용됩니다. 사용자가 Unity 카탈로그의 스토리지 자격 증명에 액세스할 수 없는 경우 요청이 실패하고 Unity 카탈로그가 사용자를 대신하여 클라우드 테넌트에 인증을 시도하지 않습니다. 스토리지 자격 증명 관리를 참조하세요.
데이터브릭스 저장소 자격 증명 생성
새 스토리지 자격 증명을 만듭니다.
호출자는 metastore 관리자이거나 CREATE_STORAGE_CREDENTIAL metastore에 대한 권한이 있어야 합니다.
databricks storage-credentials create NAME [flags]
Arguments
NAME
자격 증명 이름입니다. 이름은 메타스토어 내의 스토리지 및 서비스 자격 증명 사이에서 고유해야 합니다.
Options
--comment string
자격 증명과 연결된 주석입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--read-only
자격 증명을 읽기 작업에만 사용할 수 있는지 여부입니다.
--skip-validation
이 인수에 true를 제공하면 생성된 자격 증명의 유효성 검사가 건너뜁니다.
Examples
다음 예제에서는 새 스토리지 자격 증명을 만듭니다.
databricks storage-credentials create my-storage-credential
다음 예제에서는 주석이 있는 스토리지 자격 증명을 만듭니다.
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
다음 예제에서는 읽기 전용 스토리지 자격 증명을 만듭니다.
databricks storage-credentials create my-storage-credential --read-only
databricks 저장소 자격 증명 삭제
metastore에서 스토리지 자격 증명을 삭제합니다. 호출자는 스토리지 자격 증명의 소유자여야 합니다.
databricks storage-credentials delete NAME [flags]
Arguments
NAME
스토리지 자격 증명의 이름입니다.
Options
--force
종속 외부 위치 또는 외부 테이블(목적 STORAGE이 있는 경우) 또는 종속 서비스(목적 SERVICE이 있는 경우)가 있더라도 강제로 업데이트합니다.
Examples
다음 예제에서는 스토리지 자격 증명을 삭제합니다.
databricks storage-credentials delete my-storage-credential
다음 예제에서는 스토리지 자격 증명을 강제로 삭제합니다.
databricks storage-credentials delete my-storage-credential --force
databricks storage-credentials get
metastore에서 스토리지 자격 증명을 가져옵니다. 호출자는 메타스토어 관리자이거나 스토리지 자격 증명의 소유자이거나 스토리지 자격 증명에 대한 일부 권한이 있어야 합니다.
databricks storage-credentials get NAME [flags]
Arguments
NAME
스토리지 자격 증명의 이름입니다.
Options
Examples
다음 예제에서는 스토리지 자격 증명에 대한 정보를 가져옵니다.
databricks storage-credentials get my-storage-credential
databricks 스토리지 자격 증명 목록
스토리지 자격 증명을 나열합니다. 이 목록은 호출자가 액세스할 수 있는 권한이 있는 스토리지 자격 증명으로만 제한됩니다. 호출자가 metastore 관리자인 경우 자격 증명 검색은 제한되지 않습니다. 배열에 있는 요소의 특정 순서는 보장되지 않습니다.
databricks storage-credentials list [flags]
Options
--max-results int
반환할 스토리지 자격 증명의 최대 수입니다.
--page-token string
이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.
Examples
다음 예제에서는 모든 스토리지 자격 증명을 나열합니다.
databricks storage-credentials list
databricks 스토리지 자격 증명 업데이트
metastore에서 스토리지 자격 증명을 업데이트합니다.
호출자는 스토리지 자격 증명 또는 메타스토어 관리자의 소유자여야 합니다. 호출자가 metastore 관리자인 경우 필드만 owner 변경할 수 있습니다.
databricks storage-credentials update NAME [flags]
Arguments
NAME
스토리지 자격 증명의 이름입니다.
Options
--comment string
자격 증명과 연결된 주석입니다.
--force
종속 외부 위치 또는 외부 테이블이 있더라도 강제로 업데이트합니다.
--isolation-mode IsolationMode
전 작업 영역 또는 특정 작업 영역 그룹에서 현재 보안 개체에 액세스할 수 있는지 여부입니다. 지원되는 값: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--new-name string
스토리지 자격 증명의 새 이름입니다.
--owner string
현재 자격 증명 소유자의 사용자 이름입니다.
--read-only
자격 증명을 읽기 작업에만 사용할 수 있는지 여부입니다.
--skip-validation
이 인수에 true를 제공하면 업데이트된 자격 증명의 유효성 검사가 건너뜁니다.
Examples
다음 예제에서는 스토리지 자격 증명의 주석을 업데이트합니다.
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
다음 예제에서는 스토리지 자격 증명의 소유자를 변경합니다.
databricks storage-credentials update my-storage-credential --owner someone@example.com
다음 예제에서는 스토리지 자격 증명의 이름을 바꿉니다.
databricks storage-credentials update my-storage-credential --new-name updated-credential
databricks 스토리지 자격 증명 유효성 검사
스토리지 자격 증명의 유효성을 검사합니다. 적어도 external_location_name와 url 중 하나는 제공해야 합니다. 이 중 하나만 제공되면 유효성 검사에 사용됩니다. 둘 다 제공된 url 경우 유효성 검사에 사용되며 external_location_name 겹치는 URL을 확인할 때 무시됩니다.
storage_credential_name 또는 클라우드별 자격 증명을 제공해야 합니다.
호출자는 metastore 관리자 또는 스토리지 자격 증명 소유자이거나 CREATE_EXTERNAL_LOCATION metastore 및 스토리지 자격 증명에 대한 권한이 있어야 합니다.
databricks storage-credentials validate [flags]
Options
--external-location-name string
유효성을 검사할 기존 외부 위치의 이름입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--read-only
스토리지 자격 증명이 읽기 작업에만 사용할 수 있는지 여부입니다.
--storage-credential-name string
Required.
--url string
유효성을 검사할 외부 위치 URL입니다.
Examples
다음 예제에서는 외부 위치에 대해 스토리지 자격 증명의 유효성을 검사합니다.
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
다음 예제에서는 URL에 대해 스토리지 자격 증명의 유효성을 검사합니다.
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상