# Results

AQL operations return structured result values that communicate what happened during execution. This section covers the result types produced by write operations and change feeds.

## Result Types

- [2. Insert Results](./2.write_results.md) - Return values from insert operations
- [3. Index Definitions](./3.index_changes.md) - Index configuration in schema definitions
- [4. Table Definitions](./4.table_changes.md) - Table structure and field types
- [5. Schema and Instance Management](./5.database_changes.md) - Schema lifecycle and instance management
- [6. Change Events](./6.value_changes.md) - Structure of change feed notifications

## Common Patterns

All AQL operations follow a consistent pattern:

1. Build a query by chaining operations.
2. Execute the query with `run()` or `await` to get the result.
3. Process the structured result.

```typescript
import { Schema } from "@antelopejs/interface-database";

const schema = Schema.get("myapp")!;
const users = schema.instance().table("users");

// Insert returns an array of generated IDs
const ids = await users.insert({ name: "Alice", email: "alice@example.com" });
console.log("New ID:", ids[0]);

// Update/delete return the number of affected documents
const count = await users.get("user-123").update({ status: "active" });
console.log(`Modified ${count} documents`);

// Delete returns the number of deleted documents
const deleted = await users.get("user-123").delete();
console.log(`Deleted ${deleted} documents`);
```