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

W tym artykule opisano, jak uzyskać dostęp do bazy danych Azure Cosmos DB z usługi Azure Synapse Analytics Studio za pomocą usługi Azure Synapse link.This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link.

Wymagania wstępnePrerequisites

Przed nawiązaniem połączenia z bazą danych Azure Cosmos DB z obszarem roboczym będziesz potrzebować:Before you connect an Azure Cosmos DB database to your workspace, you'll need an:

Aby uruchomić analizę na dużą skalę w Azure Cosmos DB bez wpływu na wydajność operacyjną, zalecamy włączenie linku Synapse dla Azure Cosmos DB.To run large-scale analytics into Azure Cosmos DB without affecting your operational performance, we recommend enabling Synapse Link for Azure Cosmos DB. Link Synapse umożliwia HTAP funkcji kontenera i wbudowaną obsługę usługi Azure Synapse.Synapse Link brings HTAP capability to a container and built-in support in Azure Synapse.

Przejdź do Synapse StudioGo to Synapse Studio

W obszarze roboczym usługi Azure Synapse wybierz pozycję Uruchom Synapse Studio.From your Azure Synapse workspace, select Launch Synapse Studio. Na stronie głównej programu Synapse Studio wybierz pozycję dane, co spowoduje przejście do Eksplorator obiektów danych.On the Synapse Studio home page, select Data, which takes you to the Data Object Explorer.

Łączenie bazy danych Azure Cosmos DB z obszarem roboczym usługi Azure SynapseConnect an Azure Cosmos DB database to an Azure Synapse workspace

Łączenie Azure Cosmos DB bazą danych odbywa się jako połączona usługa.Connecting an Azure Cosmos DB database is done as a linked service. Za pomocą połączonej usługi Azure Cosmos DB można przeglądać i eksplorować dane, czytać i pisać z Apache Spark na potrzeby usługi Azure Synapse Analytics lub SQL w Azure Cosmos DB.With an Azure Cosmos DB linked service, you can browse and explore data, read, and write from Apache Spark for Azure Synapse Analytics or SQL into Azure Cosmos DB.

Korzystając z Eksplorator obiektów danych, możesz połączyć się bezpośrednio z bazą danych Azure Cosmos DB, wykonując następujące czynności:From the Data Object Explorer, you can directly connect to an Azure Cosmos DB database by following these steps:

  1. Wybierz + ikonę obok danych.Select the + icon near Data.
  2. Wybierz pozycję Połącz z danymi zewnętrznymi.Select Connect to external data.
  3. Wybierz interfejs API, z którym chcesz nawiązać połączenie, na przykład SQL API lub API for MongoDB.Select the API that you want to connect to, for example, SQL API or API for MongoDB.
  4. Wybierz opcję Kontynuuj.Select Continue.
  5. Użyj przyjaznej nazwy, aby nazwać połączoną usługę.Use a friendly name to name the linked service. Nazwa zostanie wyświetlona w Eksplorator obiektów danych i będzie używana przez środowisko uruchomieniowe usługi Azure Synapse do łączenia się z bazą danych i kontenerami.The name will appear in the Data Object Explorer and is used by Azure Synapse runtimes to connect to the database and containers.
  6. Wybierz nazwę konta Azure Cosmos DB i nazwę bazy danych.Select the Azure Cosmos DB account name and the database name.
  7. Obowiązkowe Jeśli region nie zostanie określony, operacje środowiska uruchomieniowego usługi Azure Synapse są kierowane do najbliższego regionu, w którym jest włączony magazyn analityczny.(Optional) If no region is specified, Azure Synapse runtime operations will be routed toward the nearest region where the analytical store is enabled. Można również ręcznie ustawić region, w którym użytkownicy mają uzyskiwać dostęp do magazynu analitycznego Azure Cosmos DB.You can also manually set the region you want your users to use to access the Azure Cosmos DB analytical store. Wybierz pozycję dodatkowe właściwości połączenia, a następnie wybierz pozycję Nowy.Select Additional connection properties, and then select New. W obszarze Nazwa właściwości wprowadź PreferredRegions.Under Property Name, enter PreferredRegions. Ustaw wartość na żądany region, na przykład WestUS2.Set the Value to the region you want, for example, WestUS2. (Nie ma spacji między wyrazami i cyfrą).(There are no spaces between the words and the number.)
  8. Wybierz przycisk Utwórz.Select Create.

Bazy danych Azure Cosmos DB są wyświetlane na karcie połączonej w sekcji Azure Cosmos DB .Azure Cosmos DB databases appear on the Linked tab under the Azure Cosmos DB section. Za pomocą Azure Cosmos DB można odróżnić kontener z obsługą HTAP z kontenera "tylko OLTP" przez następujące ikony:With Azure Cosmos DB, you can differentiate an HTAP-enabled container from an OLTP-only container through the following icons:

Kontener tylko OLTP:OLTP-only container:

Wizualizacja pokazująca ikonę kontenera OLTP.

Kontener z włączonym HTAP:HTAP-enabled container:

Wizualizacja pokazująca ikonę kontenera HTAP.

Szybkie współdziałanie z akcjami generowanymi przez kodQuickly interact with code-generated actions

Klikając prawym przyciskiem myszy kontener, masz listę gestów, które będą wyzwalać środowisko uruchomieniowe Spark lub SQL.By right-clicking into a container, you have a list of gestures that will trigger a Spark or SQL runtime. Zapis do kontenera odbywa się za pomocą transakcyjnego magazynu Azure Cosmos DB i będzie korzystać z jednostek żądania.Writing into a container will happen through the Transactional Store of Azure Cosmos DB and will consume Request Units.

Następne krokiNext steps