Aggiungere un'origine CDC dell'istanza gestita di Azure SQL a un flusso di eventi

Articolo
2025-04-09

Questo articolo illustra come aggiungere un'origine change data capture (CDC) Istanza gestita di SQL di Azure a un flusso di eventi.

Il connettore di origine CDC per i flussi di eventi di Microsoft Fabric permette di acquisire uno snapshot dei dati attuali in un database di Istanza di SQL gestita. 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 sorgente non è supportata nelle seguenti regioni della capacità dell'area di lavoro: Stati Uniti occidentali 3, Svizzera occidentale.

Prerequisiti

Accesso a un'area di lavoro in modalità di licenza Fabric capacity oppure in modalità di licenza di valutazione con autorizzazioni di Collaboratore o superiori.
Istanza gestita di Azure SQL Database in esecuzione.
L'istanza gestita di SQL di Azure deve avere abilitato l'endpoint pubblico e non essere dietro un firewall né inserita in una rete virtuale sicura.
L'abilitazione di CDC nell'istanza gestita di Azure SQL avviene eseguendo la stored procedure sys.sp_cdc_enable_db. Per ulteriori informazioni, consultare Abilitare e disabilitare Change Data Capture.

Nota

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

Abilitare l'endpoint pubblico nell'istanza gestita di SQL di Azure

Passare al portale di Azure, aprire l'istanza gestita di SQL di Azure, selezionare Rete e abilitare l'endpoint pubblico.

Abilitare CDC nell'istanza gestita di SQL di Azure

Abilitare CDC per il database.
```
EXEC sys.sp_cdc_enable_db; 
```
Abilitare CDC per una tabella usando un'opzione di controllo del ruolo. In questo esempio è MyTable il nome della tabella SQL.
```
EXEC sys.sp_cdc_enable_table 
   @source_schema = N'dbo', 
   @source_name   = N'MyTable', 
   @role_name     = NULL 
GO 
```
Dopo l'esecuzione della query, è stato abilitato CDC nell'istanza gestita di SQL di Azure.

Aggiungere Istanza gestita di SQL di Azure CDC come origine

Nell’Intelligence in tempo reale di Fabric selezionare Eventstream per creare un nuovo flusso di eventi.
Nella schermata successiva selezionare Aggiungi origine esterna.

Configurare e connettersi a Istanza SQL gestita di Azure CDC

Nella pagina Connetti, seleziona Nuova connessione.
Nella sezione Impostazioni di connessione immettere i valori seguenti per SQL Server nella macchina virtuale:
- Server: immettere l'endpoint dal portale di Azure, sostituendo la virgola tra l'host e la porta con due punti. Ad esempio, se l'endpoint è xxxxx.public.xxxxxx.database.windows.net,3342, è necessario immettere xxxxx.public.xxxxxx.database.windows.net:3342 nel campo Server .
- Database: immettere il nome del database a cui connettersi all'interno del Istanza gestita di SQL di Azure.
Scorrere verso il basso e nella Sezione 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 SQL Server nella macchina virtuale.
Selezionare Connetti nella parte inferiore della pagina.
Nella pagina Connetti selezionare Tutte le tabelle o Immettere il nome della/delle tabella/e. 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.
Selezionare Avanti.
Nella pagina Rivedi e connetti esaminare il riepilogo e quindi selezionare Connetti.

Visualizzare il flusso di eventi aggiornato

È possibile visualizzare l'origine del database SQL MI di Azure (CDC) aggiunta al flusso di eventi in modalità di modifica.

Per implementare l'origine Istanza gestita di SQL di Azure appena aggiunta, selezionare Pubblica. Dopo aver completato questi passaggi, l'origine Istanza SQL gestita di Azure è disponibile per la visualizzazione live.

Altri connettori:

Condividi tramite