Si el formato de salida de tabla actual es no alineado, se cambia a alineado. Si no es no alineado, se establece como no alineado. Este comando se mantiene por compatibilidad con versiones anteriores. Consulta \pset para obtener una solución más general.

Establece los parámetros de consulta para la próxima ejecución de consulta, pasando los parámetros especificados para cualquier marcador de posición de parámetro ($1, etc.).

Ejemplo:

INSERT INTO tbl1 VALUES ($1, $2) \bind 'first value' 'second value' \g

Esto también funciona para los comandos de ejecución de consultas distintos de \g, como \gx y \gset.

Este comando hace que se utilice el protocolo de consulta extendida (consulta Section 54.1.2), a diferencia del funcionamiento normal de psql, que utiliza el protocolo de consulta simple. Por lo tanto, este comando puede ser útil para probar el protocolo de consulta extendida desde psql. (El protocolo de consulta extendida se utiliza incluso si la consulta no tiene parámetros y este comando especifica cero parámetros). Este comando afecta solo a la siguiente consulta ejecutada; todas las consultas posteriores utilizarán el protocolo de consulta simple de forma predeterminada.

\bind_named es equivalente a \bind, excepto que toma el nombre de una sentencia preparada existente como primer parámetro. Una cadena vacía denota la sentencia preparada sin nombre.

Ejemplo:

INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1
\bind_named stmt1 'first value' 'second value' \g

Este comando hace que se utilice el protocolo de consulta extendida (consulta Section 54.1.2), a diferencia del funcionamiento normal de psql, que utiliza el protocolo de consulta simple. Por lo tanto, este comando puede ser útil para probar el protocolo de consulta extendida desde psql.

Establece una nueva conexión con un servidor PostgreSQL. Los parámetros de conexión a utilizar se pueden especificar utilizando una sintaxis posicional (uno o más de: nombre de base de datos, usuario, host y puerto), o utilizando una cadena de conexión conninfo tal y como se detalla en Section 32.1.1. Si no se proporcionan argumentos, se establece una nueva conexión utilizando los mismos parámetros que antes.

Especificar cualquiera de los parámetros dbname, username, host o port como - equivale a omitir dicho parámetro.

La nueva conexión puede reutilizar los parámetros de conexión de la conexión anterior; no solo el nombre de la base de datos, el usuario, el host y el puerto, sino también otras configuraciones como sslmode. De forma predeterminada, los parámetros se reutilizan en la sintaxis posicional, pero no cuando se proporciona una cadena conninfo. Pasar un primer argumento de -reuse-previous=on o -reuse-previous=off sobrescribe ese comportamiento predeterminado. Si se reutilizan los parámetros, cualquier parámetro que no se especifique explícitamente como un parámetro posicional o en la cadena conninfo se tomará de los parámetros de la conexión existente. Una excepción es que si la configuración de host se cambia de su valor anterior utilizando la sintaxis posicional, se descarta cualquier configuración de hostaddr presente en los parámetros de la conexión existente. Además, cualquier contraseña utilizada para la conexión existente se reutilizará solo si no se cambian las configuraciones de usuario, host y puerto. Cuando el comando no especifica ni reutiliza un parámetro en particular, se utiliza el valor predeterminado de libpq.

Si la nueva conexión se realiza correctamente, se cierra la conexión anterior. Si el intento de conexión falla (nombre de usuario incorrecto, acceso denegado, etc.), se mantendrá la conexión anterior si psql está en modo interactivo. Pero cuando executing a non-interactive script, the old connection is closed and an error is reported. That may or may not terminate the script; if it does not, all database-accessing commands will fail until another \connect command is successfully executed. This distinction was chosen as a user convenience against typos on the one hand, and a safety mechanism that scripts are not accidentally acting on the wrong database on the other hand. Note that whenever a \connect command attempts to re-use parameters, the values re-used are those of the last successful connection, not of any failed attempts made subsequently. However, in the case of a non-interactive \connect failure, no parameters are allowed to be re-used later, since the script would likely be expecting the values from the failed \connect to be re-used.

Ejemplos:

=> \c mydb myuser host.dom 6432
=> \c service=foo
=> \c "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"
=> \c -reuse-previous=on sslmode=require    -- cambia solo sslmode
=> \c postgresql://tom@localhost/mydb?application_name=myapp

Establece el título de cualquier tabla que se imprima como resultado de una consulta o elimina dicho título. Este comando es equivalente a \pset title title. (El nombre de este comando proviene de “caption” [título], ya que antes solo se utilizaba para establecer el título en una tabla HTML).

Cambia el directorio de trabajo actual a directory. Sin argumentos, cambia al directorio de inicio (home) del usuario actual. Para obtener detalles sobre cómo se encuentran los directorios de inicio, consulta Section 32.16.

Cierra la sentencia preparada especificada. Una cadena vacía denota la sentencia preparada sin nombre. Si no existe ninguna sentencia preparada con este nombre, la operación no hace nada (no-op).

Ejemplo:

SELECT $1 \parse stmt1
\close_prepared stmt1

Este comando hace que se utilice el protocolo de consulta extendida, a diferencia del funcionamiento normal de psql, que utiliza el protocolo de consulta simple. Por lo tanto, este comando puede ser útil para probar el protocolo de consulta extendida desde psql.

Muestra información sobre la conexión actual a la base de datos, incluyendo información relacionada con SSL si SSL está en uso.

Ten en cuenta que el campo Client User (usuario del cliente) muestra el usuario en el momento de la conexión, mientras que el campo Superuser (superusuario) indica si el usuario actual (en el contexto de ejecución actual) tiene privilegios de superusuario. Estos usuarios suelen ser el mismo, pero pueden diferir, por ejemplo, si el usuario actual se cambió con el comando SET ROLE.

Realiza una copia en el frontend (cliente). Esta es una operación que ejecuta un comando SQL COPY, pero en lugar de que el servidor lea o escriba el archivo especificado, psql lee o escribe el archivo y dirige los datos entre el servidor y el sistema de archivos local. Esto significa que la accesibilidad del archivo y los privilegios son los del usuario local, no los del servidor, y no se requieren privilegios de superusuario de SQL.

