Udostępnij za pośrednictwem


Dodawanie źródła cdC usługi Azure Cosmos DB do strumienia zdarzeń

W tym artykule pokazano, jak dodać źródło przechwytywania danych do strumienia zdarzeń usługi Azure Cosmos DB (Azure Cosmos DB for NoSQL).

Łącznik źródła przechwytywania zmian danych (CDC) usługi Azure Cosmos DB dla strumieni zdarzeń usługi Microsoft Fabric umożliwia przechwycenie migawki bieżących danych w bazie danych usługi Azure Cosmos DB. Następnie łącznik monitoruje i rejestruje wszelkie przyszłe zmiany na poziomie wiersza w tych danych. Po przechwyceniu zmian w strumieniu zdarzeń można przetwarzać te dane CDC w czasie rzeczywistym i wysyłać je do różnych miejsc docelowych w sieci szkieletowej w celu dalszego przetwarzania lub analizy.

Uwaga

To źródło nie jest obsługiwane w następujących regionach pojemności obszaru roboczego: Zachodnie stany USA3, Szwajcaria Zachodnia.

Wymagania wstępne

  • Dostęp do obszaru roboczego w trybie licencji pojemności sieci szkieletowej (lub) w trybie licencji próbnej z uprawnieniami współautora lub wyższymi uprawnieniami.
  • Dostęp do konta i bazy danych usługi Azure Cosmos DB for NoSQL .
  • Baza danych Azure Cosmos DB for NoSQL musi być publicznie dostępna i nie znajdować się za zaporą ani zabezpieczyć w sieci wirtualnej.
  • Jeśli nie masz strumienia zdarzeń, utwórz strumień zdarzeń.

Pobieranie szczegółów połączenia z witryny Azure Portal

Etykiety elementów, które należy zebrać z witryny Azure Portal, są wyświetlane w poniższych krokach. Zawsze potrzebny jest identyfikator URI punktu końcowego w formacie, na przykład https://<account>.<api>.azure.com:<port>/, klucz podstawowy oraz identyfikatory nazw i elementów bazy danych, dla których chcesz zbierać dane.

Uwaga

Usługa Azure Cosmos DB for NoSQL CDC korzysta z najnowszego trybu wersji zestawienia zmian usługi Azure Cosmos DB. Przechwytuje zmiany rekordów w najnowszej wersji. Pamiętaj, że usunięcia nie są przechwytywane w tym trybie.

  1. Na stronie witryny Azure Portal dla konta usługi Azure Cosmos DB wybierz pozycję Klucze w obszarze Ustawienia w obszarze nawigacji po lewej stronie.

  2. Na stronie Klucze skopiuj wartości identyfikatora URI i klucza podstawowego do użycia do konfigurowania połączenia strumienia zdarzeń.

    Zrzut ekranu przedstawiający identyfikator URI i klucz podstawowy na stronie Klucze usługi Azure Cosmos DB w witrynie Azure Portal.

  3. Na stronie Przegląd witryny Azure Portal dla konta usługi Azure Cosmos DB zanotuj identyfikator bazy danych i elementu, dla którego chcesz zbierać dane.

    Zrzut ekranu przedstawiający listę kontenerów dla konta interfejsu API NoSQL usługi Azure Cosmos DB.

Uwaga

Maksymalna liczba źródeł i miejsc docelowych dla jednego strumienia zdarzeń wynosi 11.

Dodawanie usługi Azure Cosmos DB (CDC) jako źródła

Jeśli jeszcze nie dodano żadnego źródła do strumienia zdarzeń, wybierz pozycję Użyj kafelka zewnętrznego źródła .

Zrzut ekranu przedstawiający wybór kafelka Użyj zewnętrznego źródła.

Jeśli dodasz źródło do już opublikowanego strumienia zdarzeń, przełącz się do trybu edycji , wybierz pozycję Dodaj źródło na wstążce, a następnie wybierz pozycję Źródła zewnętrzne.

Zrzut ekranu przedstawiający wybór menu Dodaj źródło do źródeł zewnętrznych.

Na stronie Wybieranie źródła danych wyszukaj i wybierz pozycję Połącz na kafelku Azure Event Hubs.

Zrzut ekranu przedstawiający wybór usługi Azure Cosmos DB (CDC) jako typ źródła w kreatorze Wybieranie źródła danych.

Konfigurowanie i nawiązywanie połączenia z usługą Azure Cosmos DB (CDC)

  1. Na ekranie Połącz w obszarze Połączenie wybierz pozycję Nowe połączenie, aby utworzyć połączenie w chmurze łączące się z bazą danych usługi Azure Cosmos DB.

    Zrzut ekranu przedstawiający stronę Połącz z wybranym linkiem Nowe połączenie.

  2. Na ekranie Ustawienia połączenia wprowadź następujące informacje:

    • Punkt końcowy usługi Cosmos DB: wprowadź identyfikator URI lub punkt końcowy dla konta usługi Cosmos DB skopiowanego z witryny Azure Portal.
    • Nazwa połączenia: wygenerowana automatycznie lub możesz wprowadzić nową nazwę dla tego połączenia.
    • Klucz konta: wprowadź klucz podstawowy konta usługi Azure Cosmos DB skopiowany z witryny Azure Portal.

    Zrzut ekranu przedstawiający ustawienia połączenia dla źródła usługi CDC usługi Azure Cosmos DB.

  3. Wybierz pozycję Połącz.

  4. Podaj następujące informacje dotyczące zasobów usługi Azure Cosmos DB, a następnie wybierz pozycję Dalej.

    • Identyfikator kontenera: wprowadź nazwę kontenera lub tabeli usługi Azure Cosmos DB, z którą chcesz nawiązać połączenie.

    • Baza danych: wprowadź nazwę bazy danych usługi Azure Cosmos DB.

    • Zasady przesunięcia: wybierz, czy chcesz rozpocząć odczytywanie najwcześniejszych , czy najnowszych przesunięć, jeśli nie ma zatwierdzenia.

      Możesz również zmienić nazwę źródła w sekcji Szczegóły strumienia po prawej stronie, wybierając przycisk Ołówek.

      Zrzut ekranu przedstawiający szczegóły połączenia dla źródła usługi CDC usługi Azure Cosmos DB.

  5. Na stronie Przeglądanie i łączenie przejrzyj podsumowanie, a następnie wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający stronę Przeglądanie i łączenie dla źródła usługi CDC usługi Azure Cosmos DB.

Wyświetlanie zaktualizowanego strumienia zdarzeń

  1. Zobaczysz źródło usługi Azure Cosmos DB (CDC) dodane do strumienia zdarzeń w trybie edycji. Wybierz pozycję Publikuj, aby opublikować zmiany i rozpocząć przesyłanie strumieniowe danych cdC usługi Azure Cosmos DB do strumienia zdarzeń.

    Zrzut ekranu przedstawiający dodane źródło CDC usługi Azure Cosmos DB w trybie edycji z wyróżnionym przyciskiem Publikuj.

  2. Zostanie wyświetlony strumień zdarzeń w trybie na żywo. Wybierz pozycję Edytuj na wstążce, aby wrócić do trybu edycji, aby zaktualizować strumień zdarzeń.

    Zrzut ekranu przedstawiający opublikowany strumień zdarzeń ze źródłem usługi Azure Cosmos DB w widoku na żywo.

Inne łączniki: