Skip to main content

open_cypher_queries

Creates, updates, deletes, gets or lists an open_cypher_queries resource.

Overview

Nameopen_cypher_queries
TypeResource
Idaws.neptunedata.open_cypher_queries

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
accepted_query_countintegerThe number of queries that have been accepted but not yet completed, including queries in the queue.
queriesarrayA list of current openCypher queries.
running_query_countintegerThe number of currently running openCypher queries.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_open_cypher_queriesselectregionincludeWaitingLists active openCypher queries. See Neptune openCypher status endpoint for more information. When invoking this operation in a Neptune cluster that has IAM authentication enabled, the IAM user or role making the request must have a policy attached that allows the neptune-db:GetQueryStatus IAM action in that cluster. Note that the neptune-db:QueryLanguage:OpenCypher IAM condition key can be used in the policy document to restrict the use of openCypher queries (see Condition keys available in Neptune IAM data-access policy statements).

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
includeWaitingbooleanWhen set to TRUE and other parameters are not present, causes status information to be returned for waiting queries as well as for running queries.

SELECT examples

Lists active openCypher queries. See Neptune openCypher status endpoint for more information. When invoking this operation in a Neptune cluster that has IAM authentication enabled, the IAM user or role making the request must have a policy attached that allows the neptune-db:GetQueryStatus IAM action in that cluster. Note that the neptune-db:QueryLanguage:OpenCypher IAM condition key can be used in the policy document to restrict the use of openCypher queries (see Condition keys available in Neptune IAM data-access policy statements).

SELECT
accepted_query_count,
queries,
running_query_count
FROM aws.neptunedata.open_cypher_queries
WHERE region = '{{ region }}' -- required
AND includeWaiting = '{{ includeWaiting }}'
;