Szybki start: nawiązywanie połączenia z usługą Azure Synapse Link dla usługi Azure Cosmos DB

  • Artykuł

W tym artykule opisano sposób uzyskiwania dostępu do bazy danych usługi Azure Cosmos DB z programu Azure Synapse Analytics Studio przy użyciu Synapse Link.

Wymagania wstępne

Przed nawiązaniem połączenia konta usługi Azure Cosmos DB z obszarem roboczym istnieje kilka potrzebnych rzeczy.

Włączanie magazynu analitycznego usługi Azure Cosmos DB

Aby uruchomić analizę na dużą skalę w usłudze Azure Cosmos DB bez wpływu na wydajność operacyjną, zalecamy włączenie Synapse Link dla usługi Azure Cosmos DB. Ta funkcja umożliwia korzystanie z funkcji HTAP w kontenerze i wbudowanej obsłudze Azure Synapse. Postępuj zgodnie z tym przewodnikiem Szybki start, aby włączyć Synapse Link dla kontenerów usługi Azure Cosmos DB.

W obszarze roboczym usługi Synapse wybierz pozycję Uruchom Synapse Studio. Na stronie głównej Synapse Studio wybierz pozycję **Dane, co spowoduje przejście do Eksplorator obiektów Danych.

Łączenie bazy danych usługi Azure Cosmos DB z obszarem roboczym usługi Synapse

Łączenie bazy danych usługi Azure Cosmos DB odbywa się jako połączona usługa. Połączona usługa Azure Cosmos DB umożliwia użytkownikom przeglądanie i eksplorowanie danych, odczytywanie i zapisywanie z platformy Apache Spark na potrzeby usługi Azure Synapse Analytics lub SQL w usłudze Azure Cosmos DB.

W Eksplorator obiektów danych możesz bezpośrednio połączyć bazę danych usługi Azure Cosmos DB, wykonując następujące czynności:

  1. Wybierz + ikonę w pobliżu danych
  2. Wybierz pozycję Połącz z danymi zewnętrznymi
  3. Wybierz interfejs API, z którym chcesz nawiązać połączenie: SQL lub MongoDB
  4. Wybierz pozycję Kontynuuj
  5. Nazwij połączoną usługę. Nazwa będzie wyświetlana w Eksplorator obiektów i używana przez program Synapse do łączenia się z bazą danych i kontenerami. Zalecamy użycie przyjaznej nazwy.
  6. Wybierz nazwę konta usługi Cosmos DB i nazwę bazy danych
  7. (Opcjonalnie) Jeśli nie określono żadnego regionu, operacje czasu wykonywania usługi Synapse będą kierowane do najbliższego regionu, w którym jest włączony magazyn analityczny. Można jednak ustawić ręcznie region, w którym użytkownicy mają uzyskiwać dostęp do magazynu analitycznego usługi Azure Cosmos DB. Wybierz pozycję Dodatkowe właściwości połączenia , a następnie pozycję Nowy. W obszarze Nazwa właściwości napisz wartość PreferredRegions i ustaw wartość żądanego regionu (na przykład: WestUS2, nie ma spacji między wyrazami a liczbami)
  8. Wybierz pozycję Utwórz

Bazy danych usługi Azure Cosmos DB są widoczne na karcie Połączone w sekcji Azure Cosmos DB. Kontener usługi Azure Cosmos DB z obsługą protokołu HTAP można odróżnić tylko od kontenera OLTP z następującymi ikonami:

Kontener usługi Synapse:

Kontener HTAP

Kontener tylko OLTP:

Kontener OLTP

Szybka interakcja z akcjami wygenerowanymi przy użyciu kodu

Po kliknięciu prawym przyciskiem myszy kontenera będziesz mieć listę gestów, które wyzwalają środowisko Spark lub czas wykonywania SQL. Zapisywanie w kontenerze będzie odbywać się za pośrednictwem magazynu transakcyjnego usługi Azure Cosmos DB i będzie zużywać jednostki żądań.

Następne kroki