> 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/es/analisis-de-datos/query-builder-reference.md). # Referencia del generador de Consulta El Generador de Consulta define una subconsulta GeoDin como un conjunto de definiciones de nodos individuales: lista de Tablas, cláusula FROM, Condiciones, Resultado y campos de visualización, que GeoDin combina en una sentencia SQL Completo. Esta página es la referencia de cada nodo de esa definición: qué configura y la sintaxis que acepta. Usar esta página cuando esté construyendo o editando una Consulta y necesite saber qué hace un nodo específico. *** ## Referencia: nodos del Generador de Consulta Cada subsección a continuación documenta un nodo de la definición de la subconsulta, en el orden en que aparecen en el generador. ### Tablas La lista de tablas de una subconsulta contiene los contenidos de todos los identificadores de tablas o vistas usados en la Consulta. Estos son los nombres de Tablas/Vistas en la Base de datos que se referencian en la instrucción FROM. El propósito de esta Lista es hacer cualquier adición de esquema necesaria a estos nombres antes de que se ejecute la sentencia SQL. Como la instrucción FROM puede contener cualquier sintaxis SQL (incluida la sintaxis específica de la Base de datos), GeoDin no evaluará esta cadena para determinar qué nombres de tablas deben ampliarse con un nombre de esquema. En su lugar, la lista de tablas definida aquí indica a GeoDin qué nombres Incluir en la instrucción FROM y en las demás partes de la configuración de la Consulta. Todos los nombres especificados aquí se amplían automáticamente con el nombre de esquema de la Configuración de la Base de datos de GeoDin. **Ejemplo:** Todas las Tablas de GeoDin son creadas por el usuario dbo, Creado por el propietario de la Base de datos. Por lo tanto, todos los usuarios solo pueden acceder a las Tablas si el esquema está listado y se usa el Nombre tablas completo: dbo.GeoDin\_LOC\_LOCREG Para evitar tener que especificar la sustitución del esquema para cada Tabla, es posible almacenar el esquema de las Tablas de GeoDin en la Configuración de la Conexión al base de datos para bases de datos de Usuario. **Configuración** para bases de datos de Usuario. ***Nota:*** *Los nombres de Seudónimo dados en la sentencia FROM (por ejemplo, para subconsultas) no pueden Incluirse aquí. De lo contrario, la extensión del esquema se añadirá al Seudónimo y la sentencia fallará.* ### Consultas del sistema a nivel de Proyecto (GeoDin 10 y Posterior) Desde el cambio de estructura del Proyecto en GeoDin 10, una Consulta del sistema que se va a mostrar a nivel de Proyecto debe Incluir la Tabla Registar objeto `GEODIN_LOC_LOCREG` - añadirlo a la Lista de Tablas y a la cláusula FROM de la Consulta. {% hint style="warning" %} Cuando se omite la Tabla Registar objeto de una Consulta del sistema a nivel de Proyecto, al ejecutar la Consulta se devuelve uno de los siguientes Errores, dependiendo del Sistema de Base de datos: * base de datos Access de Microsoft: `[FireDAC][...] Faltan Parámetros. Se esperaba 1.` * Base de datos Cliente/servidor: `[FireDAC][...] Nombre de Columna No válido 'ProjectGUID'.` {% endhint %} ### Configuración En la Configuración se realizan los ajustes para la Consulta, basados en la Base de datos utilizada para la Consulta. La Configuración abarca: 1. la cláusula FROM en la [enlace (de)](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md) nodo para el Comando SQL 2. y otros criterios [campos restringidos](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md) para la restricción Automáticamente (WHERE) de la Consulta, dependiendo de la Posición de la Consulta en el gestor de Perforación de GeoDin 3. Definición de la Información necesaria para procesar el Resultado de la consulta [Resultados](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md) Para el ingreso ***Subconsultas*** es posible ver la consulta haciendo clic Sobre, en "Vista previa SQL" para la subconsulta deseada. ***Nota:*** *La sentencia SQL mostrada en la Vista previa puede probarse directamente en la Base de datos después de reemplazar la Identificación del Proyecto ($PRJID), la Identificación de la Localización ($LOCID) o el INVID ($INVID)* **Opciones adicionales:** 1. -\*DISTINCT al Ejecutar la consulta en el GeoDin Gestor de Perforación- Defina si un comando de Seleccionar DISTINCT ... debe ser Ejecutar en la consulta o solo un comando de Seleccionar. En Ambos casos GeoDin muestra una Perforación que está Disponible más de una vez en una consulta solo una vez en el gestor de Perforación. Esto se hace mediante una comprobación de los Ids del Objeto. Un DISTINCT general no está en uso como estándard, porque el uso de ese comando depende del diseño de la consulta. Cuando esté seguro de que su Comando SQL permite un distinct, esta opción puede acelerar la consulta significativamente. 1. -Ignorar error- Cuando la consulta conduce a un error como estándard se muestra una Participación de error. Puede Ocultar la Participación de error al Usar esta opción. Cuando al Ejecutar la consulta conduce a un error de esta manera, el error se ignora y la consulta no se inserta en el gestor de Perforación. Puede Usar esta opción, cuando quiera crear una consulta que no pueda ser usada en Cualquiera tipo de Base de datos y quiera Ignorar este error. Se recomienda que, en lugar de Usar esta opción, la Configuración de la **Requisitos** se usan para una Consulta, porque Siempre es más rápido controlar los Requisitos que a incurrir en un error en una Consulta. 1. -Usar DISTINCT para Exportar Capa- Cuando la Consulta se utilice para Crear un Archivo de Capa, puede Seleccionar aquí si se debe usar un SELECT DISTINCT o un comando "simple" SELECT para el Exportar de la Capa. ### Condición Esta Sección de la definición de Consultas del sistema puede utilizarse opcionalmente para limitar los Resultados de la Consulta. Esta Sección es comparable a la cláusula WHERE de una Consulta SQL y se puede añadir automáticamente a la Consulta de la Base de datos. En la Lista, se pueden añadir una o más entradas para Editar. ### O **¯¯¯** Esta Sección de Consultas del sistema se puede usar para reducir los Resultados de la Consulta. Es equivalente a la restricción WHERE de una Consulta SQL y se agregará automáticamente a la Consulta de Base de datos. Los operadores lógicos posibles son las relaciones Y y O, que pueden ordenarse en dos niveles. Sobre, en el Primero nivel, las subconsultas conectadas se vinculan con una O. Primero, la Condición aparece con la palabra clave Cuando y marca el comienzo de las Condiciones. En el Primero Paso, por lo tanto, se define: <\> O <\> O <\> ... Para el Segundo Nivel, las Condiciones individuales son los criterios "Verdadero" de la Consulta, donde se pueden usar operadores Y. **Ejemplos de Condiciones** Ejemplo usando las Coordenadas de un Punto de medida (Operador O): La Consulta deberá encontrar todos los Puntos de medida donde las Coordenadas X (XCOORD) sean mayores que 100 o las Coordenadas Y sean mayores que 50. Las Condiciones serían: ``` Cuando XCOORD \> 100 O YCOORD \> 50 ``` El ejemplo puede ampliarse para demostrar la Búsqueda de Objetos con sus Coordenadas (Relación O y Y). La Consulta encuentra todos los Puntos de medida con Coordenadas X mayores que 100 y menores que 200 o con Coordenadas Y mayores que 50 y menores que 100: ``` Cuando XCOORD \> 100 XCOORD \< 200 O XCOORD \> 50 YCOORD \< 100 ``` Cuando las Condiciones para Ambos, las X-Coordenadas y las Y-Coordenadas, deben coincidir, las Condiciones se introducen en el Segundo Nivel (Y) de la Consulta: ``` Cuando XCOORD \> 100 XCOORD \< 200 YCOORD \> 50 YCOORD \< 100 ``` ### Y Para el Nivel de las Condiciones, diferentes Condiciones de Búsqueda deben definirse. Aquí, las Condiciones se definen ya sea como Condiciones individuales, o como una combinación con Y lógico. Es posible combinar grupos de Condiciones entre sí mediante un lógico [O](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md). **Configurando las Condiciones** En el Nombre del campo de datos, se debe definir el Nombre de campo del Campo que se utilizará para la Consulta. El Nombre de campo se proporciona en el formato \.\. En el campo "Condición", la Condición deseada puede definirse directamente, o puede usarse una Condición parametrizada. Cuando se define directamente, la Condición se expresa como un Término lógico con un Operador relacional y un Valor. Posibles operadores relacionales: \> mayor que \=> mayor o igual a < menor que <= menor o igual \= igual a <> no es igual a es nulo, Campo está Vacío no es nulo, Campo no está Vacío como 'A%' Contenido(s) entre comillas Alto usando comodines en la cadena de caracteres: \_ un carácter o % varios caracteres en ('T1','T2') Lista de Valores en paréntesis Redondear, Valores separados por comas, los campos de texto tienen Valores entre comillas Alto, el campo numérico tiene Valores usando punto decimal (no una coma) y no en comillas Alto **Condiciones** que realizan una Consulta a **Fecha** : por favor, compruebe su base de datos para el formato correcto: Los siguientes Formatos de Texto estándar están Disponible: Acceso #MM/DD/YYYY# Oracle 'DD-MM-YYYY' MySQL, MS SQL, PostgreSQL 'DD.MM.YYYY' **Condiciones** que realizan una Consulta a **Fecha/Hora(Fecha/Hora)**: Usar los siguientes Formatos de Texto estándar: Acceso: #MM/DD/YYYY HH:MM:SS# Oracle: A\_FECHA('*31.05.2015 12:24:36'*,'dd.mm.yyyy hh24:mi:ss') MySQL, MS SQL, PostgreSQL: 'DD.MM.YYYY HH:MM:SS' Cuando se usa una consulta con parámetros, se abre una ventana cuando la Consulta se ejecuta por Primero vez. Todo Condiciones marcadas como parametrizadas pueden introducirse y cambiarse en esta ventana. ***Nota:*** *El uso de una condición parametrizada se indica mediante los caracteres ":?". Opcionalmente, se puede especificar un operador de comparación antes de esta cadena de caracteres. En este caso, este operador se rellena previamente cuando se consultan los parámetros.* Cuando se usa una consulta con parámetros, los diferentes Ajustes necesarios se vuelven Disponible. El parámetro puede marcarse como Campo necesario - Cuando no es Campo necesario, el parámetro se ignorará cuando esté Vacío. También es posible introducir Valores por defecto y a Usar un intervalo. La opción -Usar intervalo- produce un tipo especial de Condición. Cuando quieres Selecionar objetos en una Superficie definida alrededor de una coordenada seleccionado, la siguiente Condición es posible: 1. Nombre de campo: GeoDin\_LOC\_LOCREG.XCOORD 2. Condición: >=:? 3. x Usar intervalo 4. 100 Cuando se ejecuta la consulta, se muestra una ventana de entrada que muestra la coordenada X seleccionada (Este), la distancia (100 por defecto) que debe introducirse. La siguiente condición WHERE se añade automáticamente a la sentencia SQL: ... (GeoDin\_LOC\_LOCREG.XCOORD >= C*ordenada*-100) y (GeoDin\_LOC\_LOCREG.XCOORD <= C\*oordinate+\*100) Si selecciona una segunda condición para el Campo GeoDin\_LOC\_LOCREG.YCOORD (Norte), se pueden seleccionar Objetos de un Rectángulo dado alrededor de la Localización seleccionada introduciendo 3 números en lugar de introducir las esquinas del Rectángulo. **Usando el parámetro $%SYSDATE$** Puede usar $%SYSDATE$ como marcador de posición para el parámetro de Fecha, para seleccionar la fecha Actual como Valores por defecto. También son posibles términos matemáticos con la macro $%SYSDATE$, por ejemplo, $%SYSDATE$-7 para seleccionar el mismo día de hace una semana. ### Campo para indicación Los campos de visualización definen qué campos de la Base de datos de una Perforación se van a mostrar en el GeoDin Administrador de Perforación (GOM). Los Objetos y los Contenido(s) que se muestran son en realidad los Resultados de una Consulta; normalmente se trata del Nombre de una Perforación o "LONGNAME". Sin embargo, es posible combinar campos para una visualización más detallada, como Nombre y Tipo de Pozo de sondeo. Puede organizar cuáles y cuántos campos se van a mostrar [Display](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md). Hay instrucciones de formato opcionales para mostrar el Texto. En el campo de Ingreso puede definir la macro que se aplica a los Resultados de la Consulta SQL. Cuando no se define ninguna macro, los Registros de datos se mostrarán tal como existen en la Base de datos. Esto significa, por ejemplo, que los códigos no se volverán a traducir al Texto Completo, sino que se mostrarán como códigos. La macro solo puede contener referencias a campos de visualización definidos. Por lo tanto, la macro no reemplaza los campos de visualización, sino que los complementa y les da formato. Seleccionar DISTINCT GeoDin\_LOC\_LOCREG.LOCID, GeoDin\_LOC\_ZMGENINF.SHORTNAME, GeoDin\_LOC\_ ZMGENINF.PURPOSE .... Las macros de texto se implementan exactamente de la misma manera que en una plantilla, de ahí el Rango de Opciones de formato Disponible. **Ejemplo:** $GeoDin\_LOC\_ ZMGENINF. NOMBRE CORTO $ ($GeoDin\_LOC\_ZMGENINF.PROPÓSITO $) Cuando se usa una macro de Indicaciones de rotulación, debe definirse una macro Adicional que se usa cuando la macro se actualiza en el GOM. Esto ocurre siempre que se editan y guardan Sondeos en general. Para este momento, la Perforación cargada se usa para resolver la macro. La Consulta inicial ni el registro de datos que proporciona el Ingreso en el GOM, ya que esto no es necesario y solo usaría memoria de forma innecesaria. La macro para la actualización debe crearse como en una plantilla con referencias de campo a la Perforación. Normalmente se omiten los nombres de tabla anteriores. ### Ordenar campos Aquí se pueden seleccionar Campos de datos Adicional como criterios de Orden Adicional para los Resultados de la Consulta (es decir, independientes de los campos mostrados). Un campo de ordenación se define usando \.\. Se añade automáticamente un comando ORDER BY a la sentencia SQL al usar Ordenar campos. Adicionalmente, puede definir, cuando la ordenación se usa para Ejecutar en el gestor de Perforación o en un Seleccionar diseño. ### Resultados Resultados se añaden a la lista de Campo de datos de la sentencia Seleccionar y definen la estructura de los datos de Resultado. Un Campo de resultados se define por \.\. ### Subconsulta Una Subconsulta es una Consulta independiente Sobre, en la Base de datos (una instrucción SQL), que da una cantidad de Resultados. La instrucción SQL es no definido como una instrucción Completo, sino mediante un Número de definiciones individuales. En campos de entrada separados, se definen ciertos fragmentos de la Consulta, que GeoDin combina a una instrucción SQL Completo. La razón de esto es un Número de partes Nombre de la variable de la instrucción SQL; por ejemplo, la Lista de campos en Seleccionar, que será creado en GeoDin de acuerdo a el uso designado. Esta es la única manera a lograr una Consulta optimizada (orientada al propósito) en la Base de datos, que difiere considerablemente, por ejemplo, al ejecutar la Consulta en el administrador de Perforación de GeoDin en lugar de ejecutar la misma Consulta para la recuperación de datos en Seleccionar diseño. **Nombre** Aquí se puede introducir un Nombre para la Subconsulta. **Descripción plantilla** Introduzca aquí una breve Descripción de la Consulta. La Descripción se muestra en el asistente de consultas, cuando la Consulta se define como una plantilla para Consultas de Usuario (véase [Consulta del sistema](/geodin-desktop/es/analisis-de-datos/creating-queries/sql-and-advanced-options.md)) **Combinar condiciones con O/Y** Esta opción controla la combinación de Condiciones individuales de la Consulta. Dependiendo de la Consulta con varias Condiciones, la *"O"* conexión en el nodo principal (Condición 1 Y Condición 2) O (Condición 1 Y Condición 3) puede sustituirse mejor por un *"Y"* conexión en el nodo principal (Condición 1) Y (Condición 2 O Condición 3). **Vista previa SQL** Aquí, el Comando SQL se muestra según la Configuración Actual de la Consulta. **Tipo de consulta de una Consulta de objeto** Cuando se edita un [Consulta de objeto](/geodin-desktop/es/visualizacion-disenos-e-informes/creating-custom-layouts/object-frames.md#object-frame-queries) puedes elegir entre definir un modelo estructurado o una sentencia SQL completa. Una sentencia SQL permite todas las posibilidades de Selección de datos (p. ej., Seleccionar Recuento(Datafield) AS GCCOUNT FROM Tabla), pero probablemente no sea ejecutable en todos los tipos de Base de datos. En general, un modelo estructurado es preferible. ### enlace (de) El Enlace es la cláusula FROM de una sentencia SQL. La Información puede recopilarse de una Tabla o de un conjunto de Tablas según lo definido en la Condición FROM. Cuando solo se ha seleccionado una Tabla, aquí solo se debe introducir el Nombre tablas. Para expresiones más complejas, la sintaxis de la cláusula FROM debe seguir las especificaciones SQL del Sistema de Base de datos utilizado. La definición o estructura de la cláusula FROM puede variar entre diferentes sistemas de Base de datos vencido a las especificaciones de la sintaxis SQL específica. ***Pista:*** *Puede ser útil Crear la Consulta Primero en un programa de Base de datos usando un editor gráfico de Consulta. Luego, la cláusula FROM de la sentencia puede copiarse aquí (Ejemplo: El editor de Consulta en MS Access)* ### campos restringidos Los campos de restricción se utilizan para definir Campos de datos que GeoDin agrega automáticamente a la Condición WHERE de la Consulta según la Posición de la Consulta en el gestor de objetos para restringir el conjunto de resultados de acuerdo con la estructura del gestor de objetos. La base son los [Condiciones de visualiyzación](/geodin-desktop/es/analisis-de-datos/query-builder-reference/conditions-and-operators.md) de la Consulta. **Base de datos, Consultas de la base de datos** Las Consultas no están más restringidas. Los campos restringidos pueden permanecer Vacío. **Proyecto, Consultas del proyecto** Las Consultas están restringidas usando el Proyecto Identificación. El campo de restricción PRJ\_ID tiene a ser rellenado. **Perforación** La Consulta está restringida utilizando el Proyecto Identificación y el Objeto ID. Los campos restringidos PRJ\_ID y LOCID tienen que rellenarse, a fin de que se completen. **Punto de medida** La Consulta está restringida mediante el uso de la Identificación del Punto de medida. El campo restrictivo INVID debe rellenarse a continuación. Las Secciones tienen que ser seleccionadas en el Formato del papel \.\ y tienen que ser parte del Resultado de la Consulta. ### Display Los campos de visualización definen qué campos de la Base de datos se usan para nombrar los Resultados de la Consulta en el gestor de Perforación GeoDin. De este modo, el Nombre puede componerse a partir de varios campos. Un campo de Base de datos de uso común es el Nombre del objeto LONGNAME. Pero también puede Usar nombres combinados como Nombre Y Profundidad. ``` Base de datos DemoDB Demostración de GeoDin Objetos Puntos de medida Proyecto Pozo de sondeo 1 Pozo de sondeo 2 Proyecto 2 Proyecto 3 Objetos Puntos de medida Base de datos ``` **Campo Nombre** En este campo, el Campo que se va a mostrar se define en el formato \.\. **Texto de extensión** Los caracteres introducidos aquí se añaden al Contenido del Campo como "texto de extensión". Por ejemplo, el Contenido de un Display como GeoDin\_LOC\_LOCREG.ZCOORDE (profundidad final) puede complementarse con la Unidad de medida, p. ej.: " m" o con versiones más largas, como "en m por debajo de la Altura Inicial". **Seleccionar criterios** Seleccionar la secuencia de ordenación para este Campo. Se añade automáticamente una cláusula ORDER BY a la instrucción SQL. ### Propiedades del portal ### Website propiedades Aquí configuras la resolución, el Actualizar intervalo, y un color de E:Background para la Página Web. También puedes seleccionar una Plantilla HTML para la Página Web. **Conservar Seleccionar diseño en caché:** cuando se marca esta casilla, El diseño se mantiene en la caché durante un período fijo. Dependiendo de El diseño, esto puede acortar notablemente la Hora de respuesta del servidor. ### Ajustes de cache Aquí estableces el Número de Minutos durante los cuales El diseño se mantiene en la caché. Cuando los datos para supervisar diseños se actualizan cada cinco minutos, por ejemplo, tiene sentido Conservar el diseño en la caché durante cinco minutos también. Después de este tiempo se elimina automáticamente y se vuelve a conectar con datos frescos Sobre, en la siguiente solicitud. --- # 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/es/analisis-de-datos/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.