Démarrage rapide : 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 Synapse Link.
Prérequis
Avant de connecter un compte Azure Cosmos DB à votre espace de travail, vous avez besoin de quelques éléments.
- Compte Azure Cosmos DB existant ou créer un compte après ce démarrage rapide
- Espace de travail Synapse existant ou créer un espace de travail après ce démarrage rapide
Vous avez activé le magasin analytique Azure Cosmos DB
Pour exécuter l’analytique à grande échelle dans Azure Cosmos DB sans affecter les performances opérationnelles, nous vous recommandons d’activer Synapse Link pour Azure Cosmos DB. Cette fonction apporte la fonctionnalité HTAP à un conteneur et une prise en charge intégrée dans Azure Synapse. Suivez ce guide de démarrage rapide pour activer les conteneurs Synapse Link pour Azure Cosmos DB.
Accéder à Synapse Studio
Dans votre espace de travail Synapse, sélectionnez Lancer Synapse Studio. Sur la page d’accueil de Synapse Studio, sélectionnez **Data (Données), ce qui vous permet de vous connecter à Data Object Explorer (Explorateur d'objets de données).
Connecter une base de données Azure Cosmos DB à un espace de travail Synapse
La connexion d’une base de données Azure Cosmos DB s’effectue en tant que service lié. Un service lié Cosmos DB permet aux utilisateurs de parcourir et d’explorer les données, de les lire et de les é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 procédant comme suit :
- Sélectionnez l’icône + à proximité de Données
- Sélectionnez Connect to external data (Se connecter à des sources de données externes)
- Sélectionnez l’API à laquelle vous souhaitez vous connecter : SQL ou MongoDB
- Sélectionnez Continuer
- Nommez le service lié. Le nom sera affiché dans l’Explorateur d’objets et utilisé par les exécutables Synapse pour se connecter à la base de données et aux conteneurs. Nous vous recommandons d’utiliser un nom convivial.
- Sélectionnez le nom du compte Cosmos DB et le nom de la base de données
- (Facultatif) Si aucune région n’est spécifiée, les opérations d’exécution Synapse sont acheminées vers la région la plus proche dans laquelle le magasin analytique est activé. Toutefois, vous pouvez définir manuellement la région dans laquelle vous souhaitez que vos utilisateurs accèdent au magasin analytique Azure Cosmos DB. Sélectionnez Propriétés de connexion supplémentaires puis Nouveau. Sous Nom de la propriété, indiquez PreferredRegions et définissez Valeur sur la région de votre choix (exemple : WestUS2, sans espace entre les mots et les nombres)
- Sélectionnez Créer
Les bases de données Azure Cosmos DB sont visibles sous l’onglet Lié dans la section Azure Cosmos DB. Vous pouvez différencier un conteneur Azure Cosmos DB activé par HTAP d’un conteneur OLTP uniquement en vous reportant aux icônes suivantes :
Conteneur Synapse :
Conteneur OLTP uniquement :
Interagir rapidement avec des actions générées par le code
Lorsque vous cliquez avec le bouton droit sur un conteneur, vous obtenez une liste des mouvements qui déclencheront une exécution 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.