`postgres` 명령 그룹

비고

이 정보는 Databricks CLI 버전 0.285 이상에 적용됩니다.

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

postgres 내의 명령 그룹에는 프로젝트, 분기 및 엔드포인트를 포함한 Lakebase Postgres 리소스를 관리하는 명령이 포함되어 있습니다. Postgres API는 REST API 또는 직접 SQL을 통해 Postgres 데이터베이스에 대한 액세스를 제공합니다.

databricks postgres create-branch

분기를 만듭니다. 분기를 만들 때 영구 분기를 사용하여 no_expiry: true 만료 정책을 지정해야 합니다.

비고

장기 실행 작업입니다. 기본적으로 명령은 작업이 완료되기를 기다립니다. 원시 작업 세부 정보와 함께 즉시 반환하는 데 사용합니다 --no-wait . 그런 다음 작업의 name 필드를 사용하여 명령을 사용하여 완료를 폴링할 get-operation 수 있습니다.

databricks postgres create-branch PARENT BRANCH_ID [flags]

Arguments

PARENT

이 분기가 만들어지는 프로젝트입니다. 형식: projects/{project_id}

BRANCH_ID

분기의 리소스 이름의 최종 구성 요소가 되는 분기에 사용할 ID입니다. 길이는 1~63자여야 하며 소문자로 시작하고 소문자, 숫자 및 하이픈만 포함해야 합니다(RFC 1123).

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

분기의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 프로젝트에서 분기를 만듭니다.

databricks postgres create-branch projects/my-project-id my-branch \
  --json '{
    "spec": {
      "no_expiry": true
    }
  }'

다음 예제에서는 기존 분기에서 분기를 만듭니다.

databricks postgres create-branch projects/my-project-id dev-branch \
  --json '{
    "spec": {
      "source_branch": "projects/my-project-id/branches/main",
      "no_expiry": true
    }
  }'

databricks postgres create-endpoint

엔드포인트를 만듭니다. 분기에는 읽기-쓰기 컴퓨팅 엔드포인트가 하나 있고 읽기 전용 엔드포인트(읽기 복제본)가 여러 개 있을 수 있습니다.

비고

databricks postgres create-endpoint PARENT ENDPOINT_ID [flags]

Arguments

PARENT

이 엔드포인트가 만들어지는 분기입니다. 형식: projects/{project_id}/branches/{branch_id}

ENDPOINT_ID

엔드포인트에 사용할 ID로, 엔드포인트 리소스 이름의 최종 구성 요소가 됩니다. 길이는 1~63자여야 하며 소문자로 시작하고 소문자, 숫자 및 하이픈만 포함해야 합니다(RFC 1123).

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

엔드포인트의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 분기에 읽기-쓰기 엔드포인트를 만듭니다.

databricks postgres create-endpoint projects/my-project-id/branches/my-branch-id my-endpoint \
  --json '{
    "spec": {
      "endpoint_type": "ENDPOINT_TYPE_READ_WRITE",
      "autoscaling_limit_min_cu": 0.5,
      "autoscaling_limit_max_cu": 4.0
    }
  }'

다음 예제에서는 읽기 전용 엔드포인트(읽기 복제본)를 만듭니다.

databricks postgres create-endpoint projects/my-project-id/branches/my-branch-id read-replica-1 \
  --json '{
    "spec": {
      "endpoint_type": "ENDPOINT_TYPE_READ_ONLY",
      "autoscaling_limit_min_cu": 0.5,
      "autoscaling_limit_max_cu": 4.0
    }
  }'

databricks postgres create-project

프로젝트를 만듭니다.

비고

프로젝트를 만들 때 자동으로 기본 프로덕션 분기와 읽기-쓰기 컴퓨팅 엔드포인트가 모두 자동 생성된 ID를 포함합니다.

databricks postgres create-project PROJECT_ID [flags]

Arguments

PROJECT_ID

