View a markdown version of this page

Uso de AWS SDK para ejecutar consultas de OpenCypher - Amazon Neptune

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de AWS SDK para ejecutar consultas de OpenCypher

Con el AWS Con el SDK, puede ejecutar consultas de OpenCypher en su gráfico de Neptuno mediante el lenguaje de programación que prefiera. El SDK de la API de datos de Neptune (nombre del servicio) neptunedata) proporciona el ExecuteOpenCypherQuery acción para enviar consultas de OpenCypher.

Debe ejecutar estos ejemplos desde una instancia de Amazon EC2 en la misma nube privada virtual (VPC) que su clúster de base de datos Neptune, o desde una ubicación que tenga conectividad de red con el punto final del clúster.

Enlaces directos a la documentación de referencia de la API para neptunedata El servicio en cada idioma del SDK se encuentra a continuación:

openCypher AWS Ejemplos de SDK

Los siguientes ejemplos muestran cómo configurar un neptunedata cliente, ejecuta una consulta de OpenCypher e imprime los resultados. Reemplazar YOUR_NEPTUNE_HOST y YOUR_NEPTUNE_PORT con el punto final y el puerto de su clúster de base de datos Neptune.

Client-side tiempo de espera y reintento de configuración

El tiempo de espera del cliente del SDK controla la duración cliente espera una respuesta. No controla durante cuánto tiempo se ejecuta la consulta en el servidor. Si el cliente agota el tiempo de espera antes de que finalice el servidor, la consulta puede seguir ejecutándose en Neptune mientras el cliente no tenga forma de recuperar los resultados.

Se recomienda establecer el tiempo de espera de lectura del lado del cliente en 0 (sin tiempo de espera) o en un valor que supere al menos unos segundos al del servidor neptune_query_timeout configuración en su clúster de base de datos Neptune. Esto permite a Neptune controlar cuándo se agota el tiempo de espera de las consultas.

También recomendamos establecer el máximo de reintentos en 1 (sin reintentos). Si el SDK reintenta una consulta que aún se está ejecutando en el servidor, puede provocar operaciones duplicadas. Esto es especialmente importante en el caso de las consultas de mutación, en las que un reintento podría provocar escrituras duplicadas no deseadas.

Python
  1. Siga el instrucciones de instalación para instalar Boto3.

  2. Cree un archivo llamado openCypherExample.py y pega el siguiente código:

    import boto3 import json from botocore.config import Config # Disable the client-side read timeout and retries so that # Neptune's server-side neptune_query_timeout controls query duration. client = boto3.client( 'neptunedata', endpoint_url=f'https://YOUR_NEPTUNE_HOST:YOUR_NEPTUNE_PORT', config=Config(read_timeout=None, retries={'total_max_attempts': 1}) ) response = client.execute_open_cypher_query( openCypherQuery='MATCH (n) RETURN n LIMIT 1' ) print(json.dumps(response['results'], indent=2))
  3. Ejecute el ejemplo: python openCypherExample.py

Java
  1. Siga el instrucciones de instalación para configurar el AWS SDK para Java.

  2. Usa el siguiente código para configurar un NeptunedataClient, ejecute una consulta de OpenCypher e imprima el resultado:

    import java.net.URI; import java.time.Duration; import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration; import software.amazon.awssdk.core.retry.RetryPolicy; import software.amazon.awssdk.services.neptunedata.NeptunedataClient; import software.amazon.awssdk.services.neptunedata.model.ExecuteOpenCypherQueryRequest; import software.amazon.awssdk.services.neptunedata.model.ExecuteOpenCypherQueryResponse; // Disable the client-side timeout and retries so that // Neptune's server-side neptune_query_timeout controls query duration. NeptunedataClient client = NeptunedataClient.builder() .endpointOverride(URI.create("https://YOUR_NEPTUNE_HOST:YOUR_NEPTUNE_PORT")) .overrideConfiguration(ClientOverrideConfiguration.builder() .apiCallTimeout(Duration.ZERO) .retryPolicy(RetryPolicy.none()) .build()) .build(); ExecuteOpenCypherQueryRequest request = ExecuteOpenCypherQueryRequest.builder() .openCypherQuery("MATCH (n) RETURN n LIMIT 1") .build(); ExecuteOpenCypherQueryResponse response = client.executeOpenCypherQuery(request); System.out.println(response.results().toString());
JavaScript
  1. Sigue el instrucciones de instalación para configurar el AWS SDK para JavaScript. Instale el paquete de cliente neptunedata: npm install @aws-sdk/client-neptunedata.

  2. Crea un archivo llamado openCypherExample.js y pega el siguiente código:

    import { NeptunedataClient, ExecuteOpenCypherQueryCommand } from "@aws-sdk/client-neptunedata"; import { NodeHttpHandler } from "@smithy/node-http-handler"; const config = { endpoint: "https://YOUR_NEPTUNE_HOST:YOUR_NEPTUNE_PORT", // Disable the client-side request timeout so that // Neptune's server-side neptune_query_timeout controls query duration. requestHandler: new NodeHttpHandler({ requestTimeout: 0 }), maxAttempts: 1 }; const client = new NeptunedataClient(config); const input = { openCypherQuery: "MATCH (n) RETURN n LIMIT 1" }; const command = new ExecuteOpenCypherQueryCommand(input); const response = await client.send(command); console.log(JSON.stringify(response, null, 2));
  3. Ejecute el ejemplo: node openCypherExample.js