Correspondea um tipo de consulta do CMDB que consulta a infraestrutura em busca de classes de IC e, opcionalmente, tabelas não CMDB, bem como relacionamentos e referências que os conectam.
Antes de Iniciar
Função necessária: cmdb_query_builder_read para exibir e executar somente consultas salvas, e cmdb_query_builder (contida para itil, itil_admin e asset) para criar e salvar consultas, modificar consultas salvas e executar consultas. Para emitir relatórios sobre consultas, são necessárias ACLs relacionadas ao relatório.
Usuários autorizados podem atualizar e excluir uma consulta criada por outro usuário.
Por Que e Quando Desempenhar Esta Tarefa
Para criar a consulta, arraste as classes de IC e as tabelas não CMDB que você deseja incluir na consulta. Em seguida, solte-as como nó na tela e defina as propriedades de relacionamento entre elas. É possível filtrar os atributos de qualquer nó para restringir os resultados a um conjunto específico de ICs dessa classe ou a um único IC específico. Você também pode selecionar quais colunas de propriedade devem ser exibidas nos resultados da consulta.
À medida que você avança na criação de uma consulta, as opções de lista e outros elementos da interface do usuário do Construtor de consulta do CMDB são filtrados de forma dinâmica, conforme apropriado para as suas seleções.
Para saber mais sobre como usar o Construtor de consulta, consulte o vídeo Consultas e emissão de relatórios do Construtor de consulta do CMDB — Análise da plataforma Academy Comunidade ServiceNow. Para obter uma orientação passo a passo sobre como criar consultas do CMDB no Construtor de consulta do CMDB, inclusive consultas que integram serviços de aplicações, consulte Consultas de exemplo.
Procedimento
-
Navegar até e selecione Construtor de consulta do CMDB .
-
Na página do Construtor de consulta do CMDB, execute uma das etapas a seguir:
- Selecione Criar novo. Digite um Nome, escolha Consulta do CMDB como o Tipo de consulta e selecione Criar.
- Selecione um widget de uma consulta salva para continuar criando uma consulta existente. Como pesquisar uma consulta salva primeiro, se necessário.
- Aponte para o canto superior direito de um widget de consulta salva e selecione o ícone Duplicar consulta para editar a cópia de uma consulta salva. O nome padrão da nova consulta contém a "cópia" da cadeia de caracteres.
-
Na tela, é possível executar qualquer uma das seguintes operações:
- Adicione classes de IC à consulta: na guia Classes do CMDB, selecione classes na lista de hierarquia e arraste-as para a tela.
Adicionar um IC de serviço de aplicativos à consulta: na guia Classes do CMDB, selecione a classe do Serviço de aplicações na lista de hierarquia e arraste-a para a tela.
Em Propriedades do serviço de aplicativos na barra lateral direita, é possível selecionar Converter nós anexados ao padrão para consultar padrões entre o serviço de aplicativos e outros nós de classe do CMDB. Ao consultar em um padrão, os nós em ambas as extremidades da conexão do padrão podem ser qualquer número de níveis separados. Se Converter nós anexados em padrão não estiver selecionado, a conexão entre o nó serviço de aplicativos e outros nós de classe do CMDB representará relacionamentos diretos.
- Adicione tabelas não CMDB à consulta: selecione uma tabela na lista Tabelas não CMDB e arraste-a para a tela.
Nota: Uma tabela não CMDB não pode ser o nó inicial da consulta.
Adicione conexões (relacionamentos ou padrões de serviços de aplicações) entre dois nós na tela:
- No primeiro nó da conexão, selecione o pequeno quadrado no centro do lado direito.
- No segundo nó da conexão, selecione o pequeno quadrado no centro do lado esquerdo para criar a conexão.
Tabela 1. Notações de IU de conexão
| Notação |
Descrição |
| Linha inteira |
Um relacionamento em uma consulta do CMDB. |
| Asterisco vermelho no centro da linha de conexão |
Informações como tipo de relacionamento estão ausentes, o que invalida a consulta. |
| Notação Levels:<n> Types:<n ou uma notação <Reference type>> na linha de conexão |
Conforme aplicável: o número de níveis de relacionamento e o número de tipos de relacionamento incluídos na conexão. Ou um tipo de referência de um relacionamento que é considerado uma referência. |
| Linha tracejada |
Uma conexão de padrão entre um nó serviço de aplicativos e outro nó. |
- Em Propriedades da conexão na barra lateral direita, defina as configurações de relacionamento (selecione a linha de conexão se necessário):
- Na seção Direção do relacionamento, selecione o nó Primário (o nó Secundário se ajusta automaticamente).
- Na seção Níveis de relacionamento, defina Nível como Relacionamentos de primeiro nível se os ICs estiverem diretamente conectados. Ou Relacionamentos até o segundo nível se os ICs estiverem conectados direta ou indiretamente a outro IC.
Na seção Tipos de relacionamento e Itens relacionados, selecione uma destas opções:
| Opção |
Descrição |
| Nenhum relacionamento |
Para consultar ICs sem relacionamentos de conexão, como Todos os ICs do Tomcat WAR não conectados a um servidor Windows. |
| Adicionar Tipos de relacionamentos |
Para selecionar um tipo de relacionamento específico ou qualquer outro tipo. |
| Adicionar um Item relacionado |
Para consultar ICs relacionados entre os nós. |
- Configure a coluna de referência de IC para estabelecer conexão com uma tabela não CMDB: na barra lateral direita Propriedades da conexão, na seção Coluna de referência de IC, selecione a coluna com uma referência a um IC na lista Usar coluna de referência de IC. Se houver apenas uma opção disponível, ela será selecionada automaticamente.
- Configure o padrão entre um nó serviço de aplicativos definido com a opção Converter nós anexados em padrão e um nó tabela não CMDB: selecione Aplicar <table> filtro de referência a todos os nós no padrão para aplicar a consulta ao próprio IC de serviço de aplicativos e aos ICs no serviço de aplicativos.
- Adicione filtros a um nó classe: aplique filtros para restringir uma consulta de classe a um conjunto específico de ICs ou a um único IC específico.
- Aponte para o nó ao qual adicionar um filtro e selecione o ícone Aplicar filtros que aparece acima do nó.
- Na seção Filtros, adicione o atributo e as condições da lista relacionada.
- Feche a seção Filtros.
Por exemplo: adicione um filtro de localização de banco de dados para consultar bancos de dados localizados em Seattle.
Selecione Filtros aplicados na barra lateral direita para exibir todos os filtros de cada nó na tela.
- Adicionar operadores E/OU à consulta:
- Conecte um nó a dois outros nós.
- Selecione a caixa E que aparece na linha de conexão para alternar entre os operadores E/Ou.
Por exemplo: C1 é Tomcat WAR, C2 é Servidor Linux e C3 é Servidor Windows. Consulte
Todos os ICs do Tomcat WAR conectados ao servidor Linux ou a um servidor Windows.
- Adicione colunas de propriedade de um nó que deverão ser exibidas nos resultados da consulta:
Nota: Em um relacionamento, os resultados da consulta incluem as colunas parent, child e type. Não é possível adicionar outras colunas da tabela [cmdb_rel_ci].
- Selecione Propriedades no painel lateral direito.
- Selecione um nó uma ou duas vezes para que a seção Colunas do relatório seja exibida na barra lateral direita e selecione Adicionar colunas.
- Selecione as propriedades e clique fora da lista de propriedades para fechá-la.
- Crie uma consulta de combinação integrando uma consulta do Mapeamento de serviços em uma consulta do CMDB:
- Ao criar uma consulta do CMDB, selecione Consultas de serviço salvas na barra lateral esquerda.
- Selecione e arraste uma consulta do Mapeamento de serviços para a tela.
Essa consulta retorna todos os ICs que atendem à consulta do CMDB e que estão incluídos nos serviços retornados pela consulta incorporada do
Mapeamento de serviços.
- Adicionar um marcador de pesquisa que pode ser usado como critério de pesquisa para consultas salvas:
- Selecione o ícone Adicionar marcadores na parte superior da tela.
- Selecione Adicionar marcador e, na caixa de diálogo Marcadores de consulta, insira uma ou mais cadeias de caracteres de marcador.
- Selecione o ícone Adicionar marcadores novamente para fechar a caixa de diálogo Marcadores de consulta.
-
Selecione Salvar.
Na guia Consultas salvas, aponte para um widget de consulta salva e selecione Informações da consulta. Detalhes da consulta, como tipo de consulta, data do último upgrade, grupos do CMDB associados à consulta e cronogramas de consulta, são exibidos.
O que Fazer Depois
Selecione Executar.
Somente os 100 primeiros resultados da consulta são exibidos no painel de resultados.
- Selecione Carregar mais resultados para exibir o próximo conjunto de 100 resultados.
- Selecione Carregar todos os resultados para exibir o restante dos resultados da consulta, até o número especificado pela propriedade de sistema glide.cmdb.query.max_results_limit (10.000 por padrão).
Selecione um IC para abrir o formulário de IC e, no formulário de IC, selecione Abrir no Espaço do CMDB para exibir a integridade do IC no bloco Integridade do IC no Espaço do CMDB. Esta operação requer a função sn_cmdb_user (usuário do CMDB).
Nota:
- Verifique se a propriedade glide.security.use_csrf_token está definida como verdadeiro, permitindo a exibição de todos os resultados.
- Quando Nível estiver definido como Relacionamentos até o segundo nível, o tipo de relacionamento não será exibido nos resultados da consulta.
- Quando uma consulta estiver em execução, aguarde a conclusão ou o tempo limite antes de abrir ou executar outra consulta.
- Modificar configurações do Construtor de consulta: selecione o ícone
(Configurações) para abrir a caixa de diálogo Configurações do Construtor de consulta.
- Copie e compartilhe o URL de uma consulta salva com usuários que tenham acesso ao Construtor de consulta do CMDB. Colar o URL compartilhado em uma nova janela do navegador da Internet abre diretamente a consulta salva no Construtor de consulta do CMDB.
- Criação de um relatório no Construtor de consulta do CMDB.
- Crie uma programação para executar a consulta no futuro e enviar os resultados por e-mail às partes interessadas.
- Exporte os resultados da consulta:
Selecione o menu de contexto Resultados da consulta e selecione Exportar. Mesmo se o botão Carregar mais resultados estiver visível, indicando a existência de resultados adicionais da consulta, somente os resultados visíveis serão exportados.
- Exportar e importar uma consulta do CMDB para transmitir uma definição de consulta entre instâncias.
- Preencha um grupo do CMDB usando uma consulta salva.
- Excluir consultas do CMDB.