postgres группа команд

Замечание

Эта информация относится к Databricks CLI версии 0.285 и выше.

Использование интерфейса командной строки Databricks подчиняется лицензии Databricks и уведомлению о конфиденциальности Databricks, включая любые положения о данных использования.

Группа postgres команд в интерфейсе командной строки Databricks содержит команды для управления ресурсами Lakebase Postgres, включая проекты, ветви, конечные точки, роли, каталоги и синхронизированные таблицы. API Postgres предоставляет доступ к базе данных Postgres через REST API или прямой SQL.

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

    Идентификатор, используемый для ветви, который становится окончательным компонентом имени ресурса ветви. Должно иметь длину 1–63 символов, начинаться с строчной буквы и содержать только строчные буквы, цифры и дефисы (RFC 1123).

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса ветви.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере создается ветвь в проекте:

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-catalog

Зарегистрируйте базу данных Postgres в каталоге Unity.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres create-catalog CATALOG_ID [flags]

Arguments

CATALOG_ID

    Идентификатор, используемый для каталога в каталоге Unity. Он становится конечным компонентом имени ресурса каталога (например, my_catalog становится catalogs/my_catalog).

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса каталога (только выходные данные).

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере регистрируется база данных Postgres в каталоге Unity:

databricks postgres create-catalog my-catalog \
  --json '{
    "spec": {
      "postgres_database": "mydb",
      "branch": "projects/my-project-id/branches/production"
    }
  }'

databricks postgres create-endpoint

Создайте конечную точку. Ветвь может иметь одну конечную точку вычислений для чтения и записи и несколько конечных точек только для чтения (реплик чтения) для масштабирования операций чтения.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres create-endpoint PARENT ENDPOINT_ID [flags]

Arguments

PARENT

    Ветвь, в которой создается эта конечная точка. Формат: projects/{project_id}/branches/{branch_id}

ENDPOINT_ID

    Идентификатор, используемый для конечной точки, которая становится конечным компонентом имени ресурса конечной точки. Должно иметь длину 1–63 символов, начинаться с строчной буквы и содержать только строчные буквы, цифры и дефисы (RFC 1123).

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса конечной точки.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере создается конечная точка чтения и записи в ветви:

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

Создание проекта.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

При создании проекта он автоматически включает в себя рабочую ветвь по умолчанию и конечную точку вычислений для чтения и записи как с автоматически созданными идентификаторами.

databricks postgres create-project PROJECT_ID [flags]

Arguments

PROJECT_ID

    Идентификатор, используемый для проекта, который становится окончательным компонентом имени ресурса проекта. Должно иметь длину 1–63 символов, начинаться с строчной буквы и содержать только строчные буквы, цифры и дефисы (RFC 1123).

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса проекта.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере создается проект:

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 для ветви.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres create-role PARENT [flags]

Arguments

PARENT

    Ветвь, в которой создается эта роль. Формат: projects/{project_id}/branches/{branch_id}.

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса роли (только выходные данные).

--no-wait

    Не дождитесь достижения состояния DONE.

--role-id string

    Идентификатор, используемый для роли, который становится окончательным компонентом имени ресурса роли.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере создается роль на основе паролей в ветви:

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

В следующем примере создается роль OAuth для пользователя Databricks:

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 create-synced-table

Создайте синхронизированную таблицу, которая постоянно реплицирует таблицу каталога Unity в базу данных Lakebase Postgres.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres create-synced-table SYNCED_TABLE_ID [flags]

Arguments

SYNCED_TABLE_ID

    Идентификатор, используемый для синхронизированной таблицы в {catalog}.{schema}.{table} формате. Например: my-catalog.sales.orders. Это создает синхронизированную таблицу каталога Unity и таблицу Postgres с именем {table} в схеме {schema}.

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса синхронизированной таблицы (только выходные данные).

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере создается синхронизированная таблица с однократным моментальным снимком:

databricks postgres create-synced-table my-catalog.sales.orders \
  --json '{
    "spec": {
      "source_table_full_name": "main.sales.orders",
      "branch": "projects/my-project-id/branches/production",
      "primary_key_columns": ["order_id"],
      "scheduling_policy": "SNAPSHOT",
      "postgres_database": "mydb",
      "create_database_objects_if_missing": true
    }
  }'

В следующем примере создается синхронизированная таблица с непрерывной синхронизацией (почти в режиме реального времени).

