Condividi tramite


Aggiungere il database Istanza gestita di SQL di Azure (MI) con CDC come origine nell'hub in tempo reale

Questo articolo descrive come aggiungere Istanza gestita di SQL di Azure CDC come origine evento nell'hub in tempo reale di Fabric.

Il connettore di origine CDC di Azure SQL Managed Instance consente di acquisire uno snapshot dei dati correnti in un database di Istanza gestita di SQL. 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.

Prerequisiti

  • Accesso a un'area di lavoro in modalità di licenza della capacità Fabric (o) modalità licenza di valutazione con permessi da collaboratore o superiori.
  • Database di Azure SQL Managed Instance in esecuzione.
  • L'Istanza gestita di Azure SQL deve abilitare l'endpoint pubblico e non essere collocata dietro un firewall o in una rete virtuale.
  • Per abilitare CDC nell'istanza gestita SQL di Azure, eseguire la stored procedure sys.sp_cdc_enable_db. Per ulteriori informazioni, consultare Abilitare e disabilitare Change Data Capture.

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

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

Screenshot che mostra la pagina di Rete con l'opzione Endpoint pubblico attivata.

Abilitare CDC nell'istanza gestita di SQL di Azure

  1. Abilitare CDC per il database.

    EXEC sys.sp_cdc_enable_db; 
    
  2. Abilitare CDC per una tabella usando un'opzione di ruolo di controllo. 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.

Pagina Origini dati

  1. Accedere a Microsoft Fabric.

  2. Se vedi Power BI nell'angolo in basso a sinistra della pagina, cambia in Fabric workload selezionando Power BI e poi selezionando Fabric.

    Screenshot che mostra come passare al workload di Fabric.

  3. Selezionare Tempo reale sulla barra di navigazione a sinistra.

    Screenshot che mostra come avviare l'esperienza Connetti all'Origine Dati.

  4. Per impostazione predefinita, viene visualizzata la pagina Streaming data (Dati di streaming ). Fare clic sul pulsante Aggiungi dati per accedere alla pagina Origini dati .

    Screenshot che mostra la pagina Origini dati nell'hub Real-Time.

    È anche possibile accedere direttamente alla pagina Origini dati selezionando l'opzione Aggiungi dati nella barra di spostamento a sinistra.

    Screenshot che mostra il pulsante Connetti origine dati.

  1. Nella pagina Origini dati selezionare Categoria Database CDC nella parte superiore e quindi selezionare Connetti nel riquadro DATABASE MI di Azure SQL (CDC).

    Screenshot che mostra la selezione di Azure SQL Managed Instance CDC come tipo di origine nella pagina Origini dati.

    Usare le istruzioni della sezione Aggiungere Istanza SQL gestita di Azure CDC come origine.

Aggiungere Istanza gestita di Azure SQL CDC come origine

  1. Nella pagina Connetti, seleziona Nuova connessione.

    Screenshot che mostra la selezione del collegamento Nuova connessione nella pagina Connetti.

  2. 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 .

      Screenshot che mostra la pagina Rete con informazioni sull'endpoint.

    • Database: immettere il nome del database a cui connettersi all'interno del Istanza gestita di SQL di Azure.

      Screenshot che mostra la sezione Impostazioni di connessione della pagina Connetti.

  3. 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.

  4. Selezionare Connetti nella parte inferiore della pagina.

  5. Nella pagina Connetti selezionare Tutte le tabelle o Immettere i nomi di tabella. 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 nell'elenco. Il limite di caratteri totale per l'intera voce è di 102.400 caratteri.

  6. È possibile espandere Impostazioni avanzate per configurare la modalità di gestione decimale, che specifica il modo in cui il connettore gestisce DECIMAL e NUMERIC i valori delle colonne:

    • Precise: rappresenta i valori usando tipi decimali esatti ,ad esempio Java BigDecimal, per garantire la precisione completa e l'accuratezza nella rappresentazione dei dati.
    • Double: converte i valori in numeri a virgola mobile e precisione doppia. Ciò migliora l'usabilità e le prestazioni, ma può comportare una perdita di precisione.
    • String: codifica i valori come stringhe formattate. Questo li rende facili da utilizzare nei sistemi downstream, ma perde informazioni semantiche sul tipo numerico originale.
  7. Selezionare Avanti.

    Screenshot che mostra la selezione dell'opzione Tutte le tabelle.

  8. Nella pagina Rivedi e connetti esaminare il riepilogo e quindi selezionare Connetti.

    Screenshot che mostra la selezione del pulsante Aggiungi.

Visualizzare i dettagli del flusso dei dati

  1. Nella pagina Rivedi e connetti, se si seleziona Apri eventstream, la procedura guidata apre il flusso di eventi, creato per te con l'istanza selezionata di Azure SQL MI DB CDC come origine. Per chiudere la procedura guidata, selezionare Chiudi o X* nell'angolo superiore destro della pagina.
  2. Il flusso dovrebbe essere visualizzato nella sezione Dati di streaming recenti della home page dell'hub Real-Time . Per i passaggi dettagliati, vedere Visualizzare i dettagli dei flussi dei dati nell'Hub in tempo reale di Fabric.

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