How to: Index and search documents with the Dapr .NET SDK

Mon, 01 Jan 0001 00:00:00 +0000

Use DaprSearchClient to index JSON documents and run full-text queries through a Dapr search component. In this guide, you will configure a local store, create an index, write and search typed documents, and delete them.

Prerequisites

Dapr CLI and an initialized Dapr environment
.NET 8, .NET 9, .NET 10, or .NET 11
Dapr runtime 1.19 or later with Search support
The Dapr.Search NuGet package, version 1.19.0 or later

.NET framework support

Be advised that .NET 8 and .NET 9 reach end of support in November 2026. Support for both will be dropped in Dapr v1.20; only .NET 10 and .NET 11 will be supported through the end of 2027.

Install the package in an ASP.NET Core project:

Dapr Search client

Mon, 01 Jan 0001 00:00:00 +0000

DaprSearchClient in Dapr.Search implements the alpha Search API through gRPC. Use .NET SDK 1.19.0 or later with a Dapr runtime and component that support Search. See the overview for release requirements and the how-to for a complete document lifecycle.

Client lifetime and configuration

Reuse a long-lived client rather than creating one per operation. Dependency injection registers a singleton by default and owns its disposal:

using Dapr.Search.Extensions;

builder.Services.AddDaprSearchClient((serviceProvider, clientBuilder) =>
{
 clientBuilder.UseGrpcEndpoint("http://localhost:50001");
});

The callback can resolve configuration or other services through serviceProvider. Use the optional lifetime argument to choose another ServiceLifetime when required.

Dapr Search .NET SDK on Dapr Docs

How to: Index and search documents with the Dapr .NET SDK

Prerequisites

.NET framework support

Dapr Search client

Client lifetime and configuration