Pular para o conteúdo principal

postgres grupo de comandos

nota

Essas informações se aplicam às versões 0.285 e CLI do Databricks e acima.

O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.

O grupo de comandos postgres na CLI do Databricks contém comandos para gerenciar recursos do Lakebase Postgres, incluindo projetos, branches, endpoints, funções, catálogos e tabelas sincronizadas. A API Postgres fornece acesso a um banco de dados Postgres via API REST ou SQL direto.

databricks postgres criar-ramificação

Criar uma ramificação. Ao criar uma ramificação, você deve especificar uma política de expiração usando no_expiry: true para ramificações permanentes.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres create-branch PARENT BRANCH_ID [flags]

Argumentos

PARENT

O projeto no qual esta ramificação foi criada. Formatar: projects/{project_id}

BRANCH_ID

O ID a ser usado para a ramificação, que se torna o componente final do nome do recurso da ramificação. Deve ter entre 1 e 63 caracteres, começar com uma letra minúscula e conter apenas letras minúsculas, números e hífenes (RFC 1123).

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso da ramificação.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma ramificação em um projeto:

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

O exemplo a seguir cria uma ramificação a partir de uma ramificação existente:

Bash
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

Fazer o registro de um banco de dados Postgres no Unity Catalog.

nota

Requer Databricks CLI versão 0.298 ou acima.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres create-catalog CATALOG_ID [flags]

Argumentos

CATALOG_ID

O ID a ser usado para o catálogo no Unity Catalog. Ele se torna o componente final do nome do recurso do catálogo (por exemplo, my_catalog torna-se catalogs/my_catalog).

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso do catálogo (somente para saída).

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir faz o registro de um banco de dados Postgres no Unity Catalog:

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

databricks postgres criar-endpoint

Criar um ponto de extremidade. Uma ramificação pode ter um endpoint compute de leitura e gravação e vários pontos de extremidade somente leitura (réplicas de leitura) para dimensionar as operações de leitura.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres create-endpoint PARENT ENDPOINT_ID [flags]

Argumentos

PARENT

A ramificação onde este endpoint foi criado. Formatar: projects/{project_id}/branches/{branch_id}

ENDPOINT_ID

O ID a ser usado para o endpoint, que se torna o componente final do nome do recurso do endpoint. Deve ter entre 1 e 63 caracteres, começar com uma letra minúscula e conter apenas letras minúsculas, números e hífenes (RFC 1123).

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso do endpoint.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir cria um endpoint de leitura e gravação em uma ramificação:

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

O exemplo a seguir cria um endpoint somente leitura (réplica de leitura):

Bash
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 criar-projeto

Criar um projeto.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

Ao criar um projeto, ele inclui automaticamente uma ramificação de produção default e um endpoint compute de leitura e gravação, ambos com IDs gerados automaticamente.

databricks postgres create-project PROJECT_ID [flags]

Argumentos

PROJECT_ID

O ID a ser usado para o projeto, que se torna o componente final do nome do recurso do projeto. Deve ter entre 1 e 63 caracteres, começar com uma letra minúscula e conter apenas letras minúsculas, números e hífenes (RFC 1123).

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso do projeto.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir cria um projeto:

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

O exemplo a seguir cria um projeto com uma versão específica do PostgreSQL:

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

databricks postgres criar-função

Crie uma função do Postgres para uma ramificação.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres create-role PARENT [flags]

Argumentos

PARENT

A filial onde esta função foi criada. Formato: projects/{project_id}/branches/{branch_id}.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

Nome do recurso da função (somente saída).

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--role-id string

O ID a ser usado para a função, que se torna o componente final do nome do recurso da função.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma função baseada em senha em uma ramificação:

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

O exemplo a seguir cria uma função OAuth para um usuário do Databricks:

Bash
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

Crie uma tabela sincronizada que replica continuamente uma tabela do Unity Catalog para um banco de dados Postgres do Lakebase.

nota

Requer Databricks CLI versão 0.298 ou acima.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres create-synced-table SYNCED_TABLE_ID [flags]

Argumentos

SYNCED_TABLE_ID

O ID a ser usado para a tabela sincronizada, no formato {catalog}.{schema}.{table}. Por exemplo, my-catalog.sales.orders. Isso cria tanto uma tabela sincronizada do Unity Catalog quanto uma tabela Postgres denominada {table} no esquema {schema}.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso da tabela sincronizada (somente saída).

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma tabela sincronizada com um snapshot único:

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

O exemplo a seguir cria uma tabela sincronizada com sincronização contínua (atualizações quase em tempo real):

Bash
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 excluir-ramo

Excluir uma ramificação.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

Ramos protegidos não podem ser excluídos. Use update-branch para definir spec.is_protected para false antes de excluir.

databricks postgres delete-branch NAME [flags]

Argumentos

NAME

Nome da filial a ser excluída. Formatar: projects/{project_id}/branches/{branch_id}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui um ramo:

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

databricks postgres delete-catalog

Excluir um Catálogo de Base de Dados.

nota

Requer Databricks CLI versão 0.298 ou acima.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres delete-catalog NAME [flags]