Cuando se especifica program, command es ejecutado por psql y los datos pasados desde o hacia command son dirigidos entre el servidor y el cliente. Nuevamente, los privilegios de ejecución son los del usuario local, no los del servidor, y no se requieren privilegios de superusuario de SQL.

Para \copy ... from stdin, las filas de datos se leen desde la misma fuente que emitió el comando, continuando hasta que se lea una línea que contenga solo \. o la transmisión alcance el EOF (fin de archivo). Esta opción es útil para rellenar tablas en línea dentro de un archivo de script SQL. Para \copy ... to stdout, la salida se envía al mismo lugar que la salida del comando de psql, y no se imprime el estado del comando COPY count (ya que podría confundirse con una fila de datos). Para leer/escribir la entrada o salida estándar de psql independientemente de la fuente del comando actual o de la opción \o, escribe from pstdin o to pstdout.

La sintaxis de este comando es similar a la del comando SQL COPY. Todas las opciones distintas del origen/destino de los datos son las especificadas para COPY. Debido a esto, se aplican reglas de análisis especiales al metacomando \copy. A diferencia de la mayoría de los demás metacomandos, todo el resto de la línea se toma siempre como los argumentos de \copy, y no se realiza ni la interpolación de variables ni la expansión de comillas invertidas en los argumentos.

Muestra los términos de derechos de autor (copyright) y distribución de PostgreSQL.

Ejecuta el búfer de consulta actual (como \g) y muestra los resultados en una cuadrícula de tabla de referencias cruzadas (crosstab). La consulta debe devolver al menos tres columnas. La columna de salida identificada por colV se convierte en una cabecera vertical y la columna de salida identificada por colH se convierte en una cabecera horizontal. colD identifica la columna de salida a mostrar dentro de la cuadrícula. sortcolH identifica una columna de ordenación opcional para la cabecera horizontal.

Cada especificación de columna puede ser un número de columna (empezando por 1) o un nombre de columna. Se aplican las reglas habituales de SQL de conversión de mayúsculas/minúsculas y entrecomillado a los nombres de las columnas. Si se omite, colV se toma como la columna 1 y colH como la columna 2. colH debe ser diferente de colV. Si no se especifica colD, entonces debe haber exactamente tres columnas en el resultado de la consulta, y la columna que no sea ni colV ni colH se tomará como colD.

La cabecera vertical, que se muestra como la columna más a la izquierda, contiene los valores encontrados en la columna colV, en el mismo orden que en los resultados de la consulta, pero eliminando los duplicados.

La cabecera horizontal, que se muestra como la primera fila, contiene los valores encontrados en la columna colH, eliminando los duplicados. Por defecto, estos aparecen en el mismo orden que en los resultados de la consulta. Pero si se proporciona el argumento opcional sortcolH, este identifica una columna cuyos valores deben ser números enteros, y los valores de colH aparecerán en la cabecera horizontal ordenados según los valores de sortcolH correspondientes.

Dentro de la cuadrícula de referencias cruzadas, para cada valor distinto x de colH y cada valor distinto y de colV, la celda situada en la intersección (x,y) contiene el valor de la columna colD en la fila del resultado de la consulta para la cual el valor de colH es x y el valor de colV es y. Si no existe tal fila, la celda queda vacía. Si hay varias filas de este tipo, se informa de un error.

Para cada relación (tabla, vista, vista materializada, índice, secuencia o tabla externa) o tipo compuesto que coincida con el pattern, muestra todas las columnas, sus tipos, el tablespace (si no es el predeterminado) y cualquier atributo especial como NOT NULL o valores predeterminados. También se muestran los índices, restricciones, reglas y disparadores (triggers) asociados. Para las tablas externas, también se muestra el servidor externo asociado. (“Coincidir con el patrón” se define en Patterns más adelante).

Para algunos tipos de relación, \d muestra información adicional para cada columna: valores de columna para secuencias, expresiones indexadas para índices y opciones de envoltura de datos externos (foreign data wrapper) para tablas externas.

La forma del comando \d+ es idéntica, excepto que se muestra más información: se muestran los comentarios asociados a las columnas de la tabla, así como la presencia de OID en la tabla, la definición de la vista si la relación es una vista, una configuración de identidad de réplica que no sea la predeterminada y el nombre del método de acceso si la relación tiene un método de acceso.

Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema.

Muestra una lista de las funciones de agregación, junto con su tipo de retorno y los tipos de datos sobre los que operan. Si se especifica pattern, solo se muestran las agregaciones cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Muestra una lista de los métodos de acceso. Si se especifica pattern, solo se muestran los métodos de acceso cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada método de acceso se muestra con su función de controlador (handler) asociada y su descripción.

Muestra una lista de las clases de operadores (consulta Section 36.16.1). Si se especifica access-method-pattern, solo se listan las clases de operadores asociadas con métodos de acceso cuyos nombres coincidan con ese patrón. Si se especifica input-type-pattern, solo se listan las clases de operadores asociadas con tipos de entrada cuyos nombres coincidan con ese patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada clase de operador se muestra con su familia de operadores asociada y su propietario.

Muestra una lista de las familias de operadores (consulta Section 36.16.5). Si se especifica access-method-pattern, solo se listan las familias de operadores asociadas con métodos de acceso cuyos nombres coincidan con ese patrón. Si se especifica input-type-pattern, solo se listan las familias de operadores asociadas con tipos de entrada cuyos nombres coincidan con ese patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada familia de operadores se muestra con su propietario.

Muestra una lista de los operadores asociados con familias de operadores (consulta Section 36.16.2). Si se especifica access-method-pattern, solo se listan los miembros de las familias de operadores asociadas con métodos de acceso cuyos nombres coincidan con ese patrón. Si se especifica operator-family-pattern, solo se listan los miembros de las familias de operadores cuyos nombres coincidan con ese patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada operador se muestra con su familia de operadores de ordenación (si es un operador de ordenación), y si su función subyacente es a prueba de filtraciones (leakproof).

Muestra una lista de las funciones de soporte asociadas con familias de operadores (consulta Section 36.16.3). Si se especifica access-method-pattern, solo se listan las funciones de las familias de operadores asociadas con métodos de acceso cuyos nombres coincidan con ese patrón. Si se especifica operator-family-pattern, solo se listan las funciones de las familias de operadores cuyos nombres coincidan con ese patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, las funciones se muestran con detalle, con sus listas de parámetros reales.

