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
Gestire gli accessi con Token su Azure Container Registry
Controllare la telemetria con .NET Aspire
Utilizzare EF.Constant per evitare la parametrizzazione di query SQL
Implementare il throttle in JavaScript
Gestire i dati con Azure Cosmos DB Data Explorer
Esporre i propri servizi applicativi con Semantic Kernel e ASP.NET Web API
Simulare Azure Cosmos DB in locale con Docker
Popolare una classe a partire dal testo, con Semantic Kernel e ASP.NET Core Web API
Utilizzare Containers in .NET Aspire
Integrare SQL Server in un progetto .NET Aspire
Sfruttare GPT-4o realtime su Azure Open AI per conversazioni vocali
I più letti di oggi
- Usare i settings di serializzazione/deserializzazione di System.Text.Json di ASP.NET all'interno di un'applicazione non web
- .NET Conference Italia 2025 - Milano
- The Agentic Day - Milano
- Documentare i servizi REST con Swagger e OpenAPI con .NET 9
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!