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
Integrare il Docker Model Runner in un workflow di GitHub
Utilizzare le direttive più importanti in una file based app .NET
Usare i generics di C# con la clausola nameof in modo semplificato
Leggere i parametri da riga di comando in una file based app .NET
Testare le API di Azure Resource Manager con API Playground
Utilizzare le View Transition API di JavaScript
Migrare applicazioni legacy nel cloud con Azure App Service Managed Instance
Integrare OpenTelemetry direttamente in Azure Monitor
Integrazione di Copilot in .NET Aspire
Utilizzo di CSS Scroll Snap per realizzare un carousel
Esporre tool MCP con Azure Functions
Integrare modelli AI in un workflow di GitHub


