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
Arricchire l'interfaccia di .NET Aspire
Combinare Container Queries e Media Queries
Recuperare automaticamente un utente e aggiungerlo ad un gruppo di Azure DevOps
Personalizzare le pagine di errore su Azure App Service
Abilitare il rolling update su Azure Functions flex consumption
Rendere i propri workflow e le GitHub Action utilizzate più sicure
Utilizzare DeepSeek R1 con Azure AI
Esporre un server MCP esistente con Azure API Management
Recuperare gli audit log in Azure DevOps
Utilizzare Intersect e Except per filtrare set di dati in TSql
Configurare OpenAI in .NET Aspire
Anonimizzare i dati sensibili nei log di Azure Front Door


