Consultar el contenido de un gráfico de conocimiento

Puede consultar un gráfico de conocimiento para buscar un subconjunto de entidades y relaciones que contiene e identificar cómo se conectan las distintas entidades. Vea los siguientes ejemplos:

• A partir de un gráfico de conocimiento que representa la propagación de una enfermedad infecciosa, trabaje con personas y animales vinculados a través de cualquier tipo de relación con una determinada instalación.
• A partir de un gráfico de conocimiento que representa una cadena de suministro industrial, trabaje con cualquier contenido asociado a una pieza específica, incluidos proveedores, medios de entrega, almacenes, etc.
• A partir de un gráfico de conocimiento que representa una organización, trabaje con dispositivos de un tipo determinado y enumere sus propiedades, incluido el nombre del empleado responsable.
• A partir de un gráfico de conocimiento que representa las tortugas y su hábitat, identifique los hábitats en los que el nivel de riego se estableció utilizando información en una evaluación de impacto ambiental concreta.

Puede identificar el subconjunto de entidades y relaciones, o sus propiedades, consultando el gráfico de conocimiento. Utilice el lenguaje de consulta de openCypher para escribir consultas openCypher y descubrir entidades relacionadas y sus propiedades y trabajar con este conjunto restringido de información en el gráfico de conocimiento, un mapa o un gráfico de vínculos.

La vista de consulta es una vista predeterminada de los proyectos de Knowledge Studio que permite consultar el contenido del gráfico de conocimiento del proyecto. En Contenido de la consulta (número 1 en la imagen siguiente) aparece el editor Consulta en la que escribe las consultas nuevas y la colección Consultas almacenadas que se conservan en el proyecto cuando este se guarda. El cuadro de consulta (número 2 en la imagen siguiente) es un cuadro de texto multilínea que permite formatear y ejecutar la consulta de openCypher. Los resultados de la consulta (número 3 en la imagen siguiente) se muestran en una tabla de manera predeterminada, lo que permite explorar las propiedades de los registros de gráficos devueltos (número 4 en la imagen siguiente) y seleccionar registros de sus resultados. Puede previsualizar los resultados y sus selecciones en el mapa o en vistas previas del gráfico de vínculos y agregar o eliminar todos los resultados de su selección mediante el uso de la barra de herramientas de resultados (número 5 en la imagen siguiente). La barra de herramientas de contexto (número 6 en la imagen siguiente) proporciona herramientas específicas de la consulta, como el almacenamiento de la consulta en el proyecto para usarla más adelante.

Consultar el gráfico de conocimiento de la investigación

Puede consultar las entidades y relaciones del gráfico de conocimiento en una investigación mediante el uso de la vista de la consulta .

1. Haga clic en Consulta en el panel Contenido de investigación para abrir la vista de la consulta.

   Se abre la vista de la consulta con el cuadro de consulta abierto y sin resultados visibles. El cuadro de consulta es un cuadro de texto multilínea que permite formatear la consulta de openCypher.

2. Introduzca una consulta en el cuadro de consulta. Pulse Intro para mover el puntero a una nueva línea y seguir escribiendo.

   Por ejemplo, una consulta como MATCH (e) RETURN e devolvería todas las entidades del gráfico de conocimiento. Esta consulta funciona en cualquier gráfico de conocimiento.

   Sugerencia:

   Si no sabe cuántos resultados se devolverán en una consulta, agregue LIMIT 1000 al final de su consulta para evitar que se devuelvan cientos de miles de registros de forma inesperada y esto podría agotar el tiempo de espera del navegador.

3. Haga clic en Ejecutar.

   Los resultados de la consulta aparecen en el área Resultados. Los registros de entidades y relaciones que devuelve la consulta se identifican mediante los iconos apropiados.

Escriba una consulta openCypher

Las consultas de openCypher son para las consultas de gráficos lo que las consultas de SQL a las bases de datos relacionales. La estructura básica de la consulta es buscar, o conciliar, entidades y devolver esas entidades, donde las entidades que desea buscar se identifican entre paréntesis. Por ejemplo, la consulta MATCH (e) RETURN e devuelve entidades de cualquier tipo. El número de entidades devueltas solo está limitado por la configuración del gráfico de conocimiento. Para restringir el número de elementos de gráfico devueltos, utilice una expresión LIMIT. Por ejemplo, la consulta MATCH (e) RETURN e LIMIT 5 devolverá cinco entidades de cualquier tipo.

La consulta puede identificar entidades relacionadas mediante símbolos que crean una flecha. Por ejemplo, la consulta MATCH (e1)-->(e2) RETURN e1,e2 devolverá pares de entidades, e1 y e2, donde existe cualquier tipo de relación entre las dos entidades y cualquier ruta de la entidad e1 a la entidad e2 conecta las entidades. Si la consulta se escribió con la flecha que apunta en la otra dirección, las rutas se considerarían desde la entidad de origen e2 hasta la entidad de destino e1: MATCH (e1)<--(e2) RETURN e1,e2. La manera en que las entidades están relacionadas entre sí se conoce como un patrón.

