Within the context of an active session, an instance of this type represents an executable mutation query, that is, an insert, update, or delete. It is a slimmed-down version of Query, providing only methods relevant to mutation queries.

A MutationQuery may be obtained from the org.hibernate.Session by calling:

• QueryProducer#createMutationQuery(String), passing the HQL as a string,
• QueryProducer#createNativeMutationQuery(String), passing native SQL as a string,
• QueryProducer#createMutationQuery(jakarta.persistence.criteria.CriteriaUpdate) or QueryProducer#createMutationQuery(jakarta.persistence.criteria.CriteriaDelete), passing a criteria update or delete object, or
• QueryProducer#createNamedMutationQuery(String), passing the name of a query defined using jakarta.persistence.NamedQuery or jakarta.persistence.NamedNativeQuery.

A MutationQuery controls how the mutation query is executed, and allows arguments to be bound to its parameters.

• Mutation queries must be executed using executeUpdate().
• The various overloads of setParameter(String, Object) and setParameter(int, Object) allow arguments to be bound to named and ordinal parameters defined by the query.