Argumentos

NAME

O caminho completo do recurso do catálogo a ser excluído. Formato: catalogs/{catalog_id}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui um catálogo:

Bash
databricks postgres delete-catalog catalogs/my-catalog

endpoint de exclusão do PostgreSQL do Databricks

Excluir um ponto de extremidade.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres delete-endpoint NAME [flags]

Argumentos

NAME

O nome do endpoint a ser excluído. Formatar: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui um endpoint:

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

databricks postgres excluir-projeto

Excluir um projeto.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres delete-project NAME [flags]

Argumentos

NAME

Nome do projeto a ser excluído. Formatar: projects/{project_id}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--purge

Se verdadeiro, exclui o projeto permanentemente (exclusão definitiva).

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui logicamente um projeto (recuperável por 7 dias):

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

O exemplo a seguir exclui um projeto permanentemente:

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

databricks postgres excluir-função

Excluir uma função do Postgres de uma ramificação.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres delete-role NAME [flags]

Argumentos

NAME

O caminho completo do recurso da função a ser excluída. Formato: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--reassign-owned-to string

Reatribua os objetos pertencentes à função excluída a esta função.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui uma função de uma ramificação:

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

databricks postgres delete-synced-table

Excluir uma Tabela Sincronizada.

nota

Requer Databricks CLI versão 0.298 ou acima.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres delete-synced-table NAME [flags]

Argumentos

NAME

O nome completo do recurso da tabela sincronizada a ser excluída. Formato: synced_tables/{catalog}.{schema}.{table}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir exclui uma tabela sincronizada:

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

databricks postgres gerar-credencial-de-banco-de-dados

Gere credenciais OAuth para um banco de dados Postgres. Os tokens OAuth retornados são usados para autenticar e conectar ao seu banco de dados com clientes PostgreSQL como psql.

databricks postgres generate-database-credential ENDPOINT [flags]

Argumentos

ENDPOINT

O endpoint para o qual esta credencial foi gerada. Formatar: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir gera credenciais OAuth para um endpoint:

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

databricks postgres obter-ramificação

Consiga uma filial.

databricks postgres get-branch NAME [flags]

Argumentos

NAME

O nome da filial a ser recuperada. Formatar: projects/{project_id}/branches/{branch_id}

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre uma filial:

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

databricks postgres get-catalog

Obter um Catálogo de Banco de Dados.

nota

Requer Databricks CLI versão 0.298 ou acima.

databricks postgres get-catalog NAME [flags]

Argumentos

NAME

O caminho completo do recurso do catálogo a ser recuperado. Formato: catalogs/{catalog_id}

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre um catálogo:

Bash
databricks postgres get-catalog catalogs/my-catalog

databricks postgres obter-endpoint

Obtenha um ponto final.

databricks postgres get-endpoint NAME [flags]

Argumentos

NAME

O nome do endpoint a ser recuperado. Formatar: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre um endpoint:

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

databricks postgres get-operações

Faça uma cirurgia.

databricks postgres get-operation NAME [flags]

Argumentos

NAME

O nome do recurso de operações.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre uma operação:

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

databricks postgres obter-projeto

Obtenha um projeto.

databricks postgres get-project NAME [flags]

Argumentos

NAME

O nome do projeto a ser recuperado. Formatar: projects/{project_id}

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre um projeto:

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

databricks postgres obter-função

Obtenha uma função do Postgres para uma ramificação. Recupera informações sobre a função especificada, incluindo seu método de autenticação e permissões.

databricks postgres get-role NAME [flags]

Argumentos

NAME

O caminho completo do recurso da função a ser recuperada. Formato: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém uma função:

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

databricks postgres get-synced-table

Obter uma Tabela Sincronizada.

nota

Requer Databricks CLI versão 0.298 ou acima.

databricks postgres get-synced-table NAME [flags]

Argumentos

NAME

O nome completo do recurso da tabela sincronizada. Formato: synced_tables/{catalog}.{schema}.{table}

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre uma tabela sincronizada:

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

listar ramificações do PostgreSQL

Listar filiais. Use este comando para encontrar os IDs das ramificações, incluindo a ramificação default criada com seu projeto (indicada por "default": true no status).

databricks postgres list-branches PARENT [flags]

Argumentos

PARENT

O projeto que detém essa coleção de filiais. Formatar: projects/{project_id}

Opções

--page-size int

Limite máximo para itens devolvidos.

--page-token string

Tokens da página de uma resposta anterior.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as ramificações de um projeto:

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

O exemplo a seguir lista filiais com paginação:

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

endpoint de lista do PostgreSQL do Databricks

Listar endpoints. Use este comando para encontrar os IDs endpoint , incluindo o endpoint default de leitura e gravação criado automaticamente com o seu projeto.

databricks postgres list-endpoints PARENT [flags]

Argumentos

PARENT

A filial que detém essa coleção de endpoints. Formatar: projects/{project_id}/branches/{branch_id}

Opções

--page-size int

Limite máximo para itens devolvidos.

--page-token string

