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 poziomu programu Azure Synapse Analytics Studio za pomocą usługi Synapse Link.

Wymagania wstępne

Przed połączeniem konta usługi Azure Cosmos DB z obszarem roboczym należy wykonać kilka czynności.

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 usługi Synapse Link dla usługi Azure Cosmos DB. Ta funkcja umożliwia korzystanie z funkcji HTAP w kontenerze i wbudowanej obsłudze usługi Azure Synapse. Postępuj zgodnie z tym przewodnikiem Szybki start, aby włączyć usługę Synapse Link dla kontenerów usługi Azure Cosmos DB.

W obszarze roboczym usługi Synapse wybierz pozycję Uruchom program Synapse Studio. Na stronie głównej programu 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 dla usługi Azure Synapse Analytics lub SQL w usłudze Azure Cosmos DB.

Z poziomu Eksplorator obiektów danych można 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 przycisk Kontynuuj
  5. Nazwij połączoną usługę. Nazwa będzie wyświetlana w Eksplorator obiektów i używana przez czas wykonywania usługi Synapse w celu nawiązania połączenia z bazą danych i kontenerami. Zalecamy używanie 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 wpisz PreferredRegions i ustaw wartość żądanego regionu (na przykład: WestUS2, nie ma spacji między wyrazami i 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 przez kod

Po kliknięciu prawym przyciskiem myszy w kontenerze będziesz mieć listę gestów, które będą wyzwalać środowisko uruchomieniowe 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ń.

Następne kroki