Usar los parámetros de consulta

Las consultas de Knowledge Studio admiten parámetros de consulta. Una vez escritas, las consultas son estáticas y los parámetros de la consulta permiten que partes de la consulta sean dinámicas. Un parámetro de consulta es una variable de la consulta cuyo valor se define cuando se ejecuta la consulta. Esto permite a los usuarios ejecutar la misma consulta con diferentes valores sin tener que modificarla.

Por ejemplo, puede escribir una consulta para encontrar todas las entidades directamente relacionadas con una persona: MATCH (p:Person)-[]-(n) WHERE p.Name = "John Doe" RETURN n. Los parámetros de consulta reemplazan John Doe por una variable $name que se puede configurar para que sea cualquier nombre: MATCH (p:Person)-[]-(n) WHERE p.Name = $name RETURN n. El panel Parámetros de la vista de consulta le permite definir el parámetro $name y luego cambiar el valor sin modificar la consulta.

Tipo de parámetro	Descripción
Cadena de caracteres	Cualquier conjunto de caracteres alfanuméricos.
Número	Coincide con las propiedades de gráfico de cualquier tipo de número excepto Entero grande. Nota: Knowledge Studio solo admite números enteros seguros comprendidos entre -9007199254740991 (mínimo) y 9007199254740991 (máximo). Los números que estén fuera de este rango serán incorrectos debido al redondeo, por lo que no coincidirán con los campos de Entero grande en el gráfico de conocimiento.
Geometría	Defina geometrías para usar en cualquiera de los operadores espaciales admitidos en las consultas. En este momento, solo admite geometrías rectangulares.
Solo fecha	Valores de fecha solamente, sin valores de tiempo. Más información sobre el uso de valores de fecha y hora en las consultas
Solo hora	Valores de solo hora con precisión de segundos sin valores de fecha. Más información sobre el uso de valores de fecha y hora en las consultas
Fecha	Precisión de los valores de fecha y hora en segundos (baja precisión) y milésimas de segundo (alta precisión) Más información sobre el uso de valores de fecha y hora en las consultas
Desfase de marca de tiempo	Fecha, hora y desfase con respecto a la zona de Tiempo Universal Coordinado (UTC). Más información sobre el uso de valores de fecha y hora en las consultas
Entidad	Entidades en el gráfico de conocimiento.
Relación	Relaciones en el gráfico de conocimiento.

Configurar nuevos parámetros

El panel de configuración le permite definir e inicializar los parámetros en su consulta. Deben configurarse todos los parámetros utilizados en la consulta para que la consulta se ejecute. Los parámetros pueden ser de uno de los tipos siguientes:

Parámetro de Cadena de caracteres

Configure un parámetro de Cadena de caracteres.

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Cadena de caracteres en el menú desplegable Tipo
6. Introduzca la cadena de caracteres en el cuadro de entrada que se utilizará como Valor inicial para el parámetro. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro.
7. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Parámetro Número

Configurar parámetro de Número

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Número en el menú desplegable Tipo.
6. Introduzca el número en el cuadro de entrada que se utilizará como Valor inicial para el parámetro. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro.
7. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Parámetro de geometría

Configure un parámetro de Geometría.

Obtenga más información sobre los operadores espaciales en las consultas.

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Geometría en el menú desplegable Tipo.
6. Haga clic en Establecer geometría para definir el Valor inicial del parámetro. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro. .

   Se abre el modal de bosquejo de geometría.

7. Haga clic en la herramienta Rectángulo de la barra de herramientas de gráficos.
8. Haga clic y arrastre sobre el mapa para dibujar un rectángulo alrededor del área de interés.

   Si se está configurando una lista de geometrías, este paso debe realizarse para cada geometría.

9. Si lo desea, seleccione la geometría utilizando uno de los métodos siguientes en la barra de herramientas de gráficos.
   • Seleccionar entidad: haga clic en la entidad para seleccionarla.
   • Seleccionar por rectángulo: haga clic en el mapa y arrastre un rectángulo sobre la entidad para seleccionarla.
   • Seleccionar por lazo: haga clic en el mapa o en el gráfico de vínculos y dibuje con el puntero para crear una selección de forma a mano alzada.