프로젝트에 사용할 ID로, 프로젝트의 자원 이름의 최종 구성 요소가 됩니다. 길이는 1~63자여야 하며 소문자로 시작하고 소문자, 숫자 및 하이픈만 포함해야 합니다(RFC 1123).

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

프로젝트의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 프로젝트를 만듭니다.

databricks postgres create-project my-project \
  --json '{
    "spec": {
      "display_name": "My Project"
    }
  }'

다음 예제에서는 특정 PostgreSQL 버전을 사용하여 프로젝트를 만듭니다.

databricks postgres create-project my-project \
  --json '{
    "spec": {
      "display_name": "My Project",
      "pg_version": "17"
    }
  }'

databricks postgres create-role

분기에 대한 Postgres 역할을 만듭니다.

비고

databricks postgres create-role PARENT [flags]

Arguments

PARENT

이 역할이 만들어지는 분기입니다. 형식: projects/{project_id}/branches/{branch_id}.

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

역할의 리소스 이름입니다(출력에만 해당).

--no-wait

완료 상태에 도달할 때까지 기다리지 마세요.

--role-id string

역할에 사용할 ID로, 역할 리소스 이름의 최종 구성 요소가 됩니다.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 분기에 암호 기반 역할을 만듭니다.

databricks postgres create-role projects/my-project-id/branches/my-branch-id \
  --role-id my-role \
  --json '{"spec": {"postgres_role": "my-role"}}'

다음 예제에서는 Databricks 사용자에 대한 OAuth 역할을 만듭니다.

databricks postgres create-role projects/my-project-id/branches/my-branch-id \
  --role-id my-user-role \
  --json '{"spec": {"identity_type": "USER", "postgres_role": "user@example.com"}}'

databricks postgres delete-branch

분기를 삭제합니다.

비고

보호된 분기는 삭제할 수 없습니다. 삭제하기 전에 설정하는 update-branchspec.is_protected 데 사용합니다false.

databricks postgres delete-branch NAME [flags]

Arguments

NAME

삭제할 분기의 이름입니다. 형식: projects/{project_id}/branches/{branch_id}

Options

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 분기를 삭제합니다.

databricks postgres delete-branch projects/my-project-id/branches/my-branch-id

databricks postgres delete-endpoint

엔드포인트를 삭제합니다.

비고

databricks postgres delete-endpoint NAME [flags]

Arguments

NAME

삭제할 엔드포인트의 이름입니다. 형식: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Options

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 엔드포인트를 삭제합니다.

databricks postgres delete-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

databricks postgres delete-project

프로젝트를 삭제합니다.

비고

databricks postgres delete-project NAME [flags]

Arguments

NAME

삭제할 프로젝트의 이름입니다. 형식: projects/{project_id}

Options

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--purge

true이면 프로젝트를 영구적으로 삭제합니다(하드 삭제).

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 프로젝트를 일시 삭제합니다(7일 동안 복구 가능).

databricks postgres delete-project projects/my-project-id

다음 예제에서는 프로젝트를 영구적으로 삭제합니다.

databricks postgres delete-project projects/my-project-id --purge

databricks postgres delete-role

분기에서 Postgres 역할을 삭제합니다.

비고

databricks postgres delete-role NAME [flags]

Arguments

NAME

삭제할 역할의 전체 리소스 경로입니다. 형식: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

Options

--no-wait

완료 상태에 도달할 때까지 기다리지 마세요.

--reassign-owned-to string

삭제된 역할이 소유한 개체를 이 역할에 다시 할당합니다.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 분기에서 역할을 삭제합니다.

databricks postgres delete-role projects/my-project-id/branches/my-branch-id/roles/my-role

databricks postgres generate-database-credential

Postgres 데이터베이스에 대한 OAuth 자격 증명을 생성합니다. 반환된 OAuth 토큰은 PostgreSQL 클라이언트(예 psql: PostgreSQL 클라이언트)를 사용하여 데이터베이스를 인증하고 연결하는 데 사용됩니다.

