Del via


Legg til Azure Cosmos DB CDC-kilde i en eventstream

Denne artikkelen viser deg hvordan du legger til en Azure Cosmos DB (Azure Cosmos DB for NoSQL) Endre datakilde til en hendelsesstrøm.

Azure Cosmos DB Change Data Capture (CDC)-kildekoblingen for Microsoft Fabric-hendelsesstrømmer lar deg ta et øyeblikksbilde av gjeldende data i en Azure Cosmos DB-database. Koblingen overvåker og registrerer deretter eventuelle fremtidige endringer på radnivå i disse dataene. Når endringene er registrert i hendelsesstrømmen, kan du behandle disse CDC-dataene i sanntid og sende dem til forskjellige mål i Fabric for videre behandling eller analyse.

Merk

Denne kilden støttes ikke i følgende områder av arbeidsområdets kapasitet: Vest-USA3, Sveits vest.

Forutsetning

  • Tilgang til et arbeidsområde i lisensmodus for stoffkapasitet (eller) prøveversjonslisensmodus med bidragsyter eller høyere tillatelser.
  • Tilgang til en Azure Cosmos DB for NoSQL-konto og -database.
  • Azure Cosmos DB for NoSQL-databasen må være offentlig tilgjengelig og ikke være bak en brannmur eller sikret i et virtuelt nettverk.
  • Hvis du ikke har en hendelsesstrøm, oppretter du en hendelsesstrøm.

Få tilkoblingsdetaljer fra Azure-portalen

Etikettene for elementene du må samle inn fra Azure-portalen, vises i fremgangsmåten nedenfor. Du trenger alltid endepunkt-URI-en, i et format som https://<account>.<api>.azure.com:<port>/primærnøkkelen og databasenavnet og element-ID-ene du vil samle inn data for.

Merk

Azure Cosmos DB for NoSQL CDC bruker den nyeste versjonsmodusen for Azure Cosmos DB Change Feed. Den registrerer endringene i poster i den nyeste versjonen. Vær oppmerksom på at slettinger ikke fanges opp i denne modusen.

  1. Velg Nøkler under Innstillinger i navigasjonsruten til venstre på Azure Portal-siden for Azure Cosmos DB-kontoen.

  2. Kopier URI- og Primærnøkkelverdiene som skal brukes til å konfigurere eventstream-tilkoblingen, på Taster-siden.

    Et skjermbilde av URI- og Primærnøkkelen på Azure Cosmos DB Keys-siden i Azure-portalen.

  3. Legg merke til database- og element-ID-en du vil samle inn data for, på Azure Portal Overview-siden for Azure Cosmos DB-kontoen.

    Et skjermbilde av beholderoppføringen for en Azure Cosmos DB NoSQL API-konto.

Merk

Maksimalt antall kilder og mål for én hendelsesstrøm er 11.

Legg til Azure Cosmos DB (CDC) som kilde

Hvis du ikke har lagt til noen kilde i hendelsesstrømmen ennå, velger du Bruk ekstern kildeflis .

Skjermbilde som viser utvalget av Bruk ekstern kildeflis.

Hvis du legger til kilden i en allerede publisert hendelsesstrøm, bytter du til redigeringsmodus , velger Legg til kilde på båndet, og deretter velger du Eksterne kilder.

Skjermbilde som viser utvalget av Legg til kilde i eksterne kilder-menyen.

Søk etter og velg Koble til på Azure Event Hubs-flisen på siden Velg en datakilde.

Skjermbilde som viser utvalget av Azure Cosmos DB (CDC) som kildetype i veiviseren Velg en datakilde.

Konfigurere og koble til Azure Cosmos DB (CDC)

  1. Velg Ny tilkobling på Connect-skjermen under Tilkobling for å opprette en skytilkobling som kobler til Azure Cosmos DB-databasen.

    Skjermbilde som viser Koble til-siden med koblingen Ny tilkobling valgt.

  2. Skriv inn følgende informasjon på skjermbildet Tilkoblingsinnstillinger:

    • Cosmos DB-endepunkt: Skriv inn URI-en eller endepunktet for Cosmos DB-kontoen som du kopierte fra Azure-portalen.
    • Tilkoblingsnavn: Automatisk generert, eller du kan angi et nytt navn for denne tilkoblingen.
    • Kontonøkkel: Angi primærnøkkelen for Azure Cosmos DB-kontoen som du kopierte fra Azure-portalen.

    Et skjermbilde av tilkoblingsinnstillingene for Azure Cosmos DB CDC-kilden.

  3. Velg Koble til.

  4. Oppgi følgende informasjon for Azure Cosmos DB-ressursene, og velg deretter Neste.

    • Beholder-ID: Skriv inn navnet på Azure Cosmos DB-beholderen eller tabellen du vil koble til.

    • Database: Skriv inn navnet på Azure Cosmos DB-databasen.

    • Forskyvningspolicy: Velg om du vil begynne å lese tidligste eller siste forskyvninger hvis det ikke er noen utføring.

      Du kan også endre kildenavnet i streamdetaljer-delen til høyre ved å velge Blyant-knappen.

      Et skjermbilde av tilkoblingsdetaljene for Azure Cosmos DB CDC-kilden.

  5. Se gjennom sammendraget på siden Se gjennom + koble til, og velg deretter Legg til.

    Skjermbilde som viser siden Se gjennom + koble til for Azure Cosmos DB CDC-kilden.

Vis oppdatert hendelsesstrøm

  1. Du ser Azure Cosmos DB-kilden (CDC) som er lagt til i hendelsesstrømmen i redigeringsmodus. Velg Publiser for å publisere endringene og begynne å strømme Azure Cosmos DB CDC-data til eventstreamen.

    Et skjermbilde av den tilføyde Azure Cosmos DB CDC-kilden i redigeringsmodus med Publiser-knappen uthevet.

  2. Du ser eventstreamen i live-modus. Velg Rediger på båndet for å gå tilbake til redigeringsmodus for å oppdatere hendelsesstrømmen.

    Et skjermbilde av den publiserte eventstreamen med Azure Cosmos DB-kilde i Live View.

Andre koblinger: