다음을 통해 공유

auth 명령 그룹

Note

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

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

auth 내의 명령 그룹에는 다음을 포함한 인증 관련 명령이 포함되어 있습니다.

  • 사용 가능한 인증 구성 프로필을 나열합니다.
  • 개별 인증 구성 프로필에 대한 정보를 가져옵니다.
  • OAuth U2M(사용자 대 컴퓨터) 인증을 사용하여 Azure Databricks 계정 및 작업 영역에서 Databricks CLI를 인증합니다.
  • Databricks CLI가 캐시했을 수 있는 모든 OAuth 액세스 토큰에 대한 정보를 가져옵니다.
  • Databricks CLI가 인증하는 데 사용하는 구성에 대한 세부 정보를 가져옵니다.

Tip

현재 Databricks CLI 사용자에 대한 정보를 얻으려면 다음을 실행합니다 databricks current-user me.

databricks 인증 설명

자격 증명 및 해당 자격 증명의 원본을 포함하여 Databricks CLI가 인증하는 데 사용하는 구성에 대해 설명합니다. 옵션이 지정되지 auth describe 않은 경우 명령은 인증 방법 우선 순위를 따릅니다.

databricks auth describe [flags]

옵션

--sensitive

    출력에 암호 및 토큰과 같은 중요한 필드 포함

전역 플래그

예시

다음 예제에서는 현재 인증 구성에 대해 설명합니다.

databricks auth describe

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: default
  ✓ auth_type: <authentication-type> (from <path>/<to>/.databrickscfg config file)

특정 Azure Databricks 작업 영역에 대한 정보가 사용되도록 지정하려면 작업 영역의 URL과 함께 옵션을 지정 --host 합니다.

databricks auth describe --host https://<workspace-instance-name>

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from --host flag)
  ✓ profile: default
  ✓ auth_type: <authentication-type>

특정 Azure Databricks 계정에 대한 정보를 사용하도록 지정하려면 Azure Databricks 계정 콘솔 URL --host과 함께 https://accounts.azuredatabricks.net 옵션을 지정합니다.

databricks auth describe --host <account-console-url>

Host: <account-console-url>
User: <user-name>@<domain>
AccountId: <account-id>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: <account-console-url> (from --host flag)
  ✓ account_id: <account-id>
  ✓ profile: default
  ✓ auth_type: <authentication-type>

특정 Azure Databricks 구성 프로필에 대한 정보가 사용되도록 지정하려면 프로필 이름과 함께 또는 -p 옵션을 지정 --profile 합니다.

databricks auth describe -p TEST

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: ******** (from <path>/<to>/.databrickscfg config file)
  ✓ profile: TEST (from --profile flag)
  ✓ auth_type: <authentication-type>

출력에 중요한 정보(예: Azure Databricks 개인용 액세스 토큰 및 클라이언트 비밀)를 포함하려면 다음 옵션을 지정 --sensitive 합니다.

databricks auth describe --sensitive

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: <token-value> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: <profile-name>
  ✓ auth_type: pat

databricks 인증 환경

프로필 이름 또는 Azure Databricks 계정 콘솔 URL 또는 Azure Databricks 작업 영역 URL을 사용하여 기존 구성 프로필에 대한 정보를 가져옵니다.

databricks auth env [flags]

Tip

구성 프로필 이름을 수동으로 입력하는 대신 Tab 또는 --profile 이후에 -p을 눌러서 선택하려는 기존 사용 가능한 구성 프로필 목록을 표시할 수 있습니다.

구성 프로필을 만들려면 명령을 참조하세요configure.

옵션

--host string

    인증을 받을 호스트 이름

Note

둘 이상의 프로필이 --host 값과 일치하면 일치하는 단일 프로필을 찾을 수 없다는 오류가 표시됩니다. 예를 들어 호스트 값만 있는 프로필 하나와 동일한 호스트 값뿐만 아니라 토큰 값도 가진 다른 프로필이 있을 수 있습니다. 이 경우 Databricks CLI는 프로필을 선택하지 않고 중지합니다. Databricks CLI에서 원하는 프로필을 선택할 수 있도록 다른 --host 값을 지정해 보세요. 계정 콘솔 URL인 --host 값의 경우 --account-id 값 대신 --host 값을 지정해 보세요.

--profile string

    인증을 받을 프로필

전역 플래그

예시

다음 예제에서는 기본 인증 환경을 가져옵니다.

databricks auth env

다음 예제에서는 특정 호스트에 대한 인증 환경을 가져옵니다.

databricks auth env --host https://my-workspace.cloud.databricks.com

Azure Databricks 액세스 토큰 인증으로 구성된 프로필의 출력은 다음과 같습니다.

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "TEST",
    "DATABRICKS_HOST": "https://my-workspace.cloud.databricks.com",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

다음 예제에서는 특정 프로필에 대한 인증 환경을 가져옵니다.

databricks auth env --profile my-test-environment

databricks 인증 로그인

Databricks 작업 영역 또는 계정에 로그인하고 인증 구성을 프로필에 저장합니다( ~/.databrickscfg 기본적으로). 그런 다음 이 프로필을 사용하여 플래그를 사용하여 다른 Databricks CLI 명령을 인증할 --profile 수 있습니다. 이 프로필을 사용하여 Databricks Python, Java 및 Go SDK를 포함하여 Databricks 통합 인증을 지원하는 다른 Databricks 도구를 인증할 수도 있습니다.

databricks auth login HOST [flags]