databricks postgres generate-database-credential ENDPOINT [flags]

Arguments

ENDPOINT

이 자격 증명이 생성되는 엔드포인트입니다. 형식: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

전역 플래그

예시

다음 예제에서는 엔드포인트에 대한 OAuth 자격 증명을 생성합니다.

databricks postgres generate-database-credential projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

databricks postgres get-branch

분기를 가져옵니다.

databricks postgres get-branch NAME [flags]

Arguments

NAME

검색할 분기의 이름입니다. 형식: projects/{project_id}/branches/{branch_id}

Options

전역 플래그

예시

다음 예제에서는 분기에 대한 정보를 가져옵니다.

databricks postgres get-branch projects/my-project-id/branches/my-branch-id

databricks postgres get-endpoint

엔드포인트를 가져옵니다.

databricks postgres get-endpoint NAME [flags]

Arguments

NAME

검색할 엔드포인트의 이름입니다. 형식: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Options

전역 플래그

예시

다음 예제에서는 엔드포인트에 대한 정보를 가져옵니다.

databricks postgres get-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id

databricks postgres get-operation

작업을 가져옵니다.

databricks postgres get-operation NAME [flags]

Arguments

NAME

작업 리소스의 이름입니다.

Options

전역 플래그

예시

다음 예제에서는 작업에 대한 정보를 가져옵니다.

databricks postgres get-operation projects/my-project-id/operations/my-operation-id

databricks postgres get-project

프로젝트를 가져옵니다.

databricks postgres get-project NAME [flags]

Arguments

NAME

검색할 프로젝트의 이름입니다. 형식: projects/{project_id}

Options

전역 플래그

예시

다음 예제에서는 프로젝트에 대한 정보를 가져옵니다.

databricks postgres get-project projects/my-project-id

databricks postgres get-role

분기에 대한 Postgres 역할을 가져옵니다. 인증 방법 및 권한을 포함하여 지정된 역할에 대한 정보를 검색합니다.

databricks postgres get-role NAME [flags]

Arguments

NAME

검색할 역할의 전체 리소스 경로입니다. 형식: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

Options

전역 플래그

예시

다음 예제에서는 역할을 가져옵니다.

databricks postgres get-role projects/my-project-id/branches/my-branch-id/roles/my-role

databricks postgres list-branches

분기를 나열합니다. 이 명령을 사용하여 프로젝트로 만든 기본 분기(상태에 표시됨 "default": true )를 포함하여 분기 ID를 찾습니다.

databricks postgres list-branches PARENT [flags]

Arguments

PARENT

이 분기 컬렉션을 소유하는 프로젝트입니다. 형식: projects/{project_id}

Options

--page-size int

반환된 항목의 상한입니다.

--page-token string

이전 응답의 페이지 토큰입니다.

전역 플래그

예시

다음 예제에서는 프로젝트의 모든 분기를 나열합니다.

databricks postgres list-branches projects/my-project-id

다음 예제에서는 페이지 매김이 있는 분기를 나열합니다.

databricks postgres list-branches projects/my-project-id --page-size 10

databricks postgres list-endpoints

엔드포인트를 나열합니다. 이 명령을 사용하여 프로젝트에서 자동으로 생성된 기본 읽기/쓰기 엔드포인트를 포함하여 엔드포인트 ID를 찾습니다.

databricks postgres list-endpoints PARENT [flags]

Arguments

PARENT

이 엔드포인트 컬렉션을 소유하는 분기입니다. 형식: projects/{project_id}/branches/{branch_id}

Options

--page-size int

반환된 항목의 상한입니다.

--page-token string

이전 응답의 페이지 토큰입니다.

전역 플래그

예시

다음 예제에서는 분기의 모든 엔드포인트를 나열합니다.

