Azure Cosmos DB è un database distribuito interamente gestito che persiste i documenti in formato JSON. Oltre ad alcuni campi obbligatori o riservati presenti nel grafo, come id e _ts, il resto può contenere qualsiasi struttura semplice o complessa di oggetti, la quale viene interamente indicizzata, se non diversamente indicata.
L'SDK per .NET che abbiamo a disposizione utilizza la famosa libreria Json.NET per serializzare e deserializzare un grafo, la quale permette di utilizzare gli attributi per alterare il comportamento. Delle volte però gli attributi non sono sufficienti oppure non vogliamo sporcare il dominio con questo genere di informazioni. Nelle ultime versioni del client, fortunatamente, per il .NET Framework e per .NET Standard, è stata inserita la facoltà di personalizzare il motore tramite un oggetto personalizzato di JsonSerializerSettings.
Nell'esempio seguente viene mostrato come possiamo creare il DocumentClient passando delle impostazioni che gestiscono se marcare i tipi sugli oggetti, come gestire i valori nulli e come trattare i tipi enumerati.
var settings = new JsonSerializerSettings { TypeNameHandling = TypeNameHandling.Objects, NullValueHandling = NullValueHandling.Include, Converters = {new StringEnumConverter()} }; var client = new DocumentClient(serviceEndPoint, settings);
Queste sono alcune delle possibilità che ci sono offerte. Per le altre rimandiamo alla documentazione ufficiale.
https://www.newtonsoft.com/json/help/html/SerializingJSON.htm
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Popolare una classe a partire dal testo, con Semantic Kernel e ASP.NET Core Web API
Utilizzare la versione generica di EntityTypeConfiguration in Entity Framework Core
Testare l'invio dei messaggi con Event Hubs Data Explorer
Gestione dell'annidamento delle regole dei layer in CSS
Utilizzare gRPC su App Service di Azure
Generare la software bill of material (SBOM) in GitHub
Supporto ai tipi DateOnly e TimeOnly in Entity Framework Core
Sfruttare al massimo i topic space di Event Grid MQTT
Sfruttare GPT-4o realtime su Azure Open AI per conversazioni vocali
Paginare i risultati con QuickGrid in Blazor
Utilizzare Azure Cosmos DB con i vettori
Cancellare una run di un workflow di GitHub