Aktivera Cosmos DB-konto för att använda Azure Synapse Link

Slutförd

Azure Synapse Link för Azure Cosmos DB är en molnbaserad HTAP-funktion som möjliggör integrering mellan Azure Cosmos DB och Azure Synapse Analytics.

I diagrammet ovan visas följande viktiga funktioner i Azure Synapse Link for Cosmos DB-arkitekturen:

1. En Azure Cosmos DB-container tillhandahåller ett radbaserat transaktionslager som är optimerat för läs-/skrivåtgärder.
2. Containern innehåller också ett kolumnbaserat analysarkiv som är optimerat för analytiska arbetsbelastningar. En fullständigt hanterad autosynkron process håller datalager synkroniserade.
3. Azure Synapse Link tillhandahåller en länkad tjänst som ansluter den analysarkivaktiverade containern i Azure Cosmos DB till en Azure Synapse Analytics-arbetsyta.
4. Azure Synapse Analytics tillhandahåller Synapse SQL- och Apache Spark-körningar där du kan köra kod för att hämta, bearbeta och analysera data från Azure Cosmos DB-analysarkivet utan att påverka transaktionsdatalagret i Azure Cosmos DB.

Aktivera Azure Synapse Link i Azure Cosmos DB

Det första steget i att använda Azure Synapse Link för Cosmos DB är att aktivera det i ett Azure Cosmos DB-konto. Azure Synapse Link stöds i följande typer av Azure Cosmos DB-konto:

• Azure Cosmos DB för NoSQL
• Azure Cosmos DB för MongoDB
• Azure Cosmos DB för Apache Gremlin (förhandsversion)

Du kan aktivera Azure Synapse Link på Azure-portalsidan för ditt Cosmos DB-konto, eller genom att använda Azure CLI eller Azure PowerShell från en kommandorad eller i ett skript.

Med hjälp av Azure-portalen

I Azure-portalen kan du aktivera Azure Synapse Link för ett Cosmos DB-konto på sidan Azure Synapse Link i avsnittet Integreringar enligt nedan.

Dricks

För Azure Cosmos DB för NoSQL-konton finns det också en länk på sidan Datautforskaren.

Använda Azure CLI

Om du vill aktivera Azure Synapse Link med hjälp av Azure CLI kör az cosmosdb create du kommandot (för att skapa ett nytt Cosmos DB-konto) eller az cosmosdb update kommandot (för att konfigurera ett befintligt Cosmos DB-konto) med parametern --enable-analytical-storage true . Följande kommando uppdaterar till exempel ett befintligt Cosmos DB-konto med namnet my-cosmos-db för att aktivera Azure Synapse Link.

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

Om du vill aktivera Azure Synapse Link för ett Azure Cosmos DB för Apache Gremlin-konto inkluderar du parametern --capabilities EnableGremlin .

Använda Azure PowerShell

Om du vill aktivera Azure Synapse Link med Azure PowerShell kör du cmdleten New-AzCosmosDBAccount (för att skapa ett nytt Cosmos DB-konto) eller Update-AzCosmosDBAccount en cmdlet (för att konfigurera ett befintligt Cosmos DB-konto) med parametern -EnableAnalyticalStorage 1 . Följande kommando uppdaterar till exempel ett befintligt Cosmos DB-konto med namnet my-cosmos-db för att aktivera Azure Synapse Link.

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

Överväganden för att aktivera Azure Synapse Link

Tänk på följande när du planerar att aktivera Azure Synapse Link för ett Cosmos DB-konto:

• När du har aktiverat Azure Synapse Link för ett konto kan du inte inaktivera det.

• Aktivering av Azure Synapse Link startar inte synkronisering av driftdata till ett analysarkiv – du måste också skapa eller uppdatera en container med stöd för ett analysarkiv.

• När du aktiverar Azure Synapse Link för ett Cosmos DB för NoSQL-konto med hjälp av Azure CLI eller PowerShell kan du använda parametern --analytical-storage-schema-type (Azure CLI) eller -AnalyticalStorageSchemaType (PowerShell) för att ange schematypen som WellDefined (standard) eller FullFidelity. För ett Cosmos DB för MongoDB-konto är FullFidelitystandardschematypen (och stöds endast) .

• När en schematyp har tilldelats kan du inte ändra den.

  Kommentar

  Du får lära dig mer om analysarkivet och dess schematyper i nästa lektion.