Tokens da página de uma resposta anterior.

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os endpoints em uma ramificação:

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

O exemplo a seguir lista os endpoints com paginação:

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

listar projetos do databricks postgres

Lista de projetos.

databricks postgres list-projects [flags]

Opções

--limit int

Número máximo de resultados a serem retornados.

--page-size int

Limite máximo para itens devolvidos.

--page-token string

Tokens da página de uma resposta anterior.

--show-deleted

Se os projetos excluídos temporariamente devem ser incluídos na resposta.

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os projetos:

Bash
databricks postgres list-projects

O exemplo a seguir lista projetos com paginação:

Bash
databricks postgres list-projects --page-size 10

O exemplo a seguir lista todos os projetos, incluindo aqueles que foram excluídos temporariamente:

Bash
databricks postgres list-projects --show-deleted

listar funções do PostgreSQL

Liste as funções do Postgres para uma ramificação.

databricks postgres list-roles PARENT [flags]

Argumentos

PARENT

A filial que detém esse conjunto de funções. Formato: projects/{project_id}/branches/{branch_id}.

Opções

--page-size int

Limite máximo para itens devolvidos.

--page-token string

Tokens da página de uma resposta anterior.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as funções em uma filial:

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

projeto de recuperação de exclusão do PostgreSQL do Databricks

Recuperar um projeto excluído.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres undelete-project NAME [flags]

Argumentos

NAME

O caminho completo do recurso do projeto a ser restaurado. Formatar: projects/{project_id}

Opções

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir recupera um projeto excluído logicamente:

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

databricks postgres atualização-branch

Atualizar uma ramificação.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres update-branch NAME UPDATE_MASK [flags]

Argumentos

NAME

O nome do recurso da ramificação. Formatar: projects/{project_id}/branches/{branch_id}

UPDATE_MASK

Lista de campos a serem atualizados. Caso não seja especificado, todos os campos serão atualizados assim que possível.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso da ramificação.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza uma ramificação para torná-la protegida:

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

endpoint de atualização do PostgreSQL do Databricks

Atualizar um endpoint.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres update-endpoint NAME UPDATE_MASK [flags]

Argumentos

NAME

O nome do recurso do endpoint. Formatar: projects/{project_id}/branches/{branch_id}/endpoints/{endpoint_id}

UPDATE_MASK

Lista de campos a serem atualizados. Caso não seja especificado, todos os campos serão atualizados assim que possível.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso do endpoint.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza as unidades compute máximas de um endpoint:

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

O exemplo a seguir atualiza vários campos (unidades compute mínimas e máximas):

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

Para configurar a escala para zero, inclua spec.suspension na máscara de atualização. Configure suspend_timeout_duration (60s–604800s) para definir o tempo limite de inatividade, ou no_suspension: true para desativá-lo. Não se deve definir ambos. A configuração no_suspension: false retorna um erro.

O exemplo a seguir desativa a escala para zero:

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

O exemplo a seguir habilita a escala para zero com um tempo limite de inatividade de 5 minutos.

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

projeto de atualização do PostgreSQL do Databricks

Atualizar um projeto.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres update-project NAME UPDATE_MASK [flags]

Argumentos

NAME

O nome do recurso do projeto. Formatar: projects/{project_id}

UPDATE_MASK

Lista de campos a serem atualizados. Caso não seja especificado, todos os campos serão atualizados assim que possível.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

O nome do recurso do projeto.

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o nome de exibição de um projeto:

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

databricks postgres atualizar-função

Atualizar uma função do Postgres para uma ramificação.

nota

Esta é uma operação de longa duração. Por default, o comando aguarda a conclusão das operações. Use --no-wait para retornar imediatamente com os detalhes brutos das operações. O campo name das operações pode então ser usado para verificar a conclusão usando o comando get-operation .

databricks postgres update-role NAME UPDATE_MASK [flags]

Argumentos

NAME

O caminho completo do recurso para a função. Formato: projects/{project_id}/branches/{branch_id}/roles/{role_id}.

UPDATE_MASK

Lista de campos a serem atualizados. Caso não seja especificado, todos os campos serão atualizados assim que possível.

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

--name string

Nome do recurso da função (somente saída).

--no-wait

Não espere até atingir o estado CONCLUÍDO.

--timeout duration

Tempo máximo necessário para atingir o estado CONCLUÍDO.

Bandeiras globais

Exemplos

O exemplo a seguir concede CREATEDB a uma função. Ao atualizar spec.attributes, todos os três campos de atributo devem ser fornecidos:

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

O exemplo a seguir adiciona uma função à associação databricks_superuser :

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

Bandeiras globais

--debug

Ativar ou não o registro de depuração.

-h ou --help

Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.

--log-file string

Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.

--log-format Formato

O tipo de formato de log, text ou json. O valor default é text.

--log-level string

Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.

-o, --output Tipo

O tipo de saída do comando, text ou json. O valor default é text.

-p, --profile string

O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado DEFAULT será usado.

--progress-format Formato

O formato para exibir logs de progresso é: default, append, inplace ou json

-t, --target string

Se aplicável, o pacote de destino a ser usado.