Delen via

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 u wilt dat uw gebruikers toegang hebben tot de analytische opslag van Azure Cosmos DB. Selecteer Aanvullende verbindingseigenschappen en vervolgens Nieuw. Schrijf onder Eigenschapsnaam PreferredRegions en stel 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