Dela via

Lägga till Azure Cosmos DB CDC som källa i realtidshubben

  • Artikel

Den här artikeln beskriver hur du lägger till Azure Cosmos DB for NoSQL Change Data Capture (CDC) som händelsekälla i Fabric Real-Time Hub.

Med källanslutningsappen för Azure Cosmos DB Change Data Capture (CDC) kan du samla in en ögonblicksbild av aktuella data i en Azure Cosmos DB-databas. Anslutningsappen övervakar och registrerar eventuella framtida ändringar på radnivå av dessa data. När ändringarna har samlats in i en dataström kan du bearbeta CDC-data i realtid och skicka dem till olika mål i Infrastrukturresurser för vidare bearbetning eller analys.

Förutsättningar

  • Åtkomst till en arbetsyta i infrastrukturkapacitetslicensläget (eller) utvärderingslicensläget med deltagare eller högre behörigheter.
  • Åtkomst till ett Azure Cosmos DB för NoSQL-konto och databas.
  • Din Azure Cosmos DB for NoSQL-databas måste vara offentligt tillgänglig och inte finnas bakom en brandvägg eller skyddas i ett virtuellt nätverk.
  • Om du inte har en händelseström skapar du en händelseström.

Hämta anslutningsinformation från Azure Portal

Etiketterna för de objekt som du behöver samla in från Azure Portal visas i följande steg. Du behöver alltid slutpunkts-URI:n i ett format som https://<account>.<api>.azure.com:<port>/, primärnyckeln och databasnamnet och objekt-ID:n som du vill samla in data för.

Kommentar

Azure Cosmos DB for NoSQL CDC använder det senaste versionsläget för Azure Cosmos DB-ändringsflödet. Den registrerar ändringarna i poster i den senaste versionen. Observera att borttagningar inte registreras i det här läget.

  1. På sidan Azure Portal för ditt Azure Cosmos DB-konto väljer du Nycklar under Inställningar i det vänstra navigeringsfältet.

  2. På sidan Nycklar kopierar du de URI - och primärnyckelvärden som ska användas för att konfigurera händelseströmsanslutningen.

    En skärmbild av URI:n och primärnyckeln på sidan Azure Cosmos DB-nycklar i Azure Portal.

  3. På sidan Azure Portal Översikt för ditt Azure Cosmos DB-konto noterar du det databas- och objekt-ID som du vill samla in data för.

    En skärmbild av containerlistan för ett Azure Cosmos DB NoSQL API-konto.

Hämta händelser från en Azure Cosmos DB CDC

Du kan hämta händelser från en Azure Cosmos DB CDC till realtidshubben på något av följande sätt:

Sidan datakällor

  1. Logga in på Microsoft Fabric.

  2. Välj Realtid i det vänstra navigeringsfältet.

  3. På sidan Realtidshubb väljer du + Datakällor under Anslut till på den vänstra navigeringsmenyn. Du kan också komma till sidan Datakällor från Alla dataströmmar eller Mina dataströmmar genom att välja knappen + Anslut datakälla i det övre högra hörnet.

    Skärmbild som visar hur du startar Anslut till datakällan.

Använd instruktioner från avsnittet Lägg till Azure Cosmos DB CDC som källa .

Sidan Microsoft-källor

  1. I Realtidshubben väljer du Microsoft-källor.

  2. Välj Azure Cosmos DB (CDC) i listrutan Källa.

  3. För Prenumeration väljer du en Azure-prenumeration som har resursgruppen med ditt Cosmos DB-konto.

  4. För Resursgrupp väljer du en resursgrupp som har ditt Cosmos DB-konto.

  5. För Region väljer du en plats där Cosmos DB finns.

  6. Flytta musen över namnet på cosmos DB CDC-källan som du vill ansluta till realtidshubben i listan över databaser och välj knappen Anslut eller välj ... (ellips)och välj sedan knappen Anslut .

    Skärmbild som visar sidan Microsoft-källor med filter för att visa Cosmos DB CDC och knappen Anslut.

    Om du vill konfigurera anslutningsinformation använder du steg från avsnittet Lägg till Azure Cosmos DB CDC som källa . Hoppa över det första steget för att välja Azure Cosmos DB CDC som källtyp i guiden Lägg till källa.