10. Si lo desea, modifique o elimine una entidad:
    • Cambie el tamaño de la entidad haciendo clic en uno de los rectángulos por los bordes o esquinas y arrastrándolo para cambiar el tamaño.
    • Mueva la entidad haciendo clic en cualquier parte de ella y arrastrándola a una nueva ubicación en el mapa.
    • Haga clic en Eliminar entidad en la barra de herramientas de gráficos para eliminar la entidad.
    • Haz clic en Borrar para restablecer el mapa.
11. Haga clic en Aceptar.
12. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Solo fecha

Configure un parámetro de Solo fecha.

Más información sobre el uso de valores de fecha y hora en las consultas

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Solo fecha en el menú desplegable Tipo.
6. Establezca la fecha que se utilizará para el Valor. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro. Defina la fecha utilizando uno de los siguientes métodos:
   • Escriba la fecha en el cuadro de entrada en formato MM/DD/AAAA.
   • Haga clic en el cuadro de entrada y seleccione una fecha usando el calendario.
7. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Solo hora

Configure un parámetro de Solo hora.

Más información sobre el uso de valores de fecha y hora en las consultas

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Solo hora en el menú desplegable Tipo.
6. Establezca la hora que se utilizará para elValor. . El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro. Defina la hora utilizando uno de los siguientes métodos:
   • Escriba la hora en el cuadro de entrada en formato HH:MM:SS.SSS.
   • Si lo desea, defina la hora utilizando el selector de hora.
7. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Fecha

Configure un parámetro de Fecha.

Más información sobre el uso de valores de fecha y hora en las consultas

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Fecha en el menú desplegable Tipo.
6. Establezca la fecha y la hora para el Valor. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro. Defina la fecha utilizando uno de los siguientes métodos:
   • Escriba la fecha en el cuadro de entrada en formato MM/DD/AAAA.
   • Haga clic en el cuadro de entrada y seleccione una fecha usando el calendario.
7. Defina la hora utilizando uno de los siguientes métodos:
   • Escriba la hora en el cuadro de entrada en formato HH:MM:SS.SSS.
   • Si lo desea, defina la hora utilizando el selector de hora.
8. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Parámetro de desfase de marca de tiempo

Configure un parámetro de Desfase de marca de tiempo.

Más información sobre el uso de valores de fecha y hora en las consultas

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Desfase de marca de tiempo en el menú desplegable Tipo.
6. Establezca la fecha, la hora y el desplazamiento de UTC para el Valor. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro. Defina la fecha utilizando uno de los siguientes métodos:
   • Escriba la fecha en el cuadro de entrada en formato MM/DD/AAAA.
   • Haga clic en el cuadro de entrada y seleccione una fecha usando el calendario.
7. Defina la hora utilizando uno de los siguientes métodos:
   • Escriba la hora en el cuadro de entrada en formato HH:MM:SS.SSS.
   • Si lo desea, defina la hora utilizando el selector de hora.
8. Introduzca el número de minutos para el desplazamiento de la zona horaria en desplazamiento de UTC en minutos.

   El valor predeterminado es cero. El valor mínimo es -720 (-12:00 horas) y el valor máximo es 840 (+14:00 horas)

9. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Entidad o Relación

Configure un parámetro de Entidad o Relación. La configuración de un parámetro de entidad o relación utiliza el identificador único de la entidad o relación como parámetro.

Por ejemplo: MATCH (p:Person)-[]-(m) WHERE ID(p) = $entityOrRelationshipUniqueID

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Haga clic en Crear nuevo parámetro

   Se abre el nuevo formulario Parámetro.

3. Asigne un nombre al parámetro.
   1. Haga clic en el menú de opciones junto al encabezado Parámetro.
   2. Haga clic en Cambiar nombre.
   3. Escriba un nombre descriptivo para el parámetro en el cuadro Título.
   4. Haga clic en Aplicar.

   El encabezado del parámetro se actualiza con el nuevo nombre.

