Cosmos DB-account inschakelen voor het gebruik van Azure Synapse Link

  • 5 minuten

Azure Synapse Link voor Azure Cosmos DB is een cloudeigen HTAP-mogelijkheid waarmee integratie tussen Azure Cosmos DB en Azure Synapse Analytics mogelijk is.

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and Azure Synapse Analytics.

In het bovenstaande diagram worden de volgende belangrijke functies van de Azure Synapse Link voor Cosmos DB-architectuur geïllustreerd:

  1. Een Azure Cosmos DB-container biedt een transactioneel archief op basis van rijen dat is geoptimaliseerd voor lees-/schrijfbewerkingen.
  2. De container biedt ook een analytische opslag op basis van kolommen die is geoptimaliseerd voor analytische workloads. Een volledig beheerd autosynchronisatieproces houdt de gegevensarchieven gesynchroniseerd.
  3. Azure Synapse Link biedt een gekoppelde service waarmee de container met analytische opslag in Azure Cosmos DB wordt verbonden met een Azure Synapse Analytics-werkruimte.
  4. Azure Synapse Analytics biedt Synapse SQL- en Apache Spark-runtimes waarin u code kunt uitvoeren om gegevens op te halen, te verwerken en te analyseren uit de analytische opslag van Azure Cosmos DB zonder dat dit van invloed is op het transactionele gegevensarchief in Azure Cosmos DB.

De eerste stap bij het gebruik van Azure Synapse Link voor Cosmos DB is het inschakelen in een Azure Cosmos DB-account. Azure Synapse Link wordt ondersteund in de volgende typen Azure Cosmos DB-account:

  • Azure Cosmos DB voor NoSQL
  • Azure Cosmos DB voor MongoDB
  • Azure Cosmos DB voor Apache Gremlin (preview)

U kunt Azure Synapse Link inschakelen op de azure-portalpagina voor uw Cosmos DB-account of met behulp van de Azure CLI of Azure PowerShell vanaf een opdrachtregel of in een script.

Met behulp van Azure Portal

In Azure Portal kunt u Azure Synapse Link inschakelen voor een Cosmos DB-account op de pagina Azure Synapse Link in de sectie Integraties , zoals hieronder wordt weergegeven.

A screenshot showing the option to enable Azure Synapse Link for a Cosmos DB for NoSQL account.

Tip

Voor Azure Cosmos DB for NoSQL-accounts is er ook een koppeling op de pagina Data Explorer .

Met behulp van de Azure CLI

Als u Azure Synapse Link wilt inschakelen met behulp van de Azure CLI, voert u de az cosmosdb create opdracht uit (om een nieuw Cosmos DB-account te maken) of az cosmosdb update opdracht (om een bestaand Cosmos DB-account te configureren) met de --enable-analytical-storage true parameter. Met de volgende opdracht wordt bijvoorbeeld een bestaand Cosmos DB-account met de naam my-cosmos-db bijgewerkt om Azure Synapse Link in te schakelen.

az cosmosdb update --name my-cosmos-db --resource-group my-rg --enable-analytical-storage true

Als u Azure Synapse Link wilt inschakelen voor een Azure Cosmos DB voor Apache Gremlin-account, neemt u de --capabilities EnableGremlin parameter op.

Azure PowerShell gebruiken

Als u Azure Synapse Link wilt inschakelen met behulp van Azure PowerShell, voert u de New-AzCosmosDBAccount cmdlet (om een nieuw Cosmos DB-account te maken) of Update-AzCosmosDBAccount cmdlet (om een bestaand Cosmos DB-account te configureren) uit met de -EnableAnalyticalStorage 1 parameter. Met de volgende opdracht wordt bijvoorbeeld een bestaand Cosmos DB-account met de naam my-cosmos-db bijgewerkt om Azure Synapse Link in te schakelen.

Update-AzCosmosDBAccount -Name "my-cosmos-db" -ResourceGroupName "my-rg" -EnableAnalyticalStorage 1

Houd rekening met de volgende feiten bij het inschakelen van Azure Synapse Link voor een Cosmos DB-account:

  • Nadat u Azure Synapse Link voor een account hebt ingeschakeld, kunt u dit niet uitschakelen.

  • Als u Azure Synapse Link inschakelt, wordt de synchronisatie van operationele gegevens naar een analytische opslag niet gestart. U moet ook een container maken of bijwerken met ondersteuning voor een analytische opslag.

  • Wanneer u Azure Synapse Link inschakelt voor een Cosmos DB for NoSQL-account met behulp van de Azure CLI of PowerShell, kunt u de --analytical-storage-schema-type parameter (Azure CLI) of -AnalyticalStorageSchemaType (PowerShell) gebruiken om het schematype op te geven als WellDefined (standaard) of FullFidelity. Voor een Cosmos DB voor MongoDB-account is FullFidelityhet standaardschematype (en alleen ondersteund).

  • Nadat een schematype is toegewezen, kunt u het niet wijzigen.

    Notitie

    In de volgende les leert u meer over de analytische opslag en de bijbehorende schematypen.