Skip to main content

List Stores

Returns the list of vector stores registered in the connected Ahnlich DB service. This request is typically used to discover available stores before performing store-scoped operations such as creating, dropping, or inserting vectors.

Source Code Example​

Click to expand
use ahnlich_client_rs::db::DbClient;


#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Connect to your running ahnlich-db instance
    let db_client = DbClient::new("127.0.0.1:1369".to_string()).await?;


    let tracing_id: Option<String> = None;


    // Call list_stores and print the result
    let stores = db_client.list_stores(tracing_id).await?;
    println!("Stores: {:?}", stores);


    Ok(())
}

Parameters​

  • tracing_id: Option<String> – Optional tracing context propagated with the request.

Returns​

  • Ok(StoreList) – Contains metadata for each store available on the server.

  • Err(AhnlichError) – Returned when the request cannot be completed (e.g., transport or server error).

Behavior​

  • Executes a read-only RPC with no side effects.

  • Responses are deterministic: the server returns all currently known stores.

  • If no stores exist, the response will contain an empty list.