Abilitare l'account di Cosmos DB per l'uso del collegamento ad Azure Synapse

  • 5 minuti

Collegamento ad Azure Synapse per Azure Cosmos DB è una funzionalità HTAP nativa del cloud che consente di integrare Azure Cosmos DB con Azure Synapse Analytics.

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

Nel diagramma precedente sono illustrate le funzionalità principali seguenti dell'architettura di Collegamento ad Azure Synapse per Cosmos DB:

  1. Un contenitore di Azure Cosmos DB offre un archivio transazionale basato su righe ottimizzato per le operazioni di lettura/scrittura.
  2. Il contenitore fornisce anche un archivio analitico basato su colonne ottimizzato per i carichi di lavoro analitici. Un processo di sincronizzazione automatica completamente gestito mantiene sincronizzati gli archivi dati.
  3. Collegamento ad Azure Synapse fornisce un servizio collegato che connette il contenitore abilitato per l'archivio analitico in Azure Cosmos DB a un'area di lavoro di Azure Synapse Analytics.
  4. Azure Synapse Analytics offre runtime Synapse SQL e Apache Spark in cui è possibile eseguire codice per recuperare, elaborare e analizzare i dati dall'archivio analitico di Azure Cosmos DB senza influire sull'archivio dati transazionale in Azure Cosmos DB.

Per poter usare Collegamento ad Azure Synapse per Cosmos DB è prima necessario abilitarlo in un account Azure Cosmos DB. Collegamento ad Azure Synapse è supportato nei tipi di account Azure Cosmos DB seguenti:

  • Azure Cosmos DB for NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for Apache Gremlin (anteprima)

È possibile abilitare Collegamento ad Azure Synapse nella pagina del portale di Azure per l'account Cosmos DB oppure usando l'interfaccia della riga di comando di Azure o Azure PowerShell da una riga di comando o in uno script.

Tramite il portale di Azure

Nel portale di Azure è possibile abilitare il Collegamento ad Azure Synapse per un account Cosmos DB nella pagina Collegamento ad Azure Synapse nella sezione Integrazioni, come illustrato di seguito.

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

Suggerimento

Per gli account Azure Cosmos DB for NoSQL, è disponibile anche un collegamento alla pagina Esplora dati.

Con l'interfaccia della riga di comando di Azure

Per abilitare Collegamento ad Azure Synapse con l'interfaccia della riga di comando di Azure, eseguire il comando az cosmosdb create (per creare un nuovo account Cosmos DB) o il comando az cosmosdb update (per configurare un account Cosmos DB esistente) con il parametro --enable-analytical-storage true. Ad esempio, il comando seguente aggiorna un account Cosmos DB esistente denominato my-cosmos-db per abilitare Collegamento ad Azure Synapse.

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

Per abilitare il Collegamento ad Azure Synapse per un account Azure Cosmos DB for Apache Gremlin, includere il parametro --capabilities EnableGremlin.

Uso di Azure PowerShell

Per abilitare Collegamento ad Azure Synapse con Azure PowerShell, eseguire il cmdlet New-AzCosmosDBAccount (per creare un nuovo account Cosmos DB) o il cmdlet Update-AzCosmosDBAccount (per configurare un account Cosmos DB esistente) con il parametro -EnableAnalyticalStorage 1. Ad esempio, il comando seguente aggiorna un account Cosmos DB esistente denominato my-cosmos-db per abilitare Collegamento ad Azure Synapse.

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

Quando si prevede di abilitare Collegamento ad Azure Synapse per un account Cosmos DB, considerare gli aspetti seguenti:

  • Dopo aver abilitato Collegamento ad Azure Synapse per un account, non è possibile disabilitarlo.

  • L'abilitazione di Collegamento ad Azure Synapse non comporta la sincronizzazione dei dati operativi in un archivio analitico. A tale scopo è anche necessario creare o aggiornare un contenitore con supporto per un archivio analitico.

  • Quando si abilita il Collegamento ad Azure Synapse per un account Cosmos DB per NoSQL con l'interfaccia della riga di comando di Azure o PowerShell, è possibile usare il parametro --analytical-storage-schema-type (interfaccia della riga di comando di Azure) o -AnalyticalStorageSchemaType (PowerShell) per specificare il tipo di schema come WellDefined (valore predefinito) o FullFidelity. Per un account Cosmos DB per MongoDB, il tipo di schema predefinito (e unicamente supportato) è FullFidelity.

  • Dopo aver assegnato un tipo di schema, non è possibile modificarlo.

    Nota

    Altre informazioni sull'archivio analitico e sui relativi tipi di schema sono disponibili nell'unità successiva.