psql comando

Observação

Essas informações se aplicam às versões 0.285 da CLI do Databricks e posteriores. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer provisionamentos de Dados de Uso.

O psql comando dentro da CLI do Databricks permite que você se conecte a um banco de dados do Lakebase Postgres usando um cliente PostgreSQL. Ele dá suporte a instâncias provisionadas do Lakebase e projetos de dimensionamento automático do Lakebase.

databricks psql

Conecte-se a um banco de dados do Lakebase Postgres. Esse comando requer que um psql cliente seja instalado em seu computador.

O comando inclui lógica de repetição automática para falhas de conexão. Você pode configurar o comportamento de repetição usando o --max-retries sinalizador.

databricks psql [TARGET] [flags] [-- PSQL_ARGS...]

Arguments

TARGET

    O destino ao qual se conectar. Para Lakebase Provisioned, especifique o nome da instância. Para o Dimensionamento Automático do Lakebase, especifique o caminho completo no formulário projects/<project>/branches/<branch>/endpoints/<endpoint>. Se omitido, o comando lista os bancos de dados disponíveis para seleção interativa.

PSQL_ARGS (opcional)

    Argumentos adicionais a serem passados para o psql cliente. Especifique-os após um separador de traço duplo (--).

Opções

--autoscaling

    Mostre apenas projetos de dimensionamento automático do Lakebase ao listar bancos de dados disponíveis.

--branch string

    ID do Branch para Dimensionamento Automático do Lakebase. O padrão é selecionar automaticamente quando há apenas um branch.

--endpoint string

    ID do ponto de extremidade para dimensionamento automático do Lakebase. O padrão é selecionar automaticamente quando há apenas um ponto de extremidade.

--max-retries int

    Número máximo de tentativas de repetição de conexão. Defina para 0 desabilitar novas tentativas. Padrão: 3.

--project string

    Project ID do Dimensionamento Automático do Lakebase.

--provisioned

    Mostre apenas instâncias provisionadas do Lakebase ao listar bancos de dados disponíveis.

Sinalizadores globais

Exemplos

O exemplo a seguir se conecta a uma instância provisionada do Lakebase:

databricks psql my-instance

O exemplo a seguir conecta-se a um projeto de dimensionamento automático do Lakebase usando sinalizadores:

databricks psql --project my-project --branch main --endpoint primary

O exemplo a seguir conecta-se a um projeto de dimensionamento automático do Lakebase usando o caminho completo:

databricks psql projects/my-project/branches/main/endpoints/primary

O exemplo a seguir lista apenas projetos de dimensionamento automático do Lakebase para seleção interativa:

databricks psql --autoscaling

O exemplo a seguir passa argumentos adicionais para o psql cliente:

databricks psql my-instance -- -c "SELECT 1"

O exemplo a seguir se conecta com novas tentativas desabilitadas:

databricks psql my-instance --max-retries 0

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo onde serão gravados os logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

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

-t, --target corda

    Se aplicável, o destino do pacote a ser usado