4. Defina el parámetro en la entrada Parámetro de vinculación utilizando uno de los siguientes métodos:
   • Escriba el nombre del parámetro en el cuadro de entrada.
   • Si ha escrito una consulta que contiene parámetros, seleccione el parámetro en el menú desplegable.
5. Seleccione Entidad o Relación en el menú desplegable Tipo.
6. Empiece a escribir el nombre de la entidad en el cuadro de entrada para definir la entidad o relación que se utilizará para el Valor. El valor predeterminado es Valor único, consulte Definir lista de valores para establecer una lista de valores para el parámetro.

   Aparecerá una lista desplegable con los cinco registros coincidentes principales. La lista se actualizará a medida que escriba.

7. Seleccione el registro de la lista desplegable.
8. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Utilizar listas para los valores de los parámetros

Cualquier parámetro puede ser una lista de valores, pero la lista solo puede contener un tipo de valores. Por ejemplo, para encontrar todas las personas con apellidos comunes, puede utilizar la consulta MATCH (p:People) where n.lastName in $lastNameList RETURN n y definir lastNameList como una lista de Cadena de caracteres que contenga Smith, Jones y Johnson utilizando el panel de parámetros.

Si tiene una lista delimitada de valores, como una lista de nombres separados por comas, utilice Lista a partir de texto para agregar valores a la lista.

Definir lista de valores

Puede utilizar el mismo conjunto de pasos utilizados para definir un valor para crear una lista de valores seleccionando Lista de valores en lugar de Valor único. Después de definir cada valor, agréguelo a la lista o administre la lista de valores para eliminar elementos.

1. Haga clic en Lista de valores para definir una lista de valores para el parámetro.
2. Utilice el mismo método de entrada del valor único para el tipo seleccionado (a partir del paso seis). O vea un resumen de los pasos para cada tipo en la tabla siguiente.

   Cadena de caracteres	Escriba la cadena de caracteres en el campo de entrada.
   Número	Escriba el número en el campo de entrada. Nota: Knowledge Studio solo admite números enteros seguros comprendidos entre -9007199254740991 (mínimo) y 9007199254740991 (máximo). Los números que estén fuera de este rango serán incorrectos debido al redondeo, por lo que no coincidirán con los campos de Entero grande en el gráfico de conocimiento.
   Geometría	Haga clic en Establecer geometría y dibuje varias geometrías.
   Solo fecha	Escriba la fecha en formato MM/DD/AAAA o utilice el calendario para introducir la fecha.
   Solo hora	Escriba la hora en formato HH:MM:SS.sss o utilice el selector de hora para introducir la hora.
   Fecha	Escriba la fecha en formato MM/DD/AAAA o utilice el calendario para introducir la fecha. Escriba la hora en formato HH:MM:SS.sss o utilice el selector de hora para introducir la hora.
   Desfase de marca de tiempo	Escriba la fecha en formato HH:MM:SS.sss o utilice el calendario para introducir la fecha. Escriba la hora en formato MM/DD/AAAA o utilice el selector de hora para introducir la hora. Escriba el desplazamiento de UTC en minutos.
   Entidad	Utilice el campo de entrada para buscar y seleccionar una entidad.
   Relación	Utilice el campo de entrada para buscar y seleccionar una relación.

3. Haga clic en Agregar.
4. Repita los pasos uno y dos hasta que se agreguen todos los valores a la lista.
5. Si lo desea, administre los valores de la lista.
   • Haga clic en el encabezado Valores para mostrar los valores de la lista.
   • Haga clic en Borrar junto a un valor para eliminarlo de la lista.
   • Haga clic en Borrar para borrar la lista.
   • Haga clic en Copiar para copiar los valores de la lista al portapapeles del sistema.
6. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Lista personalizada a partir de texto

Si tiene muchos valores para agregar a una lista, puede utilizar la función Lista a partir de texto para generar la lista de valores. La lista de texto acepta una lista delimitada, como una lista de nombres separados por comas, y genera una lista de valores para el parámetro del tipo que ha elegido (consulte la lista de tipos admitidos).