databricks postgres list-endpoints projects/my-project-id/branches/my-branch-id

다음 예제에서는 페이지 매김이 있는 엔드포인트를 나열합니다.

databricks postgres list-endpoints projects/my-project-id/branches/my-branch-id --page-size 10

databricks postgres list-projects

프로젝트를 나열합니다.

databricks postgres list-projects [flags]

Options

--limit int

반환할 최대 결과 수입니다.

--page-size int

반환된 항목의 상한입니다.

--page-token string

이전 응답의 페이지 토큰입니다.

--show-deleted

응답에 일시 삭제된 프로젝트를 포함할지 여부입니다.

전역 플래그

예시

다음 예제에서는 모든 프로젝트를 나열합니다.

databricks postgres list-projects

다음 예제에서는 페이지 매김이 있는 프로젝트를 나열합니다.

databricks postgres list-projects --page-size 10

다음 예제에서는 일시 삭제된 프로젝트를 포함한 모든 프로젝트를 나열합니다.

databricks postgres list-projects --show-deleted

databricks postgres list-roles

분기에 대한 Postgres 역할을 나열합니다.

databricks postgres list-roles PARENT [flags]

Arguments

PARENT

이 역할 컬렉션을 소유하는 분기입니다. 형식: projects/{project_id}/branches/{branch_id}.

Options

--page-size int

반환된 항목의 상한입니다.

--page-token string

이전 응답의 페이지 토큰입니다.

전역 플래그

예시

다음 예제에서는 분기의 모든 역할을 나열합니다.

databricks postgres list-roles projects/my-project-id/branches/my-branch-id

databricks postgres undelete-project

Project 삭제 취소합니다.

비고

databricks postgres undelete-project NAME [flags]

Arguments

NAME

삭제 취소할 프로젝트의 전체 리소스 경로입니다. 형식: projects/{project_id}

Options

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 일시 삭제된 프로젝트를 복구합니다.

databricks postgres undelete-project projects/my-project-id

databricks postgres update-branch

분기를 업데이트합니다.

비고

databricks postgres update-branch NAME UPDATE_MASK [flags]

Arguments

NAME

분기의 리소스 이름입니다. 형식: projects/{project_id}/branches/{branch_id}

UPDATE_MASK

업데이트할 필드 목록입니다. 지정되지 않은 경우 가능한 경우 모든 필드가 업데이트됩니다.

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

분기의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 분기를 보호하도록 업데이트합니다.

databricks postgres update-branch projects/my-project-id/branches/my-branch-id spec.is_protected \
  --json '{
    "spec": {
      "is_protected": true
    }
  }'

databricks postgres update-endpoint

엔드포인트를 업데이트합니다.

비고

databricks postgres update-endpoint NAME UPDATE_MASK [flags]

Arguments

NAME

엔드포인트의 리소스 이름입니다. 형식: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

UPDATE_MASK

업데이트할 필드 목록입니다. 지정되지 않은 경우 가능한 경우 모든 필드가 업데이트됩니다.

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

엔드포인트의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 엔드포인트의 최대 컴퓨팅 단위를 업데이트합니다.

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.autoscaling_limit_max_cu \
  --json '{
    "spec": {
      "autoscaling_limit_max_cu": 8.0
    }
  }'

다음 예제에서는 여러 필드(최소 및 최대 컴퓨팅 단위)를 업데이트합니다.

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id "spec.autoscaling_limit_min_cu,spec.autoscaling_limit_max_cu" \
  --json '{
    "spec": {
      "autoscaling_limit_min_cu": 1.0,
      "autoscaling_limit_max_cu": 8.0
    }
  }'

크기 조정을 0으로 구성하려면 업데이트 마스크에 포함합니다 spec.suspension . 비활성 시간 제한을 정의하거나 no_suspension: true 사용하지 않도록 설정하려면 (60s–604800s)을 설정합니다 suspend_timeout_duration . 둘 다 설정하지 마세요. 설정 no_suspension: false 은 오류를 반환합니다.

