Inicio rápido: Conexión a Azure Synapse Link para Azure Cosmos DB

  • Artículo

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

Prerrequisitos

Antes de conectar una cuenta de Azure Cosmos DB al área de trabajo, debe contar con lo siguiente.

  • Una cuenta de Azure Cosmos DB existente o deberá seguir este inicio rápido para crear una nueva.
  • Una área de trabajo de Synapse existente o deberá seguir este inicio rápido para crear una nueva.

Habilitación del almacén analítico de Azure Cosmos DB

Para ejecutar análisis a gran escala en Azure Cosmos DB sin afectar al rendimiento operativo, le recomendamos que habilite Synapse Link para Azure Cosmos DB. Esta función aporta la funcionalidad de HTAP a un contenedor y compatibilidad integrada en Azure Synapse. Siga este inicio rápido para habilitar Synapse Link para contenedores de Azure Cosmos DB.

En el área de trabajo de Synapse, seleccione Iniciar Synapse Studio. En la página principal de Synapse Studio, seleccione **Datos y se le dirigirá al 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 Synapse

La conexión de una base de datos de Azure Cosmos DB se realiza como un servicio vinculado. Un servicio vinculado de Azure Cosmos DB permite a los usuarios examinar y explorar datos, y 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 + cerca de la opción Datos.
  2. Seleccione Connect to external data (Conectar a datos externos).
  3. Seleccione la API a la que quiere conectarse. SQL o MongoDB
  4. Seleccione Continuar.
  5. Asigne un nombre al servicio vinculado. El nombre se mostrará en el Explorador de objetos y lo usarán los tiempos de ejecución de Synapse para conectarse a la base de datos y a los contenedores. Le recomendamos que use un nombre descriptivo.
  6. Seleccione el nombre de la cuenta de Cosmos DB y el nombre de la base de datos.
  7. (Opcional) Si no se especifica ninguna región, las operaciones de tiempo de ejecución de Synapse se enrutarán hacia la región más cercana en la que esté habilitado el almacén analítico. Sin embargo, puede establecer manualmente en qué región quiere que los usuarios accedan al almacén analítico de Azure Cosmos DB. Seleccione Propiedades de conexión adicionales y, a continuación, Nuevo. En Nombre de propiedad, escriba PreferredRegions y establezca el valor en la región que quiera (por ejemplo: WestUS2; no hay ningún espacio entre las palabras y los números).
  8. Seleccione Crear.

Las bases de datos de Azure Cosmos DB están visibles en la pestaña Vinculado de la sección Azure Cosmos DB. Puede diferenciar un contenedor de Azure Cosmos DB habilitado para HTAP de un contenedor solo de OLTP mediante los iconos siguientes:

Contenedor de Synapse:

Contenedor de HTAP

Contenedor solo de OLTP:

Contenedor de OLTP

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 tiempo 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