Skip to main content

gremlin_queries

Creates, updates, deletes, gets or lists a gremlin_queries resource.

Overview

Namegremlin_queries
TypeResource
Idaws.neptunedata.gremlin_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 the current queries.
running_query_countintegerThe number of Gremlin queries currently running.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_gremlin_queriesselectregionincludeWaitingLists active Gremlin queries. See Gremlin query status API for details about the output. 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:Gremlin IAM condition key can be used in the policy document to restrict the use of Gremlin 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)
includeWaitingbooleanIf set to TRUE, the list returned includes waiting queries. The default is FALSE;

SELECT examples

Lists active Gremlin queries. See Gremlin query status API for details about the output. 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:Gremlin IAM condition key can be used in the policy document to restrict the use of Gremlin queries (see Condition keys available in Neptune IAM data-access policy statements).

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