La consulta puede identificar relaciones específicas que se deben considerar entre corchetes. Por ejemplo, la consulta MATCH (e1)-[]->(e2) RETURN e1,e2 devolverá pares de entidades, e1 y e2, donde una relación única de cualquier tipo conecta las dos entidades. Esta consulta muestra otra forma de representar las mismas consultas que se ilustran anteriormente e ilustra la sintaxis de consulta preferida. La consulta se puede modificar para devolver toda la tupla completa que describe la relación al devolver la entidad de origen, e1, la relación, r y la entidad de destino, e2, como sigue: MATCH (e1)-[r]->(e2) RETURN e1,r,e2. Una consulta similar MATCH (e1)-[ ]->( )-[ ]->(e2) RETURN e1,e2 o MATCH (e1)-[*2]->(e2) RETURN e1,e2 devolverá pares de entidades que están conectadas por dos relaciones en la misma dirección. Las consultas también pueden identificar patrones en los que las relaciones tienen diferentes direcciones como MATCH (e1)-[ ]->(e2)<-[ ]-(e3) RETURN e1,e2,e3.

Las consultas de ejemplo anteriores se pueden utilizar con cualquier gráfico de conocimiento.

Puede restringir la consulta para considerar tipos de relaciones específicos y entidades relacionadas específicas agregando tipos de relación y tipos de entidad a las otras facetas de la consulta. Por ejemplo, MATCH (p:Person)-[v:HasVehicle]->(e) RETURN p,v,e devolverá todas las entidades de Persona, p, en las que una relación HasVehicle, v, conecta la persona a otra entidad de cualquier tipo, e. Las variables p y v se asignan a las entidades Persona y las relaciones HasVehicle, respectivamente, de modo que la consulta puede devolver la información sobre ellas. En comparación con el ejemplo anterior, las relaciones en las que una entidad Mascota o Documento son el destino de una relación no se incluyen en los resultados. Dependiendo del modelo de datos del gráfico de conocimiento, la entidad de destino, e, podría ser una entidad Vehículo genérica o puede ser uno de una serie de tipos de entidad específicos como Automóvil, Moto, Barco, Avión, Vehículo comercial, etc.

En los resultados de la consulta se pueden incluir propiedades específicas de entidades y relaciones. Por ejemplo, MATCH (p:Person)-[:HasVehicle]->(e) RETURN p,e.make,e.model,e.year ejecutará la misma consulta definida anteriormente. Sin embargo, en lugar de mostrar la propia entidad de destino, los resultados mostrarán los valores almacenados en varias de sus propiedades: la marca, el modelo y el año del vehículo, respectivamente. En este ejemplo, no se asignó una variable a la relación específica que la consulta tiene en cuenta porque los datos de la relación no se incluyen en los resultados de la consulta ni se evalúan en otro lugar de la consulta.

Del mismo modo, puede restringir las entidades y relaciones que se evalúan especificando propiedades que definen las entidades y relaciones de interés. Las propiedades que deben tenerse en cuenta se definen agregando una cláusula WHERE a la consulta. Al igual que con los ejemplos anteriores, se deben asignar variables para hacer referencia a información específica sobre entidades y relaciones en la cláusula WHERE. Por ejemplo, en la siguiente consulta, solo se evalúan las entidades Persona con un valor de propiedad lastName específico; las relaciones HasVehicle solo se consideran si tienen un valor NULL en la propiedad endDate y las entidades Vehículo relacionadas solo se consideran si la propiedad del año tiene un valor anterior a 1980: MATCH (p:Person)-[hv:HasVehicle]->(v:Vehicle) WHERE p.lastName = 'Doe' and hv.endDate IS NULL and v.year < 1980 RETURN p,p.firstName,v,v.make,v.year.

En lugar de devolver una serie de entidades y relaciones individuales, la consulta puede devolver la ruta completa representada por un patrón. Para ello, asigne el patrón definido en la cláusula MATCH a una variable y devuelva esa variable. Por ejemplo, la consulta MATCH path = (:Person)-[:HasVehicle]->(:Vehicle) RETURN path devolverá una lista de rutas para todas las combinaciones de entidades y relaciones que satisfagan el patrón especificado. Cada ruta contendrá todas las partes del patrón coincidente: Persona, relación HasVehicle y Vehículo. No es necesario asignar variables a las partes individuales de este patrón, ya que no las devuelve la consulta.

Modificar y actualizar los resultados de la consulta

