comandopsql
Esta informação se aplica às versões 0.285 e acima CLI Databricks . A CLI do Databricks está em versão prévia pública.
O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.
O comando psql na CLI do Databricks permite que você se conecte a um banco de dados Lakebase Postgres usando um cliente PostgreSQL. Ele oferece suporte tanto a instâncias de provisionamento Lakebase quanto a projetos de escalonamento automático Lakebase .
databricks psql
Conecte-se a um banco de dados Postgres do Lakebase. Este comando requer que um cliente psql esteja instalado em sua máquina.
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 sinalizador --max-retries .
databricks psql [TARGET] [flags] [-- PSQL_ARGS...]
Argumentos
TARGET
O alvo ao qual se conectar. Para o provisionamento Lakebase , especifique o nome da instância. Para o dimensionamento automático Lakebase , especifique o caminho completo no formato projects/<project>/branches/<branch>/endpoints/<endpoint>. Se omitido, o comando listará os bancos de dados disponíveis para seleção interativa.
PSQL_ARGS (opcional)
Argumentos adicionais para passar para o cliente psql . Especifique-os após um separador de dois traços (--).
Opções
--autoscaling
Ao listar os bancos de dados disponíveis, mostre apenas os projetos de dimensionamento automático Lakebase .
--branch string
ID da ramificação para dimensionamento automático Lakebase . Por padrão, a seleção será automática quando existir apenas uma ramificação.
--endpoint string
ID do ponto de extremidade para o dimensionamento automático Lakebase . Por padrão, a seleção será automática quando existir apenas um endpoint .
--max-retries int
Número máximo de tentativas de reconexão. Defina como 0 para desativar as novas tentativas. padrão: 3.
--project string
ID do projeto para dimensionamento automático Lakebase .
--provisioned
Ao listar os bancos de dados disponíveis, mostre apenas as instâncias de provisionamento Lakebase .
Exemplos
O exemplo a seguir conecta-se a uma instância de provisionamento Lakebase :
databricks psql my-instance
O exemplo a seguir conecta-se a um projeto de escalonamento automático Lakebase usando flags:
databricks psql --project my-project --branch main --endpoint primary
O exemplo a seguir conecta-se a um projeto de escalonamento automático Lakebase usando o caminho completo:
databricks psql projects/my-project/branches/main/endpoints/primary
O exemplo a seguir lista apenas os projetos de dimensionamento automático Lakebase para seleção interativa:
databricks psql --autoscaling
O exemplo a seguir passa argumentos adicionais para o cliente psql :
databricks psql my-instance -- -c "SELECT 1"
O exemplo a seguir conecta-se com as tentativas de reconexão desativadas:
databricks psql my-instance --max-retries 0
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.