Muestra una lista de los tablespaces. Si se especifica pattern, solo se muestran los tablespaces cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada tablespace se muestra con sus opciones asociadas, tamaño en disco, permisos y descripción.

Muestra una lista de las conversiones entre codificaciones de conjuntos de caracteres. Si se especifica pattern, solo se listan las conversiones cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto se muestra con su descripción asociada.

Muestra una lista de los parámetros de configuración del servidor y sus valores. Si se especifica pattern, solo se listan los parámetros cuyos nombres coincidan con el patrón. Sin un pattern, solo se listan los parámetros que están configurados con valores no predeterminados. (Usa \dconfig * para ver todos los parámetros). Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada parámetro se lista con su tipo de datos, el contexto en el que se puede establecer el parámetro y los privilegios de acceso (si se han otorgado privilegios de acceso no predeterminados).

Muestra una lista de las conversiones de tipo (casts). Si se especifica pattern, solo se listan las conversiones cuyos tipos de origen o destino coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada conversión, incluyendo si su función subyacente es a prueba de filtraciones (leakproof) y la descripción de la conversión.

Muestra las descripciones de los objetos de tipo constraint (restricción), operator class (clase de operador), operator family (familia de operadores), rule (regla) y trigger (disparador). Todos los demás comentarios se pueden ver mediante los comandos de barra invertida respectivos para esos tipos de objetos.

\dd muestra las descripciones de los objetos que coinciden con el pattern, o de los objetos visibles del tipo apropiado si no se proporciona ningún argumento. Pero en cualquier caso, solo se listan los objetos que tienen una descripción. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Las descripciones de los objetos se pueden crear con el comando SQL COMMENT.

Muestra una lista de los dominios. Si se especifica pattern, solo se muestran los dominios cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto se muestra con sus permisos asociados y su descripción.

Muestra una lista de las configuraciones de privilegios de acceso predeterminados. Se muestra una entrada para cada rol (y esquema, si corresponde) para el cual se han modificado los privilegios predeterminados a partir de los valores incorporados. Si se especifica pattern, solo se listan las entradas cuyo nombre de rol o nombre de esquema coincida con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

El comando ALTER DEFAULT PRIVILEGES se utiliza para establecer los privilegios de acceso predeterminados. El significado de la visualización de los privilegios se explica en Section 5.8.

En este grupo de comandos, las letras E, i, m, s, t y v representan tabla externa, índice, vista materializada, secuencia, tabla y vista, respectivamente. Puedes especificar cualquiera de estas letras, o todas ellas, en cualquier orden, para obtener una lista de objetos de estos tipos. Por ejemplo, \dti lista tablas e índices. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto se muestra con su estado de persistencia (permanente, temporal o unlogged), su tamaño físico en disco y su descripción asociada si la hubiera. Si se especifica pattern, solo se listan los objetos cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema.

Muestra una lista de los servidores externos (mnemónico: “external servers”). Si se especifica pattern, solo se listan aquellos servidores cuyo nombre coincida con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra una descripción completa de cada servidor, incluyendo los privilegios de acceso del servidor, el tipo, la versión, las opciones y la descripción.

Muestra una lista de las tablas externas (mnemónico: “external tables”). Si se especifica pattern, solo se listan las entradas cuyo nombre de tabla o de esquema coincida con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, también se muestran las opciones genéricas y la descripción de la tabla externa.

Muestra una lista de los mapeos de usuario (mnemónico: “external users”). Si se especifica pattern, solo se listan aquellos mapeos cuyos nombres de usuario coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada mapeo.

Muestra una lista de las envolturas de datos externos (mnemónico: “external wrappers”). Si se especifica pattern, solo se listan aquellas envolturas cuyo nombre coincida con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, también se muestran los privilegios de acceso, las opciones y la descripción de la envoltura de datos externos.

Muestra una lista de las funciones, junto con sus tipos de datos de resultado, tipos de datos de argumentos y tipos de funciones, que se clasifican como “agg” (agregación), “normal”, “procedure” (procedimiento), “trigger” (disparador) o “window” (ventana). Para mostrar solo funciones de tipo(s) específico(s), añade las letras correspondientes a, n, p, t o w al comando. Si se especifica pattern, solo se muestran las funciones cuyos nombres coincidan con el patrón. Cualquier argumento adicional son patrones de nombres de tipos, que se comparan con los nombres de tipos del primer, segundo y sucesivos argumentos de la función. (Las funciones coincidentes pueden tener más argumentos de los que especificas. Para evitarlo, escribe un guion - como último arg_pattern). Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada función, incluyendo la volatilidad, la seguridad en paralelo, el propietario, la clasificación de seguridad, si es a prueba de filtraciones, los privilegios de acceso, el lenguaje, el nombre interno (solo para funciones en C e internas) y la descripción. El código fuente de una función específica se puede ver mediante \sf.

Muestra una lista de las configuraciones de búsqueda de texto. Si se especifica pattern, solo se muestran las configuraciones cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra una descripción completa de cada configuración, incluyendo el analizador (parser) de búsqueda de texto subyacente y la lista de diccionarios para cada tipo de token del analizador.

Muestra una lista de los diccionarios de búsqueda de texto. Si se especifica pattern, solo se muestran los diccionarios cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada diccionario seleccionado, incluyendo la plantilla de búsqueda de texto subyacente y los valores de las opciones.

Lists text search parsers. If pattern is specified, only parsers whose names match the pattern are shown. If x is appended to the command name, the results are displayed in expanded mode. If + is appended to the command name, a full description of each parser is shown, including the underlying functions and the list of recognized token types.

Lists text search templates. If pattern is specified, only templates whose names match the pattern are shown. If x is appended to the command name, the results are displayed in expanded mode. If + is appended to the command name, additional information is shown about each template, including the underlying function names.

Lists database roles. (Since the concepts of “users” and “groups” have been unified into “roles”, this command is now equivalent to \du.) By default, only user-created roles are shown; supply the S modifier to include system roles. If pattern is specified, only those roles whose names match the pattern are listed. If x is appended to the command name, the results are displayed in expanded mode. If + is appended to the command name, additional information is shown about each role; currently this adds the comment for each role.