1. Haga clic en Lista a partir de texto.

   Se abre el modal Lista a partir de texto.

2. Escriba el carácter o los caracteres que separan los valores de su lista como entrada de Delimitador. El valor predeterminado es una coma. Si la lista está delimitada por una tabulación o nuevas líneas (Intro), haga clic en la opción correspondiente.
3. Pegue la lista delimitada en el cuadro de texto.

   El tipo de parámetro aparecerá encima del cuadro de texto. Todos los valores de la lista deben coincidir con este tipo.

4. Haga clic en Generar lista.

   La Lista de resultados se genera debajo del cuadro de texto.

5. Si lo desea, haga clic en la lista de resultados para ver los resultados.
   1. Si lo desea, haga clic en la X junto a un valor para eliminarlo de la lista.
6. Si lo desea, haga clic en Borrar para borrar todos los valores de la lista.
7. Haga clic en Agregar valores a la lista para agregar los valores generados a la lista de parámetros.
8. Haga clic en Aplicar para ejecutar la consulta con los parámetros configurados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.

Eliminar parámetro

Es posible eliminar los parámetros configurados de la consulta.

1. En la barra de herramientas contextual, haga clic en Parámetros.

   Se abre el panel Parámetros.

2. Si el panel se abre en la pestaña de edición, haga clic en la pestaña Configurar.
3. Haga clic en el menú Opciones junto al nombre del parámetro.

   Se abre el menú de opciones.

4. Haga clic en Eliminar.

   El parámetro se elimina.

Nota:

Si la consulta aún contiene el parámetro, esta devolverá un error al ejecutarse, a menos que el parámetro se reconfigure o se elimine de la consulta.

Editar valores

Si se han configurado parámetros para una consulta almacenada, cuando se abre esa consulta, el panel Parámetros se abre automáticamente en la pestaña Editar valores.

1. Si el panel Parámetros no está abierto, haga clic en Parámetros en la barra de herramientas contextual.

   Se abre el panel Parámetros. Se enumerarán los parámetros configurados para la consulta.

2. Actualice el valor en función del Tipo del parámetro.

   El tipo de cada parámetro se mostrará debajo del encabezado. Si el parámetro utiliza una lista de valores, la Lista se incluirá después del tipo. Consulte Definir lista de valores para actualizar los valores de una lista. Los valores actuales utilizados en la consulta se mostrarán en los elementos de entrada de cada parámetro. A continuación se resumen los pasos para cada tipo.

   Cadena de caracteres	Escriba la cadena de caracteres en el campo de entrada.
   Número	Escriba el número en el campo de entrada. Nota: Knowledge Studio solo admite números enteros seguros comprendidos entre -9007199254740991 (mínimo) y 9007199254740991 (máximo). Los números que estén fuera de este rango serán incorrectos debido al redondeo, por lo que no coincidirán con los campos de Entero grande en el gráfico de conocimiento.
   Geometría	Haga clic en Establecer geometría y dibuje varias geometrías.
   Solo fecha	Escriba la fecha en formato MM/DD/AAAA o utilice el calendario para introducir la fecha.
   Solo hora	Escriba la hora en formato HH:MM:SS.sss o utilice el selector de hora para introducir la hora.
   Fecha	Escriba la fecha en formato MM/DD/AAAA o utilice el calendario para introducir la fecha. Escriba la hora en formato HH:MM:SS.sss o utilice el selector de hora para introducir la hora.
   Desfase de marca de tiempo	Escriba la fecha en formato MM/DD/AAAA o utilice el calendario para introducir la fecha. Escriba la hora en formato MM/DD/AAAA o utilice el selector de hora para introducir la hora. Escriba el desplazamiento de UTC en minutos.
   Entidad	Utilice el campo de entrada para buscar y seleccionar una entidad.
   Relación	Utilice el campo de entrada para buscar y seleccionar una relación.

3. Haga clic en Aplicar para ejecutar la consulta con los valores actualizados.

Los resultados de la consulta se actualizarán en función de los nuevos valores de los parámetros.