Lägga till Azure Cosmos DB CDC som källa

  1. På sidan Anslut väljer du Ny anslutning.

    Skärmbild som visar sidan Lägg till källguiden Anslut. med länken **Ny anslutning** markerad.

  2. I avsnittet Anslutningsinställningar anger du Cosmos DB-slutpunkten. Ange URI:n eller slutpunkten för ditt Cosmos DB-konto som du kopierade från Azure Portal.

    Skärmbild som visar avsnittet Anslutningsinställningar på sidan Ny anslutning.

  3. Expandera Avancerade alternativ och följ dessa steg:

    1. För Antal återförsök anger du det maximala antalet gånger som anslutningsappen ska överföra en begäran till Cosmos DB-databasen om begäran misslyckas från ett återställningsbart fel.

    2. För Funktionen Enable AVERAGE (Aktivera genomsnittlig funktion) anger du om anslutningsappen ska skickas ned från avg-mängdfunktionen till Cosmos DB-databasen.

    3. För Aktivera SORT-passering för flera kolumner anger du om anslutningsappen ska tillåta att flera kolumner skickas till Cosmos DB-databasen när den anges i ORDER BY-satsen i SQL-frågan.

      Skärmbild som visar avancerade alternativ för att konfigurera Azure Cosmos DB-anslutningsappen.

  4. Rulla nedåt och följ de här stegen i avsnittet Anslutningsautentiseringsuppgifter .

    1. Välj en befintlig anslutning och behåll standardalternativet Skapa ny anslutning .
    2. Om du vill skapa en anslutning anger du följande värden:

      1. Som Anslutningsnamn anger du ett namn för anslutningen.

      2. För Typ av autentisering väljer du Kontonyckel.

      3. För Kontonyckel anger du nyckelvärdet som du sparade tidigare.

      4. Välj Anslut.

        Skärmbild som visar avsnittet Anslutningsautentiseringsuppgifter på sidan Ny anslutning.

  5. Gör nu följande på sidan Anslut :

    1. Ange containerns container-ID i ditt Azure Cosmos DB-konto.

    2. I avsnittet Stream-information till höger väljer du arbetsytan Infrastruktur där du vill spara den händelseström som guiden ska skapa.

    3. För eventstream-namn anger du ett namn för händelseströmmen. Guiden skapar en händelseström med den valda Azure Cosmos DB CDC som källa.

    4. Stream-namnet genereras automatiskt åt dig genom att lägga till -stream till namnet på händelseströmmen. Du kan se den här strömmen på sidan Alla dataströmmar i realtidshubben när guiden är klar.

    5. Välj Nästa.

      Skärmbild som visar den ifyllda sidan Anslut till källguiden.

  6. På skärmen Granska + anslut granskar du sammanfattningen och väljer sedan Skapa källa.

    Skärmbild som visar den ifyllda sidan Granska + anslut i guiden Lägg till källa.

Visa information om dataström

  1. På sidan Granska + anslut, om du väljer Öppna händelseström, öppnar guiden den händelseström som den skapade åt dig med den valda Azure Cosmos DB CDC som källa. Stäng guiden genom att välja Stäng eller X* i det övre högra hörnet på sidan.

    Skärmbild som visar sidan Granska + anslut när källan har skapats.

  2. I Realtidshubben väljer du Alla dataströmmar. Om du vill se den nya dataströmmen uppdaterar du sidan Alla dataströmmar .

    Skärmbild som visar sidan Alla dataströmmar i realtidshubben med den dataström som du nyss skapade.

    Detaljerade steg finns i Visa information om dataströmmar i fabric-realtidshubben.

Relaterat innehåll

Mer information om hur du använder dataströmmar finns i följande artiklar: