Getting started with the Azure Table Storage integration

Azure Table Storage logo

Azure Table Storage is a service for storing structured NoSQL data in Azure Storage tables. The Aspire Azure Table Storage Hosting integration provides methods to create Azure Table Storage resources from code in your Aspire AppHost project.

In this introduction, you'll see how to install and use the Aspire Azure Table Storage integrations in a simple configuration. If you already have this knowledge, see Azure Table Storage Hosting integration for full reference details.

Note

To follow this guide, you must have created an Aspire solution to work with. To learn how to do that, see Build your first Aspire app.

Set up hosting integration

To begin, install the Aspire Azure Storage Hosting integration in your Aspire AppHost project. This integration allows you to create and manage Azure Table Storage resources from your Aspire hosting projects:

Install the NuGet package
dotnet add package Aspire.Hosting.Azure.Storage

Next, in the AppHost project, create an Azure Table Storage resource and pass it to the consuming client projects:

var builder = DistributedApplication.CreateBuilder(args);
  
var tables = builder.AddAzureStorage("storage")
    .AddTables("tables");
  
var myService = builder.AddProject<Projects.MyService>()
    .WithReference(tables);
  
// After adding all resources, run the app...
  
builder.Build().Run();

The preceding code adds an Azure Storage resource named storage to the AppHost project, adds a table storage resource to it named tables, and passes the table storage connection information to the consuming project.

Caution

When you call AddAzureStorage, it implicitly calls AddAzureProvisioning—which adds support for generating Azure resources dynamically during app startup. The app must configure the appropriate subscription and location. For more information, see Local provisioning: Configuration.

Tip

This is the simplest implementation of Azure Table Storage resources in the AppHost. There are many more options you can choose from to address your requirements. For full details, see Azure Table Storage Hosting integration.

Set up client integration

To use Azure Table Storage from your client applications, install the Aspire Azure Table Storage client integration in your client project:

Install the NuGet package
dotnet add package Aspire.Azure.Data.Tables

In the Program.cs file of your client-consuming project, call the AddAzureTableServiceClient extension method to register a TableServiceClient for use via the dependency injection container:

builder.AddAzureTableServiceClient(connectionName: "tables");

Tip

The connectionName parameter must match the name used when adding the table storage resource in the AppHost project.

Use injected Azure Table Storage properties

In the AppHost, when you used the WithReference method to pass an Azure Table Storage resource to a consuming client project, Aspire injects several configuration properties that you can use in the consuming project.

Aspire exposes each property as an environment variable named [RESOURCE]_[PROPERTY]. For instance, the Uri property of a resource called tables becomes TABLES_URI.

Use the GetValue() method to obtain these environment variables in consuming projects:

string tableUri = builder.Configuration.GetValue<string>("TABLES_URI");

Tip

The full set of properties that Aspire injects depends on the Azure Table Storage resource configuration. For more information, see Properties of the Azure Table Storage resources.

Add Azure Table Storage resources in client code

After adding the TableServiceClient, you can retrieve the connection instance using dependency injection:

public class ExampleService(TableServiceClient client)
{
    // Use client...
}

For full details on using the client integration, see Azure Table Storage Client integration.

Next steps

Previous Azure Queue Storage - Client integrationNext Azure Table Storage - Hosting integration