Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
warehouses
Databricks CLI 내의 명령 그룹을 사용하면 SQL 웨어하우스를 관리할 수 있습니다. SQL 웨어하우스는 Databricks SQL 내의 데이터 개체에서 SQL 명령을 실행할 수 있는 컴퓨팅 리소스입니다.
SQL 웨어하우스에 연결을 참조하세요.
Databricks 웨어하우스 생성
새 SQL 웨어하우스를 만듭니다.
databricks warehouses create [flags]
Arguments
None
Options
--auto-stop-mins int
SQL 웨어하우스가 자동으로 중지되기 전에 유휴 상태로 있어야 하는 시간(분 단위), 즉 쿼리가 없는 시간이 얼마인지입니다.
--cluster-size string
이 웨어하우스에 할당된 클러스터의 크기입니다.
--creator-name string
웨어하우스 생성자 이름입니다.
--enable-photon
웨어하우스에서 Photon 최적화 클러스터를 사용해야 하는지 여부를 구성합니다.
--enable-serverless-compute
웨어하우스에서 서버리스 컴퓨팅을 사용해야 하는지 여부를 구성합니다.
--instance-profile-arn string
Deprecated.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--max-num-clusters int
자동 크기 조정기가 동시 쿼리를 처리하기 위해 만들 클러스터의 최대 수입니다.
--min-num-clusters int
이 SQL 웨어하우스에 대해 유지 관리될 사용 가능한 최소 클러스터 수입니다.
--name string
클러스터의 논리적 이름입니다.
--no-wait
실행 중 상태에 도달할 때까지 기다리지 마세요.
--spot-instance-policy SpotInstancePolicy
웨어하우스에서 스폿 인스턴스를 사용해야 하는지 여부를 구성합니다. 지원되는 값: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
상태에 도달하는 RUNNING 최대 시간(기본값 20ms)
--warehouse-type CreateWarehouseRequestWarehouseType
웨어하우스 유형: PRO 또는 CLASSIC. 지원되는 값: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
다음 예제에서는 기본 구성을 사용하여 새 SQL 웨어하우스를 만듭니다.
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
다음 예제에서는 Photon을 사용하도록 설정된 서버리스 웨어하우스를 만듭니다.
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
Databricks 웨어하우스 삭제
SQL 웨어하우스를 삭제합니다.
databricks warehouses delete ID [flags]
Arguments
ID
Required. SQL 웨어하우스의 ID입니다.
Options
Examples
다음 예제에서는 지정된 ID를 사용하여 웨어하우스를 삭제합니다.
databricks warehouses delete 1234567890abcdef
데이터브릭스 데이터 웨어하우스 편집
웨어하우스를 업데이트합니다. SQL 웨어하우스에 대한 구성을 업데이트합니다.
databricks warehouses edit ID [flags]
Arguments
ID
Required. 구성할 웨어하우스의 ID입니다.
Options
--auto-stop-mins int
SQL 웨어하우스가 자동으로 중지되기 전에 유휴 상태로 있어야 하는 시간(분 단위), 즉 쿼리가 없는 시간이 얼마인지입니다.
--cluster-size string
이 웨어하우스에 할당된 클러스터의 크기입니다.
--creator-name string
웨어하우스 생성자 이름입니다.
--enable-photon
웨어하우스에서 Photon 최적화 클러스터를 사용해야 하는지 여부를 구성합니다.
--enable-serverless-compute
웨어하우스에서 서버리스 컴퓨팅을 사용해야 하는지 여부를 구성합니다.
--instance-profile-arn string
Deprecated.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--max-num-clusters int
자동 크기 조정기가 동시 쿼리를 처리하기 위해 만들 클러스터의 최대 수입니다.
--min-num-clusters int
이 SQL 웨어하우스에 대해 유지 관리될 사용 가능한 최소 클러스터 수입니다.
--name string
클러스터의 논리적 이름입니다.
--no-wait
상태에 도달하기 RUNNING 위해 기다리지 마세요.
--spot-instance-policy SpotInstancePolicy
웨어하우스에서 스폿 인스턴스를 사용해야 하는지 여부를 구성합니다. 지원되는 값: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
상태에 도달하는 RUNNING 최대 시간(기본값 20ms)
--warehouse-type EditWarehouseRequestWarehouseType
웨어하우스 유형입니다. 지원되는 값: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
다음 예제에서는 클러스터 크기 및 자동 중지 시간을 변경하도록 웨어하우스를 업데이트합니다.
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
다음 예제에서는 기존 웨어하우스에 Photon을 사용하도록 설정합니다.
databricks warehouses edit 1234567890abcdef --enable-photon
Databricks 웨어하우스 가져오기
단일 SQL 웨어하우스에 대한 정보를 가져옵니다.
databricks warehouses get ID [flags]
Arguments
ID
Required. SQL 웨어하우스의 ID입니다.
Options
Examples
다음 예제에서는 지정된 ID를 사용하여 웨어하우스에 대한 정보를 가져옵니다.
databricks warehouses get 1234567890abcdef
databricks 창고 목록
사용자에게 관리 권한이 있는 모든 SQL 웨어하우스를 나열합니다.
databricks warehouses list [flags]
Arguments
None
Options
--run-as-user-id int
웨어하우스 목록을 가져오는 데 사용할 서비스 주체입니다.
Examples
다음 예제에서는 모든 웨어하우스를 나열합니다.
databricks warehouses list
다음 예제에서는 특정 서비스 주체를 사용하는 웨어하우스를 나열합니다.
databricks warehouses list --run-as-user-id 123456789
databricks 웨어하우스 시작
SQL 웨어하우스를 시작합니다.
databricks warehouses start ID [flags]
Arguments
ID
Required. SQL 웨어하우스의 ID입니다.
Options
--no-wait
상태에 도달하기 RUNNING 위해 기다리지 마세요.
--timeout duration
상태에 도달하는 RUNNING 최대 시간(기본값 20ms)
Examples
다음 예제에서는 지정된 ID를 사용하여 웨어하우스를 시작합니다.
databricks warehouses start 1234567890abcdef
다음 예제에서는 웨어하우스가 상태에 도달할 RUNNING 때까지 기다리지 않고 웨어하우스를 시작합니다.
databricks warehouses start 1234567890abcdef --no-wait
databricks 저장소 중지
SQL 웨어하우스를 중지합니다.
databricks warehouses stop ID [flags]
Arguments
ID
Required. SQL 웨어하우스의 ID입니다.
Options
--no-wait
상태에 도달하기 STOPPED 위해 기다리지 마세요.
--timeout duration
상태에 도달하는 STOPPED 최대 시간(기본값 20ms)
Examples
다음 예제에서는 지정된 ID를 사용하여 웨어하우스를 중지합니다.
databricks warehouses stop 1234567890abcdef
다음 예제에서는 STOPPED 상태에 도달하기 전에 웨어하우스를 중지합니다.
databricks warehouses stop 1234567890abcdef --no-wait
데이터브릭스 워크스페이스 웨어하우스 설정 가져오기 (databricks warehouses get-workspace-warehouse-config)
작업 영역의 모든 SQL 웨어하우스에서 공유하는 작업 영역 수준 구성을 가져옵니다.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Options
Examples
다음 예제에서는 작업 영역 웨어하우스 구성을 가져옵니다.
databricks warehouses get-workspace-warehouse-config
데이터브릭 창고 작업 공간 구성 설정
작업 영역의 모든 SQL 웨어하우스에서 공유하는 작업 영역 수준 구성을 설정합니다.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Options
--google-service-account string
GCP 전용: Google Cloud Storage에 액세스하기 위해 클러스터에 전달하는 데 사용되는 Google 서비스 계정입니다.
--instance-profile-arn string
AWS만 해당: 클러스터에 IAM 역할을 전달하는 데 사용되는 인스턴스 프로필입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
웨어하우스에 대한 보안 정책입니다. 지원되는 값: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
다음 예제에서는 보안 정책을 사용하여 작업 영역 웨어하우스 구성을 설정합니다.
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
Databricks 웨어하우스 권한 수준 가져오기
SQL 웨어하우스 사용 권한 수준을 가져옵니다.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
사용 권한을 얻거나 관리할 SQL 웨어하우스입니다.
Options
Examples
다음 예제에서는 웨어하우스에 대한 사용 권한 수준을 가져옵니다.
databricks warehouses get-permission-levels 1234567890abcdef
databricks 웨어하우스 권한-획득
SQL 웨어하우스의 사용 권한을 가져옵니다. SQL 웨어하우스는 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
사용 권한을 얻거나 관리할 SQL 웨어하우스입니다.
Options
Examples
다음 예제에서는 웨어하우스에 대한 권한을 가져옵니다.
databricks warehouses get-permissions 1234567890abcdef
데이터브릭스 웨어하우스 권한 설정
SQL 웨어하우스 사용 권한을 설정합니다. 개체에 대한 사용 권한을 설정하여 기존 사용 권한이 있는 경우 대체합니다. 지정되지 않은 경우 모든 직접 권한을 삭제합니다. 개체는 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
사용 권한을 얻거나 관리할 SQL 웨어하우스입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Examples
다음 예제에서는 JSON 파일을 사용하여 웨어하우스에 대한 권한을 설정합니다.
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
databricks 웨어하우스 권한 업데이트
SQL 웨어하우스에 대한 사용 권한을 업데이트합니다. SQL 웨어하우스는 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
사용 권한을 얻거나 관리할 SQL 웨어하우스입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Examples
다음 예제에서는 JSON 파일을 사용하여 웨어하우스에 대한 권한을 업데이트합니다.
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상