graphene/docs/execution/execute.rst

Executing a query
=================


For executing a query a schema, you can directly call the ``execute`` method on it.


.. code:: python

    schema = graphene.Schema(...)
    result = schema.execute('{ name }')

``result`` represents the result of execution. ``result.data`` is the result of executing the query, ``result.errors`` is ``None`` if no errors occurred, and is a non-empty list if an error occurred.


Context
_______

You can pass context to a query via ``context``.


.. code:: python

    class Query(graphene.ObjectType):
        name = graphene.String()

        def resolve_name(root, info):
            return info.context.get('name')

    schema = graphene.Schema(Query)
    result = schema.execute('{ name }', context={'name': 'Syrus'})



Variables
_________

You can pass variables to a query via ``variables``.


.. code:: python

    class Query(graphene.ObjectType):
        user = graphene.Field(User, id=graphene.ID(required=True))

        def resolve_user(root, info, id):
            return get_user_by_id(id)

    schema = graphene.Schema(Query)
    result = schema.execute(
        '''
          query getUser($id: ID) {
            user(id: $id) {
              id
              firstName
              lastName
            }
          }
        ''',
        variables={'id': 12},
    )