Delete Data with ExecuteNonQuery

Note

This feature is only available in NCache Enterprise.

NCache lets you delete the data from the cache based on the given criteria. The Delete statement returns the number of the deleted rows through the query executed using ExecuteNonQuery.

Important

The Delete statement can only be executed through ExecuteNonQuery.

Prerequisites

To learn about the standard prerequisites required to work with all NCache client-side features please refer to the given page on Client Side API Prerequisites.
Searchable objects and their attributes must be indexed by either configuring indexes or defining indexes programmatically.
For API details, refer to: ICache, ICacheReader, ExecuteReader, SearchService, QueryCommand, ExecuteNonQuery.

Here's an example which deletes all the products from the cache with the UnitsInStock equals to 0 using ExecuteNonQuery.

// Pre-condition: Cache is already connected
// Items are already present in the cache
// Provide Fully Qualified Name (FQN) of your custom class
string query = "DELETE FROM FQN.Product WHERE UnitsInStock = ?";

// Use QueryCommand for query execution
var queryCommand = new QueryCommand(query);
queryCommand.Parameters.Add("UnitsInStock", 0);

// Execute query
_cache.SearchService.ExecuteNonQuery(queryCommand);

// Pre-condition: Cache is already connected
// Items are already present in the cache

// Provide Fully Qualified Name (FQN) of your custom class
String query = "DELETE FROM FQN.Product WHERE UnitsInStock = ?";

// Use QueryCommand for query execution
QueryCommand queryCommand = new QueryCommand(query);
queryCommand.getParameters().put("UnitsInStock", 0);

// Execute query
int affectedRows = cache.getSearchService().executeNonQuery(queryCommand);

System.out.println(affectedRows + " rows were affected by the delete operation.");

// This is an async method
// Pre-condition: Cache is already connected
// Items are already present in the cache
// Provide Fully Qualified Name (FQN) of your custom class
var query = "DELETE FROM FQN.Product WHERE UnitsInStock = ?";

// Use QueryCommand for query execution
var queryCommand = new ncache.QueryCommand(query);

//Providing parameters for query
let parameter = new Map();
parameter.set("UnitsInStock", 500);
queryCommand.setParameters(parameter);

// Execute query
await ( await this.cache.getSearchService()).executeNonQuery(queryCommand);

# Pre-condition: Cache is already connected
# Items are already present in the cache
# Provide Fully Qualified Name(FQN) of your custom class
query = "DELETE FROM FQN.Product WHERE units_in_stock = 0"

# Use QueryCommand for query execution
query_command = ncache.QueryCommand(query)

# Execute query
cache.get_search_service().execute_non_query(query_command)

Note

To ensure the operation is fail-safe, it is recommended to handle any potential exceptions within your application, as explained in Handling Failures.

Additional Resources

NCache provides a sample application for SQL Queries on GitHub.

Delete Data with ExecuteNonQuery

Note

Important

Prerequisites

Note

Additional Resources

See Also