This is an alias for \lo_list, which shows a list of large objects. If x is appended to the command name, the results are displayed in expanded mode. If + is appended to the command name, each large object is listed with its associated permissions, if any.

Muestra una lista de los lenguajes procedimentales. Si se especifica pattern, solo se listan los lenguajes cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los lenguajes creados por el usuario; proporciona el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada lenguaje se lista con su manejador de llamadas, validador, privilegios de acceso y si es un objeto del sistema.

Muestra una lista de los esquemas (espacios de nombres). Si se especifica pattern, solo se listan los esquemas cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto se lista con sus permisos asociados y su descripción, si la hubiera.

Muestra una lista de los operadores con sus tipos de operandos y de resultados. Si se especifica pattern, solo se listan los operadores cuyos nombres coincidan con el patrón. Si se especifica un arg_pattern, solo se listan los operadores de prefijo cuyo nombre de tipo del argumento derecho coincida con el patrón. Si se especifican dos arg_patterns, solo se listan los operadores binarios cuyos nombres de tipo de argumentos coincidan con esos patrones. (Alternativamente, escribe - para el argumento no utilizado de un operador unario). Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada operador, incluyendo el nombre de la función subyacente y si es a prueba de filtraciones (leakproof).

Muestra una lista de las ordenaciones (collations). Si se especifica pattern, solo se listan las ordenaciones cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada ordenación se muestra con su descripción asociada, si la hubiera. Ten en cuenta que solo se muestran las ordenaciones utilizables con la codificación de la base de datos actual, por lo que los resultados pueden variar en diferentes bases de datos de la misma instalación.

Muestra una lista de las tablas, vistas y secuencias con sus privilegios de acceso asociados. Si se especifica pattern, solo se listan las tablas, vistas y secuencias cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Los comandos GRANT y REVOKE se utilizan para establecer los privilegios de acceso. El significado de la visualización de los privilegios se explica en Section 5.8.

Muestra una lista de las relaciones particionadas. Si se especifica pattern, solo se listan las entradas cuyo nombre coincida con el patrón. Se pueden añadir los modificadores t (tablas) e i (índices) al comando, filtrando la clase de relaciones a listar. Por defecto, se listan las tablas e índices particionados.

Si se utiliza el modificador n (“nested” [anidado]), o se especifica un patrón, entonces se incluyen las relaciones particionadas que no son raíz y se muestra una columna con el padre de cada relación particionada.

Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, también se muestra la suma de los tamaños de las particiones de cada relación, junto con la descripción de la relación. Si se combina n con +, se muestran dos tamaños: uno que incluye el tamaño total de las particiones hoja directamente adjuntas, y otro que muestra el tamaño total de todas las particiones, incluyendo las subparticiones adjuntas indirectamente.

Muestra una lista de las configuraciones definidas. Estas configuraciones pueden ser específicas de un rol, específicas de una base de datos o de ambos. role-pattern y database-pattern se utilizan para seleccionar los roles y bases de datos específicos a listar, respectivamente. Si se omiten, o si se especifica *, se listan todas las configuraciones, incluyendo las que no son específicas de roles o bases de datos, respectivamente. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Los comandos ALTER ROLE y ALTER DATABASE se utilizan para definir configuraciones por rol y por base de datos.

Muestra información sobre la pertenencia a cada rol otorgado, incluyendo las opciones asignadas (ADMIN, INHERIT y/o SET) y el otorgante. Consulta el comando GRANT para obtener información sobre la pertenencia a roles.

Por defecto, solo se muestran los otorgamientos a roles creados por el usuario; proporciona el modificador S para incluir los roles del sistema. Si se especifica pattern, solo se listan los otorgamientos a aquellos roles cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Muestra una lista de las publicaciones de replicación. Si se especifica pattern, solo se listan aquellas publicaciones cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, también se muestran las tablas y esquemas asociados a cada publicación.

Muestra una lista de las suscripciones de replicación. Si se especifica pattern, solo se listan aquellas suscripciones cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestran propiedades adicionales de las suscripciones.

Muestra una lista de los tipos de datos. Si se especifica pattern, solo se listan los tipos cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada tipo se lista con su nombre interno y tamaño, sus valores permitidos si es un tipo enum, y sus permisos asociados. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir los objetos del sistema.

Muestra una lista de los roles de la base de datos. (Dado que los conceptos de “usuarios” y “grupos” se han unificado en “roles”, este comando ahora es equivalente a \dg.) Por defecto, solo se muestran los roles creados por el usuario; proporciona el modificador S para incluir los roles del sistema. Si se especifica pattern, solo se listan aquellos roles cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se muestra información adicional sobre cada rol; actualmente, esto añade el comentario de cada rol.

Muestra una lista de las extensiones instaladas. Si se especifica pattern, solo se listan aquellas extensiones cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, se listan todos los objetos pertenecientes a cada extensión coincidente.

Muestra una lista de las estadísticas extendidas. Si se especifica pattern, solo se listan aquellas estadísticas extendidas cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

El estado de cada tipo de estadísticas extendidas se muestra en una columna con el nombre de su tipo de estadística (por ejemplo, Ndistinct). defined significa que se solicitó al crear las estadísticas, y NULL significa que no se solicitó. Puedes utilizar pg_stats_ext si deseas saber si se ejecutó ANALYZE y si el planificador dispone de estadísticas.

Muestra una lista de los disparadores de eventos (event triggers). Si se especifica pattern, solo se listan aquellos disparadores de eventos cuyos nombres coincidan con el patrón. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto se muestra con su descripción asociada.

Si se especifica filename, se edita el archivo; después de salir del editor, el contenido del archivo se copia en el búfer de consulta actual. Si no se indica ningún filename, el búfer de consulta actual se copia en un archivo temporal que se edita de la misma manera. O bien, si el búfer de consulta actual está vacío, la consulta ejecutada más recientemente se copia a un archivo temporal y se edita de la misma manera.

Si editas un archivo o la consulta anterior, y sales del editor sin modificar el archivo, el búfer de consulta se borra. De lo contrario, los nuevos contenidos del búfer de consulta se vuelven a analizar de acuerdo con las reglas normales de psql, tratando todo el búfer como una sola línea. Cualquier consulta completa se ejecuta inmediatamente; es decir, si el búfer de consulta contiene o termina con un punto y coma, todo lo que esté antes de ese punto se ejecuta y se elimina del búfer de consulta. Lo que quede en el búfer de consulta se vuelve a mostrar. Escribe un punto y coma o \g para enviarlo, o \r para cancelarlo borrando el búfer de consulta.

