Cria uma nova consulta.
Sinopse
- new_query [opções comuns] [-t/ype/ tipo de
registro] [-f/ield nome] * [-nome do
campo] * [-or] [-and] [-filteropnome do
campo[valor[valor]]] [-s/how]
[-show_sql/-ss] [-show_fields/-sf] [-show_filter/-sfi]
[-ids] [-dbids] [-rep/lace] filterop
Descrição
Cria, executa e salva consultas. A consulta é composta na linha de comandos e pode ser executada imediatamente ou salva para ser utilizada posteriormente.
Opções e Argumentos
- -t/ype tipo de registro
- O tipo de registro para localizar. Se nenhum valor for fornecido, o tipo de registro padrão será utilizado.
- filterop
- Filtros para utilizar para definir o critério de procura. Possíveis opções incluídas:
- eq - igual a
- ne - não igual a
- lt - menor que
- le - menor ou igual a
- gt - maior que
- ge - maior ou igual a
- like - contém o valor
- not_like - não contém o valor
- in - inclui um dos valores configurados
- not_in - não inclui nenhum dos valores configurados
- null - o campo de valor é nulo
- not_null - o campo de valor não é nulo
- between - o valor está dentro de um intervalo
- not_between - o valor não está dentro de um intervalo
- -f/ield nome
- Formato alternativo para especificar campos para exibir. Utilize este formato se o campo for o mesmo nome da opção de subcomando.
- -or
- Tipo de filtro "or" para as cláusulas da consulta.
- -filterop nome do campo [ valor [ valor ]]
- Formato utilizado para definir os campos na consulta.
- -s/how
- Exibe a consulta construída sem executar a consulta.
- -show sql/-ss
- Exibe a instrução "sql" gerada pela consulta.
- -show fields/-sf
- Exibe os campos a serem incluídos nos Resultados da Consulta.
- -show filter/-sfi
- Exibe os filtros definidos para a consulta.
- -ids
- Exibe apenas os IDs de registro nos Resultados da Consulta.
- -dbids
- O ID de banco de dados interno do registro a ser modificado.
- -rep/lace
- Sobrescreve a consulta existente.
Exemplos
Criar e executar uma consulta para
localizar todos os erros de severidade 1 ou 2. Os campos "ID", "título" e
"severidade" são exibidos nos 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
− -------------------------------------------------
Criar e executar uma consulta para localizar todos os defeitos abertos
atualmente pelo usuário Tom. Os campos "id" e "headline" são exibidos nos resultados.
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 -------------------------------------------
Criar e executar uma consulta para localizar todos os defeitos abertos atualmente
pelo usuário Tom e erros de gravidade 1. Os campos "id" e "headline" são exibidos nos resultados.
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 -------------------------------------------