databricks postgres create-synced-table my-catalog.sales.orders \
  --json '{
    "spec": {
      "source_table_full_name": "main.sales.orders",
      "branch": "projects/my-project-id/branches/production",
      "primary_key_columns": ["order_id"],
      "scheduling_policy": "CONTINUOUS",
      "postgres_database": "mydb",
      "create_database_objects_if_missing": true
    }
  }'

databricks postgres delete-branch

Удаление ветви.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

Защищенные ветви не могут быть удалены. Используйте update-branch для установки значение spec.is_protectedfalse перед удалением.

databricks postgres delete-branch NAME [flags]

Arguments

NAME

    Имя удаленной ветви. Формат: projects/{project_id}/branches/{branch_id}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере удаляется ветвь:

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

databricks postgres delete-catalog

Удаление каталога базы данных.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres delete-catalog NAME [flags]

Arguments

NAME

    Полный путь к ресурсу каталога для удаления. Формат: catalogs/{catalog_id}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере удаляется каталог:

databricks postgres delete-catalog catalogs/my-catalog

databricks postgres delete-endpoint

Удаление конечной точки.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres delete-endpoint NAME [flags]

Arguments

NAME

    Имя удаленной конечной точки. Формат: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере удаляется конечная точка:

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

databricks postgres delete-project

Удаление проекта.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres delete-project NAME [flags]

Arguments

NAME

    Имя удаленного проекта. Формат: projects/{project_id}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--purge

    Если значение true, окончательно удаляет проект (жесткое удаление).

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере обратимое удаление проекта (можно восстановить в течение 7 дней):

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

Следующий пример окончательно удаляет проект:

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

databricks postgres delete-role

Удалите роль Postgres из ветви.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres delete-role NAME [flags]

Arguments

NAME

    Полный путь к ресурсу роли для удаления. Формат: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--reassign-owned-to string

    Переназначьте объекты, принадлежащие удаленной роли этой роли.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере удаляется роль из ветви:

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

databricks postgres delete-synced-table

Удаление синхронизированной таблицы.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres delete-synced-table NAME [flags]

Arguments

NAME

    Полное имя ресурса синхронизированной таблицы для удаления. Формат: synced_tables/{catalog}.{schema}.{table}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере удаляется синхронизированная таблица:

databricks postgres delete-synced-table "synced_tables/my-catalog.sales.orders"

databricks postgres generate-database-credential

Создайте учетные данные OAuth для базы данных Postgres. Возвращенный маркер OAuth используется для проверки подлинности и подключения к базе данных с помощью клиентов PostgreSQL, таких как psql.

databricks postgres generate-database-credential ENDPOINT [flags]

Arguments

ENDPOINT

    Конечная точка, для которой создаются эти учетные данные. Формат: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

Глобальные флаги

Примеры

В следующем примере создаются учетные данные 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-catalog

Получение каталога базы данных.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

databricks postgres get-catalog NAME [flags]

Arguments

NAME

    Полный путь к ресурсу для получения каталога. Формат: catalogs/{catalog_id}

Options

Глобальные флаги

Примеры

В следующем примере показано, как получить сведения о каталоге:

databricks postgres get-catalog catalogs/my-catalog

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 get-synced-table

Получение синхронизированной таблицы.

Замечание

Требуется интерфейс командной строки Databricks версии 0.298 или более поздней.

databricks postgres get-synced-table NAME [flags]

Arguments

NAME

    Полное имя ресурса синхронизированной таблицы. Формат: synced_tables/{catalog}.{schema}.{table}

Options

Глобальные флаги

Примеры

В следующем примере показано, как получить сведения о синхронизированной таблице.

databricks postgres get-synced-table "synced_tables/my-catalog.sales.orders"

databricks postgres list-branch

Вывод списка ветвей. Используйте эту команду, чтобы найти идентификаторы ветвей, включая ветвь по умолчанию, созданную в проекте (указано "default": true в состоянии).

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-cdf-configs

Перечислите конфигурации CDF Lakebase (CdfConfigs) в базе данных.

databricks postgres list-cdf-configs PARENT [flags]

Arguments

PARENT

    Родительская база данных для указания CdfConfigs. Формат: projects/{project}/branches/{branch}/databases/{database}

Options

--limit int

    Максимальное количество возвращаемых результатов.

--page-size int

    Максимальное количество CdfConfig для возврата.

Глобальные флаги

Примеры

В следующем примере перечислены конфигурации CDF Lakebase:

databricks postgres list-cdf-configs "projects/my-project/branches/my-branch/databases/my-database"

В следующем примере перечислены конфигурации CDF с пагинацией:

databricks postgres list-cdf-configs "projects/my-project/branches/my-branch/databases/my-database" --page-size 10

