Comando psql

Nota:

Esta información se aplica a las versiones 0.285 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

El psql comando de la CLI de Databricks permite conectarse a una base de datos de Lakebase Postgres mediante un cliente de PostgreSQL. Admite instancias aprovisionadas de Lakebase y proyectos de escalado automático de Lakebase.

databricks psql

Conéctese a una base de datos de Lakebase Postgres. Este comando requiere que se instale un psql cliente en el equipo.

El comando incluye lógica de reintento automático para errores de conexión. Puede configurar el comportamiento de reintento mediante la --max-retries marca .

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

Arguments

TARGET

    Destino al que se va a conectar. En El caso de Lakebase Provisioned, especifique el nombre de la instancia. En Escalado automático de Lakebase, especifique la ruta de acceso completa con el formato projects/<project>/branches/<branch>/endpoints/<endpoint>. Si se omite, el comando muestra las bases de datos disponibles para la selección interactiva.

PSQL_ARGS (opcional)

    Argumentos adicionales para pasar al psql cliente. Especifique estos valores después de un separador de doble guión (--).

Options

--autoscaling

    Solo se muestran los proyectos de escalado automático de Lakebase al enumerar las bases de datos disponibles.

--branch string

    Id. de rama para el escalado automático de Lakebase. El valor predeterminado es seleccionar automáticamente cuando solo existe una rama.

--endpoint string

    Id. de punto de conexión para el escalado automático de Lakebase. El valor predeterminado es seleccionar automáticamente cuando solo existe un punto de conexión.

--max-retries int

    Número máximo de reintentos de conexión. Establézcalo en 0 para deshabilitar los reintentos. Predeterminado: 3.

--project string

    Project id. de escalado automático de Lakebase.

--provisioned

    Solo se muestran las instancias aprovisionadas de Lakebase al enumerar las bases de datos disponibles.

Marcas globales

Examples

En el ejemplo siguiente se conecta a una instancia aprovisionada de Lakebase:

databricks psql my-instance

En el ejemplo siguiente se conecta a un proyecto de escalado automático de Lakebase mediante marcas:

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

En el ejemplo siguiente se conecta a un proyecto de escalado automático de Lakebase mediante la ruta de acceso completa:

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

En el ejemplo siguiente se enumeran solo los proyectos de escalado automático de Lakebase para la selección interactiva:

databricks psql --autoscaling

En el ejemplo siguiente se pasan argumentos adicionales al psql cliente:

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

En el ejemplo siguiente se conecta con reintentos deshabilitados:

databricks psql my-instance --max-retries 0

Marcas globales

--debug

  Indica si se va a habilitar el registro de depuración.

-h o --help

    Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.

--log-file cadena

    Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.

--log-format formato

    Tipo de formato de registro: text o json. El valor predeterminado es text.

--log-level cadena

    Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.

-o, --output tipo

    Tipo de salida del comando, text o json. El valor predeterminado es text.

-p, --profile cadena

    Nombre del perfil en el archivo ~/.databrickscfg que se usará para ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .

--progress-format formato

    Formato para mostrar los registros de progreso: default, append, inplaceo json

-t, --target cadena

    Si procede, el destino del paquete que se va a usar