이 명령을 사용하려면 Databricks 호스트 URL( --host 지정한 프로필 이름에서 위치 인수 또는 암시적으로 유추됨) 및 프로필 이름(사용 --profile)을 지정해야 합니다. 이러한 값을 지정하지 않으면 런타임에 값을 입력하라는 메시지가 표시됩니다.

이 명령은 항상 지정된 호스트에 로그인하지만 동작은 기본적으로 구성 파일 ~/.databrickscfg 에서 설정한 기존 프로필에 따라 달라집니다.

  1. 지정된 이름의 프로필이 존재하고 호스트를 지정하는 경우 프로필에서 지정한 호스트에 로그인됩니다. 이전에는 그렇지 않은 경우 "databricks-cli"를 인증 형식으로 사용하도록 프로필이 업데이트됩니다.
  2. 지정된 이름의 프로필이 있지만 호스트를 지정하지 않으면 호스트를 지정하라는 메시지가 표시됩니다. 지정된 호스트를 사용하도록 프로필이 업데이트됩니다. 인증 유형은 이전과는 다른 경우 "databricks-cli"로 업데이트됩니다.
  3. 지정된 이름의 프로필이 존재하고 호스트를 지정하지만 호스트를 사용 --host 하거나 위치 인수로 HOST 지정하는 경우 새로 지정된 호스트를 사용하도록 프로필이 업데이트됩니다. 인증 유형은 이전과는 다른 경우 "databricks-cli"로 업데이트됩니다.
  4. 지정된 이름의 프로필이 없으면 지정된 호스트를 사용하여 새 프로필이 만들어집니다. 인증 형식은 "databricks-cli"로 설정됩니다.

주장들

HOST

    Databricks 호스트 URL(선택 사항)

옵션

--configure-cluster

    클러스터를 구성하라는 메시지(클래식 컴퓨팅)

--configure-serverless

    서버리스 컴퓨팅을 구성하라는 메시지

--timeout duration

    브라우저에서 로그인 챌린지를 완료하기 위한 시간 제한(기본값 1h0m0s)

전역 플래그

예시

다음 예제에서는 Databricks 작업 영역에 로그인합니다.

databricks auth login

다음 예제에서는 특정 Databricks 작업 영역에 로그인합니다.

databricks auth login https://my-workspace.cloud.databricks.com

다음 예제에서는 특정 프로필로 로그인하고 클러스터 설정을 구성합니다.

databricks auth login --profile my-profile --configure-cluster

다음 예제에서는 로그인 프로세스에 대한 사용자 지정 시간 제한을 설정합니다.

databricks auth login --timeout 30m

databricks 인증 프로필

사용 가능한 모든 구성 프로필( ~/.databrickscfg 기본적으로)을 나열하고 유효한 프로필인지 확인합니다.

databricks auth profiles [flags]

이 명령은 다음 형식으로 프로필을 출력합니다.

Name            Host                Valid
DEFAULT         https://<host-url>  YES
<profile-name>  https://<host-url>  NO

각 프로필이 유효한지 여부를 확인하기 위해 Databricks CLI는 각 계정 수준 프로필에 대한 작업 영역을 나열하고 각 작업 영역 수준 프로필에 대한 현재 사용자 가져오기 명령을 실행합니다. 명령이 성공하면 YES가 표시되고, 그렇지 않으면 NO가 표시됩니다.

auth profiles 명령의 출력에는 액세스 토큰이 표시되지 않습니다. 액세스 토큰을 표시하려면 databricks 인증 env를 참조하세요.

기본적으로 구성 프로필은 Linux 또는 macOS ~/.databrickscfg 또는 Windows의 파일에 %USERPROFILE%\.databrickscfg 저장됩니다. 환경 변수 DATABRICKS_CONFIG_FILE을 설정하여 이 파일의 기본 경로를 변경할 수 있습니다.

구성 프로필을 만들려면 명령을 참조하세요configure.

옵션

--skip-validate

    프로필 유효성 검사를 건너뛸지 여부

전역 플래그

예시

다음 예제에서는 모든 인증 프로필을 나열합니다.

databricks auth profiles

다음 예제에서는 유효성을 검사하지 않고 프로필을 나열합니다.

databricks auth profiles --skip-validate

databricks 인증 토큰

의 로컬 캐시에서 인증 토큰을 ~/.databricks/token-cache.json가져옵니다. 만료된 액세스 토큰을 새로 고칩니다. 이 명령은 U2M 인증(명령 사용 databricks auth login )에서만 작동합니다. 클라이언트 ID 및 비밀을 사용하는 M2M 인증은 지원되지 않습니다.

databricks auth token [HOST] [flags]

OAuth U2M 인증을 구성하고 설정하려면 OAuth U2M(사용자-컴퓨터) 인증참조하세요.

주장들

HOST

    Databricks 호스트 URL(선택 사항)

옵션

--account-id string

    Databricks 계정 ID

--timeout duration

    토큰을 획득하기 위한 시간 제한입니다. (기본값 1h0m0s)

전역 플래그

예시

다음 예제에서는 인증 토큰을 가져옵니다.

databricks auth token

다음 예제에서는 특정 호스트에 대한 인증 토큰을 가져옵니다.

databricks auth token https://my-workspace.cloud.databricks.com

출력은 다음과 같습니다.

{
  "access_token": "<token-value>",
  "token_type": "Bearer",
  "expiry": "<token-expiration-date-time>"
}

다음 예제에서는 토큰 획득에 대한 사용자 지정 시간 제한을 설정합니다.

databricks auth token --timeout 30m

전역 표시기

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

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

  • Last updated on