IBeam.Repositories.AzureTables 2.9.0

IBeam.Repositories.AzureTables

IBeam.Repositories.AzureTables provides a generic Azure Table Storage repository provider for IBeam.Repositories.

dotnet add package IBeam.Repositories.AzureTables

When To Use This

• You want IBeam repository abstractions backed by Azure Table Storage.
• You need tenant-aware partition strategies.
• You want configurable table names, key formatting, and storage models.
• You are not using a domain-specific repository package such as IBeam.Identity.Repositories.AzureTable.

What This Package Contains

Architecture Fit

API <-- DTO/model object --> Service <-- Entity --> Repository

This package is a repository provider. It should persist one entity type per repository. It should not contain service rules, permission checks, or audit orchestration.

Quick Start

using IBeam.Repositories.AzureTables;

builder.Services.ConfigureIBeamAzureTables(builder.Configuration);
builder.Services.AddIBeamAzureTablesRepositories();

Configuration:

{
  "IBeam": {
    "Repositories": {
      "AzureTables": {
        "ConnectionString": "<storage-connection-string>",
        "TableNamePrefix": "IBeam",
        "CreateTablesIfNotExists": true,
        "StorageModel": "Envelope",
        "GuidKeyFormat": "N",
        "EnableLegacyGuidKeyFallbackReads": false
      }
    }
  }
}

Configuration

Connection string fallback precedence:

1. IBeam:Repositories:AzureTables:ConnectionString
2. IBeam:AzureTables
3. IBeam:Repositories:ConnectionString
4. IBeam:ConnectionString
5. ConnectionStrings:AzureTables
6. ConnectionStrings:AzureTable
7. ConnectionStrings:AzureStorage
8. ConnectionStrings:IBeam
9. ConnectionStrings:DefaultConnection

Table Naming

Repository table names are built from:

{TableNamePrefix}{EntityOrMappedTableName}

With TableNamePrefix = "IBeam" and entity type Product, the default table is IBeamProduct.

Override a table name:

builder.Services.AddAzureEntityMapping<Product>(options =>
{
    options.TableName = "Products";
});

With the same prefix, the physical table becomes IBeamProducts.

Azure Table Schema

Generic repository tables are entity-specific. Each entity type maps to its own table unless AddAzureEntityMapping<T> changes the table name.

Envelope Storage Model

EntityColumns Storage Model

Partition And Row Keys

Example:

builder.Services.UseTenantPartitionKey<Product>();
builder.Services.UseTenantHashBucketPartitionKey<ActivityLog>(bucketCount: 32);

Data Storage Notes

This package creates generic repository tables only when CreateTablesIfNotExists is true. It does not create Identity, AccessControl, Logging, or Licensing tables owned by other packages.

Extended Docs And Agent Guidance

• AI prompt: .agent/prompt.md
• Root implementation guide: ../.agent/implementation-guide.md
• Service logging and audit: ../docs/service-logging-and-audit.md
• Service operation permissions: ../docs/service-operation-permissions.md

Agents should document entity-specific table mappings in the consuming project when using this package.

Troubleshooting

Version Notes

• Targets net10.0.
• Uses Azure.Data.Tables.
• Package version is assigned by the repository release workflow.