Partager via


Se connecter à Azure Synapse Link pour Cosmos DB

Cet article explique comment accéder à une base de données Azure Cosmos DB à partir d’Azure Synapse Analytics Studio avec Azure Synapse Link.

Prérequis

Avant de connecter une base de données Azure Cosmos DB à votre espace de travail, les points suivants doivent être respectés :

Pour effectuer de l’analytique à grande échelle dans Azure Cosmos DB sans affecter vos performances opérationnelles, nous vous recommandons d’activer Synapse Link pour Azure Cosmos DB. Synapse Link apporte une capacité HTAP pour un conteneur et un support intégré dans Azure Synapse.

Accéder à Synapse Studio

Dans votre espace de travail Azure Synapse, sélectionnez Lancer Synapse Studio. Dans la page d’accueil de Synapse Studio, sélectionnez Données pour accéder à l’Explorateur d’objets de données.

Connecter une base de données Azure Cosmos DB à un espace de travail Azure Synapse

La connexion d’une base de données Azure Cosmos DB s’effectue en tant que service lié. Avec un service lié à Azure Cosmos DB, vous pouvez parcourir et explorer les données, lire et écrire à partir d’Apache Spark pour Azure Synapse Analytics ou SQL dans Azure Cosmos DB.

À partir de l’Explorateur d’objets de données, vous pouvez vous connecter directement à une base de données Azure Cosmos DB en suivant ces étapes :

  1. Sélectionnez l’icône + à proximité de Données.
  2. Sélectionnez Se connecter à des données externes.
  3. Sélectionnez l’API à laquelle vous voulez vous connecter, par exemple API SQL ou API pour MongoDB.
  4. Sélectionnez Continuer.
  5. Utilisez un nom convivial pour nommer le service lié. Le nom apparaît dans l’Explorateur d’objets de données et est utilisé par les runtimes Azure Synapse pour se connecter à la base de données et aux conteneurs.
  6. Sélectionnez le nom du compte Azure Cosmos DB et le nom de la base de données.
  7. (Facultatif) Si aucune région n’est spécifiée, les opérations du runtime Azure Synapse sont routées vers la région la plus proche où le magasin analytique est activé. Vous pouvez aussi définir manuellement la région que vos utilisateurs doivent utiliser pour accéder au magasin analytique Azure Cosmos DB. Sélectionnez Propriétés de connexion supplémentaires, Nouveau. Sous Nom de la propriété, entrez PreferredRegions. Définissez la Valeur sur la région de votre choix, par exemple WestUS2. (Il n’y a pas d’espace entre les mots et le chiffre.)
  8. Sélectionnez Créer.

Les bases de données Azure Cosmos DB apparaissent sous l’onglet Lié dans la section Azure Cosmos DB. Avec Azure Cosmos DB, vous pouvez différencier un conteneur activé pour HTAP d’un conteneur limité à l’OLTP via les icônes suivantes :

Conteneur limité à l’OLTP :

Visualisation montrant l’icône de conteneur OLTP.

Conteneur activé pour HTAP :

Visualisation montrant l’icône de conteneur HTAP.

Interagir rapidement avec des actions générées par le code

Quand vous cliquez avec le bouton droit dans un conteneur, vous obtenez une liste des mouvements qui vont déclencher un runtime Spark ou SQL. L’écriture de données dans un conteneur aura lieu via le magasin transactionnel d’Azure Cosmos DB et consommera des unités de requête.

Étapes suivantes