Saltar para o conteúdo principal
Versão: 19

$querypath

Retorna a consulta como foi executada pelo 4D Server (por exemplo, $querypath=true)

Descrição

$querypath retorna a consulta como foi executada pelo 4D Server. Se, por exemplo, uma parte da consulta passada não devolver nenhuma entidade, o resto da consulta não é executada. A consulta solicitada é optimizada, como se pode ver em $querypath.

Para mais informações sobre os caminhos de consulta, consultar queryPlan e queryPath.

Na coleção de etapas, existe um objeto com as seguintes propriedades que definem a consulta executada:

PropriedadeTipoDescrição
descriptionStringConsulta executada ou "AND" quando existem várias etapas
timeNumberNúmero de milissegundos necessários para executar a consulta
recordsfoundsNumberNúmero de registos encontrados
stepsCollectionUma coleção com um objeto que define a etapa subsequente do caminho da consulta

Exemplo

Se passou a seguinte consulta:

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

E não foram encontradas entidades, seria devolvido o seguinte caminho de consulta, se escrever o seguinte:

GET /rest/$querypath

Resposta:

__queryPath: {

steps: [
{
description: "AND",
time: 0,
recordsfounds: 0,
steps: [
{
description: "Join on Table : Company : People.employer = Company.ID",
time: 0,
recordsfounds: 0,
steps: [
{
steps: [
{
description: "Company.name = acme",
time: 0,
recordsfounds: 0
}
]
}
]
}
]
}
]

}

Se, por outro lado, a primeira consulta devolver mais do que uma entidade, será executada a segunda. Se executarmos a seguinte consulta:

GET /rest/Employee/$filter="employer.name=a* AND lastName!=smith"&$querypath=true

Se pelo menos uma entidade for encontrada, será devolvido o seguinte caminho de consulta, se escrever o seguinte:

GET /rest/$querypath

Respose:

"__queryPath": {
"steps": [
{
"description": "AND",
"time": 1,
"recordsfounds": 4,
"steps": [
{
"description": "Join on Table : Company : Employee.employer = Company.ID",
"time": 1,
"recordsfounds": 4,
"steps": [
{
"steps": [
{
"description": "Company.name LIKE a*",
"time": 0,
"recordsfounds": 2
}
]
}
]
},
{
"description": "Employee.lastName # smith",
"time": 0,
"recordsfounds": 4
}
]
}
]
}