Condividi tramite

Aggiungere Azure Cosmos DB CDC come origine nell'hub in tempo reale (anteprima)

  • Articolo

Questo articolo descrive come aggiungere Azure Cosmos DB per NoSQL Change Data Capture (CDC) come origine evento nell'hub in tempo reale di Fabric.

Il connettore di origine Change Data Capture (CDC) di Azure Cosmos DB consente di acquisire uno snapshot dei dati correnti in un database di Azure Cosmos DB. Il connettore monitora e registra quindi eventuali modifiche future a livello di riga a questi dati. Dopo aver acquisito le modifiche in un flusso, è possibile elaborare questi dati CDC in tempo reale e inviarli a destinazioni diverse all'interno di Fabric per un'ulteriore elaborazione o analisi.

Nota

L'hub in tempo reale è attualmente in anteprima.

Prerequisiti

  • Accesso all'area di lavoro Premium di Fabric con autorizzazioni di collaboratore o superiore.
  • Accesso a un account e a un database NoSQL di Azure Cosmos DB.
  • Il database Azure Cosmos DB per NoSQL deve essere accessibile pubblicamente e non essere protetto da un firewall o protetto in una rete virtuale.

Ottenere i dettagli della connessione dal portale di Azure

Le etichette per gli elementi che è necessario raccogliere dai portale di Azure sono illustrate nei passaggi seguenti. È sempre necessario l'URI dell'endpoint, in un formato come https://<account>.<api>.azure.com:<port>/, la chiave primaria e gli ID elemento e nome del database per cui si vogliono raccogliere i dati.

Nota

Azure Cosmos DB per NoSQL CDC usa la modalità versione più recente del feed di modifiche di Azure Cosmos DB. Acquisisce le modifiche apportate ai record nella versione più recente. Si noti che le eliminazioni non vengono acquisite con questa modalità.

  1. Nella pagina portale di Azure per l'account Azure Cosmos DB selezionare Chiavi in Impostazioni nel riquadro di spostamento a sinistra.

  2. Nella pagina Chiavi copiare i valori di chiave primaria e URI da usare per configurare la connessione eventstream.

    Screenshot dell'URI e della chiave primaria nella pagina Chiavi di Azure Cosmos DB nel portale di Azure.

  3. Nella pagina panoramica di portale di Azure per l'account Azure Cosmos DB prendere nota dell'ID del database e dell'elemento per cui si vogliono raccogliere i dati.

    Screenshot dell'elenco contenitori per un account API NoSQL di Azure Cosmos DB.

Ottenere eventi da un'istanza di Azure Cosmos DB CDC

È possibile ottenere eventi da un'istanza di Azure Cosmos DB CDC in un hub in tempo reale in uno dei modi seguenti:

  • Uso dell'esperienza Get events (Ottieni eventi)
  • Uso della scheda Origini Microsoft

Avviare l'esperienza Di recupero eventi

  1. Passare all'esperienza di intelligence in tempo reale in Microsoft Fabric. Selezionare Microsoft Fabric sulla barra di spostamento a sinistra e selezionare Intelligence in tempo reale.

    Screenshot che mostra come passare all'esperienza di intelligence in tempo reale.

  2. Selezionare Hub in tempo reale sulla barra di spostamento a sinistra.

    Screenshot che mostra come avviare l'hub in tempo reale in Microsoft Fabric.

  3. Nella pagina Hub in tempo reale selezionare + Recupera eventi nell'angolo superiore destro della pagina.

    Screenshot che mostra la selezione del pulsante Ottieni eventi nell'hub in tempo reale.

Usare le istruzioni della sezione Aggiungere Azure Cosmos DB CDC come origine .

Scheda Origini Microsoft

  1. Nell'hub in tempo reale passare alla scheda Origini Microsoft .

  2. Nell'elenco a discesa Origine selezionare Azure Cosmos DB (CDC).

  3. Per Sottoscrizione selezionare una sottoscrizione di Azure con il gruppo di risorse con l'account Cosmos DB.

  4. Per Gruppo di risorse selezionare un gruppo di risorse con l'account Cosmos DB.

  5. In Area selezionare una località in cui si trova Cosmos DB.

  6. Spostare ora il mouse sul nome dell'origine CDC di Cosmos DB che si vuole connettere all'hub in tempo reale nell'elenco dei database e selezionare il pulsante Connetti oppure selezionare ... (puntini di sospensione) e quindi selezionare il pulsante Connetti .

    Screenshot che mostra la scheda Origini Microsoft con filtri per visualizzare Cosmos DB CDC e il pulsante connetti.

    Per configurare le informazioni di connessione, seguire la procedura descritta nella sezione Aggiungere Azure Cosmos DB CDC come origine . Ignorare il primo passaggio della selezione di Azure Cosmos DB CDC come tipo di origine nella procedura guidata Recupera eventi.