Puede recuperar un conjunto específico de entidades y relaciones de un gráfico de conocimiento mediante la evaluación de tipos de elementos de gráfico específicos y valores de propiedad específicos.

1. Haga clic en el cuadro de consulta.
2. Actualice el texto de la consulta openCypher existente.

   Por ejemplo, cambie la consulta a MATCH (p:Person)-[hv:HasVehicle]->(v:Vehicle) WHERE v.year < 2005 RETURN p, p.firstName, p.phoneNumber, hv, v, v.make, v.model, v.year para devolver todas las entidades Persona que tengan la relación HasVehicle con una entidad Vehículo en la que la propiedad del año del vehículo sea anterior a 2005. Los resultados incluirán valores de las propiedades firstName y phoneNumber de la entidad Persona, la relación HasVehicle y las propiedades de marca, modelo y año de la entidad Vehículo.

   Pulse Intro para mover el puntero o parte del texto de la consulta a una nueva línea en el cuadro de texto multilínea. Utilice tantas líneas como sea necesario para mayor claridad.

   
3. Haga clic en Ejecutar para obtener nuevos resultados.

   Los resultados de la consulta aparecen en la sección Resultados. Las entidades y relaciones que devuelve la consulta se identifican mediante los iconos apropiados.

   
4. Si lo desea, haga clic en Borrar para eliminar el texto de la consulta actual del cuadro de consulta.

Guardar una consulta

Puede almacenar consultas individuales que desee mantener como parte de su investigación. Cuando guarda su proyecto, las consultas almacenadas se guardan en el proyecto y aparecen en la sección Consultas almacenadas del panel Contenido de la consulta.

1. Haga clic en Guardar como consulta nueva en la barra de herramienta contextual de la consulta.

   Aparece el nuevo modal de la consulta almacenada.

   
2. Opcionalmente:
   • Escriba un nombre para la consulta en el área de entrada Título.
   • Escriba la descripción de la consulta en el área de texto Descripción. La descripción proporciona contexto para los resultados de la consulta sin tener que leer la consulta de openCypher.
3. Haga clic en Almacenar.

   La consulta se almacena en la sección Consultas almacenadas del panel Contenido de la consulta.

4. Haga clic en la consulta almacenada para ejecutar la consulta y ver los resultados.

   La consulta almacenada se ejecutará en cuanto se seleccione. El título y la descripción de la consulta aparecen encima de los resultados. El cuadro de consulta está oculto.

   
5. Haga clic en Mostrar cuadro de consulta para mostrar el texto de la consulta de openCypher en el cuadro de consulta.
6. Haga clic en el cuadro de texto de consulta y modifique la consulta existente.
7. Haga clic en Actualizar consulta almacenada en la barra de herramientas contextual de la consulta para actualizar la consulta almacenadas de forma que refleje los cambios.
8. Haga clic en el menú Opciones de esta consulta almacenada en Contenido de la consulta.
9. Haga clic en Cambiar nombre de elemento y descripción para actualizar los cuadros de texto Título y Descripción de su consulta para que reflejen los cambios.
10. Haga clic en Aplicar.
11. También puede hacer clic en Eliminar en el menú Opciones de esta consulta almacenada para eliminar la consulta almacenada del proyecto.

Explorar los resultados de la consulta

Una consulta openCypher puede devolver varios resultados. Cuando la consulta devuelve una lista de entidades o relaciones, estas se muestran en la lista de resultados con una entidad o relación por fila. Los valores devueltos por la consulta aparecen en columnas en el orden en que figuran en la instrucción de devolución de la consulta.

Una consulta openCypher puede devolver resultados que muestran qué entidades tienen una relación determinada con otra entidad. En este caso, la tabla de resultados presentará una fila para cada triplete, donde un triplete consta de la entidad de origen, la relación y la entidad de destino. Por ejemplo, una consulta como MATCH (p:Person)-[r]->(e) RETURN p,r,e devolvería una lista de resultados en la que cada fila de la tabla de resultados representa a una persona, una relación entre esa persona y otra entidad y la entidad de destino de la relación. En este caso, la tabla de resultados tendría una columna para la persona titulada Valor 0, una columna para la relación llamada Valor 1 y un título para la entidad de destino titulada Valor 2.

En su lugar, la consulta devuelve propiedades específicas de entidades o relaciones; la lista de resultados mostrará esos valores en cada columna. Por ejemplo, una consulta como MATCH (p:Person)-[:HasVehicle]->(v) RETURN p,v,v.year devolverá el nombre de visualización de la entidad Persona en la columna Valor 0, el nombre de visualización de la entidad Vehículo en la columna Valor 1 y el valor de la propiedad de año de la entidad Vehículo en la columna Valor 2. Si una entidad no presenta ningún valor para una propiedad específica devuelta por una consulta, verá (NULL) como una representación del hecho de que no hay ningún valor para mostrar.

