> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/pt/analises/query-builder-reference.md). # Referência do Construtor de Consulta O Construtor de Consulta define uma subconsulta do GeoDin como um conjunto de definições individuais de nós — lista de tabelas, cláusula FROM, condições, campos de resultado e de apresentação — que o GeoDin combina numa instrução SQL completa. Esta Página é a referência para cada nó nessa definição: o que configura e a sintaxe que aceita. Usa-a quando estiver a criar ou editar uma consulta e precisar de saber o que faz um nó específico. Também abrange as Consulta do sistema — o que são, a Pasta QUERYDEF e os nós de consulta do sistema (requerimentos, condições de apresentação e opções de apresentação). *** ## Trabalhar com Consulta do sistema As Consulta do sistema contêm as definições para consultas de banco de dados e são armazenadas nos seus próprios ficheiros com a extensão `.GSQ` (Consulta do sistema GeoDin). Uma definição de consulta normalmente não é específica de um único sistema de banco de dados, pelo que pode ser transmitida a outros utilizadores. Ao contrário das consultas de utilizador, que pertencem a um único banco de dados ou projeto, as Consulta do sistema estão automaticamente disponíveis para todos os utilizadores em todos os bancos de dados e projetos — nunca têm de ser recriadas por banco de dados. Normalmente, conseguem-se três coisas com elas: * **Definir uma consulta uma vez e tê-la em todo o lado.** Se forem regularmente solicitados resultados semelhantes a vários bancos de dados, a consulta não precisa de ser reconstruída para cada um. Definida como uma consulta do sistema, é adicionada automaticamente a cada banco de dados como um novo ramo no gestor de objetos do GeoDin, e as condições da consulta adaptam onde e como é apresentada. * **Ampliar ou reestruturar o gestor de objetos.** A estrutura padrão do gestor de objetos é definida pelo GeoDin: objetos num ramo, pontos de medição noutro. Uma consulta do sistema pode alterar isso — por exemplo, mostrando as amostras pertencentes a um furo diretamente sob esse furo, em vez de apenas na separada **Pontos de medição** ramo. * **Forneça modelos de Consulta para utilizadores menos experientes.** Consultas muito complexas geralmente unem muitas Tabelas GeoDin através de campos de ligação como `PRJ_ID`, `LOCID` E `INVID`, que exige um bom conhecimento da Estrutura da tabela. O assistente de consulta oferece as junções mais comuns, mas não todas as possíveis. Uma Consulta do sistema fecha essa lacuna ao fornecer a junção como um modelo pronto a usar, para que o Utilizador só tenha de fornecer Condições e campos de exibição. ### A Pasta QUERYDEF Consulta do sistema são armazenadas no `QUERYDEF` Pasta da Instalação GeoDin, um ficheiro por consulta. O Método **Nova consulta** cria aí um novo ficheiro com o nome que introduzir. Se uma estrutura de Pasta for criado dentro `QUERYDEF`, a mesma estrutura aparece no gestor de objeto do GeoDin, que é como uma coleção Maior de Consultas é dada uma ordem lógica. O GeoDin em si não tem Método para criar essas sub-pastas - Usa o Windows Explorer. Ficheiros de Consulta que já não são necessários são eliminados da mesma forma. Depois de reestruturar a Pasta no Explorador do Windows, clique com o botão direito no **Consultas** ramo No separador Sistema e escolha **Atualizar** para atualizar a vista do gestor de objetos. Reiniciar o GeoDin não é necessário para detetar uma nova estrutura de Pasta ou novos ficheiros de Consulta. ## Referência: nós do Construtor de Consultas Cada subseção abaixo documenta um nó da definição da Subconsulta, pela ordem em que aparecem no construtor. ### Tabelas A Lista de Tabelas de uma Subconsulta contém todos os identificadores de Tabelas ou Visualizações usados na Consulta. Estes são os nomes de Tabelas/Visualizações no Banco de dados que são referenciados na instrução FROM. O objetivo desta lista é fazer quaisquer adições de esquema necessárias a estes nomes antes de a instrução SQL ser executada. Como a instrução FROM pode conter qualquer sintaxe SQL (incluindo sintaxe específica da base de dados), o GeoDin não avaliará esta string para determinar quais os nomes das Tabelas devem ser estendidos com um nome de esquema. Em vez disso, a Lista de Tabelas definida aqui diz ao GeoDin quais nomes Incluir na instrução FROM e nas outras partes da Configuração da Consulta. Todos os nomes especificados aqui são automaticamente estendidos com o nome do esquema da Configuração da Conexão de bancos de dados do GeoDin. **Exemplo:** Todas as Tabelas do GeoDin são criadas pelo Utilizador dbo (proprietário da base de dados) do Banco de dados. Portanto, todas as Tabelas só podem ser acedidas por outros Utilizadores se o esquema estiver listado e o Nome da tabela cheia for usado: dbo.GeoDin\_LOC\_LOCREG Para evitar ter de especificar a substituição do esquema para cada Tabela, é possível armazenar o esquema das Tabelas do GeoDin na Configuração da Conexão de bancos de dados **Configuração** para Bancos de dados do Utilizador. ***Aviso:*** *Os nomes de alias dados na instrução FROM (por exemplo, para sub-consultas) podem não ser incluídos aqui. Caso contrário, a extensão do esquema será adicionada ao alias e a instrução falhará.* ### Consultas do sistema (Consulta do sistema) ao Nível de Projeto: (GeoDin 10 e Posterior) Desde a alteração da estrutura do GeoDin 10, uma Consulta do sistema que deve ser apresentada ao Nível de Projeto: deve Incluir a Tabela de Registo de típos de objetos `GEODIN_LOC_LOCREG` - Adicionar à Lista de Tabela e à cláusula FROM da Consulta. {% hint style="warning" %} Se a Tabela de Registo de típos de objetos for omitida de uma Consulta do sistema ao Nível de Projeto:, a execução da Consulta retorna um dos seguintes Erros, dependendo do sistema de Banco de dados: * Banco de dados Microsoft Access: `[FireDAC][...] Parâmetro insuficiente. Esperado 1.` * Banco de dados Cliente/Servidor: `[FireDAC][...] Nome de Coluna Inválido 'ProjectGUID'. (Projeto:)` {% endhint %} ### Configuração Na Configuração, as configurações da Consulta são feitas, com base sobre (em) a Base de dados usada para a Consulta. A Configuração abrange: 1. a instrução FROM Para a [Link (DE)](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md) nó para o Comando SQL 2. e outros critérios [Campos de restrição](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md) para a restrição Automático (WHERE) da Consulta, dependendo sobre (em) a Posição da Consulta incluido no gerenciador de objetos GeoDin 3. Definição da Informação requerido para o processamento do Resultado da consulta [Campos de resultados](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md) Para a Entrada ***Sub-Consultas*** é possível ver a Consulta clicando em "SQL Antevisão" Para a Subconsulta desejada. ***Aviso:*** *A instrução SQL exibida incluido na Antevisão pode ser testada diretamente incluido no Banco de dados após substituir o Projeto: Código único (ID) ($PRJID), a Localização-Código único (ID) ($LOCID) ou o INVID ($INVID)* **Opcões adicionais:** 1. \*-\*DISTINCT por Execução da Consulta incluido no GeoDin objeto Manager- Defina se um comando SELECT DISTINCT ... deve ser executado incluido na consulta ou apenas um comando SELECT. Em ambos os casos, o GeoDin exibe um objeto que está disponível mais de uma vez incluido em uma consulta apenas uma vez no gerenciador de objetos. Isso é feito por uma verificação dos ID's do objeto. Um DISTINCT geral não é usado como padrão, porque o uso desse comando depende do projeto da consulta. Se você tiver certeza de que seu Comando SQL permite um distinct, esta opção pode acelerar significativamente a consulta. 1. -Ignorar erro da execução- Se a consulta levar a um Erro, por Padrão, uma Anotação de Erro é exibida. Você pode ocultar a Anotação de Erro usando esta opção. Se a execução da consulta levar a um Erro dessa forma, o Erro é ignorado e a consulta não é inserida no gerenciador de objetos. Você pode usar esta opção se quiser criar uma consulta que não possa ser usada em nenhum tipo de Banco de dados e quiser ignorar esse Erro. O recomendado é que, em vez de usar esta opção, a Configuração do **Requerimentos** são usados para uma Consulta, porque é Sempre mais rápido controlar os Requerimentos do que correr ao/à Erro incluido numa Consulta. 1. -Usa DISTINCT para Exportar Formato- Se a Consulta for usada para Criar um Ficheiro de Formato, você pode Selecionar aqui se um comando Selecionar DISTINCT ou um comando "simple" Selecionar deve ser usado para que se realize o Exportar do Formato. ### Condição Esta Seção da definição de Consulta do sistema pode ser usada opcionalmente para limitar os Resultados da Consulta. Esta Seção é comparável à instrução WHERE de uma Consulta SQL e é adicionada automaticamente à Consulta ao Banco de dados. Adicionar, incluido na Lista, uma ou mais entradas para Editar. ### OU **¯¯¯** Esta Seção de Consulta do sistema pode ser usada ao/à restringir os Resultados da Consulta. Ela é equivalente ao/à restrição WHERE de uma Consulta SQL e será adicionada automaticamente ao/à Consulta do Banco de dados. Operadores lógicos possíveis são E e OU relações que podem ser ordenadas incluido em dois Níveis. No primeiro (a) Nível, sub-Consultas conectadas são vinculadas com um OU. A Condição primeiro (a) aparece com a palavra-chave Se e marca o início das Condições. No primeiro (a) passo, está portanto definido: <\> OU <\> OU <\> ... Para o Segundo Nível, as Condições singulares são os critérios "Verdadeiro" da Consulta, onde operadores E podem ser usados. **Exemplos para Condições** Exemplo usando as Coordenadas de um Ponto de monitorização (Operador OU): A Consulta deverá encontrar todos os Pontos de medição em que ou a Coordenada X (XCOORD) é superior a 100 ou a Coordenada Y é superior a 50. As Condições seriam: ``` Se XCOORD \> 100 OU YCOORD \> 50 ``` O exemplo pode ser estendido para demonstrar o Procurar a Objetos com as suas Coordenadas (Relação OU e E). A Consulta encontra todos os Pontos de medição com Coordenadas X superiores a 100 e inferiores a 200 ou com Coordenadas Y superiores a 50 e inferiores a 100: ``` Se XCOORD \> 100 XCOORD \< 200 OU XCOORD \> 50 YCOORD \< 100 ``` Se as Condições para Ambos os conjuntos das Coordenadas X e das Coordenadas Y tiverem de corresponder, as Condições são introduzidas no Segundo Nível (E) da Consulta: ``` Se XCOORD \> 100 XCOORD \< 200 YCOORD \> 50 YCOORD \< 100 ``` ### E Para o Nível de Condições, diferentes condições de Procurar a têm ao/à ser definidas. Aqui, as Condições são definidas ou como Condições singulares, ou como uma combinação com E lógico. É possível combinar grupos de Condições entre si por um lógico [OU](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md). **Configurando as Condições** No campo Nome do campo de dados, o nome do campo do Campo de dados tem de ser definido, que será usado para a Consulta. O Nome do campo é fornecido no formato \.\. No campo "condição", a condição desejada pode ser definida diretamente ou pode ser usada uma condição parametrizada. Se definida diretamente, a CONDIÇÃO é expressa como uma expressão lógica com um operador relacional e um valor. Operadores relacionais possíveis: \> maior que \=> maior ou igual ao/à < menor que <= menor ou igual \= igual a <> não igual a está nulo, Campo de dados está Vazio não está nulo, Campo de dados não está Vazio como 'A%' Conteúdo(s) incluido em aspas altas usando curingas na cadeia de caracteres: \_ um caractere ou % vários caracteres incluido ('T1','T2') Lista de Valores em parênteses Arredondar, Valores separados por vírgulas, os campos de texto têm Valores em aspas altas, campo numérico tem Valores usando Ponto decimal (não uma vírgula) e não incluido em aspas altas **Condições** essa Consulta a **Data** : por favor verifique seu banco de dados para a formatação correta: Os seguintes Texto padrão Formatos estão Disponível: Acesso #MM/DD/AAAA# Oracle 'DD-MM-YYYY' MySQL, MS SQL, PostgreSQL 'DD.MM.YYYY' **Condições** essa Consulta a **Data/Hora(Data/Tempo)**: por favor, usa os seguintes formatos padrão: Acesso: #MM/DD/YYYY HH:MM:SS# Oracle: AO/À\_DATA('*31.05.2015 12:24:36'*,'dd.mm.yyyy hh24:mi:ss') MySQL, MS SQL, PostgreSQL: 'DD.MM.AAAA HH:MM:SS' Se Consultas parametrizadas forem usadas, uma janela é aberta quando a Consulta é executada pela primeiro (a) vez. todos as Condições marcadas como parametrizadas podem ser introduzidas e alteradas incluido nesta janela. ***Aviso:*** *O Usa de uma Condição parametrizada é indicado pelos caracteres ":?". Opcionalmente, um Operador de comparação pode ser especificado antes desta cadeia de caracteres. incluido neste caso, este Operador é pré-preenchido quando os Parâmetro são consultados.* Se uma Consultas parametrizadas for usada, as diferentes Configurações gerais necessárias ficam Disponível. O Parâmetro pode ser marcado como requerido - Se ele não for requerido, o Parâmetro será ignorado quando estiver Vazio. Também é possível introduzir um Valor estandard e ao/à Usa um intervalo. A opção -Utilizar interval- produz um tipo especial de Condição. Se você quiser selecionar objetos em uma Área definida ao redor de um selecionado coordenada, a seguinte condição é possível: 1. Nome do Campo de dados: GeoDin\_LOC\_LOCREG.XCOORD 2. Condição: >=:? 3. x utilizar intervalo 4. 100 Quando a Consulta é executada, uma janela de entrada é exibida mostrando a coordenada X selecionado (Easting), a Distância (Padrão 100) a ser inserida. A seguinte Condição WHERE é adicionada automaticamente à instrução SQL: ... (GeoDin\_LOC\_LOCREG.XCOORD >= C*coordenar*-100) E (GeoDin\_LOC\_LOCREG.XCOORD <= C\*oordinate+\*100) Se você Selecionar uma Segundo Condição para o Campo de dados GeoDin\_LOC\_LOCREG.YCOORD (Northing), Objetos podem ser selecionado a partir de um Rectângulo dado em torno da Localização selecionado ao introduzir 3 números em vez de introduzir os cantos do Rectângulo. **Usando o Parâmetro $%SYSDATE$** Você pode usar $%SYSDATE$ como marcador de posição para o Parâmetro de Data, para selecionar a data atual como Valor estandard. Também são possíveis termos matemáticos com a macro $%SYSDATE$, por exemplo, $%SYSDATE$-7 para selecionar o mesmo dia uma Semana atrás. ### Campos de visualização Os campos de exibição definem quais campos do Banco de dados de um objeto devem ser mostrados incluido no GeoDin objeto Manager (GOM). Os Objetos e os Conteúdo(s) exibidos são, na verdade, os Resultados de uma Consulta - normalmente este é o Nome de um objeto ou "LONGNAME". No entanto, é possível combinar campos para uma exibição mais detalhada, como Nome e Típo de Furo. Você pode organizar quais e quantos campos devem ser exibidos ao/à [Campo de display](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md). Há instruções opcionais de formatação ao exibir o Texto. incluido no campo de Entrada, você pode definir a macro que é aplicada aos Resultados da Consulta SQL. Se Não existir nenhuma macro definida, os Registos de dados serão mostrados tal como existem incluido o Banco de dados. Isto significa, por exemplo, que os códigos não serão re-traduzidos Para atrás ao Texto cheia, mas mostrados como códigos. A macro só pode conter referências a campos de exibição definidos. Assim, a macro não substitui campos de exibição, mas complementa-os e formata-os. Selecionar DISTINCT GeoDin\_LOC\_LOCREG.LOCID, GeoDin\_LOC\_ZMGENINF.SHORTNAME, GeoDin\_LOC\_ ZMGENINF.PURPOSE .... As macros de Texto são implementadas exatamente da mesma forma que num template, daí a Área de Opcões de formatação Disponível. **Exemplo:** $GeoDin\_LOC\_ ZMGENINF. NOME CURTO $ ($GeoDin\_LOC\_ZMGENINF.FINALIDADE $) Ao usar um Texto macro, deve ser definido, adicionalmente, um outro macro que é usado quando o macro é atualizado no GOM. Isso ocorre sempre que Dados gerais são editados e guardados. Neste momento, o objeto carregado é usado para resolver o macro. A consulta inicial nem o registo de dados que fornece a Entrada no GOM, uma vez que isso não é necessário e só usaria memória desnecessariamente. O macro para a Atualizar deve ser criado como num modelo com referências de campo ao objeto. Normalmente, os nomes das tabelas precedentes são omitidos. ### Campos de ordenação Aqui, Campos de dados adicionalmente podem ser selecionado como Criterios de classificação adicionalmente para os Resultados da Consulta (ou seja, independente dos campos exibidos). Um campo de ordenação é definido usando \.\. Um comando ORDER BY é automaticamente adicionado ao/à instrução SQL ao usar os Campos de ordenação. adicionalmente você pode definir, Se a ordenação é usada para Execução incluido no gerenciador de objeto OU incluido em um Selecionar layout. ### Campos de resultados Os Campos de resultados são adicionados à lista de Campos de dados da instrução Selecionar e definem a estrutura dos dados de resultado. Um Campo de resultado é definido por \.\. **O que os Campos de resultados têm de conter** Quais identificadores e Coordenadas o GeoDin precisa do Resultado depende da finalidade para a qual a Consulta é usada. A mesma Consulta é executada de forma diferente quando 1. seu nó Resultado é adicionado ao gerenciador de objeto, 2. é usado para um Exportar de Formato OU incluido na Extensão ArcGIS, OU 3. ele fornece dados para um Relatório. Para o primeiro (a) caso, os Campos de resultados só têm de conter os IDs do objeto GeoDin; as Coordenadas não são relevantes. Muitas Operação executiva GIS, por outro lado, Usa os Campos de dados para as Coordenadas X e Y (ao/à`XCOORD` E `YCOORD`) juntamente com um Campo de dados que contém um ID objeto exclusivo - normalmente o `INVID` de um objeto. Porque uma Consulta Maio pode fornecer Endereço para uma Tabela Arbitrário no Banco de dados, incluindo Tabelas não-GeoDin, esse Código único (ID) do objeto pode vir de outra Tabela e não precisa ser o `INVID`. Quais campos identificadores são esperados também depende do tipo de objeto de resultado, que é selecionado na consulta do sistema: | Resultado Típo de objeto | Campos de identificador esperados | | ----------------------------- | ----------------------------------------------------------------------------------------- | | objeto (Vermelho) | um campo com o Projeto: Código único (ID) (`PRJ_ID`) e um campo com o ID objeto (`LOCID`) | | Ponto de monitorização (Azul) | um campo com o Código único (ID) do Ponto de monitorização (`INVID`) | As Colunas originais podem ter nomes diferentes. Tal como as outras Colunas de identificação, são fornecidas no Formato incluido `.` e têm de estar Disponível como uma Coluna incluido no Resultado da Consulta. {% hint style="success" %} Quando possível, faça o Preenchimento de todos os campos, incluido os campos em branco. Uma definição de Resultado que carrega Ambos os identificadores E as Coordenadas permite que a mesma Consulta sirva para todos os propósitos — gerente de objeto, Formato e Exportar do ArcGIS, e Relatório — em vez de apenas um. {% endhint %} ### Subconsulta Uma Subconsulta é uma consulta independente sobre (em) o Banco de dados (uma instrução SQL), que fornece uma quantidade de resultados. A instrução SQL é não definido como uma instrução completa, mas por meio de várias definições individuais. Em campos de entrada separados, certos fragmentos da consulta são definidos, os quais são combinados ao/à uma instrução SQL completa pelo GeoDin. O motivo disso é uma série de partes variáveis da instrução SQL; por exemplo, a lista de campos incluido SELECT, que será criado incluido GeoDin de acordo com o uso designado. Esta é a única forma ao/à atingir uma consulta optimizada (orientada ao objetivo) incluido o Banco de dados, que difere bastante; por exemplo, ao executar a consulta incluido o gerenciador de objetos do GeoDin, em vez de executar a mesma consulta para a recuperação de dados incluido um layout. **Nome** Aqui, um Nome para a Subconsulta pode ser inserido. **Descrição do template** Introduza aqui uma breve Denominação da Consulta. A Denominação é apresentada no assistente de Consulta, Se a Consulta estiver definida como um modelo para Consultas do Utilizador (veja [Trabalhar com Consulta do sistema](#working-with-system-queries)) **Conectar condições com OU/E** Esta opção controla a combinação de condições singulares da Consulta. Dependendo sobre (em) a Consulta com várias condições, o *"OU"* Conexão incluido o nó principal (Condição 1 e Condição 2) ou (Condição 1 e Condição 3) pode ser melhor substituído por um *"E"* Conexão incluido o nó principal (Condição 1) e (Condição 2 ou Condição 3). **Previsualização SQL** Aqui, o Comando SQL é exibido com base na Configuração atual da Consulta. **Tipo de consulta de uma Consulta da moldura de objeto** Ao editar uma [Consulta da moldura de objeto](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts/object-frames.md#object-frame-queries) você pode escolher entre definir um Modelo estruturado ou uma instrução SQL completa. Uma instrução SQL permite todas as possibilidades de escolha / seleção de dados (por exemplo, Selecionar Contagem(Datafield) AS GCCOUNT FROM Tabela), mas provavelmente não é executável em todos os tipos de Banco de dados. Em geral, um Modelo estruturado é preferível. ### Link (DE) O Link é a cláusula FROM de uma instrução SQL. A Informação pode ser coletada de uma Tabela OU de um conjunto de Tabelas, conforme definido na Condição FROM. Se apenas uma Tabela estiver selecionado, aqui só o Nome da tabela precisa ser inserido. Para expressões mais complexas, a sintaxe da cláusula FROM tem de seguir as especificações SQL do Sistema de Banco de dados utilizado. A definição OU a estrutura da cláusula FROM pode variar entre diferentes sistemas de Banco de dados devido às especificações da sintaxe SQL específica. ***Dica:*** *Pode ser útil Criar a Consulta, em primeiro (a) lugar, num programa de Banco de dados usando um editor gráfico de Consultas. Depois, a cláusula FROM da instrução pode ser copiada aqui (Exemplo: o editor de Consultas no MS Access)* ### Campos de restrição Os Campos de restrição são usados para definir Campos de dados que o GeoDin adiciona automaticamente à Condição WHERE da Consulta, dependendo da Posição da Consulta no gestor de objetos, a fim de restringir o conjunto de resultados de acordo com a estrutura do gestor de objetos. A base são os [Condições do display](/geodin-desktop/pt/analises/query-builder-reference/conditions-and-operators.md) da Consulta. **Banco de dados, Consultas de banco de dados** As Consultas não são restringidas adicionalmente. Os Campos de restrição podem permanecer Vazio. **Projeto:, Consultas de projetos** As Consultas são restringidas usando o Projeto: Código único (ID). O campo de restrição PRJ\_ID tem de ser preenchido. **objeto** A Consulta é restringida usando o Projeto: Código único (ID) e o ID objeto. Os Campos de restrição PRJ\_ID e LOCID têm de ser preenchidos. **Ponto de monitorização** A consulta é restrita usando o Ponto de monitorização Código único (ID). O campo de restrição INVID tem de ser preenchido. As Colunas têm de ser selecionado no Formato \.\ E têm de estar incluido ao Resultado da Consulta. ### Campo de display Os campos de exibição definem quais campos do Banco de dados são usados para nomear os Resultados da Consulta incluido no gerenciador de objeto GeoDin. Dessa forma, o Nome pode ser composto por vários campos. Um campo de Banco de dados comumente usado é o Nome de objeto LONGNAME. Mas você também Usa nomes combinados como Nome E Profundidade. ``` Banco de dados DemoDB GeoDin Demo Objetos Pontos de medição Projeto: Furo 1 Furo 2 Projeto: 2 Projeto: 3 Objetos Pontos de medição Banco de dados ``` **Nome do campo de dados** Neste campo, o Campo de dados a ser exibido é definido no formato \.\. **Texto da extensão** Os caracteres inseridos aqui são anexados ao Conteúdo do Campo de dados como "texto de extensão". Por exemplo, o Conteúdo de um Campo de display como GeoDin\_LOC\_LOCREG.ZCOORDE (Profundidade final) pode ser complementado com a Unidade de medição, por ex.: " m" ou com versões mais longas, como "incluido m abaixo da Altura do terreno". **Critérios de Ordenar** Selecionar a sequência de ordenação para este Campo de dados. Uma instrução ORDER BY é adicionada automaticamente à instrução SQL. ### Propriedades de portal O **Propriedades de portal** O nó contém as Configurações gerais de que a Consulta precisa quando o seu Selecionar layout é usado como um Layout do portal. Um Layout do portal é um Selecionar layout do GeoDin que contém Pelo menos um Elemento com uma Ligação de portal, isto é, uma instrução ao/à chamar outro Selecionar layout do GeoDin. Selecionar layouts que se chamam uns aos outros vão Construir uma rede completa de apresentações e Relatório - um portal. Um Layout do portal pode ser criado e usado incluido Arbitrário combinação de Módulos do GeoDin; incluido em uma Instalação do Servidor do portal do GeoDin, eles são a interface frontal ligada através da qual o leitor navega as apresentações e os dados incluido em um navegador. Um Texto padrão Gráfico oferece Não função de portal, portanto tem de ser preparado primeiro (a). incluido modo Editar, Selecionar a árvore de objeto do Gráfico - Se estiver incluido dúvida, clique na Área Branco Próximo ao/à dos quadros do objeto - Abrir **Propriedades estendidas** No Propriedades do objeto do Gráfico e ligue sobre (em) a opção **Ativar a função do portal**. Um novo **Propriedades de portal** a ramificação então aparece abaixo das Propriedades estendidas, e os elementos **Texto variável** E **Imagem variável** obter a opção de configurar Ligações de portal. A configuração das próprias ligações é descrita em [Criando plantas da localização](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-site-plans.md). Alternância **Ativar a função do portal** Desligar novamente sobre (em) um layout de portal existente remove as propriedades do portal de todos os elementos afetados do gráfico. As configurações não são perdidas, no entanto - não nem mesmo quando o gráfico é salvo - e podem ser reativadas posteriormente. **Como uma Consulta chamada recebe o ID objeto** Um layout chamado restringe-se a objetos por padrão. O layout de chamada (layout de origem) determina qual Código único (ID) do objeto é passado; o layout chamado (layout de destino) resolve-o através do [Campos de resultados](#result-fields) da sua Consulta de Moldura, que declara qual Coluna da Tabela de Resultado contém `PRJ_ID`, `LOCID` OU `INVID`. `PRJ_ID` E `LOCID` são suficientes para Objetos; Pontos de medição requerem `INVID`. Se essas atribuições estiverem ausentes, a Consulta não pode ser executada e é emitida uma Anotação de Erro. Definir todos os campos quando apenas alguns são necessários não causa problema. Internamente, ao passar um ID objeto, Sempre adiciona uma restrição ao/à declaração do Selecionar layout chamado, construída a partir das entradas incluido nos Campos de resultados. Se a declaração já tiver uma cláusula WHERE, a restrição é adicionada como um construto E. Além dos identificadores do objeto, podem ser passados mais Parâmetro ao/à Consulta no Selecionar layout de destino; eles só produzem efeito onde Condições correspondentes são definidas sobre (em) essa Consulta, e Parâmetro passados sem uma Condição de avaliação Não têm consequência. Um layout de várias Molduras não recebe nenhum ID de objeto de forma alguma - nesse caso, a Consulta da primeiro (a) Moldura fornece os identificadores do objeto. Se a Consulta de Moldura usar uma instrução SQL individual em vez de uma Consulta estruturada, apenas `PRJ_ID`, `LOCID` E `INVID` pode ser passado, e a instrução deve conter o espaço reservado correspondente para que o valor seja avaliado: | Marcador de posição | Passes | | ------------------- | ---------------------------------------------------- | | `%INVID` | os `INVID` (identificador de Ponto de monitorização) | | `%PRJID` | os `PRJ_ID` (identificador do projeto) | | `%LOCID` | os `LOCID` (Índice do objeto) | ### Propriedades do sítio Web Aqui, você define a Resolução:, o Intervalo da atualização e uma cor de Plano de fundo para o site. Você também pode Selecionar um Modelo HTML para o site. **manter Selecionar layout incluido na cache:** quando esta caixa está marcada, o O layout é mantida na cache por um período definido. Dependendo do O layout, isto pode reduzir visivelmente o tempo de resposta do servidor. ### Configurações do cache Aqui você define o número de Minutos pelos quais o O layout é mantido no cache. Se os dados para layouts de monitorização forem atualizados a cada cinco minutos, por exemplo, faz sentido manter o layout incluido na cache por cinco minutos também. Após este tempo, é removido automaticamente e reconectado com dados atualizados sobre (em) a próxima solicitação. ## Referência: nós da Consulta do sistema Uma Consulta do sistema carrega um Segundo Gropo de nós ao lado da definição da Subconsulta acima. Eles não definem o Formato da instrução SQL - eles decidem se a Consulta é executada contra um Banco de dados específico de todo, onde os Resultados aparecem no gerenciador de objeto GeoDin e como esses Resultados são exibidos. ### Requerimentos O **Requerimentos** O nó define as Condições básicas sob as quais a Consulta do sistema é executada em um Banco de dados e adicionada ao gerenciador de objetos. Como uma Consulta usa Tabelas específicas do Banco de dados, essas Tabelas podem não existir em todo lugar: um Banco de dados pode usar o Típo de objeto "Geral Perfil litológico - Britânico Texto padrão" enquanto outro usa diferentes Tipo de objetos, então uma Consulta sobre (em) a Tabela `GEODIN_LOC_BSSRCLAS` criado para o Geral Perfil litológico leva ao/à um Erro incluido no Segundo Banco de dados. Introduza uma Condição por Linha. Cada Linha deve ser cumprida (E); Se um único requisito não corresponder, a Consulta é ignorada para esse Banco de dados. As exceções são `Nome do usuário=` E `Início de sessão da estação de trabalho=` linhas, que são combinadas com OU para que possam ser introduzidas para vários utilizadores diferentes. Dentro de uma Linha, Valores separados por vírgulas são alternativas (OU). | Condição | Verificações | | ----------------------------------------- | ----------------------------------------------------------------------------------------- | | `LOCTYPE=` | O Típo de objeto nomeado está instalado no Banco de dados atual | | `DATTYPE=` | O Típo de dados nomeado está configurado no Banco de dados atual | | `ADOConnectionHas=` | A String de conexão da Conexão de bancos de dados contém a cadeia de caracteres fornecida | | `Nome do usuário=` | O nome de login do Banco de dados do Utilizador atual Acerto | | `WorkstationLogin=` | O nome de início de sessão do Windows do utilizador atual corresponde | **Restringir a um Típo de objeto específico** Os Tipo de objetos instalados são verificados com a variável `LOCTYPE=`. No exemplo a seguir, a consulta só é mostrada se o Típo de objeto "Geral Perfil litológico" for usado no Banco de dados atual: ``` LOCTYPE=BSBORLOG ``` A Designação abreviada do Típo de objeto é apresentada quando o Método **Objeto novo** é usado - tome nota desse nome para o usar aqui. Se forem indicadas várias designações abreviadas separadas por vírgulas, o GeoDin verifica se pelo menos um dos Tipo de objetos existe (OU): ``` LOCTYPE=LOCTYPE1,LOCTYPE2 ``` Se duas ou mais linhas começando com `LOCTYPE=` são fornecidas, o GeoDin verifica se todos os Tipo de objetos estão presentes (E): ``` LOCTYPE=LOCTYPE1 LOCTYPE=LOCTYPE2 ``` **Restringir a um Típo de dados específico** Os Típos de dados definidos no Banco de dados são verificados com o Nome da variável `DATTYPE=`. No exemplo a seguir, a Consulta é exibida apenas Se o Típo de dados "Quimismo da água subterrânea" existir: ``` DATTYPE=WAS ``` Os nomes curtos dos Típos de dados são mostrados nas Propriedades de um Típo de dados No separador Sistema. **Restringir a um Sistema de Banco de dados específico** O Nome da variável `ADOConexãoHas=` restringe a Consulta a um Sistema de Banco de dados específico, o que é útil para Consultas que usam sintaxe SQL Disponível apenas ali, como a sintaxe Oracle. Como uma Conexão de bancos de dados é criada a partir de uma String de conexão, a restrição é expressa como um fragmento dessa String de conexão: ``` ADOConexãoHas=MSAcc ``` Aqui a String de conexão tem de conter a cadeia de caracteres `MSAcc`, o que é Verdadeiro para um Banco de dados MS Access com uma String de conexão como `DriverID=MSAcc;Banco de dados=C:\My Data\GeoDin\DB\Access_DB.accdb`, por isso a Consulta é mostrada apenas para Bancos de dados Microsoft Access. A mesma semântica de vírgula e linha aplica-se como para `LOCTYPE=`. Várias cadeias de caracteres separadas por vírgulas são combinadas com OU: ``` ADOConnectionHas=MSAcc,MSSQL ``` Duas ou mais `ADOConexãoHas=` linhas são combinadas com E, por isso todos os textos devem estar presentes: ``` ADOConexãoHas=MSAcc ADOConnectionHas=MSSQL ``` **Restringir a utilizadores específicos** As Consultas do sistema podem ser restringidas a utilizadores nomeados do Banco de dados. `Nome do usuário=` verifica o Nome de início de sessão do Utilizador incluido no Banco de dados, por isso uma Consulta pode ser tornada acessível apenas a determinadas pessoas: ``` Nome do usuário=Smith ``` Porque isto verifica o login do Banco de dados, não está disponível para Bancos de dados Microsoft Access. `Nome do usuário` As Condições são combinadas com OU, pelo que vários utilizadores podem ser listados. `Início de sessão da estação de trabalho=` verifica, em vez disso, o nome de login do Windows do Utilizador atual, e é igualmente combinado com OU. A Consulta abaixo só é mostrada quando o Utilizador atual do Windows é "Smith" ou "Jones": ``` WorkstationLogin=Smith WorkstationLogin=Jones ``` {% hint style="info" %} Sempre declare do que uma Consulta depende. Para uma Consulta do sistema sobre Objetos, nomeie um Típo de objeto que exista no Banco de dados; se a Consulta usar as Tabelas de um Típo de dados, nomeie esse Típo de dados também. Verificar os Requerimentos é mais rápido do que cair num Erro, por isso esta é a alternativa recomendada ao **Ignorar erro da execução** opção incluido no [Configuração](#configuration) nó. {% endhint %} ### Condições do display O **Condições do display** o nó define onde, no gestor de objeto GeoDin, a Consulta é exibida, e sob que Condições é mostrada de todo. **Consulta abaixo do Típo de objeto** Estas Configurações gerais controlam em que Nível a Consulta aparece: | Nível | Onde a Consulta aparece | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Banco de dados** | Para o ramo principal do Banco de dados, ao mesmo nível que um projeto | | **Consulta do Banco de dados** | Dentro da **Objetos** OU **Pontos de medição** ramo que fica ao mesmo nível que os Projetos, dependendo do Típo de objeto do Resultado da Consulta. Estes ramos podem já conter Consultas entre projetos específicas do Utilizador | | **Projeto:** | No ramo principal de um projeto, ao mesmo nível que os ramos **Objetos** E **Pontos de medição** | | **Consultas de projetos** | Dentro da **Objetos** OU **Pontos de medição** ramificação de um Projeto:, dependendo No Resultado Típo de objeto - o mesmo Lugar que **Todos objetos** e os ramos dos tipos de objetos instalados | | **objeto** | Como um sub-ramo de um único objeto (Vermelho), geralmente representando uma Dependência sobre (em) outros Objetos | | **Ponto de monitorização** | Como um sub-ramo de um único Ponto de monitorização (Azul), representando igualmente uma Dependência estruturalmente | **Limitações de típos de objeto** Para consultas que são inseridas como novos ramos abaixo de um objeto ou ponto de monitorização, este campo limita os tipos de objetos sob os quais o ramo pode ser inserido. Suponha que uma consulta tenha como objetivo listar todas as amostras de um furo abaixo desse furo. O [Requerimentos](#requirements) já indique que a Consulta é apenas para Bancos de dados contendo "Perfil litológico Geral" Perfurações (`LOCTYPE=BSBORLOG`). Se o Banco de dados também contiver outros Objetos - que não têm nenhuma Tabela de Exemplo de Perfil litológico Geral e não retornariam nada - o ramo de Consulta ainda não deve ser oferecido sobre (em) eles. Introduzindo ``` LOCTYPE=BSBORLOG ``` restringe a consulta a objetos desse tipo, pelo que só é mostrado no ramo "Geral Perfil litológico". O campo de entrada Multilinha pode conter vários `LOCTYPE=` entradas; a Consulta é então Válido para todos os Tipo de objetos listados. **Inserir consulta apenas quando Resultados estiverem presentes** Esta opção controla se a Consulta está Sempre Visível no gerenciador de objeto ou apenas quando retorna um Resultado. A Consulta é executada primeiro (a), e Se o conjunto de Resultado estiver Vazio, o ramo da Consulta (pirâmide Amarela) não é adicionado. Isso evita ramos Vazios no gerenciador de objeto. {% hint style="warning" %} Ligue esta opção sobre (em) apenas depois de a Consulta ter sido verificada quanto a Erros de sintaxe e funcionar sem Erro incluido no gerenciador de objeto. Uma Consulta que contém um Erro não retorna Resultados; assim, com esta opção ativa, ela desaparece do gerenciador de objeto mesmo que suas Condições do display sejam atendidas — o que torna o Erro difícil de encontrar. {% endhint %} **Ordem de classificação incluido no gestor de objeto GeoDin** As Consultas são exibidas em ordem alfabética por Padrão. Inserir um Número aqui define uma Posição explícita; Usa diferentes Números sobre (em) diferentes Consultas do Sistema ao ordená-las relativamente umas às outras. ### Propriedades de visualização O **Propriedades de visualização** o nó define como os Resultados da Consulta são exibidos e quais Métodos estão Disponível sobre (em) eles incluido no gerenciador de objeto GeoDin. **Permitir expandir os nós filhos do Resultado incluido no GeoDin objeto Manager** Esta opção controla se outra Consulta do sistema existente é adicionada como um novo nó filho em um objeto de Resultado. Considere dois Tipo de objetos com uma Relação entre eles, "Funcionário" e "Furo": uma Consulta do sistema lista todas as Perfurações em que um funcionário trabalhou, e um Segundo Consulta do sistema abaixo do Furo exibe o funcionário que trabalhou nele. Com a opção ativa, expandir o Resultado produziria uma estrutura interminável - funcionário, Furo, funcionário, Furo, e assim por diante. Com a opção Desligado, a estrutura termina nas Perfurações. **Vista estendida de objeto para nós filhos do Resultado** Com esta opção, os resultados da consulta são testados quanto a valores medidos e documentos ligados, o que leva a um tipo particular de visualização. Em bancos de dados muito grandes ou lentos, esse teste demora, por isso a opção pode ser desativada aí. **Métodos disponíveis** Aqui você define quais Métodos estão Disponível sobre (em) o nó da própria Consulta ou sobre os nós de resultado (objeto ou Ponto de monitorização). Um campo Vazio significa que o GeoDin permite todos os Métodos de Texto padrão sobre (em) o nó. Ao inserir uma Lista de Código único (ID) de método separada por vírgulas, o nó fica limitado apenas a esses Métodos; cada Método do GeoDin tem um Código único (ID) exclusivo, e os números Disponível são listados na Seção ExecuteMethod do [Referência do método da API COM](/geodin-desktop/pt/integracoes-e-plug-ins/overview-1/method-reference.md). Por exemplo, introduzindo `2,6` mostra apenas **Editar o gráfico** E **Planta topográfica** No nó e suprime Métodos como **Corte geológico**, o que pode não ser possível para estes objetos. ### Opções de apresentação Uma Consulta pode ser usada como uma camada, incluido no GIS incorporado - veja [Adicionando Camadas](/geodin-desktop/pt/mapas/adding-layers.md). O **Opções de apresentação** O nó determina como o Resultado da Consulta é exibido ali. Isso torna possível definir uma consulta do sistema que não apenas testa Condições e fornece Resultados, mas já carrega consigo as suas Cores, Preenchimento e Configurações gerais da Legenda. {% hint style="info" %} Estas Configurações gerais podem tornar-se muito complexas. Normalmente, é mais fácil Construir primeiro (a) no SIG incorporado com o assistente integrado e, depois, Copiar como um bloco de Texto a partir das Propriedades do layer para o ramo de Consulta do sistema. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.geodin.com/geodin-desktop/pt/analises/query-builder-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.