Tratar el búfer como una sola línea afecta principalmente a los metacomandos: lo que quede en el búfer después de un metacomando se tomará como argumento(s) para el metacomando, incluso si abarca varias líneas. (Por lo tanto, no puedes crear scripts que utilicen metacomandos de esta manera. Utiliza \i para eso).

Si se especifica un número de línea, psql posicionará el cursor en la línea especificada del archivo o del búfer de consulta. Ten en cuenta que si se proporciona un solo argumento compuesto solo por dígitos, psql asume que es un número de línea, no un nombre de archivo.

Imprime los argumentos evaluados en la salida estándar, separados por espacios y seguidos por una nueva línea. Esto puede ser útil para intercalar información en la salida de los scripts. Por ejemplo:

=> \echo `date`
Tue Oct 26 21:40:57 CEST 1999

Si el primer argumento es un -n sin comillas, no se escribe la nueva línea final (ni tampoco el primer argumento).

Este comando recupera y edita la definición de la función o procedimiento indicado, en forma de un comando CREATE OR REPLACE FUNCTION o CREATE OR REPLACE PROCEDURE. La edición se realiza de la misma manera que para \edit. Si sales del editor sin guardar, la declaración se descarta. Si guardas y sales del editor, el comando actualizado se ejecuta inmediatamente si le añadiste un punto y coma. De lo contrario, se vuelve a mostrar; escribe un punto y coma o \g para enviarlo, o \r para cancelar.

La función de destino se puede especificar solo por su nombre, o por su nombre y argumentos, por ejemplo foo(integer, text). Se deben proporcionar los tipos de argumentos si existe más de una función con el mismo nombre.

Si no se especifica ninguna función, se presenta una plantilla en blanco de CREATE FUNCTION para su edición.

Si se especifica un número de línea, psql posicionará el cursor en la línea especificada del cuerpo de la función. (Ten en cuenta que el cuerpo de la función no suele comenzar en la primera línea del archivo).

A diferencia de la mayoría de los demás metacomandos, todo el resto de la línea se toma siempre como el/los argumento(s) de \ef, y no se realiza ni la interpolación de variables ni la expansión de comillas invertidas en los argumentos.

Establece la codificación del conjunto de caracteres del cliente. Sin un argumento, este comando muestra la codificación actual.

Repite el mensaje de error del servidor más reciente con el máximo nivel de detalle, como si VERBOSITY estuviera establecido en verbose y SHOW_CONTEXT estuviera establecido en always.

Este comando recupera y edita la definición de la vista indicada, en forma de un comando CREATE OR REPLACE VIEW. La edición se realiza de la misma manera que para \edit. Si sales del editor sin guardar, la declaración se descarta. Si guardas y sales del editor, el comando actualizado se ejecuta inmediatamente si le añadiste un punto y coma. De lo contrario, se vuelve a mostrar; escribe un punto y coma o \g para enviarlo, o \r para cancelar.

Si no se especifica ninguna vista, se presenta una plantilla en blanco de CREATE VIEW para su edición.

Si se especifica un número de línea, psql posicionará el cursor en la línea especificada de la definición de la vista.

A diferencia de la mayoría de los demás metacomandos, todo el resto de la línea se toma siempre como el/los argumento(s) de \ev, y no se realiza ni la interpolación de variables ni la expansión de comillas invertidas en los argumentos.

Establece el separador de campos para la salida de consultas no alineada. El valor predeterminado es la barra vertical (|). Es equivalente a \pset fieldsep.

Envía el búfer de consulta actual al servidor para su ejecución.

Si aparecen paréntesis después de \g, encierran una lista separada por espacios de cláusulas de opciones de formato option=value, que se interpretan de la misma manera que los comandos \pset option value, pero surten efecto solo durante la ejecución de esta consulta. En esta lista, no se permiten espacios alrededor de los signos =, pero se requieren entre las cláusulas de opciones. Si se omite =value, la opción nombrada option se cambia de la misma manera que para \pset option sin un value explícito.

Si se proporciona un argumento de filename o |command, la salida de la consulta se escribe en el archivo indicado o se dirige al comando de shell proporcionado, en lugar de mostrarse como es habitual. El archivo o comando se escribe solo si la consulta devuelve con éxito cero o más tuplas, no si la consulta falla o es un comando SQL que no devuelve datos.

Si el búfer de consulta actual está vacío, se vuelve a ejecutar la consulta enviada más recientemente. Excepto por ese comportamiento, \g sin argumentos es esencialmente equivalente a un punto y coma. Con argumentos, \g proporciona una alternativa “de un solo uso” (one-shot) al comando \o, y además permite ajustes de un solo uso de las opciones de formato de salida que normalmente se configuran mediante \pset.

Cuando el último argumento comienza con |, todo el resto de la línea se toma como el command a ejecutar, y no se realiza en él ni la interpolación de variables ni la expansión de comillas invertidas. El resto de la línea simplemente se pasa literalmente al shell.

Muestra la descripción (es decir, los nombres de las columnas y los tipos de datos) del resultado del búfer de consulta actual. La consulta no se ejecuta realmente; sin embargo, si contiene algún tipo de error de sintaxis, ese error se notificará de la manera habitual.

Si el búfer de consulta actual está vacío, se describe en su lugar la consulta enviada más recientemente.

Obtiene el valor de la variable de entorno env_var y lo asigna a la variable de psql psql_var. Si env_var no está definida en el entorno del proceso de psql, psql_var no se modifica. Ejemplo:

=> \getenv home HOME
=> \echo :home
/home/postgres

Envía el búfer de consulta actual al servidor, y luego trata cada columna de cada fila del resultado de la consulta (si lo hubiera) como una sentencia SQL a ejecutar. Por ejemplo, para crear un índice en cada columna de my_table:

=> SELECT format('create index on my_table(%I)', attname)
-> FROM pg_attribute
-> WHERE attrelid = 'my_table'::regclass AND attnum > 0
-> ORDER BY attnum
-> \gexec
CREATE INDEX
CREATE INDEX
CREATE INDEX
CREATE INDEX

