Conexión a Azure Synapse Link para Azure Cosmos DB

En este artículo se describe cómo acceder a una base de datos de Azure Cosmos DB desde Azure Synapse Analytics Studio con Azure Synapse Link.

Requisitos previos

Para poder conectar una base de datos de Azure Cosmos DB a un área de trabajo, se necesita:

Para ejecutar análisis a gran escala en Azure Cosmos DB sin que afecte al rendimiento operativo, le recomendamos que habilite Synapse Link para Azure Cosmos DB. Synapse Link aporta la funcionalidad de HTAP a un contenedor y compatibilidad integrada en Azure Synapse.

Ir a Synapse Studio

En un área de trabajo de Azure Synapse, seleccione Iniciar Synapse Studio. En la página principal de Synapse Studio, seleccione Datos y pasará a Data Object Explorer (Explorador de objetos de datos).

Conexión de una base de datos de Azure Cosmos DB a un área de trabajo de Azure Synapse

La conexión de una base de datos de Azure Cosmos DB se realiza como un servicio vinculado. Con un servicio vinculado de Azure Cosmos DB, puede examinar y explorar datos, así como leer y escribir contenido de Apache Spark para Azure Synapse Analytics o SQL en Azure Cosmos DB.

En Data Object Explorer (Explorador de objetos de datos), puede conectarse directamente a una base de datos de Azure Cosmos DB siguiendo estos pasos:

  1. Seleccione el icono + junto a Datos.
  2. Seleccione Connect to external data (Conectar a datos externos).
  3. Seleccione la API a la que desea conectarse, por ejemplo, SQL API o API para MongoDB.
  4. Seleccione Continuar.
  5. Use un nombre descriptivo para designar al servicio vinculado. El nombre aparecerá en Data Object Explorer (Explorador de objetos de datos) y se usará en los entornos de ejecución de Azure Synapse para conectarse a la base de datos y a los contenedores.
  6. Seleccione el nombre de la cuenta de Azure Cosmos DB y el nombre de la base de datos.
  7. (Opcional) Si no se especifica ninguna región, las operaciones del entorno de ejecución de Azure Synapse se enrutarán hacia la región más cercana en la que esté habilitado el almacén analítico. También puede establecer manualmente en qué región quiere que los usuarios accedan al almacén analítico de Azure Cosmos DB. Seleccione Additional connection properties (Propiedades de conexión adicionales) y, a continuación, New (Nuevo). En Property Name (Nombre de propiedad), escriba PreferredRegions. Establezca el valor en la región que desee, por ejemplo, WestUS2. (No hay espacios entre las palabras y el número).
  8. Seleccione Crear.

Las bases de datos de Azure Cosmos DB aparecen en la pestaña Linked (Vinculado) en la sección Azure Cosmos DB. Con Azure Cosmos DB, puede diferenciar un contenedor habilitado para HTAP de un contenedor solo de OLTP mediante los iconos siguientes:

Contenedor solo de OLTP:

Visualization that shows the OLTP container icon.

Contenedor habilitado para HTAP:

Visualization that shows the HTAP container icon.

Interacción rápida con las acciones generadas por el código

Al hacer clic con el botón derecho en un contenedor, tendrá una lista de gestos que desencadenarán un entorno de ejecución de Spark o SQL. La escritura en un contenedor se realizará a través del almacén transaccional de Azure Cosmos DB y consumirá unidades de solicitud.

Pasos siguientes