Create Non-Linear Algorithm Index

Creating non-linear algorithm indexes allows you to optimize query execution based on spatial or high-dimensional data structures.

Ahnlich supports the following non-linear algorithm indexes:

KDTree (K-dimensional tree) — useful for nearest-neighbor searches and multidimensional range queries.
HNSW (Hierarchical Navigable Small World) — approximate nearest-neighbor search with configurable accuracy/speed tradeoff.

Non-linear algorithm indexes improve query performance by pre-structuring the data, but depending on the algorithm, there may be tradeoffs between query time and memory consumption.

In the Ahnlich client, you can create a non-linear algorithm index by calling the create_non_linear_algorithm_index RPC via the DbServiceStub. Each index type is specified using a NonLinearIndex message with either a KdTreeConfig or HnswConfig.

Define a Client and Call the API

The following example shows how to initialize a client, request index creation, and inspect the server’s response.

Click to expand code

import asyncio
from grpclib.client import Channel
from ahnlich_client_py.grpc.services.db_service import DbServiceStub
from ahnlich_client_py.grpc.db import query as db_query
from ahnlich_client_py.grpc.algorithm.nonlinear import NonLinearIndex, KdTreeConfig, HnswConfig


async def create_non_linear_algo_index():
  async with Channel(host="127.0.0.1", port=1369) as channel:
      client = DbServiceStub(channel)

      # Create a KDTree index
      response = await client.create_non_linear_algorithm_index(
          db_query.CreateNonLinearAlgorithmIndex(
              store="test store 003",
              non_linear_indices=[NonLinearIndex(kdtree=KdTreeConfig())]
          )
      )

      # Or create an HNSW index (with optional config)
      response = await client.create_non_linear_algorithm_index(
          db_query.CreateNonLinearAlgorithmIndex(
              store="test store 003",
              non_linear_indices=[NonLinearIndex(hnsw=HnswConfig())]
          )
      )
      # response.created_indexes shows how many indexes were created
  print(response)


if __name__ == "__main__":
  asyncio.run(create_non_linear_algo_index())

Define a Client and Call the API​

Define a Client and Call the API