# SQL e opções avançadas ### Consultas Todos os objetos mostrados no gerenciador de objetos do GeoDin são o resultado de uma consulta ao banco de dados do GeoDin. As consultas podem ser feitas em projetos individuais ou em um banco de dados (ou seja, independentes de projeto). Além de consultas que resultam do cumprimento de uma ou mais condições, também é possível criar um grupo misto de objetos juntos. O GeoDin realiza automaticamente várias consultas e as exibe no gerenciador de objetos do GeoDin quando um projeto ou banco de dados é aberto. Todos os objetos em um banco de dados, incluindo diferentes tipos de objetos e pontos de medição, são listados: Objetos Todos os objetos Furo geotécnico BH 01 BH 02 BH 03 BH 04 CPT Ponto de mediçã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 suas consultas personalizadas usando o assistente de consulta. Os resultados também são exibidos no gerenciador de objetos do GeoDin - você pode criar quantas consultas quiser, e as definições são armazenadas no projeto ou banco de dados. As definições de consulta permanecem disponíveis até serem excluídas do projeto ou banco de dados.\ \ Dependendo de para qual objeto no gerenciador de objetos do GeoDin a consulta foi definida, os resultados serão específicos do projeto ou abrangentes para todo o banco de dados. Por exemplo, uma consulta em um **Objeto** ou **Ponto de medição** dentro de um projeto só pode produzir resultados de objetos do projeto no qual ele 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 o **Objetos** ou **Pontos de medição** nó de um banco de dados (ou seja, abaixo de todos os projetos desse banco de dados), uma consulta atuará sobre todos os projetos desse banco de dados. Bancos de dados\ DemoDB\ Projeto 1\ Objetos\ Todos os objetos\ Sondagem padrão SEP compatível\ Pontos de medição\ Objetos\ Minha consulta em todo o banco de dados\ Pontos de medição \ \ **Visibilidades** Isso pode ser controlado por meio das configurações avançadas e do gerenciamento de usuários. ### Criar consulta Para definir suas próprias consultas (por exemplo, "furos com profundidade superior a 9 m"), um assistente de consulta está disponível. O assistente de consulta é capaz de criar consultas até certo grau de complexidade. Para consultas altamente complexas, é possível inserir [Comando SQL alternativo](https://docs.geodin.com/geodin-desktop/pt/consultas/sql-and-advanced-options) no assistente de consulta ou criar [Consultas do sistema](https://docs.geodin.com/geodin-desktop/pt/consultas/creating-queries) (no lado do sistema do GeoDin). O assistente de consulta é iniciado usando o método **"Nova consulta"**. Isso está disponível quando **Objetos** ou **Pontos de medição** são selecionados no gerenciador de objetos do GeoDin. Uma consulta é composta por um número ilimitado de subconsultas. Quando um objeto satisfaz a condição de uma subconsulta, ele é incluído no resultado da consulta. **Exemplo:** Você deseja selecionar, a partir de um banco de dados, todos os objetos inseridos por um colega. O nome do autor para um objeto específico ou ponto de medição é armazenado na Tabela A no Campo de Dados A1; para outros objetos (por exemplo, poços de abastecimento de água), em outra Tabela B no Campo de Dados B1. Nesse caso, crie duas subconsultas: uma que consulte o campo de dados A1 na Tabela A e a segunda que consulte o campo de dados B1 na Tabela B. Juntas, elas produzem uma lista de todos os objetos do colega X no gerenciador de objetos do GeoDin. Cada subconsulta tem sua própria ordenação, cujos resultados podem ser alterados individualmente com a ajuda da opção -Ordenar os resultados parciais/subparciais-. Normalmente, porém, apenas uma subconsulta é suficiente para selecionar os objetos necessários. No primeiro passo do assistente de consulta, você define o nome da consulta, que será exibido no gerenciador de objetos do GeoDin. Você também pode organizar as subconsultas. Crie uma subconsulta usando o **Novo** botão, que leva você à seleção do modelo a ser usado para criar a subconsulta. Aqui você define se a consulta é limitada a objetos selecionados no banco de dados. Selecione um dos modelos de consulta e você obterá explicações mais detalhadas na parte inferior da janela de diálogo.\ Os seguintes modelos são oferecidos: \ **Todos os objetos** - Consulta de registro de objetos GeoDin ***Observação:*** *Essa opção está disponível apenas nos nós de objetos, ou seja, não no nó de pontos de medição no gerenciador de objetos do GeoDin!* Com esse modelo, os campos de dados disponíveis para condições e campos de exibição são fortemente limitados (somente busca por nome, coordenadas, profundidade inicial e profundidade final dos objetos).\ \ **Tipo de objeto específico** - Consulta em objetos de tipos específicos É limitada a um conjunto específico de tabelas do GeoDin (com base em seus vínculos predefinidos) e, portanto, limita os resultados produzidos pela consulta.\ \ **Vínculos de tabela definidos pelo usuário** - Consulta com vínculos de quaisquer tabelas O conjunto completo de tabelas do GeoDin, que exige conhecimento da estrutura do banco de dados e das possibilidades de ligação do GeoDin. Acesso a todas as tabelas com descrições de dados mestres, dados de amostras, dados de projeto de poços etc. \ [Comando SQL alternativo](https://docs.geodin.com/geodin-desktop/pt/consultas/sql-and-advanced-options) - Consulta SQL Essa opção requer conhecimento de SQL e da estrutura das tabelas do banco de dados GeoDin. **Definições de consulta definidas pelo usuário** - Consultas baseadas em modelos definidos pelo usuário \ Os modelos podem ser criados por você ou pelo seu supervisor do GeoDin na página do sistema GeoDin. Quando você clica em um tipo de consulta, uma ajuda explicativa é exibida na metade inferior da janela de diálogo. As tabelas e os campos de dados relevantes para a consulta são mostrados na janela. Após selecionar o modelo desejado, o **Próximo** botão leva você à definição das condições e dos campos de exibição. ### Definir configurações Dependendo do tipo de consulta escolhido, a janela mostra uma lista das tabelas de banco de dados relevantes. Para abrir a lista de campos de uma tabela, clique no símbolo de mais (+) antes do nome da tabela. Quase todas as operações nesta janela de diálogo são realizadas por arrastar e soltar. Isso significa clicar em uma entrada de tabela, mantendo o botão do mouse pressionado e arrastando para a ***Condição*** ramificação da estrutura em árvore na janela inferior.\ \ Assim que a primeira entrada de campo de dados é solta sobre uma condição, o subnível "SE" aparece. Se mais de um requisito tiver de ser atendido, execute novamente a ação de arrastar e soltar, soltando sobre o nó "SE". Isso será automaticamente estendido com "E" (Observação: o campo solto não precisa ser diferente; por exemplo, valores limite para uma variável específica).\ \ Se uma condição ou outra deve ser atendida, uma entrada de tabela do campo superior deve ser solta sobre a condição, fazendo com que o nó "Ou" apareça automaticamente. No exemplo a seguir foi definida a consulta para todos os objetos que foram perfurados a mais de 9 m de profundidade e que se encontram nas folhas de mapa JD1234 ou JD1235. Condição Se SSGKRZT1.TK25=JD1234 SSGKRZT1.ZCOORDE>9 Ou SSGKRZT1.TK25=JD1234 SSGKRZT1.ZCOORDE>9 ***Observação:*** *Para simplificar a exibição visual da consulta, não é possível definir condições OR a partir de dentro de uma condição AND. Isso mantém a lógica da consulta clara para o usuário e, por meio da definição de condições OR ilimitadas, praticamente qualquer consulta pode ser definida.* Se quisermos resumir a consulta mostrada no exemplo acima da seguinte forma: (ZCOORDE>9) AND ((ORDNSURV='JD1234') OR (ORDNSURV='JD1235')) O GeoDin também permite formular uma consulta como texto - mais detalhes são dados em [Comando SQL alternativo](https://docs.geodin.com/geodin-desktop/pt/consultas/sql-and-advanced-options). **Operadores de comparação válidos:** \= \> \>= < <= <> (diferente de) is null (campo de dados vazio) is not null (campo de dados não vazio) like 'A%' (conteúdo do campo de dados entre aspas simples, curingas: % para caracteres ilimitados e \_ para exatamente um caractere) in ('T1','T2') (lista de valores entre parênteses, valores separados por vírgulas, valores entre aspas simples para campos de texto, para valores numéricos, um separador decimal e sem aspas simples) **Para condições que consultem uma data, observe os seguintes formatos de dados para bancos de dados**: Os valores padrão são: Banco de dados Access #mm/dd/yyyy# Banco de dados Oracle 'dd-mmm-yyyy' Banco de dados dBase 'dd.mm.yyyy' **Para condições que consultem um carimbo de data/hora, use os seguintes formatos padrão** Access: #MM/DD/AAAA HH:MM:SS# Oracle: TO\_DATE('*31.05.2015 12:24:36'*','dd.mm.yyyy hh24:mi:ss') MySQL, MS SQL, PostgreSQL: 'DD.MM.AAAA HH:MM:SS' Para remover uma condição, clique no **Excluir condição** ícone. Com o mesmo botão, você também pode excluir a exibição ou ramos inteiros da condição.\ \ **Exibição do campo de dados e conteúdo na condição**\ \ Muitas vezes você pode não saber quais valores esperar para que os objetos atendam à condição que deseja definir. Clicando em **Mostrar valores** você pode exibi-los manualmente. Marcando a caixa **Automático** eles serão exibidos para qualquer campo que você selecionar. Essa opção automática deve permanecer desmarcada ao trabalhar com grandes bancos de dados, para evitar possíveis atrasos ao navegar entre os campos de dados. Você pode arrastar uma entrada da lista de valores para o campo **Restrição** . Isso é uma grande ajuda quando eles contêm muitos caracteres. O GeoDin reconhece automaticamente o formato do campo do banco de dados e coloca as cadeias de texto entre aspas simples ("cadeia de texto") na condição. **Testando uma consulta** Ao clicar no botão **Testar consulta** as condições são verificadas quanto a erros de sintaxe e o número de objetos que atendem às condições da consulta é exibido. Até 50 valores são exibidos na lista. ### Definir campos de exibição O resultado de uma consulta é sempre, no mínimo, o campo LOCID do 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 mostrados usando o LOCID no gerenciador de objetos do GeoDin. Claro que esse LOCID pode não ser tão útil. **Campos de exibição** Com os campos de exibição, você define a rotulagem dos objetos no gerenciador de objetos do GeoDin. Você pode combinar quantos campos de exibição quiser (por exemplo, nome do furo e profundidade final). Para isso, arraste os campos de dados desejados para a entrada Campos de exibição na parte inferior da janela. O conteúdo de todos os campos de exibição será vinculado a um texto e exibido no gerenciador de objetos do GeoDin. **Extensão/Texto extra** Para separar conteúdos individuais de exibição (campos de dados) entre si, um texto pode ser definido para cada campo de exibição, que é anexado ao respectivo conteúdo do campo de dados. **Exemplo:** Campos de visualização SSGKRZT1.LONGNAME (até SSGKRZT1.ZCOORDE m) Para formar o texto total na forma **Nome longo (até Xm)** para cada furo encontrado, o texto de extensão **(*****bis*** ou \[english] ***até*** e para o campo de exibição ZCOORDE o texto de extensão ***m*****)** é definido para o campo de exibição LONGNAME. Como resultado, cada furo no gerenciador de objetos do GeoDin é rotulado com nome e profundidade final: Localização mais profunda que 9 m Brg 01 (até a profundidade 11 m) Brg 02 (até a profundidade 10,5 m) Brg 03 (até a profundidade 12 m) Brg 04 (até a profundidade 9,5 m) Você pode alterar a ordem dos campos de exibição arrastando e soltando uma entrada para uma posição diferente dentro da seção **Campos de exibição** . Com os campos de exibição, você também define a ordem de classificação dos objetos encontrados no gerenciador de objetos do GeoDin. Na frente de cada campo de exibição, uma seta indica a ordem de classificação definida. Você pode alterar a ordem de classificação clicando duas vezes na entrada. A ordem de classificação pode ter os seguintes estados: crescente, decrescente, não classificado. A ordem de classificação atual é exibida na frente do campo de exibição. Os objetos encontrados são sempre classificados na ordem dos campos de exibição; ou seja, no exemplo acima primeiro pelo nome e depois pela profundidade final, se o nome for o mesmo. Para classificar os objetos pela profundidade final sem alterar a ordem dos campos de exibição, clique duas vezes no campo de exibição LONGNAME até que a classificação seja desativada para esse campo. O conjunto de resultados agora será classificado apenas pela profundidade final, e a definição da ordem dos campos de exibição será mantida. Como resultado, a seguinte lista agora é exibida no Gerenciador de Objetos do GeoDin: Localização mais profunda que 9 m Brg 04 (até a profundidade 9,5 m) Brg 02 (até a profundidade 10,5 m) Brg 01 (até a profundidade 11 m) Brg 03 (até a profundidade 12 m) **Formatação e retranslação de rótulos no gerenciador de objetos** Se a seção "Campos de exibição" estiver marcada, você pode ajustar ainda mais os campos de exibição por meio do campo de entrada inferior **Instrução de rotulagem - Consulta:**. Além de vários [Macro de texto](https://docs.geodin.com/geodin-desktop/pt/relatorios/text-macros-in-reports) Ao inserir uma macro, você pode especificar que o nome longo da entrada do campo (ou seja, a tradução reversa) seja exibido no gerenciador de objetos. As macros inseridas devem estar disponíveis na seção "Campos de exibição". Elas não podem substituir os campos de exibição, mas servem para complementá-los. ***DICA:*** *Mude para a visualização SQL e copie as entradas desejadas de lá.* **Exemplo:**\ Se você definiu GeoDin\_LOC\_S3STAMM.LONGNAME e GeoDin\_LOC\_S3STAMM.BART como campos de exibição e deseja que a descrição longa do tipo de furo (BART), ou seja, a tradução reversa da chave, seja exibida no gerenciador de objetos do GeoDin, a seguinte entrada deve ser escrita no campo de entrada **Instrução de rotulagem - consulta:** $GeoDin\_LOC\_S3STAMM.LONGNAME$ ($GeoDin\_LOC\_S3STAMM.BART$) O gerenciador de objetos agora mostra o seguinte: Furos (tipo de digestão)\ SEP3 Furo 1 (geral)\ SEP3 Furo 2 (digestão, preenchido)\ SEP3 furo 3 (furo oblíquo)\ SEP3 Furo 4 (geral) Se uma instrução de rotulagem for usada, uma macro adicional deve ser definida no campo de entrada **Instrução de rotulagem - Atualização:**. Como regra, a macro consiste nas referências de campo acima dela no campo de entrada, menos os nomes das tabelas. A macro é usada ao atualizar a exibição no gerenciador de objetos devido a alterações feitas no editor de dados mestres. (Contexto: no momento da atualização, o objeto carregado é usado para resolver a macro. A consulta inicial ou o registro de dados que levou à entrada no gerenciador de objetos não é armazenado em cache, pois isso não é necessário e apenas ocuparia memória. A macro para a atualização deve, portanto, ser criada com as referências de campo 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 que não são usados nos resultados exibidos no gerenciador de objetos do 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 classificação, clique duas vezes na entrada específica. A seta mostra a ordem de classificação atual. **Selecionar campos de resultado** Além dos campos de visualização e ordenação, também podem ser selecionados os campos de resultado, que não são usados nem para exibição nem para ordenação. No entanto, se os resultados da consulta forem exportados, por exemplo para GIS, use os campos de resultado para determinar quais campos de dados serão transferidos do GeoDin para a tabela de atributos da camada gerada. Arraste os campos desejados normalmente para o nó Campos de resultado (Exportação). Se quiser transferir todos os campos de uma tabela GeoDin, basta arrastar a tabela desejada para o nó Campos de resultado (Exportação). ### Comando SQL alternativo Além de construir consultas visualmente, você pode definir seus próprios comandos SQL usando a janela de Visualização SQL. A opção <[Comando SQL alternativo](https://docs.geodin.com/geodin-desktop/pt/consultas/sql-and-advanced-options)> permite definir um comando SQL SELECT para sua consulta: 1. O comando deve retornar um conjunto (cursor do banco de dados). Um comando SQL sem instrução SELECT no início não será executado. 2. A primeira linha do resultado retornado deve conter um GeoDin-Location-ID válido (LOCID) ou um GeoDin-Measurementpoint-ID (INVID) (dependendo do conjunto de resultados desejado). As consultas não são verificadas quanto à sua validade, mas há uma verificação formal de que a primeira linha do resultado contém números que podem ser convertidos em inteiros. Se o resultado não retornar um ID válido, o objeto não poderá ser selecionado posteriormente. Como nenhuma condição adicional é definida para o comando SQL, é possível integrar outras tabelas do banco de dados à consulta que não façam parte da estrutura do sistema GeoDin. É claro que tal consulta só faz sentido quando essas outras tabelas estão relacionadas a uma tabela do GeoDin, para que o resultado retornado forneça IDs válidos. O comando SQL alternativo mostra todos os parâmetros definidos visualmente na consulta (ordem, texto adicional etc.) desde que os nomes dos campos de dados correspondam. ### Consulta parametrizada No exemplo acima, foi definida na consulta a condição de que a profundidade final deve ser maior que 9 m. Em outro momento, você pode querer selecionar todos os furos com profundidade superior a 20 m. Para isso, você poderia alterar o valor de (>9m) para (>20m) na consulta existente ou definir uma nova consulta, que difere da primeira apenas no valor da profundidade. O GeoDin oferece outro método mais eficiente para definir consultas, que tenham condições semelhantes, deixando 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 isso, use o tipo ":?" no campo de restrição em vez de um número (profundidade) - veja abaixo: Condição Se SSGKRZT1.ZCOORDE>:? Campos de exibição SSGKRZT1.LONGNAME (até SSGKRZT1.ZCOORDE m) A condição de consulta usada é >:? Para caracterizar uma consulta parametrizada, um nome apropriado pode ser escolhido, por exemplo, "furos mais profundos que ?m", para indicar que a consulta é variável no Gerenciador de Objetos do GeoDin. Uma vez que a consulta é aberta pela primeira vez, uma janela de entrada é exibida, solicitando a inserção do parâmetro. Insira o valor de profundidade desejado e confirme clicando em **OK**. Como resultado, todos os furos mais profundos que o valor informado são exibidos no Gerenciador de Objetos do GeoDin. Os furos exibidos podem então ser usados para análises adicionais. Se você definir uma condição com um parâmetro variável em uma consulta, poderá selecionar se o parâmetro é uma entrada necessária (-parâmetro obrigatório-). Se essa opção estiver desativada, o campo de entrada pode ser deixado em branco na janela de entrada. Essa condição é deixada em branco ao executar a consulta do banco de dados e a característica não é usada para limitar os conjuntos de dados na seleção resultante. Além disso, um valor padrão pode ser definido, que é inserido automaticamente na janela de diálogo. Quando a consulta é iniciada, o valor já está inserido no campo de entrada e pode ser alterado, se desejado. Isso torna o preenchimento dos parâmetros ainda mais fácil. Dependendo do formato do campo, os valores padrão para as condições devem estar no seguinte formato: Sequência de caracteres: o valor padrão pode ser qualquer sequência de caracteres Valor numérico: o valor padrão deve ser um número; o separador decimal é um ponto (.). Data: o valor padrão deve ser uma data completa no formato dd.mm.aaaa (dia-mês-ano) **Usar intervalo** Se uma consulta for parametrizada, é possível usar um intervalo em vez de um limite superior e inferior. Um exemplo disso é a busca por objetos em uma área ao redor de um ponto específico. Isso é possível com uma consulta parametrizada e os parâmetros: (X >= X\_value1) e (X <= X\_value2) e (Y >= Y\_value1) e (Y <= Y\_value2) Se os valores das coordenadas tiverem vários dígitos, inserir os 4 parâmetros necessários é trabalhoso. Nesses casos, a opção -Usar intervalo- oferece uma possibilidade mais fácil. Para usá-la, defina apenas duas condições: X = :? e Y = :? e ative a opção -Usar intervalo-. Também pode ser fornecido um valor padrão para o intervalo. A partir da condição (X = X\_value) e (Y = Y\_value), o GeoDin gerará automaticamente 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âmetros, precisam ser inseridas apenas as coordenadas do centro e o intervalo. O uso de 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$** Você pode usar o espaço reservado $%SYSDATE$ como valor padrão de um parâmetro de data para definir a data atual como valor padrão. Também são possíveis expressões matemáticas com a macro $%SYSDATE$, por exemplo, $%SYSDATE$ - 7 para obter uma data padrão de uma semana atrás. **Alterar parâmetros** Para alterar um valor definido, use o método **Alterar parâmetro** no objeto da consulta: Em uma consulta, qualquer número de parâmetros pode ser definido. **Exemplo:** Condição Se LOCREG.XCOORD>=:? LOCREG.XCOORD<=:? LOCREG.YCOORD>=:? LOCREG.YCOORD<=:? Campos de exibição SSGKRZT1.LONGNAME No exemplo acima, quatro parâmetros são definidos para construir um retângulo de coordenadas. O primeiro 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 janela de diálogo desta consulta é mostrada abaixo: ### Atualizar consulta Em um ambiente multiusuário, muitas vezes pode ser necessário atualizar uma consulta para refletir mudanças nos próprios dados. O GeoDin verifica automaticamente alterações nos objetos usados para exibição (por exemplo, um nome de objeto mostrado no gerenciador 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, pois isso interferiria no fluxo de trabalho com grandes conjuntos de dados. Da mesma forma, se outro usuário alterar a profundidade final, isso não é atualizado automaticamente na consulta. Há uma maneira simples de atualizar rapidamente os resultados da sua consulta para incorporar alterações nos dados (por exemplo, valores de profundidade final). Clique com o botão direito do mouse na consulta no gerenciador 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 em um projeto para usar em outro. Para copiar uma consulta para todos os projetos, selecione o botão **Todos** . A consulta será copiada para todos os projetos selecionados no banco de dados. Se você tiver usado o identificador do projeto (campo de dados PRJ\_ID) na condição, na exibição ou no comando SQL alternativo, ele será ajustado automaticamente para o outro identificador de projeto ao copiar a consulta, de modo que a consulta duplicada não precise ser corrigida no projeto de destino. ### Excluir consulta Este método exclui a definição da consulta. Você **não** exclui os objetos contidos nos resultados da consulta, apenas a condição que produz esses resultados. ### Agrupar objetos Em algumas situações, os objetos de um banco de dados não podem ser consultados adequadamente. Isso pode ocorrer devido a entradas de banco de dados incompletas ou ausentes, ou porque outros critérios, não armazenados no banco de dados, são importantes. Para esses casos, o GeoDin oferece a possibilidade de criar **Grupos** de objetos que não obedecem a condições específicas. O método **"Novo grupo"** está disponível nos nós de objetos e de pontos de medição. Digite um nome para o grupo que será usado no gerenciador de objetos do GeoDin para identificação. Após criar um grupo, a lista inicialmente fica vazia. Para preenchê-la, selecione um objeto no gerenciador de objetos do GeoDin, mantenha pressionado o botão esquerdo do mouse, arraste e solte-o na janela de diálogo aberta. Você pode selecionar objetos ou grupos individuais no gerenciador de objetos do GeoDin. Você pode excluir e alterar a ordem dos objetos em um grupo usando os botões apropriados na janela de diálogo <**Grupo**>. Os objetos são inseridos na lista com a designação que possuem no momento da inserção. Esse texto não pode ser alterado posteriormente e não será atualizado mesmo que a situação dos dados mude. Em contraste, nas consultas, os textos 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 em um grupo cujos rótulos já não estejam corretos após uma alteração nos dados do objeto. Este exemplo mostra que os grupos têm várias desvantagens em comparação com as consultas e, portanto, devem ser usados apenas se uma consulta realmente não for possível pelas razões mencionadas no início ou se você esperar que os dados desses objetos não mudem mais. Consultas e grupos são mostrados com pirâmides de cores diferentes no gerenciador de objetos do GeoDin - amarelo para consultas e azul para grupos. A visibilidade pode ser controlada para usuários e grupos nas configurações avançadas no gerenciamento de usuários. ### Excluir grupo de objetos Este método exclui a definição do grupo, **não** os objetos contidos dentro do grupo. ### Importar grupos Use o **"Importar grupo"** método para pesquisar objetos GeoDin em um banco de dados GeoDin com base em dados externos ("arquivo de importação") e agrupar os objetos encontrados. Dependendo do nó em que o método é iniciado, os objetos GeoDin são pesquisados em todo o banco de dados (nó "Objetos" um nível abaixo do banco de dados) ou apenas em um projeto (nó "Objetos" um nível abaixo do projeto). As seguintes etapas são necessárias: **Fonte de dados** Aqui você abre o arquivo (por exemplo, arquivo Excel, banco de dados) que contém as informações sobre os objetos GeoDin que devem ser pesquisados (e posteriormente agrupados) no banco de dados. **Vínculo do objeto** Aqui você vincula os objetos GeoDin do banco de dados às especificações na fonte de dados. Esta etapa inicia a seleção dos objetos a serem agrupados. [Importação](https://docs.geodin.com/geodin-desktop/pt/importando-dados/import) Faça aqui as configurações de controle de comparação. A pré-visualização mostra quais objetos GeoDin são encontrados no banco de dados usando as informações no arquivo de importação e quais objetos GeoDin não são mencionados no arquivo de importação. Inicie aqui a criação do grupo. **Salvar e carregar configuração** Todas as configurações de importação de grupo podem ser salvas em um arquivo de configuração. O arquivo de configuração permite a rápida repetição da criação de um grupo em um momento posterior, se a base de dados for semelhante ou igual. ### Fonte de dados Abra o arquivo que contém as informações sobre os objetos GeoDin a serem pesquisados (e posteriormente agrupados) no banco de dados. Os seguintes formatos de arquivo são suportados: 1. MS Excel 2. MS Access 3. dBASE 4. Arquivos de texto 5. Arquivos CSV Após selecionar o arquivo, especifique a fonte de dados e selecione uma planilha (Excel), uma tabela (Access, dBase) ou um separador de colunas (CSV, arquivo de texto). Os dados de pesquisa são exibidos na pré-visualização. Para arquivos MS Excel ou de texto, você também pode especificar se a primeira linha contém títulos de coluna. O formato de data usado nesses arquivos também pode ser especificado. O GeoDin leva essa configuração em consideração ao converter datas posteriormente. Use este botão para remover registros selecionados da pré-visualização se você não quiser que eles sejam incluídos na pesquisa (os registros serão removidos apenas desta pré-visualização; o arquivo de origem permanece inalterado). ### Vínculo do objeto Nesta etapa, você atribui os registros de dados no seu arquivo de importação aos objetos GeoDin no seu banco de dados. A atribuição é baseada na correspondência de conteúdos entre dados mestres selecionados dos objetos GeoDin e os registros de dados no arquivo de importação. **Exemplo** O arquivo de importação contém uma coluna com uma seleção de nomes de furos. Esses furos devem ser agrupados no GeoDin. Para a atribuição, você deve associar a coluna do arquivo de importação ao campo LONGNAME da tabela de dados mestres do GeoDin. A busca pelos objetos GeoDin a serem agrupados é então realizada comparando os nomes dos furos. Se você especificar vários conteúdos para a atribuição do objeto (por exemplo, nome do furo, localização do furo etc.), somente serão selecionados para agrupamento os objetos GeoDin no banco de dados para os quais todos os campos coincidirem. **Tabelas**: Selecione a tabela de dados mestres do banco de dados que servirá de base para uma comparação de dados mestres entre o arquivo de importação e os objetos GeoDin. Para atribuir os campos a serem referenciados, arraste e solte as entradas individuais das listas "Tabelas:" e "Fonte de dados:" para o campo correspondente na outra lista. Como alternativa, você pode selecionar os dois campos e dar um clique duplo em um deles para fazer a atribuição. No caso de nomes de coluna no arquivo de importação que sejam idênticos aos nomes de coluna na tabela de dados mestres do banco de dados, você pode atribuir essas entradas correspondentes automaticamente usando o botão \. As atribuições feitas são transferidas para a tabela "Atribuições:". Ao mesmo tempo, as entradas atribuídas são removidas das listas "Tabelas:" e "Fonte de dados:" para que permaneçam apenas as entradas que ainda não foram atribuídas. Com os dois campos de entrada abaixo das listas, o conteúdo das listas pode ser filtrado. Se um termo for inserido, apenas as entradas que contêm esse termo serão exibidas nas listas. Se você esvaziar o campo de entrada, todas as entradas serão exibidas novamente. Atribuições inválidas são destacadas em cores na tabela. Isso ocorre quando você altera a fonte de dados depois de fazer a atribuição. Remova essas entradas usando o botão\ . ### Importação Faça os ajustes finais para a criação do grupo e veja uma pré-visualização do status das atribuições. Em seguida, inicie a criação de um novo grupo. **Opções de comparação**\ Se você marcar a caixa *\[Diferenciar maiúsculas e minúsculas]*, os nomes das colunas do arquivo de importação e os da tabela de dados mestres só serão atribuídos se a grafia também corresponder em relação ao uso de maiúsculas e minúsculas. **Pré-visualização**\ A janela de pré-visualização fornece uma visão geral das atribuições realizadas. Há três tipos de resultados: *Um objeto GeoDin foi encontrado* Exatamente um objeto GeoDin pôde ser encontrado no banco de dados para a entrada a ser pesquisada. *Vários objetos GeoDin foram encontrados* Vários objetos GeoDin foram encontrados no banco de dados para a entrada a ser pesquisada. Isso significa que o conteúdo do seu arquivo de importação não é único. Talvez seja necessário incluir mais campos de dados na comparação para encontrar os objetos GeoDin corretos. *Nenhum objeto GeoDin foi encontrado* Não há nenhum objeto GeoDin no banco de dados com informações que correspondam ao termo de pesquisa. Verifique a atribuição dos campos de dados e o conteúdo do arquivo de importação. **Filtro para a pré-visualização**\ Você pode filtrar e classificar as atribuições exibidas na pré-visualização. Para isso, clique no cabeçalho da coluna desejada.\ "**Use a caixa suspensa "Filtro para pré-visualização:"** para exibir apenas um dos três tipos de resultados (veja acima) na janela de pré-visualização. **Executar importação**\ Com um clique no botão \*\*Executar importação\*\*, todos os objetos GeoDin atribuídos com sucesso são combinados em um novo grupo no Gerenciador de Objetos do GeoDin. No cabeçalho "Execução", você pode definir um nome para o novo grupo na janela de edição. Por padrão, o nome do arquivo de importação é pré-preenchido aqui.\ Após a execução, um log é exibido, que você pode salvar usando o botão correspondente. Se quiser criar outros grupos, volte para **Fonte de dados**. ### Gerenciamento de usuários A visibilidade/usabilidade de vários métodos e funções pode ser restringida por meio da administração de usuários. Por padrão, a opção *"Todos"* está ativada - ou seja, sem restrição. Por meio da opção Grupos de usuários, a funcionalidade pode ser liberada explicitamente para determinados *grupos ou usuários individuais*. Isso é 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 **Configurações do usuário**. ### Mapeamento de campos Este capítulo de ajuda não está disponível no idioma atual. Você pode atualizar os arquivos de ajuda do GeoDin com a função \. Para isso, é necessária uma conexão com a internet. Ao SQL definido pelo usuário podem ser anexadas informações de estrutura. Assim, são possíveis formatações de casas decimais ou conversões de unidades para campos numéricos, ou traduções de dicionário para campos de texto. Para o mapeamento de campos, um campo de resultado é atribuído a um campo da estrutura do GeoDin. **Exemplo:** select $Schema$GeoDin\_LOC\_LOCE2LAYER.\* from $Schema$GeoDin\_LOC\_LOCE2LAYER Atribuição: Estrutura da tabela do banco de dados GeoDin\_LOC\_LOC\_E2LAYER.SECSTYPE E2LAYER.SECSTYPE --- # Agent Instructions: 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: ``` GET https://docs.geodin.com/geodin-desktop/pt/consultas/sql-and-advanced-options.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.