Leggere dati con associazioni di input
Per connettersi a un'origine dati, è necessario configurare un'associazione di input. Un'associazione di input consente di scrivere una quantità minima di codice per creare un messaggio. Non è necessario scrivere il codice per le attività, ad esempio aprire una connessione di archiviazione, in quanto l'associazione e il runtime di Funzioni di Azure gestiscono automaticamente queste attività.
Tipi di associazioni di input
Le funzioni della catena di Azure possono avere più tipi di input. Non tutti i tipi, tuttavia, supportano sia l'input che l'output. Usare una funzione di input ogni volta che è necessario inserire dati di quel tipo. A questo punto, verranno illustrati i tipi di funzioni di input che supportano le associazioni di input e verrà spiegato quando usarli.
Archiviazione BLOB di Azure - Le associazioni Archiviazione BLOB consentono di eseguire operazioni di lettura da un BLOB.
Azure Cosmos DB: l'associazione di input di Azure Cosmos DB usa l'API SQL per recuperare uno o più documenti di Azure Cosmos DB e li passa al parametro di input della funzione. L'ID documento o i parametri di query possono essere determinati in base al trigger che richiama la funzione.
App per dispositivi mobili: l'associazione di input dell'App per dispositivi mobili carica un record da un endpoint tabella per dispositivi mobili e lo passa alla funzione.
Archiviazione tabelle di Azure - È possibile leggere dati e lavorare con Archiviazione tabelle di Azure.
Un elenco completo delle associazioni supportate è disponibile qui
Per creare un'associazione come input, è necessario definire direction come in. I parametri per ogni tipo di associazione potrebbero variare.
Che cos'è un'espressione di associazione?
Un'espressione di associazione è un testo specializzato in function.json, nei parametri della funzione o nel codice che viene valutato quando la funzione viene richiamata per restituire un valore. Se, ad esempio, si ha un'associazione di coda del bus di servizio, è possibile usare un'espressione di associazione per ottenere il nome della coda dalle impostazioni dell'app.
Tipi di espressioni di associazione
Esistono numerosi tipi di espressioni di associazione, tra cui:
- Impostazioni app
- Nome file del trigger
- Metadati del trigger
- Payload JSON
- Nuovo GUID
- Data e ora corrente
Quasi tutte le espressioni di associazione sono racchiuse tra parentesi graffe. Le espressioni di associazione delle impostazioni dell'app vengono tuttavia racchiuse tra segni di percentuale anziché tra parentesi graffe. Ad esempio, se il percorso dell'associazione di output del BLOB è %Environment%/newblob.txt e il valore dell'impostazione dell'app per l'ambiente è Development, verrà creato un BLOB nel contenitore Development.
Riepilogo
Le associazioni di input consentono di connettere la funzione a un'origine dati. È possibile connettersi a diversi tipi di origini dati e i parametri per ognuna sono diversi. Per risolvere i valori delle origini di input, usare le espressioni di associazione nel file function.json, nei parametri della funzione o nel codice.