Las consultas generadas se ejecutan en el orden en que se devuelven las filas, y de izquierda a derecha dentro de cada fila si hay más de una columna. Los campos NULL se ignoran. Las consultas generadas se envían literalmente al servidor para su procesamiento, por lo que no pueden ser metacomandos de psql ni contener referencias a variables de psql. Si alguna consulta individual falla, la ejecución de las consultas restantes continúa, a menos que ON_ERROR_STOP esté establecida. La ejecución de cada consulta está sujeta al procesamiento de ECHO. (A menudo es aconsejable establecer ECHO en all o queries cuando se utiliza \gexec). El registro de consultas, el modo de paso único, el tiempo de ejecución (timing) y otras características de ejecución de consultas también se aplican a cada consulta generada.

Si el búfer de consulta actual está vacío, se vuelve a ejecutar la consulta enviada más recientemente.

Envía el búfer de consulta actual al servidor y almacena el resultado de la consulta en variables de psql (consulta Variables más adelante). La consulta a ejecutar debe devolver exactamente una fila. Cada columna de la fila se almacena en una variable independiente, con el mismo nombre que la columna. Por ejemplo:

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset
=> \echo :var1 :var2
hello 10

Si especificas un prefix, esa cadena se antepone a los nombres de las columnas de la consulta para crear los nombres de las variables a utilizar:

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset result_
=> \echo :result_var1 :result_var2
hello 10

Si el resultado de una columna es NULL, la variable correspondiente se elimina (unset) en lugar de establecerse.

Si la consulta falla o no devuelve una fila, no se modifica ninguna variable.

Si el búfer de consulta actual está vacío, se vuelve a ejecutar en su lugar la consulta enviada más recientemente.

\gx es equivalente a \g, excepto que fuerza el modo de salida expandido para esta consulta, como si se hubiera incluido expanded=on en la lista de opciones de \pset. Consulta también \x.

Ofrece ayuda sobre la sintaxis del comando SQL especificado. Si no se especifica command, entonces psql listará todos los comandos para los que hay ayuda sintáctica disponible. Si command es un asterisco (*), se muestra la ayuda de sintaxis de todos los comandos SQL.

A diferencia de la mayoría de los demás metacomandos, todo el resto de la línea se toma siempre como el/los argumento(s) de \help, y no se realiza ni la interpolación de variables ni la expansión de comillas invertidas en los argumentos.

Activa el formato de salida de consultas en HTML. Si el formato HTML ya está activado, se vuelve al formato predeterminado de texto alineado. Este comando existe por motivos de compatibilidad y conveniencia, pero consulta \pset para configurar otras opciones de salida.

Lee la entrada desde el archivo filename y la ejecuta como si se hubiera introducido desde el teclado.

Si filename es - (guion), se lee la entrada estándar hasta una indicación de EOF o el metacomando \q. Esto se puede utilizar para intercalar la entrada interactiva con la entrada de archivos. Ten en cuenta que el comportamiento de Readline se utilizará solo si está activo en el nivel más externo.

expression yields true then processing continues normally; otherwise, lines are skipped until a matching \elif, \else, or \endif is reached. Once an \if or \elif test has succeeded, the arguments of later \elif commands in the same block are not evaluated but are treated as false. Lines following an \else are processed only if no earlier matching \if or \elif succeeded.

The expression argument of an \if or \elif command is subject to variable interpolation and backquote expansion, just like any other backslash command argument. After that it is evaluated like the value of an on/off option variable. So a valid value is any unambiguous case-insensitive match for one of: true, false, 1, 0, on, off, yes, no. For example, t, T, and tR will all be considered to be true.

Expressions that do not properly evaluate to true or false will generate a warning and be treated as false.

Lines being skipped are parsed normally to identify queries and backslash commands, but queries are not sent to the server, and backslash commands other than conditionals (\if, \elif, \else, \endif) are ignored. Conditional commands are checked only for valid nesting. Variable references in skipped lines are not expanded, and backquote expansion is not performed either.

All the backslash commands of a given conditional block must appear in the same source file. If EOF is reached on the main input file or an \include-ed file before all local \if-blocks have been closed, then psql will raise an error.

Here is an example:

-- check for the existence of two separate records in the database and store
-- the results in separate psql variables
SELECT
    EXISTS(SELECT 1 FROM customer WHERE customer_id = 123) as is_customer,
    EXISTS(SELECT 1 FROM employee WHERE employee_id = 456) as is_employee
\gset
\if :is_customer
    SELECT * FROM customer WHERE customer_id = 123;
\elif :is_employee
    \echo 'is not a customer but is an employee'
    SELECT * FROM employee WHERE employee_id = 456;
\else
    \if yes
        \echo 'not a customer or employee'
    \else
        \echo 'this will never print'
    \endif
\endif

The \ir command is similar to \i, but resolves relative file names differently. When executing in interactive mode, the two commands behave identically. However, when invoked from a script, \ir interprets file names relative to the directory in which the script is located, rather than the current working directory.

List the databases in the server and show their names, owners, character set encodings, and access privileges. If pattern is specified, only databases whose names match the pattern are listed. If x is appended to the command name, the results are displayed in expanded mode. If + is appended to the command name, database sizes, default tablespaces, and descriptions are also displayed. (Size information is only available for databases that the current user can connect to.)

Lee el objeto grande con OID loid de la base de datos y lo escribe en filename. Ten en cuenta que esto es sutilmente diferente de la función del servidor lo_export, que actúa con los permisos del usuario con el que se ejecuta el servidor de la base de datos y en el sistema de archivos del servidor.

Almacena el archivo en un objeto grande (large object) de PostgreSQL. Opcionalmente, asocia el comentario proporcionado con el objeto. Ejemplo:

foo=> \lo_import '/home/peter/pictures/photo.xcf' 'a picture of me'
lo_import 152801

La respuesta indica que el objeto grande recibió el ID de objeto 152801, el cual puede utilizarse para acceder al objeto grande recién creado en el futuro. Por motivos de legibilidad, se recomienda asociar siempre un comentario legible por humanos con cada objeto. Tanto los OID como los comentarios se pueden ver con el comando \lo_list.

