Nawiązywanie połączenia z usługą Azure Synapse Link dla usługi Azure Cosmos DB

Artykuł
04/24/2023

W tym artykule opisano sposób uzyskiwania dostępu do bazy danych usługi Azure Cosmos DB z programu Azure Synapse Analytics Studio za pomocą usługi Azure Synapse Link.

Wymagania wstępne

Przed połączeniem bazy danych usługi Azure Cosmos DB z obszarem roboczym potrzebne są następujące elementy:

Istniejąca baza danych usługi Azure Cosmos DB lub utwórz nowe konto, wykonując kroki opisane w przewodniku Szybki start: Zarządzanie kontem usługi Azure Cosmos DB.
Istniejący obszar roboczy Azure Synapse lub utwórz nowy obszar roboczy, wykonując kroki opisane w przewodniku Szybki start: tworzenie obszaru roboczego usługi Synapse.

Włączanie Synapse Link na koncie bazy danych 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. Synapse Link umożliwia korzystanie z funkcji HTAP w kontenerze i wbudowanej obsłudze Azure Synapse.

Przejdź do Synapse Studio

W obszarze roboczym Azure 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 Azure Synapse

Łączenie bazy danych usługi Azure Cosmos DB odbywa się jako połączona usługa. Dzięki połączonej usłudze Azure Cosmos DB możesz przeglądać i eksplorować dane, odczytywać i zapisywać z platformy Apache Spark na potrzeby Azure Synapse Analytics lub SQL w usłudze Azure Cosmos DB.

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

Wybierz ikonę w + pobliżu pozycji Dane.
Wybierz pozycję Połącz z danymi zewnętrznymi.
Wybierz interfejs API, z którym chcesz nawiązać połączenie, na przykład interfejs API SQL lub interfejs API dla bazy danych MongoDB.
Wybierz opcję Kontynuuj.
Użyj przyjaznej nazwy, aby nazwać połączoną usługę. Nazwa będzie wyświetlana w Eksplorator obiektów danych i jest używana przez środowiska uruchomieniowe Azure Synapse do łączenia się z bazą danych i kontenerami.
Wybierz nazwę konta usługi Azure Cosmos DB i nazwę bazy danych.
(Opcjonalnie) Jeśli żaden region nie zostanie określony, Azure Synapse operacje środowiska uruchomieniowego będą kierowane do najbliższego regionu, w którym jest włączony magazyn analityczny. Możesz również ręcznie ustawić region, za pomocą którego użytkownicy będą uzyskiwać dostęp do magazynu analitycznego usługi Azure Cosmos DB. Wybierz pozycję Dodatkowe właściwości połączenia, a następnie wybierz pozycję Nowy. W obszarze Nazwa właściwości wprowadź wartość PreferredRegions. Ustaw wartość na żądany region, na przykład WestUS2. (Nie ma spacji między wyrazami a liczbą).
Wybierz przycisk Utwórz.

Bazy danych usługi Azure Cosmos DB są wyświetlane na karcie Połączone w sekcji Azure Cosmos DB . Usługa Azure Cosmos DB umożliwia odróżnienie kontenera z obsługą protokołu HTAP na podstawie kontenera tylko olTP za pomocą następujących ikon:

Kontener tylko OLTP:

Wizualizacja przedstawiająca ikonę kontenera OLTP.

Kontener z obsługą protokołu HTAP:

Wizualizacja przedstawiająca ikonę kontenera HTAP.

Szybka interakcja z akcjami wygenerowanymi przy użyciu kodu

Klikając prawym przyciskiem myszy kontener, masz listę gestów, które spowodują wyzwolenie środowiska uruchomieniowego Spark lub SQL. Zapisywanie w kontenerze nastąpi za pośrednictwem transakcyjnego magazynu usługi Azure Cosmos DB i będzie zużywać jednostki żądań.