Configuration¶

This section describes the key configuration and administration tasks required to operate AkasicDB reliably.

GUC Parameters for the Graph Module¶

Use AkasicDB graph GUC parameters to control graph query planning.

Parameter	Description	Default
`enable_graphplan`	Enables or disables graph-specific operators in the query planner (`true`/`false`)	`false`

-- Example: enable or disable graph-specific operators at the session level
SET enable_graphplan = on;

The efficiency of AkasicDB’s graph-specific operators may vary depending on the complexity of the graph query, the size of the data, and the characteristics of the dataset.

GUC Parameters for the Vector Module¶

AkasicDB vector GUC parameters affect query planning or query execution. Index build options are set in CREATE INDEX ... WITH (options = ...) and are not changed by these GUCs.

Parameter List¶

Parameter	Description	Default
`vectoron.enable_index`	Enables or disables vector index usage in the query planner (`true`/`false`)	`true`
`vectoron.hnsw_ef_search`	Candidate exploration width during HNSW search	`100`
`vectoron.ivf_nprobe`	Number of IVF clusters to scan during search	`10`
`vectoron.pgvector_compatibility`	Enables pgvector compatibility mode (`true`/`false`)	`false`
`vectoron.search_mode`	Search mode (`"vbase"` or `"basic"`)	`"vbase"`
`vectoron.vamana_l_search`	Candidate exploration width during Vamana search	`100`

-- Session-wide HNSW search width
SET vectoron.hnsw_ef_search = 100;

For a single query, use SET LOCAL inside a transaction.

BEGIN;
SET LOCAL vectoron.vamana_l_search = 200;

SELECT id
  FROM items
 ORDER BY embedding <-> '[0.1,0.2,0.3]'::vector
 LIMIT 10;
COMMIT;

Search-time Parameters¶

Parameter	Applies to	Notes
`vectoron.hnsw_ef_search`	HNSW query execution	Candidate exploration width for HNSW searches. Higher values may improve recall and may increase latency and CPU cost.
`vectoron.vamana_l_search`	Vamana query execution	Candidate exploration width for Vamana searches. Higher values may improve recall and may increase latency and CPU cost. This is separate from build-time `indexing.vamana.l_search`.
`vectoron.ivf_nprobe`	IVF query execution	Number of IVF clusters scanned for a query. Higher values may improve recall and may increase I/O and latency. This is separate from build-time `indexing.ivf.nlist`.

Before applying a value broadly, check recall and latency with queries that match the target filters and data distribution.