Ten en cuenta que este comando es sutilmente diferente de la función del lado del servidor lo_import porque actúa como el usuario local en el sistema de archivos local, en lugar del usuario y el sistema de archivos del servidor.

Muestra una lista de todos los objetos grandes de PostgreSQL almacenados actualmente en la base de datos, junto con los comentarios proporcionados para ellos. Si se añade x al nombre del comando, los resultados se muestran en modo expandido. Si se añade + al nombre del comando, cada objeto grande se lista con sus permisos asociados, si los hubiera.

Elimina el objeto grande con el OID loid de la base de datos.

Organiza guardar los resultados de consultas futuras en el archivo filename o redirigir los resultados futuros al comando de shell command. Si no se especifica ningún argumento, la salida de la consulta se restablece a la salida estándar.

Si el argumento comienza con |, entonces todo el resto de la línea se toma como el command a ejecutar, y no se realiza en él ni la interpolación de variables ni la expansión de comillas invertidas. El resto de la línea simplemente se pasa literalmente al shell.

Los “resultados de la consulta” incluyen todas las tablas, respuestas de comandos y notificaciones obtenidas del servidor de la base de datos, así como la salida de varios comandos de barra invertida que realizan consultas en la base de datos (como \d); pero no los mensajes de error.

Imprime el búfer de consulta actual en la salida estándar. Si el búfer de consulta actual está vacío, se imprime la consulta ejecutada más recientemente.

Crea una sentencia preparada a partir del búfer de consulta actual, basándose en el nombre de un objeto de sentencia preparada de destino. Una cadena vacía denota la sentencia preparada sin nombre.

Ejemplo:

SELECT $1 \parse stmt1

Este comando hace que se utilice el protocolo de consulta extendida, a diferencia del funcionamiento normal de psql, que utiliza el protocolo de consulta simple. Este comando emitirá un mensaje Parse (F), por lo que puede ser útil para probar el protocolo de consulta extendida desde psql. Este comando afecta solo a la siguiente consulta ejecutada; todas las consultas posteriores utilizarán el protocolo de consulta simple por defecto.

Cambia la contraseña del usuario especificado (por defecto, el usuario actual). Este comando solicita la nueva contraseña, la cifra y la envía al servidor como un comando ALTER ROLE. Esto asegura que la nueva contraseña no aparezca en texto claro en el historial de comandos, en el registro del servidor ni en ningún otro lugar.

Solicita al usuario que proporcione texto, que se asigna a la variable name. Se puede especificar una cadena de solicitud opcional, text. (Para solicitudes de varias palabras, encierra el texto entre comillas simples).

Por defecto, \prompt utiliza la terminal para la entrada y la salida. Sin embargo, si se utilizó el interruptor de línea de comandos -f, \prompt utiliza la entrada y la salida estándar.

Este comando establece opciones que afectan a la salida de las tablas de resultados de las consultas. option indica qué opción se va a establecer. La semántica de value varía según la opción seleccionada. Para algunas opciones, omitir value hace que la opción se alterne (toggle) o se elimine (unset), tal y como se describe en la opción en particular. Si no se menciona tal comportamiento, entonces omitir value simplemente hace que se muestre la configuración actual.

\pset sin ningún argumento muestra el estado actual de todas las opciones de impresión.

Las opciones de impresión ajustables son:

Se pueden ver ilustraciones de cómo lucen estos diferentes formatos en Examples, más adelante.

Sale del programa psql. En un archivo de script, solo se finaliza la ejecución de ese script.

Este comando es idéntico a \echo, excepto que la salida se escribirá en el canal de salida de consultas, tal y como se establece mediante \o.

Restablece (borra) el búfer de consulta.

Entra en modo "restringido" con la clave proporcionada. En este modo, el único metacomando permitido es \unrestrict, para salir del modo restringido. La clave solo puede contener caracteres alfanuméricos.

Este comando está destinado principalmente a su uso en volcados (dumps) de texto plano generados por pg_dump, pg_dumpall y pg_restore, pero puede ser útil en otros casos.

Imprime el historial de la línea de comandos de psql en filename. Si se omite filename, el historial se escribe en la salida estándar (utilizando el paginador si es apropiado). Este comando no está disponible si psql se compiló sin soporte para Readline.

Establece la variable de psql name a value, o si se proporciona más de un valor, a la concatenación de todos ellos. Si solo se proporciona un argumento, la variable se establece a un valor de cadena vacía. Para eliminar una variable, usa el comando \unset.

\set sin argumentos muestra los nombres y valores de todas las variables de psql actualmente establecidas.

Los nombres de variables válidos pueden contener letras, dígitos y guiones bajos. Consulta Variables más adelante para obtener detalles. Los nombres de variables distinguen entre mayúsculas y minúsculas.

Ciertas variables son especiales, ya que controlan el comportamiento de psql o se establecen de forma automática para reflejar el estado de la conexión. Estas variables están documentadas en Variables, más adelante.

Establece la variable de entorno name a value, o si no se proporciona el value, elimina la variable de entorno. Ejemplo:

testdb=> \setenv PAGER less
testdb=> \setenv LESS -imx4F

This command fetches and shows the definition of the named function or procedure, in the form of a CREATE OR REPLACE FUNCTION or CREATE OR REPLACE PROCEDURE command. The definition is printed to the current query output channel, as set by \o.

The target function can be specified by name alone, or by name and arguments, for example foo(integer, text). The argument types must be given if there is more than one function of the same name.

If + is appended to the command name, then the output lines are numbered, with the first line of the function body being line 1.

Unlike most other meta-commands, the entire remainder of the line is always taken to be the argument(s) of \sf, and neither variable interpolation nor backquote expansion are performed in the arguments.

This command fetches and shows the definition of the named view, in the form of a CREATE OR REPLACE VIEW command. The definition is printed to the current query output channel, as set by \o.

If + is appended to the command name, then the output lines are numbered from 1.

Unlike most other meta-commands, the entire remainder of the line is always taken to be the argument(s) of \sv, and neither variable interpolation nor backquote expansion are performed in the arguments.

This group of commands implements pipelining of SQL statements. A pipeline must begin with a \startpipeline and end with an \endpipeline. In between there may be any number of \syncpipeline commands, which sends a sync message without ending the ongoing pipeline and flushing the send buffer. In pipeline mode, statements are sent to the server without waiting for the results of previous statements. See Section 32.5 for more details.