En el siguiente ejemplo se muestra una consulta que devuelve una entidad Persona en la que participa la persona en una relación HasVehicle con el vehículo. La consulta también devuelve la propiedad acquisitionDate de la relación HasVehicle y la propiedad make de la entidad Vehículo.

Las columnas que contienen una entidad o una relación mostrarán el nombre de visualización del elemento del gráfico junto con su icono. En la captura de pantalla anterior, la entidad Persona devuelta aparece en la columna Valor 0. La propiedad acquisitionDate de la relación HasVehicle se muestra en la columna Valor 1. El valor de la propiedad make de la entidad Vehículo aparece en la columna Valor 2.

Un tercer tipo común de consulta devuelve una ruta entre una entidad y otra. Una ruta contiene todas las entidades y relaciones entre las entidades de origen y destino especificadas. Por ejemplo, una consulta como MATCH path=(p:Person)-[r]->(e) RETURN path devolverá todas las rutas a entidades conectadas a una entidad Persona por una relación. La tabla de resultados de la consulta mostrará la ruta en la columna Valor 0.

Las rutas pueden incluir cualquier cantidad de entidades y relaciones. Por ejemplo, una consulta como MATCH path=(c:Company)-[r*2]-(v:Vehicle) RETURN path devolverá todas las rutas entre entidades Empresa y entidades Vehículo que está a dos relaciones exactamente. Cada ruta contendrá la entidad Empresa original, cada entidad intermediaria y la relación, y la entidad Vehículo de destino. La tabla de resultados de la consulta mostrará la ruta en la columna Valor 0. De forma predeterminada, mostrará simplemente la entidad de origen y la entidad de destino en la ruta y el número total de registros de la ruta. Haga clic en Expandir para ver el resultado de la ruta completa.

Las rutas pueden devolverse como un elemento del resultado de una consulta. Por ejemplo, la misma consulta puede devolver la ruta y el nombre de la empresa de origen y el año del vehículo de destino. MATCH path=(c:Company)-[r*2]-(v:Vehicle) RETURN path, c.name, v.year. La tabla de resultados de la consulta mostrará la ruta contraída en la columna Valor 0, la propiedad de nombre de la entidad Empresa en la columna Valor 1 y la propiedad de año de la entidad Vehículo en la columna Valor 2.

Todos los resultados de la consulta se muestran en la vista de tabla de forma predeterminada. En esta vista, puede seleccionar los resultados de la consulta y ver las propiedades de cualquier entidad o relación devuelta por la consulta.

1. Haga clic en una entidad o una relación de la tabla de resultados para ver sus propiedades.
2. También puede utilizar Agregar selección a para agregar este registro a otro elemento del contenido.
3. Utilice el botón Agregar registros a selección de la columna Selección para agregar todas las entidades y relaciones de esa fila a su selección.

   Las entidades y relaciones de esta fila se resaltarán. Cualquier instancia de esas entidades y relaciones que aparezcan en otras filas de resultados también se resaltarán. El número total de registros seleccionados se muestra en la parte inferior de la tabla.

   
4. Opcionalmente:
   • Pulse Ctrl mientras hace clic en una entidad o relación para agregar precisamente ese registro a su selección.
   • Haga clic en Seleccionar todo en el menú de los resultados para seleccionar todos los registros devueltos en la consulta.
5. Utilice el botón Eliminar registros de selección de la columna Selección para eliminar todas las entidades y relaciones de esa fila de su selección.
6. Opcionalmente:
   • Pulse Ctrl mientras hace clic en una entidad o relación para eliminar precisamente ese registro de su selección.
   • Haga clic en Borrar selección en el menú de los resultados para seleccionar todos los registros devueltos en la consulta.
7. Utilice Agregar selección a de la barra de herramientas contextual de la consulta para agregar los registros seleccionados a un gráfico de vínculos, mapa o tarjeta de datos.

Previsualizar los resultados en un mapa o gráfico de vínculos

También puede utilizar la vista previa de mapa de los resultados de la consulta y la vista previa de gráfico de vínculos de los resultados de la consulta para previsualizar los resultados de la consulta en una visualización diferente. Las selecciones realizadas en la vista de tabla se reflejarán en la vista previa de mapa y la vista previa de gráfico de vínculos.

1. Haga clic en la vista de mapa en el menú de los resultados para ver una vista previa de las entidades espaciales que devuelve su consulta.
   
2. Haga clic en la vista de gráfico de vínculos del menú de los resultados para ver una vista previa de los resultados de la consulta en un gráfico de vínculos.
   
3. Haga clic en la vista de tabla del menú de resultados para volver a la tabla de resultados predeterminada.