Con Azure Cosmos DB possiamo memorizzare documenti strutturati in JSON, e non solo, in grande quantità e godere di ottime prestazioni nella loro ricerca. Possiamo estrarre porzioni dei documenti o ricercarli usando molte delle funzioni builtin già disponibili. Delle volte, però, esse non sono sufficienti e necessitiamo di logiche più articolate per estrarre quello che vogliamo. In questo caso possiamo ricorrere alle user-defined function, delle funzioni JavaScript che possiamo definire sul database stesso e con le quali possiamo manipolare il JSON literal.
Per creare la funzione possiamo usare il data explorer direttamente sul portale Azure, il quale sulla toolbar mette a disposizione l'interfaccia apposita.

L'editor che si presenta, lo stesso anche per modificare una funzione già presente, è molto semplice e ci permette di creare una funzione che deve restituire uno dei tipi JavaScript: numeri, stringhe, oggetti e array.

Se usiamo la funzione per ottenere un oggetto complesso o un array, questo verrà incluso nel grafo senza nessuna incompatibilità. Nella figura abbiamo definito una funzione di split di una stringa, la quale quindi restituisce un array.
La funzione può essere poi usata per ottenere un array, come nel seguente esempio:
SELECT udf.SPLIT('chiave1,chiave2',',') AS items
Il risultato sarà il seguente:
[ { "items": [ "chiave1", "chiave2" ] } ]
Possiamo eventualmente usare le JOIN per poter appiattire l'array o combinarlo all'interno di una subquery. Se la funzione viene usata nei filtri, invece, è importante notare che appesantisce notevolmente la ricerca, forzando un scan completo non potendo utilizzare gli indici. Di conseguenza, si può ottimizzare il lavoro aggiungendo altri predicati.
Per maggiori consigli rimandiamo alla documentazione ufficiale:
https://docs.microsoft.com/en-us/azure/cosmos-db/sql-query-udfs
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Eliminare spazio inutilizzato in un Azure Container Registry
devConf 2022
Impostare un promemoria per ruotare le chiavi di Azure Storage
Le novità di Blazor in .NET 6.0
Tutti i video di #netconfit sono disponibili online => https://aspit.co/netconf-21 Buona visione! #dotnet6 #aspnetcore #blazor #efcore6 #maui #aws #azure #vs2022
Blazor PWA e Offline-First
Taggare automaticamente un repository con una pipeline di Azure DevOps
Cambiare a runtime la stringa di connessione di Entity Framework Core
Log streaming di una Azure Container App
Utilizzare il Service Bus Explorer integrato del portale Azure
Chiamare un endpoint ASP.NET Core protetto da Certificate Authentication
Tracciare gli eventi tramite i DevTools di Chrome
I più letti di oggi
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!
- YARP: un reverse proxy in ASP.NET Core
- Whidbey, Yukon e Longhorn su MSDN