---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# Registros de consulta

# Registros de consulta {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Recupera vários registros de uma tabela especificada.

## Antes de Iniciar

Função necessária: sn_cli_metadata.cli_admin, sn_cli_metadata.cli_user ou admin

## Procedimento

Abra a ferramenta de linha de comando do seu sistema e execute este comando.  

    $ snc record query [--displayvalue displayValue --fields fields --limit limit --offset offset --query query --table table]

Passe valores para esses argumentos.  
{#query-record__id_b5x_qyf_m4b__entry__2}

| Parâmetro | Descrição |
|-|-|
| displayValue | Inclua `--displayvalue` para recuperar o valor de exibição do banco de dados para campos de referência e de opção. Não inclua este parâmetro para recuperar os valores reais. |
| campos | Lista separada por vírgulas de nomes de campos a serem retornados do banco de dados. |
| limite | Número máximo de registros a serem retornados. |
| deslocamento | Índice de registro inicial para o qual a recuperação de registros será iniciada. Use este valor para paginar a recuperação do registro. |
| consulta | Obrigatório. Consulta codificada usada para filtrar o conjunto de resultados no seguinte formato: `--query '`\<column_name\>\<operator\>\<value\> ' . |
| tabela | Obrigatório. Nome da tabela na qual os registros serão consultados. |
[ ]

{#query-record__id_b5x_qyf_m4b}

## Exemplo

    $ snc record query --displayvalue --fields short_description,state --query '123TEXTQUERY321=email' --table incident

A CLI retorna todos os registros que correspondem à consulta.  

    {
       "result": [
          {
             "short_description": "Unable to connect to email",
             "state": "Closed"
          }
       ]
    }