Databricks CLI 문제 해결

참고

Databricks CLI 사용은 사용량 현황 데이터 프로비저닝을 포함하여 Databricks 라이선스 및 Databricks 개인 정보 보호 고지의 적용을 받습니다.

Databricks CLI 관련 문제를 해결하려면 다음 정보를 사용합니다.

로깅 사용

명령이 실패하거나 예상 출력을 생성하지 않는 경우 로깅을 사용하여 무엇이 잘못되었는지 식별할 수 있습니다. Databricks CLI가 다양한 명령 이벤트, 경고 및 오류에 대해 출력하는 메시지를 기록할 수 있습니다. 이러한 메시지를 기록하려면 다음 Databricks CLI 명령 옵션을 지정합니다.

플래그 설명
--log-file 출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.
--log-format text로 출력 로그를 텍스트로 기록하거나 json으로 출력 로그를 JSON으로 기록합니다. 이 플래그를 지정하지 않으면 출력 로그가 텍스트로 기록됩니다.
--log-level 로그 형식 수준을 나타내는 문자열입니다. 유효한 로그 수준은 error, warn, infodebug, trace및 disabled. 기본 수준은 disabled아무 것도 기록되지 않음을 의미합니다. --debug는 --log-level debug와 같습니다.

다음 예제 명령은 지정된 명령에 대한 추적 메시지를 JSON 형식으로 명명 databricks-cli.log 된 파일에 기록합니다.

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

Terraform을 다운로드하는 동안 오류가 발생했습니다.

일부 버전의 Databricks CLI에서 만료된 키를 실행하면 databricks bundle deploy다음 오류가 발생합니다.

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

이 오류를 해결하려면 Databricks CLI를 최신 패치 버전으로 업그레이드하여 최신 키로 작동하도록 확인 메커니즘을 업데이트합니다. 현재 CLI 부 버전에 해당하는 패치된 버전으로 업그레이드합니다.

  • Binary install: GitHub Databricks CLI 릴리스 페이지에서 패치된 버전을 다운로드합니다.

  • setup-cli(설치 스크립트 또는 GitHub 작업): 구성의 버전을 GitHub Databricks CLI 릴리스 페이지 패치된 버전으로 업데이트합니다.

    예를 들어 GitHub 작업과 함께 0.296.1 사용하려면 다음을 수행합니다.

    - uses: databricks/setup-cli@main
  with:
    version: 0.296.1

저장된 자격 증명 오류

Databricks CLI 버전 1.0.0부터 Databricks CLI는 JSON 파일 대신 OS 네이티브 보안 스토리지(macOS의 키 집합, Windows 자격 증명 관리자, Linux의 D-Bus 비밀 서비스)에 U2M(사용자 간) 인증 토큰을 저장합니다. 토큰 스토리지를 참조하세요. 워크플로가 JSON 파일 위에 빌드되는 경우 새 스토리지 메서드에 대해 작동하지 않으며 다음 시나리오에서 문제가 발생할 수 있습니다.

  • GA로 업그레이드했지만 아직 다시 로그인하지 않았습니다. Databricks CLI는 더 이상 이전 버전에서 저장된 자격 증명을 읽지 않고 오류를 반환합니다.

    Stored credentials from older CLI versions are no longer used.
Run "databricks auth login" to sign in again.

If secure storage is not available in this environment, set
DATABRICKS_AUTH_STORAGE=plaintext and re-run login.

    이 문제를 해결하려면 실행 databricks auth login 합니다.

  • 로그인 시 보안 스토리지 검사 실패 그 동안 databricks auth loginDatabricks CLI는 OAuth 흐름을 시작하기 전에 보안 스토리지를 확인합니다. 확인이 실패하는 경우(Linux 컨테이너, SSH 세션, WSL1 및 D-Bus가 실행되지 않는 헤드리스 서버에서 가장 일반적임) 동작은 보안 스토리지가 명시적으로 구성되었는지 여부에 따라 달라집니다.

    • 기본 모드, 명시적인 스토리지 설정 없음: Databricks CLI는 알림 없이 평문으로 폴백하고 ~/.databrickscfg의 [__settings__] 섹션에 auth_storage = plaintext를 씁니다. 후속 명령은 다시 검사하지 않고 일반 텍스트를 사용합니다.
    • 명시적 보안 모드(구성 프로필에서 DATABRICKS_AUTH_STORAGE=secure 또는 auth_storage = secure): Databricks CLI는 DATABRICKS_AUTH_STORAGE=plaintext 폴백을 가리키는 오류를 반환합니다.

    확인 작업이 즉시 실패하지 않고 시간 초과되는 경우(예: 키체인이 잠겨 있지만 접근할 수 있는 상태인 경우), Databricks CLI는 키체인 백엔드를 유지하고 OS 잠금 해제 프롬프트가 브라우저 OAuth 흐름과 병렬로 실행되도록 합니다.

    로그인 후 Databricks CLI가 사용하는 스토리지 모드를 확인하려면 다음을 실행합니다 databricks auth describe.

  • 저장된 토큰을 읽는 동안 키체인에 접근할 수 없습니다. 로그인 시와 달리 Databricks CLI는 토큰을 읽는 시점에 키체인에 접근할 수 없으면 알림 없이 자동으로 다른 방식으로 대체하지 않습니다. 예를 들어 데스크톱 머신에 로그인한 다음 헤드리스 세션에서 SSH를 통해 연결한 경우 저장된 토큰이 필요한 명령이 오류와 함께 실패합니다. 일반 텍스트 대체를 사용하여 이 문제를 해결합니다. 일반 텍스트 대체 사용을 참조하세요.

명령이 완료되지 않음

이러한 databricks cluster list 명령을 실행하면 중단된 것처럼 보이는 경우 Databricks CLI의 버전을 최신 버전으로 업데이트합니다. 이전 버전의 CLI는 목록의 항목 수가 많고 명령이 완료되지 않은 것처럼 보이는 경우에도 전체 목록을 로드하려고 합니다.

  • Last updated on