Verbinding maken met Azure Synapse Link voor Azure Cosmos DB

Artikel
04/24/2023

In dit artikel wordt beschreven hoe u toegang krijgt tot een Azure Cosmos DB-database vanuit Azure Synapse Analytics Studio met behulp van Azure Synapse Link.

Vereisten

Voordat u een Azure Cosmos DB-database verbindt met uw werkruimte, hebt u het volgende nodig:

Een bestaande Azure Cosmos DB-database, of u kunt een nieuw account maken door de stappen te volgen in: Quickstart: Een Azure Cosmos DB-account beheren.
Een bestaande Azure Synapse-werkruimte, of u kunt een nieuwe werkruimte maken door de stappen te volgen in Quickstart: Een Synapse-werkruimte maken.

Synapse Link op een Azure Cosmos DB-database-account inschakelen

Als u grootschalige analyses wilt uitvoeren in Azure Cosmos DB zonder de prestaties van bewerkingen te beïnvloeden, wordt u aangeraden om Synapse Link voor Azure Cosmos DB in te schakelen. Synapse Link brengt HTAP-mogelijkheden naar een container en biedt ingebouwde ondersteuning in Azure Synapse.

Ga naar Synapse Studio

Selecteer Synapse Studio starten vanuit uw Azure Synapse-werkruimte. Selecteer op de startpagina van Synapse Studio de optie Gegevens. U wordt nu naar Data Object Explorer geleid.

Een Azure Cosmos DB-database verbinden met een Azure Synapse-werkruimte

Het verbinden van een Azure Cosmos DB-database wordt uitgevoerd als een gekoppelde service. Met een gekoppelde service van Azure Cosmos DB kunt u bladeren in gegevens en deze verkennen, en lees- en schrijfbewerkingen vanuit Apache Spark voor Azure Synapse Analytics of SQL uitvoeren in Azure Cosmos DB.

Vanuit Data Object Explorer kunt u rechtstreeks verbinding maken met een Azure Cosmos DB-database door de volgende stappen te volgen:

Selecteer het pictogram + bij de optie Gegevens.
Selecteer Verbinding maken met externe gegevens.
Selecteer de API waarmee u verbinding wilt maken, bijvoorbeeld SQL API of API voor MongoDB.
Selecteer Doorgaan.
Gebruik een beschrijvende naam voor de gekoppelde service. De naam wordt weergegeven in Data Object Explorer en wordt tijdens Azure Synapse-uitvoeringen gebruikt om verbinding te maken met de database en containers.
Selecteer de Azure Cosmos DB-accountnaam en de databasenaam.
Als er geen regio is opgegeven, worden Azure Synapse-uitvoeringen gerouteerd naar de dichtstbijzijnde regio waar de analytische opslag is ingeschakeld (optioneel). U kunt de regio die u uw gebruikers wilt laten gebruiken om toegang te krijgen tot de analytische opslag van Azure Cosmos DB ook handmatig instellen. Selecteer Aanvullende verbindingseigenschappen en selecteer vervolgens Nieuw. Voer onder Naam van eigenschapPreferredRegions in. Stel de waarde in op de gewenste regio, bijvoorbeeld WestUS2. (Er zijn geen spaties tussen de woorden en het getal.)
Selecteer Maken.

Azure Cosmos DB-databases worden weergegeven op het tabblad Gekoppeld in het gedeelte Azure Cosmos DB. Met Azure Cosmos DB kunt u een container met HTAP onderscheiden van een alleen-OLTP-container, met behulp van de volgende pictogrammen:

Alleen-OLTP-container:

Visualisatie waarmee het OLTP-containerpictogram wordt weergegeven.

Container met HTAP:

Visualisatie waarmee het HTAP-containerpictogram wordt weergegeven.

Snel communiceren via met code gegenereerde acties

Als u met de rechtermuisknop op een container klikt, ziet u een lijst met gebaren die een Apache Spark- of SQL-uitvoering activeren. Schrijven naar een container gebeurt via de transactionele opslag van Azure Cosmos DB, en hierbij worden aanvraageenheden verbruikt.