All queries executed while a pipeline is ongoing use the extended query protocol. Queries are appended to the pipeline when ending with a semicolon. The meta-commands \bind, \bind_named, \close_prepared or \parse can be used in an ongoing pipeline. While a pipeline is ongoing, \sendpipeline will append the current query buffer to the pipeline. Other meta-commands like \g, \gx or \gdesc are not allowed in pipeline mode.

\flushrequest appends a flush command to the pipeline, allowing to read results with \getresults without issuing a sync or ending the pipeline. \getresults will automatically push unsent data to the server. \flush can be used to manually push unsent data.

\getresults accepts an optional number_results parameter. If provided, only the first number_results pending results will be read. If not provided or 0, all pending results are read.

When pipeline mode is active, a dedicated prompt variable is available to report the pipeline status. See %P for more details

COPY is not supported while in pipeline mode.

Example:

\startpipeline
SELECT * FROM pg_class;
SELECT 1 \bind \sendpipeline
\flushrequest
\getresults
\endpipeline

Alterna la visualización de los encabezados de nombre de columna de salida y del pie de página del recuento de filas. Este comando es equivalente a \pset tuples_only y se proporciona por conveniencia.

Especifica los atributos que se colocarán dentro de la etiqueta table en el formato de salida HTML. Este comando es equivalente a \pset tableattr table_options.

Con un parámetro, activa o desactiva la visualización de cuánto tiempo tarda cada sentencia SQL. Sin un parámetro, alterna la visualización entre activado y desactivado. La visualización se realiza en milisegundos; los intervalos superiores a 1 segundo también se muestran en formato minutos:segundos, añadiéndose campos de horas y días si es necesario.

Sale del modo «restringido» (es decir, donde todos los demás metacomandos están bloqueados), siempre que la clave especificada coincida con la proporcionada a \restrict cuando se ingresó al modo restringido.

Este comando está destinado principalmente a su uso en volcados de texto plano generados por pg_dump, pg_dumpall y pg_restore, pero puede ser útil en otros lugares.

Elimina (borra) la variable de psql name.

La mayoría de las variables que controlan el comportamiento de psql no se pueden eliminar; en su lugar, un comando \unset se interpreta como el restablecimiento de sus valores por defecto. Consulta Variables más abajo.

Escribe el búfer de consulta actual en el archivo filename o lo envía mediante una tubería al comando del intérprete de comandos command. Si el búfer de consulta actual está vacío, se escribe en su lugar la consulta ejecutada más recientemente.

Si el argumento comienza con |, entonces todo el resto de la línea se toma como el command a ejecutar, y no se realiza interpolación de variables ni expansión de comillas invertidas en él. El resto de la línea simplemente se pasa literalmente al intérprete de comandos.

Este comando es idéntico a \echo excepto que la salida se escribirá en el canal de error estándar de psql, en lugar de en la salida estándar.

Ejecuta repetidamente el búfer de consulta actual (como lo hace \g) hasta que se interrumpa, o la consulta falle, o se alcance el límite de recuento de ejecuciones (si se proporciona), o la consulta ya no devuelva el número mínimo de filas. Espera el número especificado de segundos (por defecto 2) entre ejecuciones. El tiempo de espera por defecto se puede cambiar con la variable WATCH_INTERVAL. Para compatibilidad con versiones anteriores, seconds se puede especificar con o sin el prefijo interval=. Cada resultado de consulta se muestra con un encabezado que incluye la cadena de texto de \pset title (si la hay), la hora de inicio de la consulta y el intervalo de retraso.

Si el búfer de consulta actual está vacío, se vuelve a ejecutar la consulta enviada más recientemente.

Establece o alterna el modo de formato de tabla expandido. Como tal, es equivalente a \pset expanded.

Muestra una lista de tablas, vistas y secuencias con sus privilegios de acceso asociados. Si se especifica un pattern, solo se muestran las tablas, vistas y secuencias cuyos nombres coincidan con el patrón. Por defecto, solo se muestran los objetos creados por el usuario; proporciona un patrón o el modificador S para incluir objetos del sistema. Si se añade x al nombre del comando, los resultados se muestran en modo expandido.

Este es un alias para \dp (“display privileges”).

Sin argumentos, escapa a un sub-intérprete de comandos; psql se reanuda cuando el sub-intérprete de comandos finaliza. Con un argumento, ejecuta el comando del intérprete de comandos command.

A diferencia de la mayoría de los otros metacomandos, el resto de la línea siempre se toma como argumento(s) de \!, y no se realiza interpolación de variables ni expansión de comillas invertidas en los argumentos. El resto de la línea simplemente se pasa literalmente al intérprete de comandos.

Muestra información de ayuda. El parámetro opcional topic (por defecto commands) selecciona qué parte de psql se explica: commands describe los comandos de barra invertida de psql; options describe las opciones de línea de comandos que se pueden pasar a psql; y variables muestra ayuda sobre las variables de configuración de psql.

La barra invertida seguida de un punto y coma no es un metacomando en el mismo sentido que los comandos anteriores; más bien, simplemente hace que se añada un punto y coma al búfer de consulta sin ningún procesamiento adicional.

Normalmente, psql enviará un comando SQL al servidor tan pronto como llegue al punto y coma que finaliza el comando, incluso si queda más entrada en la línea actual. Así, por ejemplo, ingresar

select 1; select 2; select 3;

dará como resultado que los tres comandos SQL se envíen individualmente al servidor, mostrándose los resultados de cada uno antes de continuar con el siguiente comando. Sin embargo, un punto y coma ingresado como \; no activará el procesamiento de comandos, por lo que el comando anterior y el posterior se combinan efectivamente y se envían al servidor en una sola solicitud. Por ejemplo,

select 1\; select 2\; select 3;

da como resultado el envío de los tres comandos SQL al servidor en una sola solicitud, cuando se alcanza el punto y coma sin barra invertida. El servidor ejecuta dicha solicitud como una sola transacción, a menos que haya comandos BEGIN/COMMIT explícitos incluidos en la cadena de texto para dividirla en múltiples transacciones. (Consulta Section 54.2.2.1 para obtener más detalles sobre cómo maneja el servidor las cadenas de texto con múltiples consultas).