> 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/creating-queries.md). # Criando Consultas Uma Consulta filtra os Objetos e os Pontos de medição mostrados no gestor de objetos GeoDin por uma ou mais Condições. Esta página abrange o que são Consultas e como são delimitadas, a lógica e/ou do Assistente de Consulta, o passo a passo completo para criar a sua própria Consulta e a referência completa para modelos de Consulta, operadores e Formatos de data, campos de apresentação, o Comando SQL alternativo e Consultas parametrizadas. Também abrange objeto **grupos** (coleções manuais e baseadas em importação) e a **Atribuição do campo** que anexa informação de estrutura ao SQL definido pelo utilizador. ## Consultas Todos objetos mostrados no gestor de objetos GeoDin são o resultado de uma Consulta ao Banco de dados GeoDin. As Consultas podem ser feitas em Projetos individuais ou num Banco de dados (isto é, independentes do projeto). Para além das Consultas que resultam do cumprimento de uma ou mais Condições, também é possível criar um Gropo misto de Objetos em conjunto. O GeoDin faz automaticamente várias Consultas e apresenta-as no gestor de objetos GeoDin quando um Projeto ou Banco de dados é aberto. Todos os objetos num Banco de dados, incluindo diferentes tipos de Objetos e Pontos de medição, são listados: Objetos Todos objetos Furo geotécnico BH 01 BH 02 BH 03 BH 04 CPT Ponto de monitorização BH Filtro B01: (4-6m) B01: (7.5-9.5m) Amostras B01: (1.4-1.8m) B01: (2.5-2.9m) B01: (5.2-5.6m) Além das Consultas padrão predefinidas do GeoDin, você pode criar as suas Consultas especificadas pelo utilizador usando o assistente de Consulta. Os Resultados também são exibidos no gestor de objetos do GeoDin - pode criar tantas Consultas como quiser, as definições são armazenadas no Projeto: ou no Banco de dados. As definições de Consulta permanecem disponíveis até serem eliminadas do Projeto: ou do Banco de dados.\ \ Dependendo de para qual objeto no gestor de objetos do GeoDin uma Consulta foi definida, os Resultados serão específicos do Projeto: ou abrangentes para todo o Banco de dados. Por exemplo, uma Consulta sobre um **objeto** OU **Ponto de monitorização** dentro de um projeto só pode produzir resultados de objetos do projeto, em que está contido. DemoDB\ Projeto 1\ Objetos\ Todos os objetos\ Sondagem padrão SEP compatível\ Furo 1\ Furo 2\ Furo 3\ Minha Consulta\ Pontos de medição\ Objetos\ Pontos de medição Por outro lado, usando qualquer um dos **Objetos** OU **Pontos de medição** nó de um Banco de dados (isto é, abaixo de todos projetos desse Banco de dados), uma Consulta atuará em todos projetos desse Banco de dados. Bancos de dados\ DemoDB\ Projeto 1\ Objetos\ todos os objetos\ Compatível com SEP padrão\ Pontos de medição\ Objetos\ Minha Consulta em todo o Banco de dados\ Pontos de medição \ \ **Visibilidades** Isto pode ser controlado através das Configurações gerais avançadas e da gestão do Utilizador. {% hint style="warning" %} **Visibilidade Padrão alterada:** Nas versões anteriores do GeoDin, as consultas recém-criadas eram privadas por Padrão (visíveis apenas para o Utilizador que as criou). Este comportamento foi invertido - as Consultas e os Mapas criados Agora são **visíveis para todos os utilizadores** do Banco de dados igual por Padrão. Se uma Consulta tiver de ser restringida ao Utilizador que a criou, abrir a Consulta **Avançado** separador de Configurações gerais e Configurar a Visibilidade em conformidade. O mesmo Padrão aplica-se aos Mapas. {% endhint %} ## Lógica de Condição E vs. OU Ao construir Condições no Assistente de Consulta, a colocação de uma Condição determina se é combinada com lógica E ou OU: * **Lógica OU:** arraste um campo para o Nível de topo **Condições** nó. Cada condição colocada neste Nível cria um ramo OU independente - a Consulta retorna Objetos que correspondem a qualquer uma das condições. * **Lógica E:** arraste um campo sobre (em) um **Entrada de Condição existente** (aninhado sob o nó "Se"). Isto adiciona a condição como um requisito E, adicionalmente, dentro desse ramo - a Consulta retorna Objetos que correspondem a todos os critérios aninhados simultaneamente. **Exemplo:** Ao/à encontrar Todos objetos a uma Profundidade superior a 9 m E sobre a folha de Mapa JD1234, coloque primeiro a condição de Profundidade no nó Condições, depois coloque a condição da folha de Mapa na Entrada da condição de Profundidade. Ambos devem ser satisfeitos. {% hint style="info" %} Consultas No **Pontos de medição** o ramo Pontos de medição de um projeto devolve pontos de medição em vez de objetos. Pode criar consultas sob qualquer um dos **Objetos** ou o **Pontos de medição** nó na árvore do Gestor de Objetos. {% endhint %} ## Criar uma consulta Para definir as suas próprias consultas (por ex. "perfurações mais profundas do que 9 m") está disponível um assistente de consulta. O assistente de consulta é capaz de criar consultas até um certo grau de complexidade. Para consultas altamente complexas, é possível introduzir [Comando alternativo SQL.](/geodin-desktop/pt/analises/creating-queries/sql-and-advanced-options.md) no assistente de consulta ou criar [Consulta do sistema](/geodin-desktop/pt/analises/creating-queries.md) (No lado do sistema do GeoDin). Uma consulta é composta por um número ilimitado de subconsultas. Quando um objeto cumpre uma condição de subconsulta, é incluído no resultado da consulta. **Exemplo:** Pretende selecionar todos os objetos que um colega introduziu de um banco de dados. O nome do autor para um objeto específico ou Ponto de monitorização está armazenado na Tabela A no Campo de dados A1, para outros objetos (por ex. poços de abastecimento de água) noutra Tabela B no Campo de dados B1. Neste caso, crie duas subconsultas: uma que consulta o campo de dados A1 na Tabela A e a segunda que consulta o campo de dados B1 na Tabela B. Em conjunto, produzem uma lista de todos os objetos do colega X no gestor de objetos do GeoDin. Cada subconsulta tem a sua própria ordenação, cujos resultados podem ser alterados de forma Individual com a ajuda da opção -Ordenação dos resultados sub/parciais-. Normalmente, porém, basta apenas uma subconsulta para escolher os objetos necessários. {% stepper %} {% step %} #### Paso 1: Iniciar o assistente de consulta O assistente de consulta é iniciado usando o método ![New Query](/files/b5b1d0a457e003192c0aa893e0f72c824d9306f8) **"Nova consulta"**. Isto está disponível quando qualquer um dos **Objetos** OU **Pontos de medição** estão selecionados no gestor de objetos do GeoDin. {% endstep %} {% step %} #### Paso 2: Dar nome à consulta e organizar subconsultas No primeiro passo do assistente de consulta, define o nome da consulta, que será apresentado no gestor de objetos do GeoDin. Também pode organizar as subconsultas. {% endstep %} {% step %} #### Paso 3: Criar uma subconsulta e escolher um modelo Criar uma subconsulta usando o **Novo** botão que o leva à seleção do modelo a ser usado para criar a subconsulta. Aqui, define se a consulta está limitada aos objetos selecionados no banco de dados. Selecione um dos modelos de consulta e obterá explicações mais detalhadas na parte inferior da janela de diálogo. Os modelos em oferta estão listados em **Referência: Modelos de consulta** abaixo. Quando clica num tipo de consulta, é apresentada ajuda explicativa na metade inferior da janela de diálogo. As tabelas e os campos de dados relevantes para a consulta são mostrados na janela. {% endstep %} {% step %} #### Paso 4: Definir condições e campos de visualização Depois de selecionar o modelo desejado, o **Próximo** botão leva-o à definição das condições e dos campos de visualização (ver **Referência: Definir condições** E **Referência: Escolher campos de visualização** abaixo). {% endstep %} {% endstepper %} *** ## Referência: Modelos de consulta Quando cria uma subconsulta, o **Novo** botão abre a seleção do modelo a ser usado. São oferecidos os seguintes modelos: \ **Todos objetos** - Consulta de registo de objetos GeoDin ***Aviso:*** *Esta opção só está disponível sob os nós de objetos, ou seja, não sob o nó de ponto de monitorização no gestor de objetos GeoDin!* Com este modelo, os campos de dados disponíveis para condições e campos de visualização são fortemente limitados (apenas pesquisa por nome, coordenadas, profundidade inicial e profundidade final dos objetos).\ \ **Tipo de objeto específico** - Consulta sobre objetos de certos tipos de objeto Está limitado a um conjunto específico de tabelas GeoDin (com base nas suas ligações predefinidas) e, por isso, limita os resultados produzidos pela consulta.\ \ **Ligações de tabelas definidas pelo utilizador** - Consulta com ligações de quaisquer tabelas O conjunto completo de tabelas GeoDin, o que requer conhecimento da estrutura da base de dados GeoDin e das possibilidades de ligação. Acesso a todas as tabelas com descrições de dados mestre, dados de amostra, dados da construção do furo, etc. \ [Comando alternativo SQL.](/geodin-desktop/pt/analises/creating-queries/sql-and-advanced-options.md) - Consulta SQL Esta escolha requer experiência em SQL e conhecimento da estrutura da tabela da base de dados GeoDin. **Definição de Consulta definida pelo Utilizador** - Consultas baseadas em modelos Definido pelo utilizador \ Os modelos podem ser criado por você ou pelo seu supervisor GeoDin sobre (em) a Página do Sistema GeoDin. ## Referência: Definir condições Dependendo do Tipo de consulta escolhido, a janela mostra uma Lista das Tabelas relevantes do Banco de dados. Para Abrir uma Lista de campos da Tabela, clique no Símbolo de mais (+) antes do Nome da Tabela. Quase todos os passos da Operação executiva neste diálogo são Efetuado pela/o arrastar e soltar. Isto significa clicar sobre (em) uma Entrada de Tabela, manter o Botão do rato premido e arrastar sobre (em) a ![Condition](/files/ade9de8f6a8f7a7bdd3ab4df59c33f073ed69e1a) ***Condição*** ramo da Hieraquia incluido na janela inferior.\ \ Assim que a primeiro (a) Entrada do Campo de dados é largada sobre uma Condição, o sub-Nível "Se" aparece. Se mais de um requisito tiver de ser cumprido, então execute novamente a Ação de arrastar e soltar, largando sobre o nó "Se". Isto será automaticamente estendido com "E" (Aviso: o campo largado não precisa de ser um diferente, por exemplo, limitando Valores para um Nome da variável específico).\ \ Se uma Condição ou outra Condição tiver de ser cumprida, uma Entrada de Tabela do campo do topo deve ser largada sobre a Condição, pelo que o nó "OU" aparecerá automaticamente. No seguinte exemplo, a Consulta para Todos objetos que foram perfurados a mais de 9 m de profundidade e que se encontram No números dos Mapas JD1234 OU JD1235 foi definida. ``` Condição Se SSGKRZT1.TK25=JD1234 SSGKRZT1.ZCOORDE>9 Ou SSGKRZT1.TK25=JD1234 SSGKRZT1.ZCOORDE>9 ``` ***Aviso:*** *Ao simplificar a apresentação visual da Consulta, não é possível definir condições OU a partir de uma condição E. Isto mantém a lógica da Consulta clara para o Utilizador e, através da definição de condições OU ilimitadas, virtualmente qualquer Consulta pode ser definida.* Se quisermos resumir a Consulta mostrada no exemplo acima da seguinte forma: (ZCOORDE>9) E ((ORDNSURV='JD1234') OU (ORDNSURV='JD1235')) O GeoDin também permite formular uma Consulta como Texto - mais Detalhes são fornecidos em [Comando alternativo SQL.](/geodin-desktop/pt/analises/creating-queries/sql-and-advanced-options.md). **Operador de comparação válido:** | Operador | Significado | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | = | | | > | | | >= | | | < | | | <= | | | <> | (não igual a) | | é nulo | (Campo de dados está Vazio) | | não é nulo | (Campo de dados não está Vazio) | | como 'A%' | (Conteúdo(s) do Campo de dados incluido em aspas alta, Espaços reservados: % para caracteres ilimitados e \_ exatamente um caractere) | | incluido ('T1','T2') | (Lista de Valor incluido em parênteses Arredondar, Valores separados por vírgulas, Valores incluido em aspas alta para campos de Texto, para valores numéricos um delimitador decimal e excluido de aspas alta) | **Para Condições, que Consulta uma data, por favor, veja o seguinte Aviso sobre os Formatos de dados para Bancos de dados**: Os Valores de Texto padrão são: | Banco de dados | Formato | | ------------------------ | ------------- | | Banco de dados MS Access | #dd/mm/aaaa# | | Banco de dados Oracle | 'dd-mmm-aaaa' | | Banco de dados dBase | 'dd.mm.aaaa' | **Para Condições, que Consulta um carimbo de Tempo, Usa os seguintes Formatos de Texto padrão** | Banco de dados | Formato | | -------------------------- | --------------------------------------------------------- | | Access: | #DD/MM/AAAA HH:MM:SS# | | Oráculo: | TO\_DATE('*31.05.2015 12:24:36'*,'dd.mm.yyyy hh24:mi:ss') | | MySQL, MS SQL, PostgreSQL: | 'DD.MM.YYYY HH:MM:SS' | ao/à Eliminar uma Condição clique No **Eliminar condição** ícone. Com o mesmo Botão, também pode Eliminar o ecrã ou ramos inteiros da Condição.\ \ **Exibição do Campo de dados e do Conteúdo na Condição**\ \ Muitas vezes, pode não saber quais valores esperar dos objetos para satisfazer a condição que deseja definir. Ao clicar **Mostrar valores** pode exibi-los manualmente. Ao marcar a caixa **Automático** serão exibidos para o campo que selecionar. Esta opção automática deve ser deixada desmarcada ao trabalhar com grandes bancos de dados, para evitar possíveis atrasos ao navegar entre os campos de dados. Pode arrastar uma entrada da lista de valores para o **Restrição** campo. Isso é de grande ajuda quando estes contêm muitos caracteres. O GeoDin reconhece automaticamente o formato do campo do banco de dados e define cadeias de texto em aspas altas ("cadeia de texto") na condição. **Testando uma consulta** Ao clicar no botão **Verificar consulta** As Condições são verificadas quanto a Erros de sintaxe e o Número de Objetos que correspondem às Condições da Consulta são exibidos. Até 50 Valores são exibidos na Lista. ## Referência: Escolher campos de visualização O Resultado de uma Consulta é sempre Pelo menos o campo LOCID da Banco de dados GeoDin - um Número de identificação exclusivo do objeto GeoDin. Quando nenhum campo de exibição é definido, os Resultados da Consulta são exibidos usando o LOCID no gerenciador do objeto GeoDin. Naturalmente, este LOCID não pode não ser de grande utilidade. ![Display Fields](/files/f5b2b7735ba9aed9a5180d487ce7ce5d4210eee2) **Exibir campos** Com os campos de exibição, você define os Rótulos dos Objetos no gestor de objeto GeoDin. Você pode combinar quantos campos de exibição como quiser (por exemplo, Nome do Furo e Profundidade final). Ao/à fazer isso, arraste os Campos de dados desejados para a Entrada de campos de exibição na parte inferior da janela. O Conteúdo(s) de todos os campos de exibição será ligado ao/à Texto e exibido no gestor de objeto GeoDin. **Extensão/Texto extra** Para separar os conteúdos individuais do display (Campos de dados) uns dos outros, pode ser definido um texto para cada Campo de display, que é anexado ao respetivo conteúdo do campo de dados. **Exemplo:** Campos de visualização SSGKRZT1.LONGNAME (bis SSGKRZT1.ZCOORDE m) incluido ao formar o Texto da Soma incluido na forma **Denominação longa (ao Xm)** para cada Furo encontrado, o Texto de extensão **(*****até*** ou \[Inglês] ***ao/à*** e para o Campo de display ZCOORDE o Texto de extensão ***m*****)** é definido para o Campo de display LONGNAME. Como resultado, cada Furo incluido no gestor de objeto GeoDin é rotulado com Nome e Profundidade final: Localização mais profunda que 9m Brg 01 (Até a profundidade 11m) Brg 02 (até a profundidade 10.5m) Brg 03 (até a profundidade 12m) Brg 04 (até a profundidade 9.5m) Você pode modificar a ordem dos Campo de display arrastando e soltando uma entrada para uma posição diferente dentro da **Campo de display** Seção. Com o Campo de display, você também define a ordem de ordenação dos Objetos encontrados no gerenciador de Objetos GeoDin. Na frente de cada Campo de display, uma seta indica a ordem de ordenação definida. Você pode modificar a ordem de ordenação dando dois cliques na entrada. A ordem de ordenação pode ter os seguintes estados: Crescente, Decrescente, não ordenado. A ordem de ordenação atual é exibida na frente do Campo de display. Os objetos encontrados são sempre ordenados na ordem dos Campo de display, ou seja, no exemplo acima primeiro por Nome e depois pela profundidade final se o Nome for o mesmo. Para ordenar os objetos por profundidade final sem modificar a ordem dos Campo de display, dê dois cliques no campo de display LONGNAME até que a ordenação seja desativada para esse campo. O conjunto de resultados agora será ordenado apenas por profundidade final, e a definição da ordem do campo de display será mantida. Como resultado, a seguinte Lista é agora exibida no GeoDin- Gerenciador de Objetos: Localização mais profunda que 9m Brg 04 (até a profundidade 9.5m) Brg 02 (até a profundidade 10.5m) Brg 01 (Até a profundidade 11m) Brg 03 (até a profundidade 12m) **Formatação e retradução de rótulos no gerenciador de Objetos** Se a Seção "Campos de exibição" estiver marcada, pode ajustar ainda mais os campos de exibição através do Campo de entrada inferior **Instrução de Rótulos - Consulta:**. Ao lado de numerosos [Texto macro](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates/text-macros-in-reports.md) Ao introduzir uma macro, pode especificar que a Denominação longa da Entrada do campo (isto é, a tradução inversa) é exibida no gestor de objeto. As macros introduzidas devem estar Disponível na Seção "Campos de exibição". Não podem substituir os campos de exibição, mas servem para os complementar. ***DICA:*** *Mude para a Antevisão SQL e copie as Entradas desejadas a partir daí.* **Exemplo:**\ Se tiver definido GeoDin\_LOC\_S3STAMM.LONGNAME e GeoDin\_LOC\_S3STAMM.BART como campos de exibição e quiser que a descrição longa do tipo de furo (BART), isto é, a tradução Para atrás da chave, seja exibida no gestor do objeto GeoDin, a seguinte Entrada deve ser escrita no Campo de entrada **Declaração de Rótulos - Consulta:** $GeoDin\_LOC\_S3STAMM.LONGNAME$ ($GeoDin\_LOC\_S3STAMM.BART$) O gestor de objetos agora mostra o seguinte: Orifícios (tipo de digestão)\ SEP3 Orifício 1 (geral)\ SEP3 Orifício 2 (digestão, preenchido)\ SEP3 orifício 3 (orifício oblíquo)\ SEP3 Orifício 4 (geral) Se uma instrução de Rótulos for usada, uma macro adicional deve ser definida no Campo de entrada **Instrução de Rótulos - Atualizar:**. Em regra, a macro consiste nas referências dos campos acima dela no Campo de entrada, menos os nomes das tabelas. A macro é usada ao atualizar a exibição no gestor de objetos devido às Mudanças feitas no editor de dados mestres. (Plano de fundo: No momento da atualização, o objeto carregado é usado para resolver a macro. A Consulta inicial ou o registo de dados que levou à Entrada no gestor de objetos não é guardado em cache, pois isso não é necessário e só ocuparia memória. A macro para a atualização deve, portanto, ser criada com as referências de campo, tal como também são usadas em layouts para o objeto carregado.) As seguintes referências de campo são, portanto, inseridas para o exemplo acima: $LONGNAME$ ($BART$) **Selecionar Campos de ordenação** Além dos Campos de visualização (que também podem ser usados para ordenar os Resultados conforme descrito acima), também os Campos de dados, Não utilizados nos Resultados exibidos no gerenciador de objeto GeoDin, podem ser usados para ordenação. Para isso, arraste os Campos de ordenação escolhidos da Lista superior para a Entrada **Campos de ordenação** por arrastar e soltar. Para alterar a ordem de ordenação, clique duas vezes na entrada específica. A seta mostra a ordem de ordenação atual. **Selecionar campos de resultados** Além da vista e dos Campos de ordenação, os Campos de resultados podem ser selecionados, os quais não são usados nem para a exibição nem para a ordenação. No entanto, Se os Resultados da Consulta forem exportados, por exemplo para SIG, Usa os Campos de resultados para determinar quais Campos de dados devem ser transferidos da Tabela GeoDin para a Tabela de atributos da camada gerada. Arraste os campos desejados como de costume para o nó Campos de resultados (Exportar). Se quiser transferir todos os campos de uma Tabela GeoDin, basta arrastar a tabela desejada para o nó Campos de resultados (Exportar). ## Referência: Comando alternativo SQL. Além de construir visualmente Consultas, pode definir os seus próprios comandos SQL utilizando a janela de Previsualização SQL. A opção <[Comando alternativo SQL.](/geodin-desktop/pt/analises/creating-queries/sql-and-advanced-options.md)> permite que você defina um comando SQL-Selecionar para sua consulta: 1. O comando deve retornar uma quantidade (cursor do Banco de dados). Um SQL-Command sem instrução Selecionar no início de um comando não será executado. 2. A primeiro (a) Linha do Resultado retornado deve conter um GeoDin-Localização-Código único (ID) válido (LOCID) ou um GeoDin-Measurementpoint-Código único (ID) válido (INVID) (dependendo sobre (em) do conjunto de Resultado desejado). As Consultas não são verificadas quanto à sua validade, mas uma verificação formal de que a primeiro (a) Linha do Resultado contém números que podem ser convertidos ao/à inteiros. Onde o Resultado não retorna um Código único (ID) válido, o objeto não pode ser selecionado Posterior. Porque não são definidas mais Condições para o Comando-SQL, é possível ao integrar outras Tabelas do Banco de dados incluído na Consulta que não fazem parte da estrutura do Sistema GeoDin. Claro, tal Consulta só faz sentido quando outras Tabelas estão relacionadas ao/à uma GeoDin-Tabela, de modo que o Resultado retornado forneça um Código único (ID) válido. O Comando alternativo SQL. mostra todos os Parâmetro visualmente definidos na Consulta (ordem, Texto adicional etc.), incluido desde que os nomes do Campo de dados correspondam. ## Referência: Consultas parametrizadas No exemplo acima, uma Condição foi definida na Consulta de que a Profundidade final deve ser maior que 9 m. Para outro momento, você pode querer escolher todos os Perfurações que sejam mais profundas do que 20 m. Para fazer isso, você poderia Modificar o Valor de (>9m) para (>20m) na Consulta existente ou definir uma Nova consulta, que difere do primeiro (a) apenas no Valor da Profundidade. O GeoDin oferece outro Método mais eficiente para definir Consultas, que têm Condições semelhantes, enquanto deixa o Parâmetro principal livre para assumir Valores diferentes. A mesma Consulta pode então ser usada para fazer várias seleções de Objetos GeoDin. Para fazer isso, Usa o Típo ":?" incluido no campo de limitação ao invés de um Número (Profundidade) - veja abaixo: ``` Condição Se SSGKRZT1.ZCOORDE>:? Campo de display SSGKRZT1.LONGNAME (ao/à SSGKRZT1.ZCOORDE m) ``` A Condição de Consulta usada é >:? ao/à caracterizar Consultas parametrizadas, pode ser escolhido um Nome apropriado, por exemplo, "Perfurações mais profundas do que ?m", para marcar que a Consulta é Nome da variável incluido no GeoDin objeto Manager. Quando a Consulta é aberta pela primeiro (a) Tempo, é apresentado um diálogo de entrada, solicitando a entrada do Parâmetro. Introduza o Valor de Profundidade desejado e confirme clicando **OK**. Como Resultado, todas as Perfurações mais profundas do que o Valor dado são exibidas no GeoDin Gerenciador de objeto. As Perfurações exibidas podem então ser usadas para Análises posteriores. Se você definir uma Condição com um Parâmetro variável em uma Consulta, pode Selecionar se o Parâmetro é uma Indicação do parâmetro preciso requerido (-Indicação do parâmetro preciso-). Se esta opção estiver Bloqueado, o Campo de entrada pode ser deixado Vazio no diálogo de entrada. Esta Condição fica Vazio ao executar a Consulta do Banco de dados e a característica não é utilizada para limitar os conjuntos de dados na Escolha / Seleção resultante. Além disso, pode ser definido um Texto padrão, que é inserido automaticamente na caixa de diálogo. Se a Consulta for Iniciado, o Valor já está inserido no Campo de entrada e pode ser alterado, se desejado. Isso torna o preenchimento dos Parâmetro ainda mais fácil. Dependendo do Formato de campo, os Texto padrão para Condições têm de estar no seguinte Formato: Cadeia de caracteres: o Texto padrão valor pode ser Arbitrário cadeia de caracteres Valor numérico: O Texto padrão Valor tem de ser, ao/à, um Número, o separador decimal é um Ponto (.). Data: O Valor de Texto padrão deve ser uma Data completa, incluido o formato dd.mm.yyy (Dia-Mês-Ano) **Utilizar interval** Se uma Consulta estiver parametrizada, é possível usar um Intervalo em vez de um limite superior e inferior. Um exemplo disto é a Procura a: Objetos numa Área à volta de um Ponto específico. Isto é possível com Consultas parametrizadas e o Parâmetro: (X >= X\_value1) E (X <= X\_value2) E (Y >= Y\_value1) E (Y <= Y\_value2) Se os Valores de Coordenadas tiverem vários dígitos, inserir os 4 Parâmetro necessários é demorado. Nesses casos, a opção -Utilizar interval- oferece uma possibilidade mais fácil. Ao utilizá-lo, defina apenas duas Condições: X = :? E Y = :? E ative a opção No -Utilizar interval-. Um Valor estandard para o Intervalo também pode ser fornecido. A partir da Condição ( X =X\_Valor) E ( Y= Y\_Valor), GeoDin irá automaticamente gerar a seguinte instrução SQL: ((X >= X\_value - Xinterval) E (X <= X\_value + Xinterval)) E ((Y >= Y\_value - Yinterval) E (Y <= Y\_value + Yinterval)) Como Parâmetro, apenas as Coordenadas do Centro e o Intervalo precisam ser inseridos. Usar intervalos só é possível para Consultas parametrizadas, mas pode ser usado para qualquer Campo de dados Numérico (por exemplo Profundidade final). **Usando o Parâmetro $%SYSDATE$** Pode usar o marcador de posição $%SYSDATE$ como o Valor estandard de um Parâmetro de Data para definir a data atual como o Valor estandard. Além disso, são possíveis expressões matemáticas com a macro $%SYSDATE$, por exemplo $%SYSDATE$ - 7 para obter uma data padrão para o dia anterior a uma semana. **Modificar parâmetros** Para modificar um Valor definido, usa o Método ![Change parameter](/files/f9c4d4dbee39061ad0ea41b044e30c52b72e5dbd) **Modificar Parâmetro** Para o objeto Consulta: Numa Consulta, pode ser definido um Número Arbitrário de Parâmetro. **Exemplo:** ``` Condição Se LOCREG.XCOORD>=:? LOCREG.XCOORD<=:? LOCREG.YCOORD>=:? LOCREG.YCOORD<=:? Campo de display SSGKRZT1.LONGNAME ``` No exemplo acima, quatro Parâmetro são definidos para construir um Rectângulo de Coordenadas. O primeiro (a) de cada um dos Valores X e Y define as Coordenadas iniciais - o Segundo Valor em cada par define a extensão da Área a ser pesquisada. A caixa de diálogo da Consulta para esta Consulta é mostrada abaixo: ## Atualizar consulta Num ambiente multiutilizador, pode frequentemente ser necessário Atualizar consulta para refletir Mudanças nos próprios dados. O GeoDin verifica automaticamente Mudanças nos Objetos usados para a apresentação (por exemplo, um Nome de objeto mostrado no gestor de objetos do GeoDin). No entanto, se um Parâmetro da Condição for alterado (por exemplo, "Profundidade final"), a Consulta não é atualizada automaticamente, porque isso interferiria com o fluxo de trabalho em grandes conjuntos de dados. Da mesma forma, se outro Utilizador alterar a Profundidade final, isso não é atualizado automaticamente na Consulta. Existe uma forma simples de Atualizar rapidamente os Resultados da sua Consulta para incorporar Mudanças nos dados (por exemplo, Valores de Profundidade final). Clique com o botão direito do rato na Consulta no gestor de Objetos do GeoDin e escolha **Atualizar** no menu pop-up. A Lista de Objetos será reconstruída. ## Duplicar consulta Com o Método **"Duplicar consulta"** você pode Copiar uma Consulta feita incluido um Projeto: ao/à Usa incluido outro. Para Copiar uma Consulta ao/à todos projetos, Selecionar o **todos** Botão. A Consulta será copiada ao/à todos os Projetos selecionado no Banco de dados incluido. Se você usou o identificador do projeto (PRJ\_ID Campo de dados) na sua consulta incluido a Condição, exibindo ou Comando SQL alternativo, ele será automaticamente ajustado ao/à outro identificador de projeto ao copiar a Consulta, de modo que a Consulta duplicada não precise ser corrigida no projeto de destino. ## Eliminar consulta Este Método exclui a definição da Consulta. Você **não** Eliminar os Objetos contidos incluido nos Resultados da Consulta, apenas a Condição que produz estes Resultados. *** ## Trabalhando com grupos de objetos ### Grupos de objetos Em algumas situações, os objetos de um banco de dados não podem ser consultados corretamente. Isso pode dever-se a entradas do banco de dados incompletas ou em falta, ou ao facto de outros critérios, não armazenados no banco de dados, serem importantes. Para esses casos, o GeoDin oferece a possibilidade de criar **Grupos** de objetos que não cumprem quaisquer condições específicas. O método **"Novo grupo"** está disponível nos nós de objetos e pontos de medição. Introduza um nome para o grupo que será usado no gestor de objetos do GeoDin para identificação. Após criar um grupo, a lista fica inicialmente vazia. Para preencher a lista, selecione um objeto no gestor de objetos do GeoDin, mantenha premido o botão esquerdo do rato, arraste-o e largue-o na janela de diálogo aberta. Pode selecionar objetos individuais ou grupos no gestor de objetos do GeoDin. Pode eliminar e alterar a ordem dos objetos num grupo usando os botões apropriados em <**Gropo**> janela de diálogo. Objetos são inseridos na Lista com a designação que têm no Tempo da inserção. Este Texto não pode ser alterado Posterior e não será Atualizado mesmo se a situação dos dados tiver Mudanças. Em contraste, para Consultas, os Texto de Rótulo são Atualizados e os Objetos que já não atendem à Condição são removidos da Lista quando a Consulta é Atualizada. Portanto, pode haver Objetos incluido em um Gropo cujos Rótulos já não estão corretos após uma Modificar nos dados do objeto. Este exemplo mostra que Gropo têm uma série de desvantagens em comparação ao/à Consultas e, portanto, só devem ser usados Se uma Consulta não for realmente possível pelas razões mencionadas Para o início ou se você espera que os dados desses Objetos não vão mais Modificar. Consultas e grupos são mostrados com pirâmides de cores diferentes, incluido no gerenciador de objeto GeoDin - Amarelo para consultas e Azul para grupos. A Visibilidade pode ser controlada para Utilizador e grupos incluido nas Configurações gerais na gestão de utilizadores. ### Eliminar grupo de objetos Este método exclui a definição do grupo, **não** os Objetos contidos dentro do Gropo. ### Importar grupos Usa o **"Grupo de importação"** método para procurar os Objetos GeoDin num Banco de dados GeoDin com base em dados externos ("Ficheiro de importação") e agrupar os Objetos encontrados em conjunto. Dependendo do nó em que o método é iniciado, os Objetos GeoDin são procurados em todo o Banco de dados (nó "Objetos" um nível abaixo do Banco de dados) ou apenas num Projeto (nó "Objetos" um nível abaixo do Projeto). São necessários os seguintes passos: **Origem dos dados** Aqui abre o ficheiro (por ex., ficheiro Excel, banco de dados) que contém a informação sobre os objetos GeoDin a procurar (e posteriormente agrupar) no banco de dados. **Link de objeto** Aqui atribui os objetos GeoDin da base de dados às especificações na origem dos dados. Este passo inicia a seleção dos objetos a agrupar. [Importar](/geodin-desktop/pt/importar-dados/import.md) Faça aqui as definições para o controlo da comparação. A antevisão mostra quais objetos GeoDin são encontrados no banco de dados usando a informação no ficheiro de importação e quais objetos GeoDin não são mencionados no ficheiro de importação. Inicie aqui a criação do grupo. **Guardar e Carregar configuração** todos os Gropo Importar Configurações gerais podem ser guardados num ficheiro de Configuração. O ficheiro de Configuração permite uma rápida re-Execução de uma criação de Gropo numa altura Posterior, se a Base dos dados for semelhante ou igual. ### Origem dos dados Abrir o Ficheiro que contém a Informação sobre os Objetos GeoDin a serem procurados (e, em momento Posterior, agrupados) no Banco de dados. Os seguintes Formatos de ficheiros são suportados: 1. MS Excel 2. MS Access 3. dBASE 4. Ficheiros de Texto 5. Ficheiros CSV Após selecionar o Ficheiro, especifique a Origem dos dados e Selecionar uma folha de cálculo (Excel), uma Tabela (Access, dBase) ou um separador de Coluna (CSV, ficheiro de Texto). Os dados de pesquisa são apresentados na Antevisão. Para MS Excel ou Ficheiros de Texto, também pode especificar se a primeiro (a) linha contém cabeçalhos de Coluna. O Formato de data usado nestes Ficheiros também pode ser especificado. GeoDin leva esta configuração em conta quando converte datas em momento Posterior. Usa este Botão para eliminar registos selecionado da Antevisão se não quiser que sejam incluídos na procura (os registos só serão eliminados nesta Antevisão, o ficheiro de origem permanece Inalterado). ### Link de objeto Neste Paso, você atribui os registos de dados no Ficheiro de importação aos Objetos GeoDin no seu Banco de dados. A atribuição baseia-se na correspondência de Conteúdo(s) entre os dados-mestre selecionado de Objetos GeoDin e os registos de dados no Ficheiro de importação. **Exemplo** O Ficheiro de importação contém uma Coluna com uma Seleção de nomes de perfurações. Estas Perfurações devem ser agrupadas no GeoDin. Para a atribuição, deve atribuir a Coluna do Ficheiro de importação ao campo LONGNAME da tabela de dados-mestre do GeoDin. A Procura a: dos Objetos GeoDin a agrupar é agora realizada comparando os nomes das Perfurações. Se especificar vários Conteúdo(s) para a atribuição do objeto (por exemplo, o nome da perfuração, a localização da perfuração, etc.), apenas esses Objetos GeoDin no Banco de dados para os quais todos os campos correspondem são selecionado para agrupamento. **Tabelas**: Selecione a tabela de dados-mestre do Banco de dados que deve servir de Base para uma comparação de dados-mestre entre o Ficheiro de importação e os Objetos GeoDin. Para atribuir os campos a referenciar, arraste e largue as entradas individuais das listas "Tabelas:" e "Origem dos dados:" para o campo correspondente na outra lista. Em alternativa, pode Selecionar os dois campos e fazer duplo clique num deles para efetuar a atribuição. No caso de nomes de coluna no Ficheiro de importação que sejam idênticos aos nomes de coluna na tabela de dados-mestre do Banco de dados, pode atribuir estas entradas correspondentes automaticamente usando o interruptor \. As atribuições efetuadas são transferidas para a tabela "Atribuições:". Ao mesmo tempo, as entradas atribuídas são eliminadas das listas "Tabelas:" e "Origem dos dados:" para que apenas permaneçam as entradas que ainda não foram atribuídas. Com os dois Campos de entrada abaixo das listas, o Conteúdo(s) das listas pode ser filtrado. Se for introduzido um termo, apenas as entradas são exibidas nas listas que contêm este termo. Se esvaziar o Campo de entrada, todas as entradas são exibidas novamente. As atribuições Inválido são marcado em Cor na tabela. Isto ocorre quando modifica a Origem dos dados depois de ter feito a atribuição. Elimine estas entradas usando o Botão\ . ### Importar Faça as definições do último passo para a criação do Gropo e veja uma Antevisão do estado das atribuições. Depois, inicie a criação de Novo grupo. **Opções de comparação**\ Se marcar a caixa *\[Sensível a maiúsculas e minúsculas]*, os nomes de Coluna do Ficheiro de importação e os da Tabela de dados mestre só serão atribuídos ao/à verificar-se também a correspondência da grafia em relação à sensibilidade a maiúsculas e minúsculas. **Antevisão**\ A janela de Antevisão fornece um Resumo das atribuições efetuadas. Existem três tipos de Resultados: *Foi encontrado um objeto GeoDin* Foi possível encontrar exatamente um objeto GeoDin no Banco de dados, incluido para a Entrada ao/à pesquisar. *Foram encontrados vários Objetos GeoDin* Foram encontrados vários objetos GeoDin no banco de dados para a entrada a ser pesquisada. Isso significa que os conteúdos do seu ficheiro de importação não são únicos. Talvez precise Incluir mais campos de dados na comparação para encontrar os objetos GeoDin corretos. *Não foi encontrado nenhum objeto GeoDin* Não existe um objeto GeoDin no Banco de dados com Informação que tem Acerto com o termo de pesquisa. Verifique a atribuição dos Campos de dados e o Conteúdo(s) do Ficheiro de importação. **Filtro para a antevisão**\ Você pode usar Filtro e Ordenar as atribuições exibidas incluido na Antevisão. ao/à fazer isso, clique No Cabeçalho da Coluna incluido na Coluna requerido.\ "**Usa o Filtro para a Antevisão:"** caixa suspensa ao/à exibir apenas um dos três Típos: de Resultados (veja acima) incluido na janela de Antevisão. **Executar Importar**\ Com um clique do rato No Botão \*\*Executar Importar\*\* todos os Objetos GeoDin atribuídos com sucesso são combinados num Novo grupo no GeoDin Gestor de Objetos. Sob o Título "Execução" pode definir um Nome para o Novo grupo, incluido na janela de edição. Por Padrão, o Nome do Ficheiro de importação é pré-preenchido aqui.\ Após a Execução, é apresentado um registo que pode Guardar usando o Botão correspondente. Se quiser Criar mais grupos, volte Para atrás ao **Origem dos dados**. ## Gestão de Utilizador A visibilidade/utilização de vários métodos e funções pode ser restringida através da administração de utilizadores. Por Padrão, a opção *"todos"* está ligado - ou seja, sem restrição. Através da opção grupos de Utilizador, a funcionalidade pode ser explicitamente disponibilizada para determinados *grupos OU utilizadores individuais*. Isto é usado, por exemplo, para Métodos, Bancos de dados do Sistema OU Consultas. A criação de usuários e grupos é descrita no capítulo sobre (em) **Configurações personalizadas**. ## Referência: Atribuição do campo Informação da estrutura pode ser anexada a SQL Definido pelo utilizador. Aos campos de Número pode então ser dada formatação de casas decimais ou conversões de Unidade, e aos campos de Texto Traduções de Dicionário. Para a Atribuição do campo, um Campo de resultado é atribuído a um campo da estrutura GeoDin. **Exemplo:** Selecionar $Schema$GeoDin\_LOC\_LOCE2LAYER.\* de $Schema$GeoDin\_LOC\_LOCE2LAYER Mapeamento: Banco de dados - Estrutura da tabela GeoDin\_LOC\_LOC\_E2LAYER.SECSTYPE E2LAYER.SECSTYPE --- # 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/creating-queries.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.