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