Saltar para o conteúdo principal
Versão: Próximo

Obter informação do servidor

Pode obter várias informações do servidor REST:

  • os bancos expostos e seus atributos
  • os conteúdos de cache do servidor REST, incluindo sessões de usuário.

Use the $catalog, $catalog/\{dataClass\}, or $catalog/$all parameters to get the list of exposed dataclasses and their attributes.

Para obter a coleção de todas as classes de dados expostas junto com seus atributos:

GET /rest/$catalog/$all

Informação de Cache​

Use the $info parameter to get information about the entity selections currently stored in 4D Server's cache as well as running user sessions.

queryPath e queryPlan​

Las selecciones de entidades generadas a través de búsquedas pueden tener las dos propiedades siguientes: queryPlan y queryPath. To calculate and return these properties, you just need to add $queryPlan and/or $queryPath in the REST request.

Por exemplo:

GET /rest/People/$filter="employer.name=acme AND lastName=Jones"&$queryplan=true&$querypath=true

Essas propriedades são objetos que contém informação sobre como o servidor realiza pesquisas compostas internamente através de dataclasses e relações:

  • queryPlan: objeto que contiene la descripción detallada de la petición justo antes de ser ejecutada (es decir, la consulta planificada).
  • queryPath: objeto que contiene la descripción detallada de la consulta tal y como se ha realizado realmente.

A informação registrada inclui o tipo de pesquisa (indexada e sequencial) e cada subpesquisa necessária junto com operações de conjunção. As rotas de acesso das petições também contém o número de entidades encontradas e o tempo necessário para executar cada critério de pesquisa. As rotas de acesso das petições também contém o número de entidades encontradas e o tempo necessário para executar cada critério de pesquisa. Geralmente a descrição do plano de pesquisa e sua rota são idênticas, mas podem diferir porque 4D pode implementar otimizações dinâmicas quando uma pesquisa for executada para melhorar desempenho. Por exemplo, o motor 4D pode converter dinamicamente uma consulta indexada em uma consulta sequencial se estimar que seja mais rápido. Esse caso particular pode acontecer quando o número de entidades sendo pesquisada é baixo.