Quickstart: Verbinding maken met Azure Synapse Link voor Azure Cosmos DB

  • Artikel

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

Vereisten

Voordat u een Azure Cosmos DB-account verbindt met uw werkruimte, hebt u enkele dingen nodig.

  • Een bestaand Azure Cosmos DB-account, of u kunt een nieuw account maken door deze quickstart te volgen
  • Een bestaande Synapse-werkruimte , of u kunt een nieuwe werkruimte maken door deze quickstart te volgen

Analytische opslag van Azure Cosmos DB 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. Deze functie brengt HTAP-mogelijkheden naar een container en biedt ingebouwde ondersteuning in Azure Synapse. Volg deze quickstart om Synapse Link in te schakelen voor Azure Cosmos DB-containers.

Selecteer Synapse Studio starten vanuit uw 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 Synapse-werkruimte

Het verbinden van een Azure Cosmos DB-database wordt uitgevoerd als gekoppelde service. Met een gekoppelde service van Azure Cosmos DB kunnen gebruikers bladeren in gegevens en deze verkennen, en lees- en schrijfbewerkingen vanuit Apache Spark for 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 uit te voeren:

  1. Selecteer het pictogram + bij de optie Gegevens
  2. Selecteer Verbinding maken met externe gegevens
  3. Selecteer de API waarmee u verbinding wilt maken: SQL of MongoDB
  4. Selecteer Doorgaan
  5. Geef de gekoppelde service een naam. De naam wordt weergegeven in Object Explorer en wordt tijdens Synapse-uitvoeringen gebruikt om verbinding te maken met de database en containers. We raden u aan een beschrijvende naam te gebruiken.
  6. Selecteer de Cosmos DB-accountnaam en databasenaam
  7. Als er geen regio is opgegeven, worden Synapse-uitvoeringen gerouteerd naar de dichtstbijzijnde regio waar de analytische opslag is ingeschakeld (optioneel). U kunt echter handmatig de regio instellen waar uw gebruikers toegang moeten krijgen tot de analytische opslag van Azure Cosmos DB. Selecteer Aanvullende verbindingseigenschappen en vervolgens Nieuw. Onder Eigenschapsnaam schrijft u PreferredRegions en stelt u de Waarde in op de gewenste regio (bijvoorbeeld: WestUS2, er is geen spatie tussen woorden en getallen)
  8. Selecteer Maken

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

Synapse-container:

HTAP-container

Alleen-OLTP-container:

OLTP-container

Snel communiceren via met code gegenereerde acties

Als u met de rechtermuisknop op een container klikt, ziet u een lijst met gebaren die een 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