databricks postgres list-cdf-statuses

Перечислите статусы репликации реплицированных таблиц в конфигурации Lakebase CDF.

databricks postgres list-cdf-statuses PARENT [flags]

Arguments

PARENT

    Родительский CdfConfig для указания CdfStatuses. Формат: projects/{project}/branches/{branch}/databases/{database}/cdf-configs/{cdf_config}

Options

--limit int

    Максимальное количество возвращаемых результатов.

--page-size int

    Максимальное количество CdfStatus для возврата.

Глобальные флаги

Примеры

В следующем примере перечислены статусы репликации для конфигурации CDF:

databricks postgres list-cdf-statuses "projects/my-project/branches/my-branch/databases/my-database/cdf-configs/my-cdf-config"

databricks postgres list-databases

Перечислить базы данных Postgres в отделении.

databricks postgres list-databases PARENT [flags]

Arguments

PARENT

    Филиал, владеющий этой коллекцией баз данных. Формат: projects/{project_id}/branches/{branch_id}

Options

--limit int

    Максимальное количество возвращаемых результатов.

--page-size int

    Верхняя граница возвращаемых элементов.

Глобальные флаги

Примеры

В следующем примере перечислены все базы данных в ветке:

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

В следующем примере приведены базы данных с пагинацией:

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

databricks postgres list-endpoints

Вывод списка конечных точек. Используйте эту команду для поиска идентификаторов конечных точек, включая конечную точку чтения и записи по умолчанию, созданную в проекте.

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-role

Вывод списка ролей 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.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres undelete-project NAME [flags]

Arguments

NAME

    Полный путь к ресурсу проекта для отмены. Формат: projects/{project_id}

Options

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере восстанавливается обратимо удаленный проект:

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

databricks postgres update-branch

Обновление ветви.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres update-branch NAME UPDATE_MASK [flags]

Arguments

NAME

    Имя ресурса ветви. Формат: projects/{project_id}/branches/{branch_id}

UPDATE_MASK

    Список полей для обновления. Если не указано, все поля обновляются по возможности.

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса ветви.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере обновляется ветвь, чтобы сделать ее защищенной:

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

databricks postgres update-endpoint

Обновление конечной точки.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

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 inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса конечной точки.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере обновляется максимальное количество вычислительных единиц конечной точки:

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
    }
  }'

Чтобы настроить масштабирование до нуля, включите spec.suspension в маску обновления. Установите suspend_timeout_duration (60s–604800s), чтобы определить время ожидания бездействия или no_suspension: true отключить его. Не задавайте их оба. Параметр no_suspension: false возвращает ошибку.

В следующем примере отключается масштабирование до нуля:

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

Следующий пример позволяет масштабировать до нуля с 5-минутным временем ожидания бездействия:

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

Обновление проекта.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

databricks postgres update-project NAME UPDATE_MASK [flags]

Arguments

NAME

    Имя ресурса проекта. Формат: projects/{project_id}

UPDATE_MASK

    Список полей для обновления. Если не указано, все поля обновляются по возможности.

Options

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса проекта.

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере обновляется отображаемое имя проекта:

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

Databricks postgres update-role

Обновите роль Postgres для ветви.

Замечание

Это длительная операция. По умолчанию команда ожидает завершения операции. Используется --no-wait для немедленного возврата сведений о необработанной операции. Затем поле операции name можно использовать для опроса завершения с помощью get-operation команды.

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 inline или @path к JSON-файлу с телом запроса.

--name string

    Имя ресурса роли (только выходные данные).

--no-wait

    Не дождитесь достижения состояния DONE.

--timeout duration

    Максимальное время достижения состояния DONE.

Глобальные флаги

Примеры

В следующем примере предоставляется 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, связанной группе команд или отдельной команде.

--log-file струна

    Строка, представляющая файл для записи журналов выходных данных. Если этот флаг не указан, по умолчанию используется запись журналов выходных данных в stderr.

--log-format формат

    Тип формата журнала: text или json. Значение по умолчанию — text.

--log-level струна

    Строка, представляющая уровень формата журнала. Если не указано, уровень формата журнала отключен.

типа -o, --output

    Тип выходных данных команды: text или json. Значение по умолчанию — text.

-p, --profile струна

    Имя профиля в ~/.databrickscfg файле, используемого для выполнения команды. Если этот флаг не указан, при наличии используется профиль с именем DEFAULT.

--progress-format формат

    Формат для отображения журналов хода выполнения: default, appendinplace, илиjson

-t, --target струна

    Если применимо, целевой объект пакета для использования