psql - Online en la nube

PROGRAMA:

NOMBRE

psql - Terminal interactivo de PostgreSQL

SINOPSIS

psql [opción...] [nombre de la base de datos [nombre de usuario]]

DESCRIPCIÓN

psql es un front-end basado en terminales para PostgreSQL. Te permite escribir consultas
de forma interactiva, envíelos a PostgreSQL y vea los resultados de la consulta. Alternativamente, ingrese
puede ser de un archivo. Además, proporciona una serie de metacomandos y varios
Funciones similares a shell para facilitar la escritura de scripts y la automatización de una amplia variedad de tareas.

CAMPUS

-a
- eco-todo
Imprima todas las líneas de entrada que no estén vacías en la salida estándar a medida que se leen. (Esto no lo hace
aplicar a las líneas leídas de forma interactiva.) Esto es equivalente a establecer la variable ECHO a
todas.

-A
--no alinear
Cambia al modo de salida no alineado. (El modo de salida predeterminado está alineado de otra manera).

-b
--echo-errores
Imprima los comandos SQL fallidos en la salida de error estándar. Esto es equivalente a configurar el
variable ECHO a errores.

-c comando
--comando =comando
Especifica que psql ejecutará una cadena de comando, comandoy luego salir. Esto es
útil en scripts de shell. Archivos de inicio (psqlrc y ~ / .psqlrc) se ignoran con esto
.

comando debe ser una cadena de comando que sea completamente analizable por el servidor
(es decir, no contiene funciones específicas de psql) o un solo comando de barra invertida. Así tu
no se pueden mezclar meta-comandos SQL y psql con esta opción. Para lograr eso, podrías
canalice la cadena a psql, por ejemplo: echo '\ x \\ SELECT * FROM foo;' | psql. (\\ es
el metacomando del separador).

Si la cadena de comandos contiene varios comandos SQL, se procesan en un solo
transacción, a menos que existan explícitas EMPEZAR/COMETER comandos incluidos en la cadena para
dividirlo en múltiples transacciones. Esto es diferente del comportamiento cuando el
La misma cadena se alimenta a la entrada estándar de psql. Además, solo el resultado del último SQL
se devuelve el comando.

Debido a estos comportamientos heredados, poner más de un comando en el -c cadena
a menudo tiene resultados inesperados. Es mejor alimentar varios comandos al estándar de psql
entrada, ya sea usando echo como se ilustra arriba, o mediante un documento de shell aquí, para
ejemplo:

psql <
\x
SELECCIONAR * DE foo;
EOF

-d nombre de la base de datos
--dbname =nombre de la base de datos
Especifica el nombre de la base de datos a la que conectarse. Esto es equivalente a especificar
nombre de la base de datos como el primer argumento sin opción en la línea de comando.

Si este parámetro contiene un signo = o comienza con un prefijo URI válido (postgresql: //
o postgres: //), se trata como un conninfo cuerda. Consulte la Sección 31.1.1, “Conexión
Strings ”, en la documentación para obtener más información.

-e
- eco-consultas
Copie también todos los comandos SQL enviados al servidor en la salida estándar. Esto es
equivalente a configurar la variable ECHO a consultas.

-E
- eco-oculto
Haga eco de las consultas reales generadas por \d y otros comandos de barra invertida. Puedes usar esto
para estudiar las operaciones internas de psql. Esto es equivalente a configurar la variable
ECHO_OCULTO a en

-f nombre de archivo
--file =nombre de archivo
Usa el archivo nombre de archivo como fuente de comandos en lugar de leer comandos
interactivamente. Una vez que se procesa el archivo, psql termina. Esto es de muchas maneras
equivalente al meta-comando \i.

If nombre de archivo es - (guión), luego se lee la entrada estándar hasta que una indicación EOF o \q
meta-comando. Sin embargo, tenga en cuenta que Readline no se utiliza en este caso (como si -n had
ha sido especificado).

Usar esta opción es sutilmente diferente a escribir psql nombre de archivo. En general, ambos
hará lo que espera, pero el uso de -f habilita algunas características agradables como error
mensajes con números de línea. También existe una pequeña posibilidad de que el uso de esta opción
reducir los gastos generales de puesta en marcha. Por otro lado, la variante que usa la entrada del shell
La redirección está (en teoría) garantizada para producir exactamente el mismo resultado que tendría
recibido si hubiera ingresado todo a mano.

-F separador
--field-separator =separador
Usa separador como separador de campo para salida no alineada. Esto es equivalente a \ pset
camposep or \f.

-h hostname
--host =hostname
Especifica el nombre de host de la máquina en la que se ejecuta el servidor. Si el valor
comienza con una barra, se utiliza como directorio para el socket de dominio Unix.

-H
--html
Active la salida tabular HTML. Esto es equivalente al formato \ pset html o al \H
mando.

-l
--lista
Enumere todas las bases de datos disponibles, luego salga. Se ignoran otras opciones sin conexión.
Esto es similar al metacomando \lista.

-L nombre de archivo
--log-file =nombre de archivo
Escribe toda la salida de la consulta en un archivo nombre de archivo, además de la salida normal
destino.

-n
--sin línea de lectura
No use Readline para editar líneas y no use el historial de comandos. Esto puede ser
útil para desactivar la expansión de pestañas al cortar y pegar.

-o nombre de archivo
--salida =nombre de archivo
Ponga toda la salida de la consulta en el archivo nombre de archivo. Esto es equivalente al comando \o.

-p Puerto
--port =Puerto
Especifica el puerto TCP o la extensión del archivo de socket de dominio Unix local en el que
el servidor está escuchando conexiones. Por defecto, el valor de la PUERTOPG entorno
variable o, si no se establece, al puerto especificado en tiempo de compilación, generalmente 5432.

-P asignación
--pset =asignación
Especifica las opciones de impresión, al estilo de \ pset. Tenga en cuenta que aquí tiene que separar
nombre y valor con un signo igual en lugar de un espacio. Por ejemplo, para configurar la salida
formato a LaTeX, puede escribir -P formato = látex.

-q
--tranquilo
Especifica que psql debe hacer su trabajo en silencio. Por defecto, imprime mensajes de bienvenida.
y varios resultados informativos. Si se utiliza esta opción, nada de esto sucede. Esta
es útil con el -c opción. Esto es equivalente a configurar la variable TRANQUILO a en

-R separador
--record-separator =separador
Usa separador como separador de registros para salida no alineada. Esto es equivalente al
\ pset registrosep mando.

-s
--un solo paso
Ejecutar en modo de un solo paso. Eso significa que se le solicita al usuario antes de enviar cada comando.
al servidor, con la opción de cancelar la ejecución también. Use esto para depurar scripts.

-S
--linea sola
Se ejecuta en modo de una sola línea donde una nueva línea termina un comando SQL, como punto y coma
hace.

Note
Este modo se proporciona para aquellos que insisten en él, pero no necesariamente
Animado a usarlo. En particular, si mezcla SQL y metacomandos en una línea
el orden de ejecución puede no ser siempre claro para el usuario inexperto.

-t
--tuplas solo
Desactive la impresión de los nombres de las columnas y los pies de página del recuento de filas de resultados, etc.
equivalente a la \t mando.

-T opciones_tabla
--table-attr =opciones_tabla
Especifica las opciones que se colocarán dentro de la etiqueta de la tabla HTML. Ver \ pset para obtener más detalles.

-U nombre de usuario
--username =nombre de usuario
Conéctese a la base de datos como usuario nombre de usuario en lugar del predeterminado. (Debes tener
permiso para hacerlo, por supuesto.)

-v asignación
--set =asignación
--variable =asignación
Realice una asignación de variable, como la \colocar meta-comando. Tenga en cuenta que debe separar
nombre y valor, si lo hay, con un signo igual en la línea de comando. Para desarmar una variable,
deje el signo igual. Para establecer una variable con un valor vacío, use el signo igual
pero deje el valor. Estas asignaciones se realizan durante una etapa muy temprana de
puesta en marcha, por lo que las variables reservadas para fines internos pueden sobrescribirse más adelante.

-V
--versión
Imprima la versión psql y salga.

-w
--Sin contraseña
Nunca emita una solicitud de contraseña. Si el servidor requiere autenticación de contraseña y una
La contraseña no está disponible por otros medios, como un archivo .pgpass, la conexión
el intento fallará. Esta opción puede ser útil en trabajos por lotes y scripts donde ningún usuario
está presente para ingresar una contraseña.

Tenga en cuenta que esta opción permanecerá configurada durante toda la sesión y, por lo tanto, afectará a los usos.
del meta-comando \conectar así como el intento de conexión inicial.

-W
--contraseña
Obligar a psql a solicitar una contraseña antes de conectarse a una base de datos.

Esta opción nunca es esencial, ya que psql solicitará automáticamente una contraseña si
el servidor exige autenticación de contraseña. Sin embargo, psql desperdiciará una conexión
intente averiguar que el servidor quiere una contraseña. En algunos casos vale la pena escribir
-W para evitar el intento de conexión adicional.

Tenga en cuenta que esta opción permanecerá configurada durante toda la sesión y, por lo tanto, afectará a los usos.
del meta-comando \conectar así como el intento de conexión inicial.

-x
--expandido
Active el modo de formato de tabla expandido. Esto es equivalente al \x mando.

-X,
--no-psqlrc
No lea el archivo de inicio (ni el archivo psqlrc de todo el sistema ni el
~ / .psqlrc de archivo).

-z
--campo-separador-cero
Establezca el separador de campo para la salida no alineada en un byte cero.

-0
--registro-separador-cero
Establezca el separador de registros para la salida no alineada en un byte cero. Esto es útil para
interactuando, por ejemplo, con xargs -0.

-1
- transacción única
Cuando psql ejecuta un script, agregar esta opción envuelve EMPEZAR/COMETER alrededor del guion
para ejecutarlo como una sola transacción. Esto asegura que todos los comandos
completar correctamente o no se aplica ningún cambio.

Si el propio script usa EMPEZAR, COMETERo RETROCEDER, esta opción no tendrá la
efectos deseados. Además, si el script contiene algún comando que no se puede ejecutar
dentro de un bloque de transacciones, especificar esta opción hará que el comando (y por lo tanto
toda la transacción) para fallar.

-?
--ayuda [=tema]
Mostrar ayuda sobre psql y salir. El opcional tema parámetro (por defecto a opciones)
selecciona qué parte de psql se explica: los comandos describen los comandos de barra invertida de psql;
options describe las opciones de la línea de comandos que se pueden pasar a psql; y variables
muestra ayuda sobre las variables de configuración de psql.

SALIR ESTADO

psql devuelve 0 al shell si terminó normalmente, 1 si ocurre un error fatal propio
(por ejemplo, memoria insuficiente, archivo no encontrado), 2 si la conexión con el servidor no funciona correctamente y
la sesión no era interactiva, y 3 si ocurría un error en un script y la variable
ON_ERROR_PARAR se estableció.

USO

Conectándote a a Base de datos
psql es una aplicación cliente de PostgreSQL normal. Para conectarse a una base de datos,
necesita saber el nombre de su base de datos de destino, el nombre de host y el número de puerto del
servidor y con qué nombre de usuario desea conectarse. psql se puede informar sobre esos
parámetros a través de opciones de línea de comando, a saber -d, -h, -py -U respectivamente. Si una
Si se encuentra un argumento que no pertenece a ninguna opción, se interpretará como el
nombre de la base de datos (o el nombre de usuario, si ya se ha dado el nombre de la base de datos). No todos estos
se requieren opciones; hay valores predeterminados útiles. Si omite el nombre de host, psql
conéctese a través de un socket de dominio Unix a un servidor en el host local, o mediante TCP / IP a localhost
en máquinas que no tienen sockets de dominio Unix. El número de puerto predeterminado se determina en
tiempo de compilación. Dado que el servidor de la base de datos utiliza el mismo valor predeterminado, no tendrá que
especificar el puerto en la mayoría de los casos. El nombre de usuario predeterminado es el nombre de usuario de su sistema operativo,
como es el nombre de la base de datos predeterminada. Tenga en cuenta que no puede simplemente conectarse a cualquier base de datos bajo
cualquier nombre de usuario. El administrador de su base de datos debería haberle informado sobre su acceso
los derechos.

Cuando los valores predeterminados no son del todo correctos, puede ahorrarse algo de escritura configurando el
Variables de entorno BASE DE DATOS DE PG, PHOST, PUERTOPG y/o PGUSER a los valores apropiados. (Para
variables de entorno adicionales, consulte la Sección 31.14, "Variables de entorno", en la
documentación.) También es conveniente tener un ~ / .pgpass archivo para evitar tener regularmente
para escribir contraseñas. Consulte la Sección 31.15, "El archivo de contraseña", en la documentación para
más información.

Una forma alternativa de especificar los parámetros de conexión es en un conninfo cadena o un URI,
que se utiliza en lugar de un nombre de base de datos. Este mecanismo le da un control muy amplio sobre
la conexión. Por ejemplo:

$ psql "servicio = miservicio sslmode = require "
$ psql postgresql: // dbmaster: 5433 / mydb? sslmode = require

De esta forma también puede utilizar LDAP para la búsqueda de parámetros de conexión como se describe en la Sección
31.17, “Búsqueda LDAP de parámetros de conexión”, en la documentación. Consulte la Sección 31.1.2,
"Palabras clave de parámetros", en la documentación para obtener más información sobre todos los
opciones de conexión.

Si la conexión no se pudo realizar por algún motivo (por ejemplo, privilegios insuficientes, servidor
no se está ejecutando en el host de destino, etc.), psql devolverá un error y terminará.

Si tanto la entrada estándar como la salida estándar son un terminal, entonces psql configura el cliente
codificación a "auto", que detectará la codificación de cliente adecuada de la configuración regional
configuración (LC_CTYPE variable de entorno en sistemas Unix). Si esto no funciona como
esperado, la codificación del cliente se puede anular utilizando la variable de entorno
PGCLIENTENCODIFICACIÓN.

Entrando SQL Comandos
En funcionamiento normal, psql proporciona un mensaje con el nombre de la base de datos a la que psql está
conectado actualmente, seguido de la cadena =>. Por ejemplo:

$ psql pruebadb
psql (9.5.2)
Escriba "ayuda" para obtener ayuda.

testdb =>

En el indicador, el usuario puede escribir comandos SQL. Normalmente, las líneas de entrada se envían al
servidor cuando se alcanza un punto y coma de terminación de comando. Un final de línea no termina
un comando. Por lo tanto, los comandos se pueden distribuir en varias líneas para mayor claridad. Si el comando fue
enviado y ejecutado sin error, los resultados del comando se muestran en la pantalla.

Siempre que se ejecuta un comando, psql también sondea los eventos de notificación asincrónica
generado por ESCUCHA(7) y NOTIFICAR(7).

Mientras que los comentarios de bloque de estilo C se pasan al servidor para su procesamiento y eliminación,
Los comentarios estándar de SQL son eliminados por psql.

Metacomandos
Todo lo que ingrese en psql que comience con una barra invertida sin comillas es un metacomando psql
que es procesado por el propio psql. Estos comandos hacen que psql sea más útil para la administración.
o secuencias de comandos. Los metacomandos a menudo se denominan comandos de barra inclinada o barra invertida.

El formato de un comando psql es la barra invertida, seguida inmediatamente por un verbo de comando,
luego cualquier argumento. Los argumentos están separados del verbo comando y entre sí por
cualquier número de caracteres de espacio en blanco.

Para incluir espacios en blanco en un argumento, puede citarlo con comillas simples. Para incluir un
comillas simples en un argumento, escriba dos comillas simples dentro del texto entre comillas simples. Cualquier cosa
contenida entre comillas simples está además sujeta a sustituciones de tipo C para \ n (nuevo
línea), \ t (tabulador), \ b (retroceso), \ r (retorno de carro), \ f (avance de formulario), \dígitos (octales),
y \ xdígitos (hexadecimal). Una barra invertida que precede a cualquier otro carácter entre comillas simples
el texto cita ese único carácter, sea lo que sea.

Dentro de un argumento, el texto que está entre comillas inversas (`) se toma como una línea de comando
que se pasa al shell. La salida del comando (con cualquier nueva línea final eliminada)
reemplaza el texto entrecomillado.

Si aparecen dos puntos sin comillas (:) seguidos de un nombre de variable psql dentro de un argumento,
se reemplaza por el valor de la variable, como se describe en Interpolación SQL.

Algunos comandos toman un identificador SQL (como el nombre de una tabla) como argumento. Estos argumentos
siga las reglas de sintaxis de SQL: las letras sin comillas se obligan a minúsculas, mientras que el doble
las comillas (") protegen las letras de la conversión de mayúsculas y minúsculas y permiten la incorporación de espacios en blanco en
el identificador. Dentro de las comillas dobles, las comillas dobles emparejadas se reducen a una sola comilla doble
en el nombre resultante. Por ejemplo, FOO "BAR" BAZ se interpreta como fooBARbaz y "A
"" nombre "extraño se convierte en un" nombre "extraño.

El análisis de argumentos se detiene al final de la línea o cuando aparece otra barra invertida sin comillas.
fundar. Una barra invertida sin comillas se toma como el comienzo de un nuevo metacomando. El especial
secuencia \\ (dos barras invertidas) marca el final de los argumentos y continúa analizando SQL
comandos, si los hay. De esa forma, los comandos SQL y psql se pueden mezclar libremente en una línea. Pero en cualquier
En este caso, los argumentos de un metacomando no pueden continuar más allá del final de la línea.

Se definen los siguientes metacomandos:

\a
Si el formato de salida de la tabla actual no está alineado, se cambia a alineado. Si esto es
no sin alinear, se establece en sin alinear. Este comando se mantiene al revés
compatibilidad. Ver \ pset para una solución más general.

\ c o \ connect [ nombre de la base de datos [ nombre de usuario ] [ fortaleza ] [ Puerto ]] | conninfo
Establece una nueva conexión a un servidor PostgreSQL. Los parámetros de conexión a utilizar
se puede especificar usando una sintaxis posicional o usando la conexión conninfo
cadenas como se detalla en la Sección 31.1.1, “Cadenas de conexión”, en la documentación.

Cuando se utilizan parámetros posicionales, si alguno de nombre de la base de datos, nombre de usuario, fortaleza or Puerto se omiten
o especificado como -, se utiliza el valor de ese parámetro de la conexión anterior;
si no hay una conexión previa, el valor predeterminado de libpq para el valor del parámetro es
usado. Cuando se utilizan cadenas de conninfo, no se utilizan valores de la conexión anterior para
la nueva conexión.

Si la nueva conexión se realiza correctamente, la conexión anterior se cierra. Si el
intento de conexión fallido (nombre de usuario incorrecto, acceso denegado, etc.), el anterior
La conexión solo se mantendrá si psql está en modo interactivo. Al ejecutar un
script no interactivo, el procesamiento se detendrá inmediatamente con un error. Esta
La distinción se eligió como una conveniencia para el usuario contra los errores tipográficos, por un lado, y una
mecanismo de seguridad de que los scripts no actúan accidentalmente en la base de datos incorrecta en el
otra mano.

Ejemplos:

=> \ c mydb myuser host.dom 6432
=> \ c servicio = foo
=> \ c "host = puerto localhost = 5432 dbname = mydb connect_timeout = 10 sslmode = deshabilitar"
=> \ c postgresql: // tom @ localhost / mydb? nombre_aplicación = myapp

\C [ título ]
Establece el título de las tablas que se imprimen como resultado de una consulta o desarma cualquiera
título. Este comando es equivalente a \ pset title título. (El nombre de este comando
deriva de "título", ya que anteriormente solo se usaba para establecer el título en un HTML
mesa.)

\CD [ directorio ]
Cambia el directorio de trabajo actual a directorio. Sin argumento, cambios en el
directorio de inicio del usuario actual.

Consejo
Para imprimir su directorio de trabajo actual, use \! pwd.

\ conninfo
Muestra información sobre la conexión actual a la base de datos.

\Copiar { mesa [( column_list )] | ( pregunta )} {de | a } { 'nombre del archivo' | programa
'mando' | stdin | stdout | pstdin | pstdout} [[con] ( opción [, ...])]
Realiza una copia de frontend (cliente). Esta es una operación que ejecuta un SQL COPIA(7)
comando, pero en lugar de que el servidor lea o escriba el archivo especificado, psql lee
o escribe el archivo y enruta los datos entre el servidor y el sistema de archivos local.
Esto significa que la accesibilidad y los privilegios de los archivos son los del usuario local, no los
servidor, y no se requieren privilegios de superusuario SQL.

Cuando se especifica el programa, comando es ejecutado por psql y los datos pasados ​​desde o hacia
comando se enruta entre el servidor y el cliente. Nuevamente, los privilegios de ejecución
son los del usuario local, no del servidor, y no se otorgan privilegios de superusuario SQL
requerida.

Para \ copy ... from stdin, las filas de datos se leen desde la misma fuente que emitió el
comando, continuando hasta \. se lee o la secuencia alcanza EOF. Esta opcion es util
para completar tablas en línea dentro de un archivo de secuencia de comandos SQL. Para \ copiar ... a la salida estándar,
la salida se envía al mismo lugar que la salida del comando psql, y la copia contar comando
el estado no se imprime (ya que podría confundirse con una fila de datos). Leer / escribir
entrada o salida estándar de psql independientemente de la fuente de comando actual u opción \ o,
escribir desde pstdin o pstdout.

La sintaxis de este comando es similar a la del SQL COPIA(7) comando. Todas las opciones
que no sean el origen / destino de los datos son los especificados para COPIA(7). Debido a esto,
Se aplican reglas especiales de análisis a la \Copiar mando. En particular, la variable de psql
las reglas de sustitución y los escapes de barra invertida no se aplican.

Consejo
Esta operación no es tan eficiente como SQL COPIA comando porque todos los datos deben
pasar a través de la conexión cliente / servidor. Para grandes cantidades de datos, el SQL
el comando podría ser preferible.

\derechos de autor
Muestra los términos de derechos de autor y distribución de PostgreSQL.

\ d [S +] [ patrón ]
Para cada relación (tabla, vista, índice, secuencia o tabla externa) o tipo compuesto
coincidiendo con el patrón, mostrar todas las columnas, sus tipos, el espacio de tabla (si no el
default) y cualquier atributo especial como NOT NULL o defaults. Índices asociados,
También se muestran restricciones, reglas y disparadores. Para tablas extranjeras, el asociado
También se muestra el servidor externo. ("Hacer coincidir el patrón" se define en Patrones
abajo.)

Para algunos tipos de relación, \ d muestra información adicional para cada columna: columna
valores para secuencias, expresión indexada para índices y opciones de envoltura de datos externos
para mesas extranjeras.

La forma de comando \ d + es idéntica, excepto que se muestra más información: any
Se muestran los comentarios asociados con las columnas de la tabla, así como la presencia de
OID en la tabla, la definición de vista si la relación es una vista, un valor no predeterminado
configuración de identidad de réplica.

De forma predeterminada, solo se muestran los objetos creados por el usuario; proporcionar un patrón o el modificador S para
incluir objetos del sistema.

Note
If \d se usa sin un patrón argumento, es equivalente a \ dtvsE que lo hará
muestra una lista de todas las tablas, vistas, secuencias y tablas externas visibles. Esto es
puramente una medida de conveniencia.

\ da [S] [ patrón ]
Enumera las funciones agregadas, junto con su tipo de retorno y los tipos de datos que
operar en. Si patrón se especifica, solo los agregados cuyos nombres coinciden con el patrón son
mostrado. De forma predeterminada, solo se muestran los objetos creados por el usuario; suministrar un patrón o la S
modificador para incluir objetos del sistema.

\ db [+] [ patrón ]
Muestra los espacios de tabla. Si patrón se especifica, solo los espacios de tabla cuyos nombres coinciden
se muestran el patrón. Si se agrega + al nombre del comando, cada espacio de tabla se enumera
con sus opciones asociadas, tamaño en disco, permisos y descripción.

\ dc [S +] [ patrón ]
Muestra las conversiones entre codificaciones de juegos de caracteres. Si patrón se especifica, solo
se enumeran las conversiones cuyos nombres coinciden con el patrón. De forma predeterminada, solo creadas por el usuario
se muestran los objetos; proporcione un patrón o el modificador S para incluir objetos del sistema. Si +
se agrega al nombre del comando, cada objeto se enumera con su asociado
descripción.

\ dC [+] [ patrón ]
Enumera los tipos de moldes. Si patrón se especifica, solo los elencos cuyos tipos de origen o destino
coinciden con el patrón se enumeran. Si se agrega + al nombre del comando, cada objeto es
enumerados con su descripción asociada.

\ dd [S] [ patrón ]
Muestra las descripciones de objetos de restricción de tipo, clase de operador, familia de operador,
regla y disparador. Todos los demás comentarios se pueden ver con la barra invertida respectiva.
comandos para esos tipos de objetos.

\ dd muestra descripciones de los objetos que coinciden patrón, o de objetos visibles de
el tipo apropiado si no se da ningún argumento. Pero en cualquier caso, solo los objetos que
tienen una descripción. De forma predeterminada, solo se muestran los objetos creados por el usuario; suministro
un patrón o el modificador S para incluir objetos del sistema.

Las descripciones de los objetos se pueden crear con el COMENTARIO(7) Comando SQL.

\ ddp [ patrón ]
Enumera la configuración de privilegios de acceso predeterminada. Se muestra una entrada para cada rol (y esquema,
si corresponde) para los cuales la configuración de privilegios predeterminada se ha cambiado de la
valores predeterminados incorporados. Si patrón se especifica, solo las entradas cuyo nombre de rol o esquema
el nombre coincide con el patrón.

Los PRIVILEGIOS ALTER DEFAULT (ALTER_DEFAULT_PRIVILEGES(7)) el comando se usa para configurar
privilegios de acceso predeterminados. El significado de la pantalla de privilegios se explica en
GRANT(7).

\ dD [S +] [ patrón ]
Enumera los dominios. Si patrón se especifica, solo los dominios cuyos nombres coinciden con el patrón son
mostrado. De forma predeterminada, solo se muestran los objetos creados por el usuario; suministrar un patrón o la S
modificador para incluir objetos del sistema. Si se agrega + al nombre del comando, cada objeto
aparece con sus permisos asociados y descripción.

\ dE [S +] [ patrón ]
\ di [S +] [ patrón ]
\ dm [S +] [ patrón ]
\ ds [S +] [ patrón ]
\ dt [S +] [ patrón ]
\ dv [S +] [ patrón ]
En este grupo de comandos, las letras E, i, m, s, t y v significan tabla extranjera,
índice, vista materializada, secuencia, tabla y vista, respectivamente. Puede especificar cualquier
o todas estas cartas, en cualquier orden, para obtener una lista de objetos de este tipo.
Por ejemplo, \ dit enumera índices y tablas. Si se agrega + al nombre del comando, cada
El objeto se enumera con su tamaño físico en el disco y su descripción asociada, si
alguna. Si patrón se especifica, solo se enumeran los objetos cuyos nombres coinciden con el patrón.
De forma predeterminada, solo se muestran los objetos creados por el usuario; proporcionar un patrón o el modificador S para
incluir objetos del sistema.

\ des [+] [ patrón ]
Enumera los servidores externos (mnemotécnico: "servidores externos"). Si patrón se especifica, solo
se enumeran aquellos servidores cuyo nombre coincide con el patrón. Si se usa la forma \ des +, un
Se muestra una descripción completa de cada servidor, incluida la ACL del servidor, el tipo, la versión,
opciones y descripción.

\ det [+] [ patrón ]
Enumera tablas extranjeras (mnemónico: "tablas externas"). Si patrón se especifica, solo
Se enumeran las entradas cuyo nombre de tabla o nombre de esquema coincide con el patrón. Si la forma
Se usa \ det +, las opciones genéricas y la descripción de la tabla foránea también se muestran.

\ deu [+] [ patrón ]
Enumera las asignaciones de usuarios (mnemotécnico: "usuarios externos"). Si patrón se especifica, solo aquellos
Se enumeran las asignaciones cuyos nombres de usuario coinciden con el patrón. Si se usa la forma \ deu +,
se muestra información adicional sobre cada mapeo.

Precaución
\ deu + también puede mostrar el nombre de usuario y la contraseña del usuario remoto, así que tenga cuidado
Debe tomarse para no revelarlos.

\ rocío [+] [ patrón ]
Muestra una lista de envoltorios de datos externos (mnemotécnico: "envoltorios externos"). Si patrón está especificado,
sólo se enumeran los contenedores de datos externos cuyo nombre coincide con el patrón. Si el
form \ dew +, la ACL, las opciones y la descripción de la envoltura de datos externos son
también se muestra.

\ df [antwS +] [ patrón ]
Enumera las funciones, junto con sus argumentos, tipos de retorno y tipos de función,
que se clasifican como "agg" (agregado), "normal", "disparador" o "ventana". A
mostrar solo funciones de tipo (s) específico (s), agregue las letras correspondientes a, n, t, o
w al comando. Si patrón se especifica, solo las funciones cuyos nombres coinciden
se muestran el patrón. De forma predeterminada, solo se muestran los objetos creados por el usuario; proporcionar un patrón
o el modificador S para incluir objetos del sistema. Si se usa la forma \ df +, adicionales
se muestra información sobre cada función, incluida la clasificación de seguridad,
volatilidad, propietario, idioma, código fuente y descripción.

Consejo
Para buscar funciones que toman argumentos o devuelven valores de un tipo específico, use
la capacidad de búsqueda de su localizador para desplazarse por la salida \ df.

\ dF [+] [ patrón ]
Enumera las configuraciones de búsqueda de texto. Si patrón se especifica, solo las configuraciones cuyo
se muestran los nombres que coinciden con el patrón. Si se usa la forma \ dF +, una descripción completa de
Se muestra cada configuración, incluido el analizador de búsqueda de texto subyacente y el
lista de diccionarios para cada tipo de token de analizador.

\ dFd [+] [ patrón ]
Enumera los diccionarios de búsqueda de texto. Si patrón se especifica, solo los diccionarios cuyos nombres
coinciden con el patrón se muestran. Si se utiliza la forma \ dFd +, se proporciona información adicional
se muestra sobre cada diccionario seleccionado, incluida la plantilla de búsqueda de texto subyacente
y los valores de las opciones.

\ dFp [+] [ patrón ]
Muestra una lista de analizadores de búsqueda de texto. Si patrón se especifica, solo los analizadores cuyos nombres coinciden
se muestran el patrón. Si se usa la forma \ dFp +, se incluye una descripción completa de cada analizador
que se muestra, incluidas las funciones subyacentes y la lista de tipos de tokens reconocidos.

\ dFt [+] [ patrón ]
Muestra las plantillas de búsqueda de texto. Si patrón se especifica, solo las plantillas cuyos nombres coinciden
se muestran los patrones. Si se usa la forma \ dFt +, se muestra información adicional
sobre cada plantilla, incluidos los nombres de las funciones subyacentes.

\ dg [+] [ patrón ]
Enumera 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 \ du.) Si patrón se especifica, solo
se enumeran los roles cuyos nombres coinciden con el patrón. Si se usa la forma \ dg +,
se muestra información adicional sobre cada función; actualmente esto agrega el comentario para
cada rol.

\ dl
Este es un alias para \ lo_list, que muestra una lista de objetos grandes.

\ dL [S +] [ patrón ]
Enumera los lenguajes de procedimiento. Si patrón se especifica, solo los idiomas cuyos nombres coinciden
se enumeran los patrones. De forma predeterminada, solo se muestran los idiomas creados por el usuario; suministrar el
Modificador S para incluir objetos del sistema. Si se agrega + al nombre del comando, cada
El idioma se enumera con su controlador de llamadas, validador, privilegios de acceso y si
es un objeto del sistema.

\ dn [S +] [ patrón ]
Enumera esquemas (espacios de nombres). Si patrón se especifica, solo los esquemas cuyos nombres coinciden
se enumeran los patrones. De forma predeterminada, solo se muestran los objetos creados por el usuario; suministrar un
patrón o el modificador S para incluir objetos del sistema. Si se agrega + al comando
nombre, cada objeto se enumera con sus permisos asociados y descripción, si corresponde.

\ do [S +] [ patrón ]
Enumera los operadores con sus operandos y tipos de resultados. Si patrón se especifica, solo
se enumeran los operadores cuyos nombres coinciden con el patrón. De forma predeterminada, solo creadas por el usuario
se muestran los objetos; proporcione un patrón o el modificador S para incluir objetos del sistema. Si +
se agrega al nombre del comando, se muestra información adicional sobre cada operador,
actualmente solo el nombre de la función subyacente.

\ dO [S +] [ patrón ]
Enumera las colaciones. Si patrón se especifica, solo las intercalaciones cuyos nombres coinciden
se enumeran los patrones. De forma predeterminada, solo se muestran los objetos creados por el usuario; proporcionar un patrón
o el modificador S para incluir objetos del sistema. Si se agrega + al nombre del comando,
cada colación se enumera con su descripción asociada, si la hubiera. Tenga en cuenta que solo
Se muestran las intercalaciones utilizables con la codificación de la base de datos actual, por lo que los resultados pueden
varían en diferentes bases de datos de la misma instalación.

\ dp [ patrón ]
Enumera tablas, vistas y secuencias con sus privilegios de acceso asociados. Si patrón
se especifica, solo las tablas, vistas y secuencias cuyos nombres coinciden con el patrón son
listado.

El objetivo principal era mejorar las capacidades analíticas existentes y facilitar la generación de nuevos modelos predictivos o biomarcadores. Para ello, se buscaba vincular los datos de imágenes con la Historia Clínica Electrónica (HCE), utilizando técnicas de procesamiento del lenguaje natural (PLN) para su análisis. GRANT(7) y REVOCAR(7) los comandos se utilizan para establecer privilegios de acceso. El significado de
la pantalla de privilegios se explica en GRANT(7).

\ drds [ patrón de rol [ patrón de base de datos ]]
Enumera los ajustes de configuración definidos. Estos ajustes pueden ser específicos de la función,
específico de la base de datos, o ambos. patrón de rol e patrón de base de datos se utilizan para seleccionar
roles y bases de datos específicos para enumerar, respectivamente. Si se omite, o si se especifica *,
se enumeran todas las configuraciones, incluidas las que no son específicas de la función o de la base de datos,
respectivamente.

El papel de ALTER (ALTERAR_ROL(7)) y ALTER DATABASE (ALTER_BASE DE DATOS(7)) los comandos son
se utiliza para definir las opciones de configuración por función y por base de datos.

\ dT [S +] [ patrón ]
Enumera los tipos de datos. Si patrón se especifica, solo los tipos cuyos nombres coinciden con el patrón
están listados. Si se agrega + al nombre del comando, cada tipo se lista con su
nombre y tamaño interno, sus valores permitidos si es un tipo de enumeración, y su asociado
permisos. De forma predeterminada, solo se muestran los objetos creados por el usuario; proporcionar un patrón o el
Modificador S para incluir objetos del sistema.

\ du [+] [ patrón ]
Enumera 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.) Si patrón se especifica, solo
se enumeran los roles cuyos nombres coinciden con el patrón. Si se usa la forma \ du +,
se muestra información adicional sobre cada función; actualmente esto agrega el comentario para
cada rol.

\ dx [+] [ patrón ]
Muestra las extensiones instaladas. Si patrón se especifica, solo aquellas extensiones cuyos nombres
coinciden con el patrón se enumeran. Si se usa la forma \ dx +, todos los objetos pertenecientes a
se enumeran todas las extensiones coincidentes.

\ dy [+] [ patrón ]
Enumera los desencadenantes de eventos. Si patrón se especifica, solo aquellos activadores de eventos cuyos nombres
coinciden con el patrón se enumeran. Si se agrega + al nombre del comando, cada objeto es
enumerados con su descripción asociada.

\ e o \ edit [ nombre de archivo ] [ número de línea ]
If nombre de archivo se especifica, el archivo se edita; después de que el editor sale, su contenido es
copiado de nuevo al búfer de consulta. Si no nombre de archivo se da, el búfer de consulta actual es
copiado a un archivo temporal que luego se edita de la misma manera.

El nuevo búfer de consulta se vuelve a analizar de acuerdo con las reglas normales de psql, donde
todo el búfer se trata como una sola línea. (Por lo tanto, no puede hacer scripts de esta manera.
Usa \i para eso.) Esto significa que si la consulta termina con (o contiene) un punto y coma,
se ejecuta inmediatamente. De lo contrario, simplemente esperará en el búfer de consultas; escribe
punto y coma o \ g para enviarlo, o \ r para cancelar.

Si se especifica un número de línea, psql colocará el cursor en la línea especificada de
el búfer de archivo o consulta. Tenga en cuenta que si se proporciona un único argumento de todos los dígitos, psql
asume que es un número de línea, no un nombre de archivo.

Consejo
Consulte en MEDIO AMBIENTE para saber cómo configurar y personalizar su editor.

\eco texto [...]
Imprime los argumentos en la salida estándar, separados por un espacio y seguidos por un
nueva línea. Esto puede resultar útil para intercalar información en la salida de los scripts. Para
ejemplo:

=> \eco `fecha`
Mar 26 de octubre 21:40:57 CEST 1999

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

Consejo
Si utiliza la opcion de \o comando para redirigir la salida de su consulta que puede que desee utilizar
\ qecho en lugar de este comando.

\ ef [ función descriptiva [ número de línea ]]
Este comando obtiene y edita la definición de la función nombrada, en forma de
CREAR OR SUSTITUIR FUNCIÓN mando. La edición se realiza de la misma forma que para \ edit.
Una vez que el editor sale, el comando actualizado espera en el búfer de consultas; tipo punto y coma
o \ g para enviarlo, o \ r para cancelar.

La función de destino se puede especificar por nombre solo, o por nombre y argumentos, para
ejemplo foo (entero, texto). Los tipos de argumentos se deben dar si hay más de uno.
función del mismo nombre.

Si no se especifica ninguna función, un espacio en blanco CREAR FUNCIÓN la plantilla se presenta para
edición.

Si se especifica un número de línea, psql colocará el cursor en la línea especificada de
el cuerpo de la función. (Tenga en cuenta que el cuerpo de la función normalmente no comienza en el primer
línea del archivo.)

Consejo
Consulte en MEDIO AMBIENTE para saber cómo configurar y personalizar su editor.

\ encoding [ codificación ]
Establece la codificación del juego de caracteres del cliente. Sin un argumento, este comando muestra el
codificación actual.

\ f [ cadena ]
Establece el separador de campo para la salida de consultas no alineadas. El valor predeterminado es la barra vertical.
(|). Ver también \ pset para una forma genérica de configurar las opciones de salida.

\ g [ nombre de archivo ]
\ g [|comando ]
Envía el búfer de entrada de la consulta actual al servidor y, opcionalmente, almacena el
salida en nombre de archivo o canaliza la salida al comando de shell comando. El archivo o
El comando se escribe solo si la consulta devuelve cero o más tuplas, no
si la consulta falla o es un comando SQL que no devuelve datos.

Un \ g desnudo es esencialmente equivalente a un punto y coma. A \ g con argumento es un "one-shot"
alternativa a la \o mando.

\ gset [ prefijo ]
Envía el búfer de entrada de la consulta actual al servidor y almacena la salida de la consulta en
psql variables (ver Variables). La consulta a ejecutar debe devolver exactamente una fila.
Cada columna de la fila se almacena en una variable separada, nombrada igual que la
columna. Por ejemplo:

=> SELECCIONAR 'Hola' AS var1, 10 AS var2
-> \ gset
=> \eco : var1 : var2
hola xnumx

Si especifica un prefijo, esa cadena se antepone a los nombres de las columnas de la consulta para
cree los nombres de las variables para usar:

=> SELECCIONAR 'Hola' AS var1, 10 AS var2
-> \ gset resultado_
=> \eco : result_var1 : result_var2
hola xnumx

Si el resultado de una columna es NULL, la variable correspondiente no se establece en lugar de establecerse.

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

\ ho \ help [ comando ]
Ofrece ayuda de sintaxis sobre el comando SQL especificado. Si comando no se especifica, entonces psql
mostrará una lista de todos los comandos para los que está disponible la ayuda de sintaxis. Si comando es un
asterisco (*), luego se muestra la ayuda de sintaxis en todos los comandos SQL.

Note
Para simplificar la escritura, los comandos que constan de varias palabras no tienen que ser
cotizado. Por lo tanto, está bien escribir \ayuda alterar mesa.

\ H o \ html
Activa el formato de salida de la consulta HTML. Si el formato HTML ya está activado, se cambia
volver al formato de texto alineado predeterminado. Este comando es por compatibilidad y
conveniencia, pero mira \ pset sobre la configuración de otras opciones de salida.

\ yo o \ incluir nombre de archivo
Lee la entrada del archivo nombre de archivo y lo ejecuta como si hubiera sido escrito en el
teclado.

If nombre de archivo es - (guión), luego se lee la entrada estándar hasta que una indicación EOF o \q
meta-comando. Esto se puede utilizar para intercalar entradas interactivas con entradas de archivos.
Tenga en cuenta que el comportamiento de Readline se utilizará solo si está activo en el nivel más externo.

Note
Si desea ver las líneas en la pantalla a medida que se leen, debe configurar el
variable ECHO a todos.

\ ir o \ include_relative nombre de archivo
El comando \ ir es similar a \ i, pero resuelve los nombres de archivos relativos de manera diferente. Cuándo
ejecutándose en modo interactivo, los dos comandos se comportan de manera idéntica. Sin embargo cuando
invocado desde un script, \ ir interpreta los nombres de archivo en relación con el directorio en el que
se encuentra el script, en lugar del directorio de trabajo actual.

\ l [+] o \ list [+] [ patrón ]
Enumere las bases de datos en el servidor y muestre sus nombres, propietarios, juego de caracteres
codificaciones y privilegios de acceso. Si patrón se especifica, solo bases de datos cuyos nombres
coinciden con el patrón se enumeran. Si se agrega + al nombre del comando, los tamaños de la base de datos,
También se muestran los espacios de tabla predeterminados y las descripciones. (La información de tamaño es solo
disponible para bases de datos a las que el usuario actual puede conectarse).

\ lo_export ley nombre de archivo
Lee el objeto grande con OID ley de la base de datos y lo escribe en nombre de archivo. Nota
que esto es sutilmente diferente de la función del servidor lo_exportar, que actúa con el
permisos del usuario que ejecuta el servidor de la base de datos y en el archivo del servidor
.

Consejo
Usa \ lo_list para averiguar el OID del objeto grande.

\ lo_import nombre de archivo [ comentario ]
Almacena el archivo en un objeto grande de PostgreSQL. Opcionalmente, asocia el dado
comentar con el objeto. Ejemplo:

foo => \ lo_import '/home/peter/pictures/photo.xcf' 'a imagen of yo'
lo_importar 152801

La respuesta indica que el objeto grande recibió el ID de objeto 152801, que puede ser
utilizado para acceder al objeto grande recién creado en el futuro. Por el bien 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 \ lo_list mando.

Tenga en cuenta que este comando es sutilmente diferente del del lado del servidor lo_importar porque
actúa como el usuario local en el sistema de archivos local, en lugar del usuario del servidor y
sistema de archivos.

\ lo_list
Muestra una lista de todos los objetos grandes de PostgreSQL almacenados actualmente en la base de datos, junto con
con cualquier comentario proporcionado para ellos.

\ lo_unlink ley
Elimina el objeto grande con OID ley de la base de datos.

Consejo
Usa \ lo_list para averiguar el OID del objeto grande.

\ o o \ out [ nombre de archivo ]
\ o o \ out [|comando ]
Se arregla para guardar los resultados de consultas futuras en el archivo nombre de archivo o canalizar resultados futuros a
el comando de shell comando. Si no se especifica ningún argumento, la salida de la consulta se restablece a
la salida estándar.

"Resultados de la consulta" incluye todas las tablas, las respuestas a los comandos y los avisos obtenidos del
servidor de base de datos, así como la salida de varios comandos de barra invertida que consultan
base de datos (como \d), pero no mensajes de error.

Consejo
Para intercalar la salida de texto entre los resultados de la consulta, utilice \ qecho.

\ p o \ imprimir
Imprime el búfer de consulta actual en la salida estándar.

\contraseña [ nombre de usuario ]
Cambia la contraseña del usuario especificado (por defecto, el usuario actual). Esta
El comando solicita la nueva contraseña, la cifra y la envía al servidor como una
ALTER PAPEL mando. Esto asegura que la nueva contraseña no aparezca en texto sin cifrar.
en el historial de comandos, el registro del servidor o en otro lugar.

\inmediato [ texto ] nombre
Solicita al usuario que proporcione texto, que se asigna a la variable nombre . Un opcional
cadena de aviso, texto, se puede especificar. (Para indicaciones de varias palabras, rodee el texto con
comillas simples.)

De forma predeterminada, \ prompt usa el terminal para entrada y salida. Sin embargo, si el -f comando
Se usó el interruptor de línea, \ prompt usa la entrada estándar y la salida estándar.

\ pset [ opción [ propuesta de ]]
Este comando establece opciones que afectan la salida de las tablas de resultados de la consulta. opción
indica qué opción se va a configurar. La semántica de propuesta de variar dependiendo del
opción seleccionada. Para algunas opciones, omitir propuesta de hace que la opción sea conmutada o
desarmado, como se describe en la opción particular. Si no se menciona tal comportamiento,
luego omitiendo propuesta de solo da como resultado 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:

frontera
El objetivo principal era mejorar las capacidades analíticas existentes y facilitar la generación de nuevos modelos predictivos o biomarcadores. Para ello, se buscaba vincular los datos de imágenes con la Historia Clínica Electrónica (HCE), utilizando técnicas de procesamiento del lenguaje natural (PLN) para su análisis. propuesta de Tiene que ser un número. En general, cuanto mayor es el número, más bordes y
líneas que tendrán las tablas, pero los detalles dependen del formato particular. En HTML
formato, esto se traducirá directamente en el atributo border = ... En la mayoría de los demás
formatea solo los valores 0 (sin borde), 1 (líneas divisorias internas) y 2 (tabla
frame) tienen sentido, y los valores superiores a 2 se tratarán de la misma forma que border = 2. El
Los formatos latex y latex-longtable permiten adicionalmente un valor de 3 para agregar divisiones
líneas entre filas de datos.

columnas
Establece el ancho de destino para el formato envuelto, y también el límite de ancho para
determinar si la salida es lo suficientemente amplia como para requerir el buscapersonas o cambiar al
visualización vertical en modo automático expandido. Cero (el valor predeterminado) provoca el ancho objetivo
para ser controlado por la variable de entorno COLUMNAS, o el ancho de pantalla detectado
if COLUMNAS no está configurado. Además, si las columnas son cero, el formato envuelto
solo afecta la salida de la pantalla. Si las columnas son distintas de cero, la salida del archivo y la tubería es
envuelto a ese ancho también.

expandido (o x)
If propuesta de se especifica, debe estar encendido o apagado, lo que habilitará o deshabilitará
modo expandido o automático. Si propuesta de se omite el comando alterna entre encendido y
fuera de la configuración. Cuando el modo expandido está habilitado, los resultados de la consulta se muestran en dos
columnas, con el nombre de la columna a la izquierda y los datos a la derecha. Este modo es
útil si los datos no caben en la pantalla en el modo "horizontal" normal. En
la configuración automática, el modo expandido se utiliza siempre que la salida de la consulta es más amplia
que la pantalla, de lo contrario se utiliza el modo normal. La configuración automática es solo
eficaz en los formatos alineados y envueltos. En otros formatos, siempre se comporta
como si el modo expandido estuviera desactivado.

camposep
Especifica el separador de campo que se utilizará en formato de salida no alineado. De esa manera uno
puede crear, por ejemplo, una salida separada por tabuladores o comas, que otros programas
podría preferir. Para establecer una pestaña como separador de campo, escriba \ pset fieldsep '\ t'. El
el separador de campo predeterminado es '|' (una barra vertical).

camposep_zero
Establece el separador de campo para usar en formato de salida no alineado en un byte cero.

pie de página
If propuesta de se especifica, debe estar encendido o apagado, lo que habilitará o deshabilitará
visualización del pie de página de la tabla (el (n filas) contar). Si propuesta de se omite el comando
activa o desactiva la visualización del pie de página.

formato
Establece el formato de salida en uno de: no alineado, alineado, envuelto, html, asciidoc,
latex (usa tabular), latex-longtable o troff-ms. Las abreviaturas únicas son
permitido. (Eso significaría que una letra es suficiente).

El formato no alineado escribe todas las columnas de una fila en una línea, separadas por
separador de campo actualmente activo. Esto es útil para crear resultados que podrían ser
destinados a ser leídos por otros programas (por ejemplo, separados por tabuladores o
formato separado por comas).

El formato alineado es la salida de texto estándar, legible por humanos y con un formato agradable; esta
es el predeterminado.

El formato envuelto es como alineado pero envuelve valores de datos anchos a lo largo de las líneas para hacer que el
la salida se ajusta al ancho de la columna de destino. El ancho objetivo se determina como se describe
bajo la opción de columnas. Tenga en cuenta que psql no intentará ajustar el encabezado de la columna
títulos; por lo tanto, el formato envuelto se comporta igual que el alineado si el ancho total
necesario para los encabezados de columna excede el objetivo.

Los formatos html, asciidoc, latex, latex-longtable y troff-ms publican tablas
que están destinados a ser incluidos en documentos utilizando el marcado respectivo
idioma. ¡No son documentos completos! Es posible que esto no sea necesario en HTML,
pero en LaTeX debes tener un envoltorio de documentos completo. látex-longtable también
requiere los paquetes LaTeX longtable y booktabs.

estilo de línea
Establece el estilo de dibujo de la línea de borde en ascii, ascii antiguo o unicode. Único
se permiten abreviaturas. (Eso significaría que una letra es suficiente).
el ajuste es ascii. Esta opción solo afecta a los formatos de salida alineados y envueltos.

El estilo ascii utiliza caracteres ASCII simples. Las líneas nuevas en los datos se muestran usando un +
símbolo en el margen derecho. Cuando el formato envuelto envuelve los datos de una línea
al siguiente sin un carácter de nueva línea, se muestra un punto (.) en el lado derecho
margen de la primera línea, y nuevamente en el margen izquierdo de la siguiente línea.

El estilo antiguo-ascii usa caracteres ASCII simples, usando el estilo de formato usado en
PostgreSQL 8.4 y versiones anteriores. Las líneas nuevas en los datos se muestran usando un símbolo: en su lugar
del separador de columnas de la izquierda. Cuando los datos se envuelven de una línea a la
siguiente sin un carácter de nueva línea, a; El símbolo se usa en lugar de la mano izquierda.
separador de columnas.

El estilo Unicode utiliza caracteres de dibujo de caja Unicode. Se muestran nuevas líneas en los datos
utilizando un símbolo de retorno de carro en el margen derecho. Cuando los datos están empaquetados
de una línea a la siguiente sin un carácter de nueva línea, se muestra un símbolo de puntos suspensivos
en el margen derecho de la primera línea, y nuevamente en el margen izquierdo de
la siguiente línea.

Cuando la configuración del borde es mayor que cero, la opción de estilo de línea también determina
los caracteres con los que se dibujan las líneas del borde. Los caracteres ASCII simples funcionan
en todas partes, pero los caracteres Unicode se ven mejor en pantallas que los reconocen.

nulo
Establece la cadena que se imprimirá en lugar de un valor nulo. El valor predeterminado es imprimir
nada, que puede confundirse fácilmente con una cadena vacía. Por ejemplo, uno podría
prefiera \ pset null '(nulo)'.

localnumérico
If propuesta de se especifica, debe estar encendido o apagado, lo que habilitará o deshabilitará
visualización de un carácter específico de la localidad para separar grupos de dígitos a la izquierda de
el marcador decimal. Si propuesta de se omite el comando alterna entre regular y
salida numérica específica de la configuración regional.

pagar
Controla el uso de un programa de buscapersonas para consultas y resultados de ayuda psql. Si el medio ambiente
variable PAGER está configurado, la salida se canaliza al programa especificado. De lo contrario, un
Se utiliza el valor predeterminado dependiente de la plataforma (como más).

Cuando la opción de buscapersonas está desactivada, el programa de buscapersonas no se usa. Cuando la opción de buscapersonas
está encendido, el buscapersonas se usa cuando es apropiado, es decir, cuando la salida es a un terminal
y no cabe en la pantalla. La opción de buscapersonas también se puede establecer en siempre, lo que
hace que el buscapersonas se utilice para todas las salidas del terminal independientemente de si encaja
en la pantalla. \ pset buscapersonas sin un propuesta de activa y desactiva el uso del buscapersonas.

paginar_min_lines
Si pager_min_lines se establece en un número mayor que la altura de la página, el pager
El programa no se llamará a menos que haya al menos tantas líneas de salida para
show. La configuración predeterminada es 0.

registrosep
Especifica el separador de registros (línea) que se utilizará en el formato de salida no alineado. El
el valor predeterminado es un carácter de nueva línea.

registrosep_cero
Establece el separador de registros para usar en formato de salida no alineado en un byte cero.

tableattr (o T)
En formato HTML, esto especifica los atributos que se colocarán dentro de la etiqueta de la tabla. Esta
podría ser, por ejemplo, cellpadding o bgcolor. Tenga en cuenta que probablemente no quiera
especifique border aquí, ya que \ pset border se ocupa de eso. Si no propuesta de
se proporciona, los atributos de la tabla no se establecen.

En formato latex-longtable, esto controla el ancho proporcional de cada columna
que contiene un tipo de datos alineado a la izquierda. Se especifica como un espacio en blanco
lista de valores, por ejemplo, '0.2 0.2 0.6'. Las columnas de salida no especificadas usan la última
valor específico.

título
Establece el título de la tabla para las tablas impresas posteriormente. Esto se puede usar para dar
sus etiquetas descriptivas de salida. Si no propuesta de se da, el título no está definido.

tuplas_only (ot)
If propuesta de se especifica, debe estar encendido o apagado, lo que habilitará o deshabilitará
modo solo de tuplas. Si propuesta de se omite el comando alterna entre regular y
salida solo de tuplas. La salida regular incluye información adicional como la columna
encabezados, títulos y varios pies de página. En el modo de solo tuplas, solo los datos reales de la tabla
se muestra.

unicode_border_linestyle
Establece el estilo de dibujo de borde para el estilo de línea Unicode en uno de
doble.

unicode_column_linestyle
Establece el estilo de dibujo de columna para el estilo de línea Unicode en uno de
doble.

unicode_header_linestyle
Establece el estilo de dibujo del encabezado para el estilo de línea Unicode en uno de
doble.

Las ilustraciones de cómo se ven estos diferentes formatos se pueden ver en la sección EJEMPLOS.

Consejo
Hay varios comandos de acceso directo para \ pset. Vea \a, \C, \H, \t, \Ty \x.

\ q o \ salir
Cierra el programa psql. En un archivo de secuencia de comandos, solo se termina la ejecución de esa secuencia de comandos.

\ qecho texto [...]
Este comando es idéntico a \eco excepto que la salida se escribirá en la consulta
canal de salida, según lo establecido por \o.

\ r o \ restablecer
Restablece (limpia) el búfer de consultas.

\s [ nombre de archivo ]
Imprima el historial de la línea de comandos de psql en nombre de archivo. Si nombre de archivo se omite, la historia es
escrito en la salida estándar (usando el buscapersonas si corresponde). Este comando no es
disponible si psql se creó sin el soporte de Readline.

\colocar [ nombre [ propuesta de [...]]]
Establece la variable psql nombre a propuesta de, o si se da más de un valor, a la
concatenación de todos ellos. Si solo se da un argumento, la variable se establece con
un valor vacío. Para desarmar una variable, use el \ unset mando.

\colocar sin ningún argumento muestra los nombres y valores de todos los psql configurados actualmente
variables.

Los nombres de variables válidos pueden contener letras, dígitos y guiones bajos. Ver la seccion
Variables a continuación para obtener más detalles. Los nombres de las variables distinguen entre mayúsculas y minúsculas.

Aunque puede configurar cualquier variable para lo que desee, psql trata varios
variables como especiales. Están documentados en la sección de variables.

Note
Este comando no está relacionado con el comando SQL SET(7).

\ setenv nombre [ propuesta de ]
Establece la variable de entorno nombre a propuesta deo si el propuesta de no se suministra, desarma
la variable de entorno. Ejemplo:

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

\ sf [+] función descriptiva
Este comando busca y muestra la definición de la función nombrada, en forma de
CREAR OR SUSTITUIR FUNCIÓN mando. La definición se imprime en la consulta actual.
canal de salida, según lo establecido por \o.

La función de destino se puede especificar por nombre solo, o por nombre y argumentos, para
ejemplo foo (entero, texto). Los tipos de argumentos se deben dar si hay más de uno.
función del mismo nombre.

Si se agrega + al nombre del comando, entonces las líneas de salida están numeradas, con el
la primera línea del cuerpo de la función es la línea 1.

\t
Alterna la visualización de los encabezados de los nombres de las columnas de salida y el pie de página del recuento de filas. Este comando
es equivalente a \ pset tuples_only y se proporciona para su comodidad.

\T opciones_tabla
Especifica los atributos que se colocarán dentro de la etiqueta de la tabla en formato de salida HTML. Esta
comando es equivalente a \ pset tableattr opciones_tabla.

\momento [ on | off ]
Sin parámetro, alterna una visualización de cuánto tiempo toma cada declaración SQL, en
milisegundos. Con parámetro, establece lo mismo.

\ unset nombre
Deselecciona (elimina) la variable psql nombre .

\ w o \ escribir nombre de archivo
\ w o \ write |comando
Envía el búfer de consulta actual al archivo nombre de archivo o lo canaliza al comando de shell
comando.

\reloj [ segundos ]
Ejecute repetidamente el búfer de consulta actual (como \ g) hasta que se interrumpa o la consulta
falla. Espere el número especificado de segundos (predeterminado 2) entre ejecuciones.

\X [ on | off | auto ]
Establece o alterna el modo de formato de tabla expandido. Como tal, es equivalente a \ pset
expandido.

\ z [ patrón ]
Enumera tablas, vistas y secuencias con sus privilegios de acceso asociados. Si un
patrón se especifica, solo tablas, vistas y secuencias cuyos nombres coinciden con el patrón
están listados.

Este es un alias para \ dp ("Mostrar privilegios").

\! [ comando ]
Se escapa a un shell independiente o ejecuta el comando del shell comando. Los argumentos son
no más interpretado; el caparazón los verá como están. En particular, la variable
las reglas de sustitución y los escapes de barra invertida no se aplican.

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

Patrones
Los diversos comandos \ d aceptan un patrón parámetro para especificar el nombre (s) de objeto a ser
desplegado. En el caso más simple, un patrón es solo el nombre exacto del objeto. El
los caracteres dentro de un patrón normalmente se doblan a minúsculas, al igual que en los nombres SQL;
por ejemplo, \ dt FOO mostrará la tabla llamada foo. Como en los nombres SQL, colocando el doble
las comillas alrededor de un patrón dejan de doblarse a minúsculas. Si necesita incluir un
carácter real de comillas dobles en un patrón, escríbalo como un par de comillas dobles dentro
una secuencia de comillas dobles; nuevamente, esto está de acuerdo con las reglas para SQL citado
identificadores. Por ejemplo, \ dt "FOO" "BAR" mostrará la tabla denominada FOO "BAR (no
foo "). A diferencia de las reglas normales para nombres SQL, puede poner comillas dobles alrededor de
parte de un patrón, por ejemplo \ dt FOO "FOO" BAR mostrará la tabla llamada
fooFOObar.

Siempre que el patrón El parámetro se omite por completo, los comandos \ d muestran todos
objetos que son visibles en la ruta de búsqueda del esquema actual; esto es equivalente a
usando * como patrón. (Se dice que un objeto es visible si el esquema que lo contiene es
en la ruta de búsqueda y ningún objeto del mismo tipo y nombre aparece antes en la
ruta de búsqueda. Esto es equivalente a la afirmación de que el objeto puede ser referenciado por
nombre sin calificación de esquema explícita.) Para ver todos los objetos en la base de datos
independientemente de la visibilidad, utilice *. * como patrón.

Dentro de un patrón, * coincide con cualquier secuencia de caracteres (sin incluir caracteres) y?
coincide con cualquier carácter. (Esta notación es comparable al nombre de archivo de shell de Unix
patrones.) Por ejemplo, \ dt int * muestra tablas cuyos nombres comienzan con int. Pero
entre comillas dobles, * y? pierden estos significados especiales y simplemente se combinan
literalmente.

Un patrón que contiene un punto (.) Se interpreta como un patrón de nombre de esquema seguido de
un patrón de nombre de objeto. Por ejemplo, \ dt foo *. * Bar * muestra todas las tablas cuya tabla
name incluye barras que están en esquemas cuyo nombre de esquema comienza con foo. Cuando no hay punto
aparece, entonces el patrón coincide solo con los objetos que son visibles en el esquema actual
ruta de búsqueda. Nuevamente, un punto entre comillas dobles pierde su significado especial y es
emparejado literalmente.

Los usuarios avanzados pueden utilizar notaciones de expresiones regulares, como clases de caracteres, para
ejemplo [0-9] para que coincida con cualquier dígito. Todos los caracteres especiales de expresión regular funcionan como
especificado en la Sección 9.7.3, "Expresiones regulares POSIX", en la documentación, excepto
por . que se toma como separador como se mencionó anteriormente, * que se traduce al
notación de expresión regular. *,? que se traduce a., y $ que coincide
literalmente. ¿Puede emular estos caracteres de patrón si lo necesita escribiendo? por ., (R+ |)
for R*, o (R|) para R?. $ no es necesario como carácter de expresión regular ya que el
patrón debe coincidir con el nombre completo, a diferencia de la interpretación habitual de regular
expresiones (en otras palabras, $ se agrega automáticamente a su patrón). Escribir * en
el principio y / o el final si no desea que el patrón quede anclado. Tenga en cuenta que
entre comillas dobles, todos los caracteres especiales de expresión regular pierden su especial
significados y se corresponden literalmente. Además, los caracteres especiales de expresión regular
se emparejan literalmente en patrones de nombre de operador (es decir, el argumento de \ do).

Avanzada Caracteristicas
Variables
psql proporciona funciones de sustitución de variables similares a los shells de comandos comunes de Unix.
Las variables son simplemente pares de nombre / valor, donde el valor puede ser cualquier cadena de cualquier
longitud. El nombre debe constar de letras (incluidas letras no latinas), dígitos y
subrayados.

Para establecer una variable, use el metacomando psql \colocar. Por ejemplo,

testdb => \colocar foo de caramelos

establece la variable foo en la barra de valor. Para recuperar el contenido de la variable,
preceda el nombre con dos puntos, por ejemplo:

testdb => \eco : foo
de caramelos

Esto funciona tanto en los comandos SQL habituales como en los metacomandos; hay más detalles en SQL
Interpolación, a continuación.

Si llamas \colocar sin un segundo argumento, la variable se establece, con una cadena vacía
como valor. Para desarmar (es decir, eliminar) una variable, use el comando \ unset. Para mostrar el
valores de todas las variables, llame \colocar sin ningún argumento.

Note
Los argumentos de \colocar están sujetos a las mismas reglas de sustitución que con otros
comandos. Por lo tanto, puede construir referencias interesantes como \ set: foo
"algo" y obtener "enlaces suaves" o "variables variables" de la fama de Perl o PHP,
respectivamente. Desafortunadamente (¿o afortunadamente?), No hay forma de hacer nada
útil con estos constructos. Por otro lado, \ set bar: foo es un perfecto
forma válida de copiar una variable.

Varias de estas variables son tratadas especialmente por psql. Representan ciertos
configuraciones de opciones que se pueden cambiar en tiempo de ejecución alterando el valor de la variable,
o en algunos casos representan el estado cambiante de psql. Aunque puedes usar estos
variables para otros fines, esto no se recomienda, ya que el comportamiento del programa puede
se vuelven realmente extraños muy rápido. Por convención, todas las variables tratadas especialmente
Los nombres constan de letras ASCII en mayúsculas (y posiblemente dígitos y guiones bajos).
Para garantizar la máxima compatibilidad en el futuro, evite utilizar dichos nombres de variables para
sus propios propósitos. A continuación se muestra una lista de todas las variables tratadas especialmente.

COMPROMISO AUTOMÁTICO
Cuando está activado (el valor predeterminado), cada comando SQL se confirma automáticamente al tener éxito
terminación. Para posponer el compromiso en este modo, debe ingresar un EMPEZAR or EMPIEZA
TRANSACCIÓN Comando SQL. Cuando está desactivado o desarmado, los comandos SQL no se confirman hasta
usted explicita explícitamente COMETER or FIN. El modo de apagado automático funciona emitiendo un
implícitamente EMPEZAR para usted, justo antes de cualquier comando que no esté ya en un
bloque de transacciones y no es en sí mismo un EMPEZAR u otro comando de control de transacciones,
ni un comando que no se pueda ejecutar dentro de un bloque de transacciones (como VACÍO).

Note
En el modo de cierre automático, debe abandonar explícitamente cualquier transacción fallida
que entran a los ABORTAR or RETROCEDER. También tenga en cuenta que si sale de la sesión
sin comprometerse, su trabajo se perderá.

Note
El modo de confirmación automática es el comportamiento tradicional de PostgreSQL, pero
autocommit-off está más cerca de la especificación SQL. Si prefiere la desconexión automática,
tal vez desee configurarlo en el archivo psqlrc de todo el sistema o en su ~ / .psqlrc archivo.

COMP_KEYWORD_CASE
Determina qué mayúsculas y minúsculas se utilizará al completar una palabra clave SQL. Si se establece en
minúsculas o mayúsculas, la palabra completa estará en minúsculas o mayúsculas, respectivamente.
Si se establece en preserve-lower o preserve-upper (el valor predeterminado), la palabra completa
ser en el caso de la palabra ya ingresada, pero las palabras se completan sin
todo lo que ingrese estará en minúsculas o mayúsculas, respectivamente.

NOMBREBD
El nombre de la base de datos a la que está conectado actualmente. Esto se establece cada vez
se conecta a una base de datos (incluido el inicio del programa), pero se puede desarmar.

ECHO
Si se establece en todos, todas las líneas de entrada no vacías se imprimen en la salida estándar tal como están
leer. (Esto no se aplica a las líneas leídas de forma interactiva). Para seleccionar este comportamiento
en el inicio del programa, utilice el interruptor -a. Si se establece en consultas, psql imprime cada consulta
a la salida estándar a medida que se envía al servidor. El cambio para esto es -e. Si está configurado
a errores, solo las consultas fallidas se muestran en la salida de error estándar. El
cambiar porque esto es -b. Si no se establece, o si se establece en ninguno (o cualquier otro valor que no sea el
arriba), no se muestran consultas.

ECHO_OCULTO
Cuando esta variable está activada y un comando de barra invertida consulta la base de datos, el
La consulta se muestra primero. Esta característica le ayuda a estudiar los componentes internos de PostgreSQL y
proporcione una funcionalidad similar en sus propios programas. (Para seleccionar este comportamiento en
puesta en marcha del programa, utilice el interruptor -E.) Si establece la variable en el valor noexec,
las consultas solo se muestran, pero en realidad no se envían al servidor y se ejecutan.

CODIFICACION
La codificación actual del juego de caracteres del cliente.

FETCH_COUNT
Si esta variable se establece en un valor entero> 0, los resultados de SELECCIONAR las consultas son
recuperados y mostrados en grupos de esa cantidad de filas, en lugar del valor predeterminado
comportamiento de recopilar todo el conjunto de resultados antes de mostrarlo. Por lo tanto, solo un
se utiliza una cantidad limitada de memoria, independientemente del tamaño del conjunto de resultados.
Las configuraciones de 100 a 1000 se usan comúnmente al habilitar esta función. Tenga en cuenta
que al usar esta función, una consulta puede fallar después de haber mostrado
algunas filas.

Consejo
Aunque puede utilizar cualquier formato de salida con esta función, la alineación predeterminada
El formato tiende a verse mal porque cada grupo de FETCH_COUNT las filas serán
formateado por separado, lo que lleva a diferentes anchos de columna en los grupos de filas.
Los otros formatos de salida funcionan mejor.

SU CONTROL
Si esta variable está configurada para ignorar el espacio, las líneas que comienzan con un espacio no
ingresado en la lista del historial. Si se establece en un valor de ignoredups, las líneas que coinciden
la línea del historial anterior no se ingresa. Un valor de ignorar ambos combina los dos
opciones. Si no se configura, o si se establece en ninguno (o en cualquier otro valor que los anteriores), todos
las líneas leídas en modo interactivo se guardan en la lista del historial.

Note
Esta característica fue plagiada descaradamente por Bash.

ARCHIVO HISTÓRICO
El nombre de archivo que se utilizará para almacenar la lista del historial. El valor predeterminado es
~ / .psql_history. Por ejemplo, poniendo:

\ set HISTFILE ~ / .psql_history- : DBNAME

in ~ / .psqlrc hará que psql mantenga un historial separado para cada base de datos.

Note
Esta característica fue plagiada descaradamente por Bash.

SU TAMAÑO
El número de comandos para almacenar en el historial de comandos. El valor predeterminado es 500.

Note
Esta característica fue plagiada descaradamente por Bash.

HOST
El servidor de base de datos al que está conectado actualmente. Esto se establece cada vez
se conecta a una base de datos (incluido el inicio del programa), pero se puede desarmar.

IGNORAR
Si no está configurado, enviar un carácter EOF (generalmente Control + D) a una sesión interactiva
de psql terminará la aplicación. Si se establece en un valor numérico, esa cantidad de EOF
los caracteres se ignoran antes de que finalice la aplicación. Si la variable está configurada
pero no tiene un valor numérico, el valor predeterminado es 10.

Note
Esta característica fue plagiada descaradamente por Bash.

LASTOIDE
El valor del último OID afectado, como se devuelve de un INSERT or \ lo_import
mando. Esta variable solo se garantiza que sea válida hasta después del resultado de
se ha mostrado el siguiente comando SQL.

ON_ERROR_ROLLBACK
Cuando se activa, si una sentencia en un bloque de transacciones genera un error, el
se ignora el error y la transacción continúa. Cuando se establece en interactivo,
Los errores solo se ignoran en las sesiones interactivas y no al leer un script.
archivos. Cuando se desarma o se apaga, una declaración en un bloque de transacción que genera
un error aborta toda la transacción. El modo de reversión de errores funciona emitiendo
un implícito PUNTO DE GUARDADO para usted, justo antes de cada comando de una transacción
bloquear y luego retroceder al punto de guardado si el comando falla.

ON_ERROR_PARAR
De forma predeterminada, el procesamiento de comandos continúa después de un error. Cuando se establece esta variable
en su lugar, el procesamiento se detendrá inmediatamente. En modo interactivo, psql
volver al símbolo del sistema; de lo contrario, psql se cerrará y devolverá el código de error 3 a
distinguir este caso de las condiciones de error fatal, que se informan mediante error
código 1. En cualquier caso, cualquier script que se esté ejecutando actualmente (el script de nivel superior, si
any, y cualquier otro script que pueda haber invocado) será terminado
inmediatamente. Si la cadena de comandos de nivel superior contiene varios comandos SQL,
el procesamiento se detendrá con el comando actual.

PORT
El puerto del servidor de la base de datos al que está conectado actualmente. Esto se establece cada
vez que se conecta a una base de datos (incluido el inicio del programa), pero puede desarmarse.

PRONTO1
PRONTO2
PRONTO3
Estos especifican cómo deberían verse los mensajes de error de psql. Consulte las indicaciones a continuación.

TRANQUILO
Establecer esta variable en activado es equivalente a la opción de línea de comando -q. Es
probablemente no sea demasiado útil en modo interactivo.

LINEA SOLA
Establecer esta variable en activado es equivalente a la opción de línea de comando -S.

UN SOLO PASO
Establecer esta variable en activado es equivalente a la opción de línea de comando -s.

USUARIO
El usuario de la base de datos con el que está conectado actualmente. Esto se establece cada vez que
conectarse a una base de datos (incluido el inicio del programa), pero se puede desarmar.

VERBOSIDAD
Esta variable se puede establecer en los valores predeterminados, detallados o concisos para controlar el
verbosidad de los informes de errores.

SQL Interpolación
Una característica clave de las variables psql es que puede sustituirlas ("interpolarlas") en
sentencias SQL regulares, así como los argumentos de los metacomandos. Además, psql
proporciona facilidades para garantizar que los valores de las variables utilizados como literales SQL y
los identificadores se citan correctamente. La sintaxis para interpolar un valor sin ningún
citar es anteponer el nombre de la variable con dos puntos (:). Por ejemplo,

testdb => \colocar foo 'mi mesa'
testdb => SELECCIONAR * DESDE : foo;

consultaría la tabla my_table. Tenga en cuenta que esto puede ser peligroso: el valor del
La variable se copia literalmente, por lo que puede contener comillas no balanceadas o incluso barra invertida.
comandos. Debe asegurarse de que tenga sentido donde lo puso.

Cuando un valor se va a utilizar como un literal o identificador de SQL, es más seguro organizar
para que sea cotizado. Para citar el valor de una variable como literal de SQL, escriba dos puntos
seguido del nombre de la variable entre comillas simples. Para citar el valor como SQL
identificador, escriba dos puntos seguidos del nombre de la variable entre comillas dobles. Estos
construcciones tratan correctamente con comillas y otros caracteres especiales incrustados dentro de la
valor variable. El ejemplo anterior se escribiría con más seguridad de esta manera:

testdb => \colocar foo 'mi mesa'
testdb => SELECCIONAR * DESDE : "foo";

La interpolación de variables no se realizará dentro de los literales SQL citados y
identificadores. Por lo tanto, una construcción como ': foo' no funciona para producir una cotización
literal del valor de una variable (y no sería seguro si funcionara, ya que
no manejaría correctamente las comillas incrustadas en el valor).

Un ejemplo de uso de este mecanismo es copiar el contenido de un archivo en una tabla.
columna. Primero cargue el archivo en una variable y luego interpole el valor de la variable
como una cadena entre comillas:

testdb => \colocar contenido gato mi_archivo.txt`
testdb => INSERT EN mi mesa VALORES (:'contenido');

(Tenga en cuenta que esto aún no funcionará si my_file.txt contiene bytes NUL. Psql no
admite bytes NUL incrustados en valores variables).

Dado que los dos puntos pueden aparecer legalmente en los comandos SQL, un aparente intento de interpolación
(es decir,: nombre,: 'nombre' o: "nombre") no se reemplaza a menos que la variable nombrada sea
configurado actualmente. En cualquier caso, puede escapar de los dos puntos con una barra invertida para protegerlo de
sustitución.

La sintaxis de dos puntos para las variables es SQL estándar para lenguajes de consulta integrados, como
ECPG. Las sintaxis de los dos puntos para las secciones de matriz y las conversiones de tipos son extensiones de PostgreSQL,
que a veces puede entrar en conflicto con el uso estándar. La sintaxis de comillas de dos puntos para
escapar del valor de una variable como un literal o identificador SQL es una extensión psql.

Incitación
Las indicaciones de problemas de psql se pueden personalizar según sus preferencias. Las tres variables
PRONTO1, PRONTO2y PRONTO3 contienen cadenas y secuencias de escape especiales que
describir la apariencia del mensaje. El mensaje 1 es el mensaje normal que se emite
cuando psql solicita un nuevo comando. El mensaje 2 se emite cuando se esperan más entradas
durante la entrada del comando porque el comando no se terminó con un punto y coma o un
la cita no se cerró. El mensaje 3 se emite cuando ejecuta un SQL COPIA comando y tu eres
Se espera que escriba los valores de la fila en la terminal.

El valor de la variable de solicitud seleccionada se imprime literalmente, excepto donde un porcentaje
se encuentra el signo (%). Dependiendo del siguiente carácter, otro texto es
sustituido en su lugar. Las sustituciones definidas son:

%M
El nombre de host completo (con el nombre de dominio) del servidor de la base de datos, o [local] si el
la conexión se realiza a través de un socket de dominio Unix, o [local:/ dir / nombre], si el dominio Unix
socket no está en la ubicación compilada por defecto.

%m
El nombre de host del servidor de la base de datos, truncado en el primer punto, o [local] si
la conexión se realiza a través de un socket de dominio Unix.

%>
El número de puerto en el que escucha el servidor de la base de datos.

%n
El nombre de usuario de la sesión de la base de datos. (La expansión de este valor puede cambiar durante un
sesión de base de datos como resultado del comando SET SESIÓN AUTORIZACIÓN.)

%/
El nombre de la base de datos actual.

%~
Como% /, pero la salida es ~ (tilde) si la base de datos es su base de datos predeterminada.

%#
Si el usuario de la sesión es un superusuario de la base de datos, entonces un #, de lo contrario un>. (El
La expansión de este valor puede cambiar durante una sesión de base de datos como resultado de
el comando SET SESIÓN AUTORIZACIÓN.)

%R
En el indicador 1 normalmente =, pero ^ si está en modo de una sola línea, y! si la sesión es
desconectado de la base de datos (lo que puede suceder si \conectar falla). En el mensaje 2
la secuencia se reemplaza por -, *, una comilla simple, una comilla doble o un dólar
firmar, dependiendo de si psql espera más entrada porque el comando no
terminado todavía, porque estás dentro de un / * ... * / comentario, o porque estás
dentro de una cadena entre comillas o en dólares. En el mensaje 3, la secuencia no produce
cualquier cosa.

%x
Estado de la transacción: una cadena vacía cuando no está en un bloque de transacción, o * cuando está en
un bloque de transacciones, o! cuando en un bloque de transacciones fallidas, o? cuando el
el estado de la transacción es indeterminado (por ejemplo, porque no hay conexión).

%l
El número de línea dentro de la declaración actual, comenzando por 1.

%dígitos
Se sustituye el carácter con el código octal indicado.

%:nombre :
El valor de la variable psql nombre . Consulte la sección Variables para obtener más detalles.

%`comando`
La salida de comando, similar a la sustitución ordinaria de "retroceso".

% [...%]
Los mensajes pueden contener caracteres de control de terminal que, por ejemplo, cambian el
color, fondo o estilo del texto del mensaje, o cambie el título del
ventana de terminal. Para que funcionen las funciones de edición de línea de Readline
correctamente, estos caracteres de control que no son de impresión deben ser designados como invisibles por
rodeándolos con% [y%]. Múltiples pares de estos pueden ocurrir dentro del
inmediato. Por ejemplo:

testdb => \ set PROMPT1 '% [% 033 [1; 33; 40m%]% n @% /% R% [% 033 [0m%]% #'

da como resultado un indicador amarillo sobre negro (1; 33) en negrita (40;) en los dispositivos compatibles con VT100,
terminales con capacidad de color.
Para insertar un signo de porcentaje en su mensaje, escriba %%. Las solicitudes predeterminadas son '% /% R% #'
para las solicitudes 1 y 2, y '>>' para la solicitud 3.

Note
Esta característica fue plagiada descaradamente de tcsh.

Línea de comando Edición
psql admite la biblioteca Readline para una cómoda edición y recuperación de líneas. El
el historial de comandos se guarda automáticamente cuando psql sale y se vuelve a cargar cuando psql
pone en marcha. También se admite la finalización con tabulación, aunque la lógica de finalización no hace
afirmar ser un analizador de SQL. Las consultas generadas al completar la pestaña también pueden interferir
con otros comandos SQL, por ejemplo, SET TRANSACTION ISOLATION LEVEL. Si por alguna razon tu
no le gusta completar la pestaña, puede desactivarlo colocando esto en un archivo llamado
.inputrc en su directorio de inicio:

$ si psql
establecer deshabilitar finalización en
$ endif

(Esto no es un psql sino una función de Readline. Lea su documentación para obtener más información
detalles.)

MEDIO AMBIENTE

COLUMNAS
Si \ pset columnas es cero, controla el ancho para el formato envuelto y el ancho para
determinar si la salida amplia requiere el buscapersonas o debe cambiarse a la vertical
formato en modo automático expandido.

PAGER
Si los resultados de la consulta no caben en la pantalla, se canalizan a través de este comando.
Los valores típicos son más o menos. El valor predeterminado depende de la plataforma. El uso de la
El buscapersonas se puede desactivar mediante el \ pset mando.

BASE DE DATOS DE PG
PHOST
PUERTOPG
PGUSER
Parámetros de conexión predeterminados (consulte la Sección 31.14, "Variables de entorno", en el
documentación).

PSQL_EDITOR
EDITOR
VISUAL
Editor utilizado por el \e e \ ef comandos. Las variables se examinan en el orden
enumerado; se utiliza el primero que se establece.

Los editores predeterminados integrados son vi en sistemas Unix y notepad.exe en Windows
.

PSQL_EDITOR_LINENUMBER_ARG
Cuándo \e or \ ef se utiliza con un argumento de número de línea, esta variable especifica el
Argumento de línea de comandos utilizado para pasar el número de línea de inicio al editor del usuario. Para
editores como Emacs o vi, este es un signo más. Incluya un espacio final en el
valor de la variable si debe haber espacio entre el nombre de la opción y la línea
número. Ejemplos:

PSQL_EDITOR_LINENUMBER_ARG = '+'
PSQL_EDITOR_LINENUMBER_ARG = '- línea'

El valor predeterminado es + en los sistemas Unix (correspondiente al editor predeterminado vi, y útil
para muchos otros editores habituales); pero no hay ningún valor predeterminado en los sistemas Windows.

PSQL_HISTORIA
Ubicación alternativa para el archivo de historial de comandos. Se realiza la expansión de tilde (~).

PSQLRC
Ubicación alternativa del archivo .psqlrc del usuario. Se realiza la expansión de tilde (~).

SHELL
Comando ejecutado por el \! mando.

TMPDIR
Directorio para almacenar archivos temporales. El valor predeterminado es / tmp.

Esta utilidad, como la mayoría de las otras utilidades de PostgreSQL, también usa las variables de entorno
compatible con libpq (consulte la Sección 31.14, “Variables de entorno”, en la documentación).

Use psql en línea usando los servicios de onworks.net