Elaborare e creare documenti di Azure Cosmos DB usando App per la logica di Azure
Si applica a: App per la logica di Azure (consumo + standard)
Dal flusso di lavoro in App per la logica di Azure è possibile connettersi ad Azure Cosmos DB e usare i documenti usando il connettore Azure Cosmos DB. Questo connettore fornisce trigger e azioni che il flusso di lavoro può usare per le operazioni di Azure Cosmos DB. Ad esempio, le azioni includono la creazione o l'aggiornamento, la lettura, l'esecuzione di query e l'eliminazione di documenti.
È possibile connettersi ad Azure Cosmos DB da entrambi i tipi di risorse app per la logica (consumo) e app per la logica (standard) usando le operazioni del connettore gestito. Per App per la logica (Standard), Azure Cosmos DB offre anche operazioni predefinite , attualmente in anteprima e offrono funzionalità diverse, prestazioni migliori e velocità effettiva più elevata. Ad esempio, se si usa il tipo di risorsa App per la logica (Standard), è possibile usare il trigger predefinito per rispondere alle modifiche in un contenitore di Azure Cosmos DB. È possibile combinare le operazioni di Azure Cosmos DB con altre azioni e trigger nei flussi di lavoro dell'app per la logica per abilitare scenari come l'origine eventi e l'elaborazione dati generale.
Limiti
Attualmente, solo i flussi di lavoro con stato in una risorsa app per la logica (Standard) possono usare sia le operazioni del connettore gestito che le operazioni predefinite. I flussi di lavoro senza stato possono usare solo operazioni predefinite.
Il connettore Azure Cosmos DB supporta solo gli account Azure Cosmos DB creati con Azure Cosmos DB per NoSQL.
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Flusso di lavoro dell'app per la logica da cui si vuole accedere all'account Azure Cosmos DB. Per usare il trigger di Azure Cosmos DB, è necessario creare l'app per la logica usando il tipo di risorsa App per la logica (Standard) e aggiungere un flusso di lavoro vuoto.
Aggiungere un trigger di Azure Cosmos DB
In App per la logica di Azure ogni flusso di lavoro deve iniziare con un trigger, che viene generato quando si verifica un evento specifico o quando viene soddisfatta una condizione specifica.
Se si usa il tipo di risorsa App per la logica (Standard), il trigger predefinito denominato Quando viene creato o modificato un elemento (anteprima) è disponibile ed è basato sul modello di feed di modifiche di Azure Cosmos DB. Questo trigger non è disponibile per il tipo di risorsa App per la logica (consumo).
Non sono disponibili trigger di Azure Cosmos DB per il tipo di risorsa App per la logica (consumo).
Aggiungere un'azione di Azure Cosmos DB
In App per la logica di Azure, un'azione è un passaggio del flusso di lavoro che segue un trigger o un'altra azione. Il connettore Azure Cosmos DB offre azioni per i tipi di risorse app per la logica (consumo) e app per la logica (standard). Negli esempi seguenti per ogni tipo di risorsa viene illustrato come usare un'azione che crea o aggiorna un documento.
Per aggiungere un'azione di Azure Cosmos DB a un flusso di lavoro dell'app per la logica in App per la logica di Azure multi-tenant, seguire questa procedura:
Nella portale di Azure aprire il flusso di lavoro nella finestra di progettazione.
Se il flusso di lavoro è vuoto, aggiungere qualsiasi trigger desiderato.
Questo esempio inizia con il trigger Quando viene ricevuta una richiesta HTTP.
Nel trigger o nell'azione in cui si vuole aggiungere l'azione Azure Cosmos DB selezionare Nuovo passaggio o Aggiungi un'azione, se tra i passaggi.
Nella casella di ricerca della finestra di progettazione immettere
Azure Cosmos DB. Selezionare l'azione Azure Cosmos DB da usare.In questo esempio viene usata l'azione denominata Crea o aggiorna documento (V3).
Se vengono richiesti i dettagli della connessione, creare ora una connessione all'account Azure Cosmos DB.
Fornire le informazioni necessarie per l'azione.
Proprietà Richiesto Valore Descrizione Nome dell'account Azure Cosmos DB Sì Selezionare Usa impostazioni di connessione (<Azure-Cosmos-DB-account-name>) oppure immettere manualmente il nome. Nome dell'account Azure Cosmos DB. ID database Sì <database-ID> Database che si desidera connettere. ID contenitore Sì <container-ID> Contenitore su cui eseguire una query. Documento Sì <Documento JSON> Documento JSON da creare. In questo esempio viene usato il corpo della richiesta dall'output del trigger. Suggerimento: se il token corpo del trigger HTTP non viene visualizzato nell'elenco di contenuto dinamico da aggiungere, accanto al nome del trigger, selezionare Visualizza altro.
Nota: assicurarsi che il corpo sia json ben formato e, come minimo, contenga la proprietà e la
idproprietà della chiave di partizione per il documento. Se esiste già un documento con la chiave di partizione e specificataid, il documento viene aggiornato. Altrimenti, viene creato un nuovo documento.L'immagine seguente mostra un'azione di esempio:
Configurare qualsiasi altra impostazione di azione in base alle esigenze.
Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Testare l'app per la logica per assicurarsi che il flusso di lavoro crei un documento nel contenitore specificato.
Connettersi ad Azure Cosmos DB
Quando si aggiunge un trigger o un'azione che si connette a un servizio o a un sistema e non si dispone di una connessione esistente o attiva, App per la logica di Azure chiede di fornire le informazioni di connessione, che variano in base al tipo di connessione, ad esempio:
- Credenziali dell'account
- Nome da usare per la connessione
- Nome del server o del sistema
- Tipo di autenticazione da usare
- Un stringa di connessione
Prima di poter configurare il trigger di Azure Cosmos DB o l'azione di Azure Cosmos DB, è necessario connettersi a un account di database.
In un flusso di lavoro dell'app per la logica (consumo) una connessione di Azure Cosmos DB richiede i valori delle proprietà seguenti:
| Proprietà | Richiesto | Valore | Descrizione |
|---|---|---|---|
| Nome connessione | Sì | <nome connessione> | Nome da usare per la connessione. |
| Tipo di autenticazione | Sì | <tipo di connessione> | Tipo di autenticazione che si vuole usare. In questo esempio viene usata la chiave di accesso. - Se si seleziona Chiave di accesso, specificare i valori di proprietà obbligatori rimanenti per creare la connessione. - Se si seleziona Microsoft Entra integrato, non sono necessari altri valori di proprietà, ma è necessario configurare la connessione seguendo la procedura per l'autenticazione di Microsoft Entra e il connettore Azure Cosmos DB. |
| Chiave di accesso all'account Azure Cosmos DB | Sì | <access-key> | Chiave di accesso per l'account Azure Cosmos DB da usare per questa connessione. Questo valore è una chiave di lettura/scrittura o una chiave di sola lettura. Nota: per trovare la chiave, passare alla pagina dell'account Azure Cosmos DB. Nel menu di spostamento, in Impostazioni, selezionare Chiavi. Copiare uno dei valori di chiave disponibili. |
| Account Id | Sì | <acccount-ID> | Nome dell'account Azure Cosmos DB da usare per questa connessione. |
L'immagine seguente mostra una connessione di esempio:
Nota
Dopo aver creato la connessione, se si dispone di una connessione di Azure Cosmos DB esistente che si vuole usare o se si vuole creare un'altra nuova connessione, selezionare Cambia connessione nell'editor dei dettagli del trigger o dell'azione.
Informazioni di riferimento sui connettori
Per informazioni di riferimento sulle operazioni del connettore gestito di Azure Cosmos DB, ad esempio trigger, azioni e limiti, vedere la pagina di riferimento del connettore.
Non esiste alcuna pagina di riferimento corrispondente per le operazioni predefinite di Azure Cosmos DB. Per altre informazioni, vedere invece la tabella seguente:
| Tipo | Nome | Parametri |
|---|---|---|
| Grilletto | Quando viene creato o modificato un elemento | - ID database: obbligatorio. Nome del database con i contenitori monitorati e lease. - ID contenitore monitorato: obbligatorio. Nome del contenitore monitorato. - ID contenitore lease: obbligatorio. Nome del contenitore usato per archiviare i lease. - Creare un contenitore di lease: obbligatorio. Se true, creare il contenitore di lease se non è già esistente. - Velocità effettiva del contenitore lease: facoltativa. Numero di unità richiesta da assegnare quando viene creato il contenitore di lease. |
| Azione | Creare o aggiornare un elemento | - ID database: obbligatorio. Nome del database. - ID contenitore: obbligatorio. Nome del contenitore. - Elemento: obbligatorio. Elemento da creare o aggiornare. - Chiave di partizione: facoltativa. Valore della chiave di partizione per l'elemento richiesto. - Is Upsert: facoltativo. Se true, sostituire l'elemento, se esistente. In caso contrario, creare l'elemento. |
| Azione | Creare o aggiornare molti elementi in blocco | Questa azione è ottimizzata per scenari con velocità effettiva elevata e prevede un'elaborazione aggiuntiva prima che l'azione invii gli elementi da creare nel contenitore Azure Cosmos DB. Per un numero elevato di elementi, questa elaborazione aggiuntiva accelera il tempo totale della richiesta. Per un numero ridotto di elementi, questo sovraccarico aggiuntivo può causare prestazioni più lente rispetto all'uso di più azioni di creazione di elementi singoli. - ID database: obbligatorio. Nome del database. |
| Azione | Leggere un elemento | - ID database: obbligatorio. Nome del database. - ID contenitore: obbligatorio. Nome del contenitore. - ID elemento: obbligatorio. Valore id dell'elemento richiesto. - Chiave di partizione: obbligatorio. Valore della chiave di partizione per l'elemento richiesto. |
| Azione | Eliminare un elemento | - ID database: obbligatorio. Nome del database. - ID contenitore obbligatorio. Nome del contenitore. - ID elemento: obbligatorio. Valore id dell'elemento richiesto. - Chiave di partizione: obbligatorio. Valore della chiave di partizione per l'elemento richiesto. |
| Azione | Eseguire query sugli elementi | - ID database: obbligatorio. Nome del database. - ID contenitore: obbligatorio. Nome del contenitore. - Query SQL: obbligatorio. Testo della query SQL di Azure Cosmos DB. - Chiave di partizione: facoltativa. Valore della chiave di partizione per la richiesta, se presente. - Token di continuazione: facoltativo. Token di continuazione per questa query fornita dal servizio Azure Cosmos DB, se presente. - Numero massimo di elementi: facoltativo. Numero massimo di elementi da restituire per la query. |
Procedure consigliate per le operazioni predefinite di Azure Cosmos DB
Ottenere risultati iterabili dall'azione Elementi di query
L'azione predefinita Elementi di query in un flusso di lavoro dell'app per la logica (Standard) include molti output di contenuto dinamico disponibili per l'uso nelle azioni successive. Per ottenere gli elementi dei risultati della query o i metadati degli elementi come oggetto iterabile, seguire questa procedura:
Nella portale di Azure aprire il flusso di lavoro nella finestra di progettazione.
Se il flusso di lavoro è vuoto, aggiungere qualsiasi trigger desiderato.
Questo esempio inizia con il trigger Ricorrenza.
Nel trigger o nell'azione in cui si vuole aggiungere l'azione Azure Cosmos DB selezionare Inserisci un nuovo passaggio (+) >Aggiungi un'azione.
Nella finestra di progettazione verificare che l'opzione Aggiungi un'operazione sia selezionata. Nel riquadro Aggiungi un'azione visualizzata, nella casella di ricerca Scegliere un'operazione selezionare Predefinita per trovare le azioni di Azure Cosmos DB.
Nella casella di ricerca immettere
Azure Cosmos DB. Selezionare l'azione Elementi query (anteprima).Se vengono richiesti i dettagli della connessione, creare una connessione all'account Azure Cosmos DB.
Fornire le informazioni necessarie per l'azione.
Proprietà Richiesto Valore Descrizione Database Id Sì <database-ID> Database che si desidera connettere. ID contenitore Sì <container-ID> Contenitore su cui eseguire una query. Query SQL Sì <sql-query> Query SQL per la richiesta. L'immagine seguente mostra un'azione di esempio:
Configurare qualsiasi altra impostazione di azione in base alle esigenze.
Nell'azione selezionare Inserisci un nuovo passaggio (+) >Aggiungi un'azione. Nel riquadro Aggiungi un'azione visualizzata selezionare l'azione da eseguire in tutti gli elementi dei risultati della query.
Questo esempio usa l'azione predefinita di Azure Cosmos DB denominata Elimina un elemento (anteprima).This example use the Azure Cosmos DB built-in action named Delete an item (preview).
- Nell'azione aggiunta in precedenza è possibile accedere ai dati dall'output dell'azione di query. Fare clic all'interno di uno dei campi di input dell'azione in modo che venga visualizzato l'elenco di contenuto dinamico. Selezionare uno degli elementi di risposta disponibili o selezionare Visualizza altro per altre opzioni.
In questo esempio viene usato l'ID dell'elemento di risposta nel campo ID elemento per popolare gli ID in base ai risultati della query.
Dopo aver selezionato un elemento della risposta, l'azione For each viene aggiunta automaticamente per scorrere tutti i risultati della query. Il ciclo For each contiene l'azione aggiunta in precedenza. È possibile aggiungere qualsiasi altra azione che si desidera eseguire nel ciclo.
Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Testare l'app per la logica per assicurarsi che il flusso di lavoro restituisca l'output previsto.