다음 예제에서는 크기 조정을 0으로 사용하지 않도록 설정합니다.

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.suspension \
  --json '{
    "spec": {
      "no_suspension": true
    }
  }'

다음 예제에서는 5분 비활성 시간 제한을 사용하여 0으로 크기를 조정할 수 있습니다.

databricks postgres update-endpoint projects/my-project-id/branches/my-branch-id/endpoints/my-endpoint-id spec.suspension \
  --json '{
    "spec": {
      "suspend_timeout_duration": "300s"
    }
  }'

databricks postgres update-project

프로젝트를 업데이트합니다.

비고

databricks postgres update-project NAME UPDATE_MASK [flags]

Arguments

NAME

프로젝트의 리소스 이름입니다. 형식: projects/{project_id}

UPDATE_MASK

업데이트할 필드 목록입니다. 지정되지 않은 경우 가능한 경우 모든 필드가 업데이트됩니다.

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

프로젝트의 리소스 이름입니다.

--no-wait

DONE 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 프로젝트의 표시 이름을 업데이트합니다.

databricks postgres update-project projects/my-project-id spec.display_name \
  --json '{
    "spec": {
      "display_name": "Updated Project Name"
    }
  }'

databricks postgres update-role

분기에 대한 Postgres 역할을 업데이트합니다.

비고

databricks postgres update-role NAME UPDATE_MASK [flags]

Arguments

NAME

역할의 전체 리소스 경로입니다. 형식: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

UPDATE_MASK

업데이트할 필드 목록입니다. 지정되지 않은 경우 가능한 경우 모든 필드가 업데이트됩니다.

Options

--json JSON

요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--name string

역할의 리소스 이름입니다(출력에만 해당).

--no-wait

완료 상태에 도달할 때까지 기다리지 마세요.

--timeout duration

완료 상태에 도달하는 최대 시간입니다.

전역 플래그

예시

다음 예제에서는 역할에 부여합니다 CREATEDB . 업데이트 spec.attributes할 때 다음 세 가지 특성 필드를 모두 제공해야 합니다.

databricks postgres update-role projects/my-project-id/branches/my-branch-id/roles/my-role \
  spec.attributes \
  --json '{"spec": {"attributes": {"createdb": true, "createrole": false, "bypassrls": false}}}'

다음 예제에서는 멤버 자격에 역할을 추가합니다 databricks_superuser .

databricks postgres update-role projects/my-project-id/branches/my-branch-id/roles/my-role \
  spec.membership_roles \
  --json '{"spec": {"membership_roles": ["DATABRICKS_SUPERUSER"]}}'

전역 표시기

--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 2026-05-27

postgres 명령 그룹

databricks postgres create-branch

Arguments

Options

예시

databricks postgres create-endpoint

Arguments

Options

예시

databricks postgres create-project

Arguments

Options

예시

databricks postgres create-role

Arguments

Options

예시

databricks postgres delete-branch

Arguments

Options

예시

databricks postgres delete-endpoint

Arguments

Options

예시

databricks postgres delete-project

Arguments

Options

예시

databricks postgres delete-role

Arguments

Options

예시

databricks postgres generate-database-credential

Arguments

Options

예시

databricks postgres get-branch

Arguments

Options

예시

databricks postgres get-endpoint

Arguments

Options

예시

databricks postgres get-operation

Arguments

Options

예시

databricks postgres get-project

Arguments

Options

예시

databricks postgres get-role

Arguments

Options

예시

databricks postgres list-branches

Arguments

Options

예시

databricks postgres list-endpoints

Arguments

Options

예시

databricks postgres list-projects

Options

예시

databricks postgres list-roles

Arguments

Options

예시

databricks postgres undelete-project

Arguments

Options

예시

databricks postgres update-branch

Arguments

Options

예시

`postgres` 명령 그룹