Crea una consulta nueva.
Sinopsis
- new_query [common options] [-t/ype/ record
type] [-f/ield name] * [-field
name] * [-or] [-and] [-filteropfield
name[value[value]]] [-s/how]
[-show_sql/-ss] [-show_fields/-sf] [-show_filter/-sfi]
[-ids] [-dbids] [-rep/lace] filterop
Descripción
Crea, ejecuta y guarda consultas. La consulta se compone de la línea de mandatos y se puede ejecutar y guardar inmediatamente o posteriormente.
Opciones y argumentos
- -t/ype record type
- El tipo de registro que se debe buscar. Si no se especifica ningún valor, se utiliza el tipo de registro predeterminado.
- filterop
- Estos son los filtros que se pueden utilizar para establecer los criterios de búsqueda. Las opciones son las siguientes:
- eq - igual a
- ne - no igual a
- lt - menor que
- le - menor o igual que
- gt - mayor que
- ge - mayor o igual que
- like - que contenga el valor
- not_like - que no contenga el valor
- in - que incluya uno de los conjuntos de valores
- not_in - que no incluya ninguno de los conjuntos de valores
- null - valor de campo nulo
- not_null - valor de campo no nulo
- between - valor comprendido entre un intervalo
- not_between - valor no comprendido en ningún intervalo
- -f/ield name
- Formato alternativo para especificar los campos que se deben mostrar. Se debe utilizar este formato si el nombre de un campo coincide con el nombre de una opción de submandato.
- -or
- Tipo de filtro "or" de las cláusulas de la consulta.
- -filterop field name [ value [ value ]]
- Formato que se utiliza para definir los campos de una consulta.
- -s/how
- Muestra la consulta construida sin tener que ejecutarla.
- -show sql/-ss
- Muestra la sentencia SQL que se genera con la consulta.
- -show fields/-sf
- Muestra los campos que se deben incluir en los Resultados de la consulta.
- -show filter/-sfi
- Muestra los filtros definidos para las consultas.
- -ids
- Muestra sólo los ID de registro en los Resultados de la consulta.
- -dbids
- ID de base de datos interno del registro que se debe modificar.
- -rep/lace
- Sobrescribe la consulta existente.
Ejemplos
Creación de una consulta y ejecución de esta para detectar todos los errores de gravedad 1 y 2. Los campos "id", "headline" y
"severity" se muestran en los resultados.
CQTOOL> new_query -id -headline -severity -in severity "1 2" "Public Queries/query1"
id Headline Severity
----- --------------- ----------------------------
SAMPL00000011 The foobar is broken 1-Critical
SAMPL00000021 The widget needs repair 1-Critical
SAMPL00000019 query does not work 1-Critical
SAMPL00000051 we need new features 2-High
Count: 4
− -------------------------------------------------
Create and run a query to find all the defects currently
opened by the user Tom. The "id" and "headline" fields are displayed in the results.
CQTOOL> new_query -eq State Opened -and -eq Owner Tom -id -headline "Public Queries/query2"
id Headline
SAMPL00000011 The foobar is broken
SAMPL00000021 The widget needs repair
Count: 2 -------------------------------------------
Create and run a query to find all the defects currently opened
by the user Tom and severity 1 errors. The "id" and "headline" fields are displayed in the results.
CQTOOL> new_query ( -eq State Opened -and -eq Owner Tom ) -and ( -eq Severity 1-Critical -and -Project Classics ) -headline "Public Queries/query3"
id Headline
SAMPL00000011 The foobar is broken
Count: 1 -------------------------------------------