Aggiungere Azure Cosmos DB CDC come origine

  1. Nella schermata Selezionare un'origine dati selezionare Azure Cosmos DB (CDC).

    Screenshot che mostra la pagina Selezionare un'origine dati con l'opzione Azure Cosmos DB (CDC) selezionata.

  2. Selezionare Vai alla risorsa per passare all'account Azure Cosmos DB nel portale di Azure.

    Screenshot che mostra la pagina Connetti con il collegamento **Vai alla risorsa** evidenziato.

  3. Nella pagina Connetti selezionare Nuova connessione.

    Screenshot che mostra la pagina Connetti della procedura guidata Recupera eventi con il collegamento **Nuova connessione** evidenziato.

  4. Nella sezione Impostazioni di connessione specificare l'endpoint cosmos DB. Immettere l'URI o l'endpoint per l'account Cosmos DB copiato dal portale di Azure.

    Screenshot che mostra la sezione Impostazioni connessione della pagina Nuova connessione.

  5. Espandere Opzioni avanzate e seguire questa procedura:

    1. Per Numero di tentativi, specificare il numero massimo di volte in cui il connettore deve ritrasmettere una richiesta al database Cosmos DB se la richiesta ha esito negativo da un errore ripristinabile.

    2. Per Abilitare il passaggio della funzione AVERAGE, specificare se il connettore deve passare la funzione di aggregazione AVG al database Cosmos DB.

    3. Per Abilitare il passaggio SORT per più colonne, specificare se il connettore deve consentire il passaggio di più colonne al database Cosmos DB quando specificato nella clausola ORDER BY della query SQL.

      Screenshot che mostra le opzioni avanzate per configurare il connettore Azure Cosmos DB.

  6. Scorrere verso il basso e nella sezione Credenziali di connessione seguire questa procedura.

    1. Selezionare una connessione esistente e mantenere l'opzione Crea nuova connessione predefinita.
    2. Per creare una connessione, immettere i valori seguenti:

      1. In Nome connessione immettere un nome per la connessione.

      2. Per Tipo di autenticazione selezionare Chiave account.

      3. Per Chiave account immettere il valore della chiave salvato in precedenza.

      4. Selezionare Connetti.

        Screenshot che mostra la sezione Credenziali di connessione della pagina Nuova connessione.

  7. Nella pagina Connetti seguire questa procedura:

    1. Specificare l'ID contenitore del contenitore nell'account Azure Cosmos DB. 1.

    2. Nella sezione Dettagli flusso a destra selezionare l'area di lavoro Infrastruttura in cui si vuole salvare il flusso di eventi che verrà creato dalla procedura guidata.

    3. Per nome del flusso di eventi immettere un nome per il flusso di eventi. La procedura guidata crea un flusso di eventi con l'istanza di Azure Cosmos DB CDC selezionata come origine.

    4. Il nome stream viene generato automaticamente aggiungendo -stream al nome del flusso di eventi. Questo flusso viene visualizzato nella scheda Flussi di dati dell'hub in tempo reale al termine della procedura guidata.

    5. Selezionare Avanti.

      Screenshot che mostra la pagina Connetti della procedura guidata Recupera eventi compilata.

  8. Nella schermata Rivedi e crea esaminare il riepilogo e quindi selezionare Crea origine.

    Screenshot che mostra la pagina Rivedi e crea della procedura guidata Recupera eventi compilata.

Visualizzare i dettagli del flusso di dati

  1. Nella pagina Rivedi e crea, se si seleziona Apri eventstream, la procedura guidata apre il flusso di eventi creato automaticamente con l'istanza di Azure Cosmos DB CDC selezionata come origine. Per chiudere la procedura guidata, selezionare Chiudi o X* nell'angolo superiore destro della pagina.

    Screenshot che mostra la pagina Rivedi e crea dopo la creazione dell'origine.

  2. Nell'hub in tempo reale passare alla scheda Flussi di dati dell'hub in tempo reale. Aggiorna la pagina. Verrà visualizzato il flusso di dati creato automaticamente, come illustrato nell'immagine seguente.

    Screenshot che mostra la scheda Flussi di dati dell'hub in tempo reale con il flusso appena creato.

    Per i passaggi dettagliati, vedere Visualizzare i dettagli dei flussi di dati nell'hub in tempo reale di Fabric.

Contenuto correlato

Per informazioni sull'utilizzo dei flussi di dati, vedere gli articoli seguenti: