Attribute Reference¶

All Azure Table Storage attributes live in the Deepstaging.Cloud.Azure.Storage namespace. See also the Generated Code and Effects Composition pages for what these attributes produce.

[TableEntity]¶

Marks a partial record or partial class as an Azure Table Storage entity. The generator produces ToTableEntity() / FromTableEntity() mapper methods, a typed store interface and implementation, and DI registration.

[TableEntity("Conversations")]
public partial record Conversation
{
    [PartitionKey] public required string ThreadTs { get; init; }
    [RowKey] public required string PhoneNumber { get; init; }
    public required string DisplayName { get; init; }
    public required int MessageCount { get; init; }
    public required DateTimeOffset CreatedAt { get; init; }
}

[TableStore]¶

Marks a static partial class as an assembly-level table store aggregator. The generator discovers all [TableEntity] types in the assembly and produces an aggregated service, capability interface, Eff<RT, T> effect methods, and DI registration.

[TableStore]
public static partial class ChatStore;

No constructor parameters or properties — pure marker attribute.

[PartitionKey]¶

Marks a property as the partition key for a [TableEntity]. Every table entity must have exactly one [PartitionKey] property.

[PartitionKey] public required string ThreadTs { get; init; }

Constant partition key pattern¶

Use Constant when all entities share the same partition key:

[TableEntity("PhoneMappings")]
public partial record PhoneMapping
{
    [PartitionKey(Constant = "PhoneMappings")] public required string PhoneNumber { get; init; }
    [RowKey] public required string ThreadTs { get; init; }
    public required DateTime CreatedUtc { get; init; }
}

With a constant partition key:

• ToTableEntity() uses the literal "PhoneMappings" instead of reading the property value
• FromTableEntity() does not assign the partition key property from the entity
• Generated Eff methods omit the partitionKey parameter — the constant is baked in:

// Without constant — requires both keys
ChatStore.GetConversation<RT>(partitionKey, rowKey)

// With constant — partition key is automatic
ChatStore.GetPhoneMapping<RT>(rowKey)

[RowKey]¶

Marks a property as the row key for a [TableEntity]. Every table entity must have exactly one [RowKey] property.

[RowKey] public required string PhoneNumber { get; init; }

Rules and Constraints¶

• Every [TableEntity] must be partial so the generator can extend it with mapper methods.
• Every [TableEntity] needs exactly one [PartitionKey] and one [RowKey] property.
• The [TableStore] class must be partial (error if not) and should be static (warning if not).
• Properties with non-native types trigger an informational diagnostic (DSAT04) indicating they will be JSON-serialized.