Habilitación de una cuenta de Cosmos DB para usar Azure Synapse Link

  • 5 minutos

Azure Synapse Link para Azure Cosmos DB es una capacidad HTAP nativa de nube que permite la integración entre Azure Cosmos DB y Azure Synapse Analytics.

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

En el diagrama anterior, se ilustran las siguientes características clave de la arquitectura de Azure Synapse Link para Cosmos DB:

  1. Un contenedor de Azure Cosmos DB proporciona un almacén transaccional basado en filas que está optimizado para operaciones de lectura/escritura.
  2. El contenedor también proporciona un almacén analítico basado en columnas que está optimizado para cargas de trabajo analíticas. Un proceso de sincronización automática totalmente administrado mantiene sincronizados los almacenes de datos.
  3. Azure Synapse Link proporciona un servicio vinculado que conecta el contenedor habilitado para el almacén analítico en Azure Cosmos DB a un área de trabajo de Azure Synapse Analytics.
  4. Azure Synapse Analytics proporciona los entornos de ejecución de Synapse SQL y Apache Spark en los que puede ejecutar código para recuperar, procesar y analizar datos del almacén analítico de Azure Cosmos DB sin que resulte afectado el almacén de datos transaccional en Azure Cosmos DB.

El primer paso para usar Azure Synapse Link para Cosmos DB consiste en habilitarlo en una cuenta de Azure Cosmos DB. Azure Synapse Link se admite en los siguientes tipos de cuenta de Azure Cosmos DB:

  • Azure Cosmos DB para NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for Apache Gremlin (versión preliminar)

Puede habilitar Azure Synapse Link en la página Azure Portal de la cuenta de Cosmos DB, o mediante la CLI de Azure o Azure PowerShell desde una línea de comandos o en un script.

Uso de Azure Portal

En Azure Portal, puede habilitar Azure Synapse Link para una cuenta de Cosmos DB en la página Azure Synapse Link de la sección Integraciones, como se muestra a continuación.

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

Sugerencia

Para las cuentas de Azure Cosmos DB for NoSQL, también hay un vínculo en el Explorador de datos page.

Uso de la CLI de Azure

Para habilitar Azure Synapse Link mediante la CLI de Azure, ejecute el comando az cosmosdb create (para crear una nueva cuenta de Cosmos DB) o un comando az cosmosdb update (para configurar una cuenta de Cosmos DB existente) con el parámetro --enable-analytical-storage true. Por ejemplo, el siguiente comando actualiza una cuenta de Cosmos DB existente denominada my-cosmos-db para habilitar Azure Synapse Link.

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

Si desea habilitar Azure Synapse Link para una cuenta de Azure Cosmos DB for Apache Gremlin, incluya el parámetro --capabilities EnableGremlin.

Uso de Azure PowerShell

Para habilitar Azure Synapse Link mediante Azure PowerShell, ejecute el cmdlet New-AzCosmosDBAccount (para crear una cuenta de Cosmos DB) o un cmdlet Update-AzCosmosDBAccount (para configurar una cuenta de Cosmos DB existente) con el parámetro -EnableAnalyticalStorage 1. Por ejemplo, el siguiente comando actualiza una cuenta de Cosmos DB existente denominada my-cosmos-db para habilitar Azure Synapse Link.

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

Al planear la habilitación de Azure Synapse Link para una cuenta de Cosmos DB, tenga en cuenta los siguientes hechos:

  • Después de habilitar Azure Synapse Link para una cuenta, no se puede deshabilitar.

  • La habilitación de Azure Synapse Link no inicia la sincronización de datos operativos en un almacén analítico; también debe crear o actualizar un contenedor con compatibilidad con un almacén analítico.

  • Al habilitar Azure Synapse Link para una cuenta de Cosmos DB for NoSQL mediante la CLI de Azure o PowerShell, puede usar el parámetro --analytical-storage-schema-type (CLI de Azure) o el parámetro -AnalyticalStorageSchemaType (PowerShell) para especificar el tipo de esquema como WellDefined (valor predeterminado) o FullFidelity. Para una cuenta de Cosmos DB for MongoDB, el tipo de esquema predeterminado (y el único que se admite) es FullFidelity.

  • Después de asignar un tipo de esquema, no se puede cambiar.

    Nota

    Obtendrá más información sobre el almacén analítico y sus tipos de esquema en la unidad siguiente.