Condividi tramite

Aggiungere l'origine CDC del database SQL di Azure a un eventstream

  • Articolo

Questo articolo mostra come aggiungere una fonte di Change Data Capture (CDC) del database SQL di Azure a un flusso di eventi.

Il connettore di origine CDC del database SQL di Azure per i flussi di eventi di Microsoft Fabric consente di acquisire uno snapshot dei dati correnti in un database SQL di Azure. Il connettore monitora e registra poi eventuali modifiche future a livello di riga a questi dati. Una volta acquisite le modifiche nell'eventstream, è possibile elaborare questi dati CDC in tempo reale e inviarli a destinazioni diverse in Fabric per un'ulteriore elaborazione o analisi.

Nota

Questa fonte non è supportata nelle seguenti regioni della capienza della tua area di lavoro: West US3, Svizzera occidentale.

Prerequisiti

  • Accesso a un'area di lavoro in modalità di licenza per capacità Fabric o in modalità di licenza di valutazione, con autorizzazioni di Collaboratore o superiori.
  • Un server Azure SQL in esecuzione con un database SQL di Azure.
  • Il database SQL di Azure deve essere accessibile pubblicamente e non essere protetto da un firewall o in una rete virtuale.
  • Abilitato CDC nel database SQL di Azure eseguendo la stored procedure sys.sp_cdc_enable_db. Per ulteriori informazioni, consultare Abilitare e disabilitare Change Data Capture.
  • Se non si dispone di un flusso di eventi, creare un flusso di eventi.

Si noti che non è necessario abilitare il mirroring nel database SQL di Azure.

Abilitare CDC nel database SQL di Azure

  1. Passare al portale di Azure, aprire il database SQL di Azure e selezionare Editor di query. Scegliere un metodo di autenticazione per eseguire l’accesso.

    Screenshot dell’apertura del database SQL di Azure.

  2. Eseguire i comandi SQL seguenti per abilitare CDC nel database:

    -- Enable Database for CDC
EXEC sys.sp_cdc_enable_db;

-- Enable CDC for a table using a gating role option
EXEC sys.sp_cdc_enable_table
    @source_schema = N'dbo',
    @source_name   = N'MyTable',
    @role_name     = NULL
GO

Avviare la procedura guidata Selezionare un'origine dati

Se non hai ancora aggiunto alcuna sorgente al flusso di eventi, seleziona il riquadro Usa sorgente esterna.

Screenshot che mostra la selezione del riquadro Usa origine esterna.

Se si aggiunge l'origine a un flusso di eventi già pubblicato, passare alla modalità modifica, selezionare Aggiungi origine sulla barra multifunzione e quindi selezionare Origini esterne.

Screenshot che mostra la selezione di Aggiungi origine nel menu delle origini esterne.  

Nella pagina Selezionare un'origine dati cercare e selezionare Connetti sul riquadro Azure SQL DB (CDC).

Screenshot che mostra la selezione di CDC di Azure SQL DB come tipo di origine nella procedura guidata per ottenere eventi.

Configurare e connettersi al CDC del database SQL di Azure

  1. Nella pagina Connetti, selezionare Nuova connessione.

    Screenshot che mostra la pagina Connetti della procedura guidata per ottenere eventi con il link **Nuova connessione** evidenziato.

  2. Nella sezione Impostazioni di connessione immettere i valori seguenti per il database SQL di Azure:

    • Server: immettere il nome del server Azure SQL dal portale di Azure. È in questo formato: mysqlservername.database.windows.net.

    • Database: immettere il nome del database SQL di Azure dal portale di Azure.

      Screenshot che mostra le impostazioni di connessione della pagina Nuova connessione.

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

    • Per Nome connessione, immetti un nome per la connessione.

    • Per Tipo di autenticazione selezionare Base.

      Nota

      Attualmente, i flussi di eventi di Fabric supportano solo l'autenticazione di Base .

    • Immettere Nome utente e Password per il database.

  4. Selezionare Connetti.

    Screenshot che mostra le Credenziali di connessione della pagina Nuova connessione.

  5. Nella pagina Connetti, selezionare Tutte le tabelle oppure Immettere i nomi delle tabelle. Se si seleziona quest'ultimo, specificare le tabelle usando un elenco delimitato da virgole di identificatori di tabella completi (schemaName.tableName) o espressioni regolari valide. Per esempio:

    • Usare dbo.test.* per selezionare tutte le tabelle i cui nomi iniziano con dbo.test.
    • Usare dbo\.(test1|test2) per selezionare dbo.test1 e dbo.test2.

    È possibile combinare entrambi i formati usando virgole. È possibile immettere fino a 100 tabelle, con ogni nome di tabella (incluso il nome dello schema) limitato a 128 caratteri se si usano direttamente identificatori di tabella completi.

  6. Selezionare Avanti.

    Screenshot che mostra la pagina di connessione della procedura guidata

  7. Nella schermata Rivedi e crea esaminare il riepilogo e quindi selezionare Aggiungi.

    Screenshot della pagina compilata Rivedi e crea nella procedura guidata Ottieni eventi.

Nota

Il numero massimo di fonti e destinazioni per un flusso di eventi è 11.

Visualizzare il flusso di eventi aggiornato

  1. È possibile visualizzare l'origine del database SQL di Azure (CDC) aggiunta all’eventstream in modalità di modifica.

    Screenshot dello streaming dell’origine CDC del database SQL di Azure nella visualizzazione di Modifica.

  2. Per implementare questa origine CDC del database SQL di Azure appena aggiunta, selezionare Pubblica. Dopo aver completato questi passaggi, l'origine CDC del database SQL di Azure è disponibile per la vista dal vivo.

    Screenshot dello streaming database SQL di Azure origine CDC nella visualizzazione live.

Contenuto correlato

Altri connettori: