2010-11-24 23 views
36

¿Cuál es el personaje de los comentarios en postgres?¿Carácter/caracteres del comentario en postgres/postgresql/psql?

SELECT * FROM my_table  # pound sign produces a syntax error 

Gracias cababunga, la siguiente parece funcionar:

SELECT * FROM my_table  -- this is my comment 

Pero esto no funciona:

\dt jvcurve_thin.jvcurve_results -- my comment #2 

\ dt: argumento extra "-" ignorados

+7

'psql' no es compatible con los comentarios de trailing line en sus comandos de barra inclinada. Simplemente ponga el comentario en la línea anterior. –

Respuesta

17

En el comentario de SQL comienza con --.

+3

La mayoría de las bases de datos permiten comentarios tipo C, pero no estoy seguro de cuál (si es que lo hace) el estándar SQL los estipula: '/ * comment * /' –

3

No parece que psql admita los comentarios tradicionales de final de línea -- en su psql -specific "slash commands."

Sin embargo, si está de acuerdo con los comentarios de final de línea que se muestran en la ejecución, usar \echo parece ser una solución válida. Por ejemplo:

\dt jvcurve_thin.jvcurve_results \echo my comment #2 

El "doble barra" separador de meta-comandos se parece a otra posibilidad (y sin el efecto secundario de eco). Iniciar un nuevo comando con ella y comenzar inmediatamente un comentario --:

\dt jvcurve_thin.jvcurve_results \\ -- my comment #2 

Por último, el cambio a la cáscara y añadir un comentario cáscara parece otra posibilidad:

\dt jvcurve_thin.jvcurve_results \! # my comment #2 
+0

Probablemente no deberías usar dos barras invertidas \\ ya que estas se usan para comandos separados para 'psql', por ej. '\ d table1 \\ \ d table2', y puede exhibir comportamiento cuando el supuesto comentario incluye comandos' psql'. Vea la descripción de la opción '-c' [aquí] (http://www.postgresql.org/docs/9.1/static/app-psql.html). – valid

+0

Gracias, @valid. ¿Qué tal anteponer el texto después de \\ con '--' luego, como en' \\ --' mi comentario. – cjerdonek

+1

oh sí. Eso parece estar bien. Todavía presenta algo de comportamiento diferente. Al escribir double-dash en la consola interactiva psql, el comando de comentario y los que siguen directamente se recopilan y almacenan en el historial con el siguiente comando (sin comentarios) sin comentarios, que se comporta casi como un comentario de líneas múltiples. La doble barra invertida combinada con doble guión no funciona de la misma manera, es decir, el comentario no se compila con los siguientes comandos. Aunque consideraría todo este comportamiento deseado, no creo que sea particularmente intuitivo. Así que ten cuidado;) – valid

55

De acuerdo con la documentación de PostgreSQL, hay los comentarios de estilo en línea y en bloque.

El estilo en línea:

SELECT 23 AS test -- this is just a test 

El bloque estilo:

/* The following is a very 
* non-trivial SQL code */ 
SELECT 42 AS result 
+1

Cosas como esta es la razón por la que te mantenemos en este sitio. – Fuser97381

+1

Pregunta cómo hacer comentarios en los scripts de la consola interactiva psql (es decir, incluir el comentario de los metacomandos invertidos, que es el truco), no cómo comentar el SQL de Postgres normal. –

1

De la documentación oficial: PostgreSQL Comments.

Un comentario es una secuencia de caracteres que comienzan con guiones dobles y se extiende hasta el final de la línea, por ejemplo:

-- This is a standard SQL comment 

Alternativamente, de estilo C bloque comentarios pueden ser utilizados:

/* multiline comment * with nesting: /* nested block comment */ */ 

donde el comentario comienza con/* y se extiende a la coincidencia ocurrencia de * /. Estos comentarios de bloque anidan, como se especifica en el estándar SQL , pero a diferencia de C, de modo que se pueden comentar bloques más grandes del código que pueden contener comentarios de bloque existentes.

Un comentario se elimina de la secuencia de entrada antes de una nueva sintaxis análisis y es reemplazado efectivamente por espacios en blanco.

Y ha sido compatible de la misma manera desde edades oscuras (versión 7.0).

Cuestiones relacionadas