비고
이 정보는 Databricks CLI 버전 0.285 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
psql
Databricks CLI 내의 명령을 사용하면 PostgreSQL 클라이언트를 사용하여 Lakebase Postgres 데이터베이스에 연결할 수 있습니다. Lakebase 프로비전된 인스턴스와 Lakebase 자동 크기 조정 프로젝트를 모두 지원합니다.
databricks psql
Lakebase Postgres 데이터베이스에 연결합니다. 이 명령을 사용하려면 psql 컴퓨터에 클라이언트를 설치해야 합니다.
이 명령에는 연결 실패에 대한 자동 재시도 논리가 포함됩니다. 플래그를 사용하여 다시 시도 동작을 --max-retries 구성할 수 있습니다.
databricks psql [TARGET] [flags] [-- PSQL_ARGS...]
Arguments
TARGET
연결할 대상입니다. Lakebase 프로비전의 경우 인스턴스 이름을 지정합니다. Lakebase 자동 크기 조정의 경우 양식 projects/<project>/branches/<branch>/endpoints/<endpoint>의 전체 경로를 지정합니다. 생략하면 명령은 대화형 선택에 사용할 수 있는 데이터베이스를 나열합니다.
PSQL_ARGS(선택 사항)
클라이언트에 전달할 추가 인수입니다 psql . 이중 대시(--) 구분 기호 뒤를 지정합니다.
Options
--autoscaling
사용 가능한 데이터베이스를 나열할 때만 Lakebase 자동 크기 조정 프로젝트를 표시합니다.
--branch string
Lakebase 자동 크기 조정의 분기 ID입니다. 기본적으로 분기가 하나만 있는 경우 자동 선택됩니다.
--endpoint string
Lakebase 자동 크기 조정에 대한 엔드포인트 ID입니다. 기본적으로 엔드포인트가 하나만 있는 경우 자동 선택됩니다.
--max-retries int
최대 연결 재시도 횟수입니다. 재시도를 0 사용하지 않도록 설정합니다. 기본값: 3.
--project string
Lakebase 자동 크기 조정에 대한 Project ID입니다.
--provisioned
사용 가능한 데이터베이스를 나열할 때만 Lakebase 프로비전된 인스턴스를 표시합니다.
예시
다음 예제에서는 Lakebase 프로비전된 인스턴스에 연결합니다.
databricks psql my-instance
다음 예제에서는 플래그를 사용하여 Lakebase 자동 크기 조정 프로젝트에 연결합니다.
databricks psql --project my-project --branch main --endpoint primary
다음 예제에서는 전체 경로를 사용하여 Lakebase 자동 크기 조정 프로젝트에 연결합니다.
databricks psql projects/my-project/branches/main/endpoints/primary
다음 예제에서는 대화형 선택을 위한 Lakebase 자동 크기 조정 프로젝트만 나열합니다.
databricks psql --autoscaling
다음 예제에서는 클라이언트에 추가 인수를 psql 전달합니다.
databricks psql my-instance -- -c "SELECT 1"
다음 예제에서는 재시도를 사용하지 않도록 설정하여 연결합니다.
databricks psql my-instance --max-retries 0
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상