Verbinding maken met Azure Synapse Link voor Azure Cosmos DB
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:
- Bestaande Azure Cosmos DB-database of maak een nieuw account door de stappen in quickstart te volgen: Een Azure Cosmos DB-account beheren.
- Bestaande Azure Synapse-werkruimte of maak een nieuwe werkruimte door de stappen in quickstart te volgen: 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 eigenschap PreferredRegions 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:
Container met HTAP:
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.
Volgende stappen
- Krijg inzicht in wat wordt ondersteund tussen Azure Synapse en Azure Cosmos DB
- Privé-eindpunten configureren voor analytische opslag van Azure Cosmos DB
- Meer informatie over het uitvoeren van query's op de analytische opslag met Spark 3
- Meer informatie over het uitvoeren van query's op de analytische opslag met Spark 2