Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Cet article explique comment accéder à une base de données Azure Cosmos DB à partir d’Azure Synapse Analytics Studio avec Azure Synapse Link.
Important
La mise en miroir vers Microsoft Fabric est désormais disponible. La mise en miroir vers Fabric fournit toutes les fonctionnalités d’Azure Synapse Link avec de meilleures performances analytiques, la possibilité d’unifier votre patrimoine de données avec OneLake dans Fabric et d’ouvrir l’accès à vos données au format Delta Parquet. Au lieu d’Azure Synapse Link, utilisez Fabric Mirroring.
Avec la fonctionnalité de mise en miroir vers Microsoft Fabric, vous pouvez répliquer en continu votre ensemble de données existant directement dans OneLake de Fabric, notamment des données issues de SQL Server 2016+, Azure SQL Database, Azure SQL Managed Instance, Oracle, Cosmos DB, Snowflake, et plus encore.
Pour plus d’informations, consultez les bases de données mises en miroir Microsoft Fabric.
Conditions préalables requises
Avant de connecter une base de données Azure Cosmos DB à votre espace de travail, vous aurez besoin d’un :
- Base de données Azure Cosmos DB existante ou création d’un compte en suivant les étapes de démarrage rapide : Gérer un compte Azure Cosmos DB.
- Espace de travail Azure Synapse existant ou créer un espace de travail en suivant les étapes de démarrage rapide : Créer un espace de travail Synapse.
Activer Synapse Link sur un compte de base de données Azure Cosmos DB
Pour exécuter des analyses à 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 des capacités HTAP à un conteneur et offre 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, qui vous amène à 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 est effectuée en tant que service lié. Avec un service lié Azure Cosmos DB, vous pouvez parcourir et explorer des 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 procédant comme suit :
- Sélectionnez l’icône + près des Données.
- Sélectionnez Se connecter aux données externes.
- Sélectionnez l’API à laquelle vous souhaitez vous connecter, par exemple CosmosDB pour NoSQL ou l’API CosmosDB pour MongoDB.
- Sélectionnez Continuer.
- Utilisez un nom convivial pour nommer le service lié. Le nom s’affiche 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.
- Sélectionnez le nom du compte Azure 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 Azure Synapse sont routées vers la région la plus proche où le magasin analytique est activé. Vous pouvez également définir manuellement la région que vos utilisateurs utilisent pour accéder au magasin analytique Azure Cosmos DB. Sélectionnez Propriétés de connexion supplémentaires, puis Sélectionnez Nouveau. Sous Nom de propriété, entrez PreferredRegions. Définissez la valeur sur la région souhaitée, par exemple , WestUS2. (Il n’y a pas d’espace entre les mots et le nombre.)
- Cliquez sur Créer.
Les bases de données Azure Cosmos DB apparaissent sous l’onglet Lié sous la section Azure Cosmos DB . Avec Azure Cosmos DB, vous pouvez différencier un conteneur compatible HTAP d’un conteneur OLTP uniquement via les icônes suivantes :
Conteneur OLTP uniquement :
Conteneur compatible HTAP :
Interagir rapidement avec les actions générées par le code
En cliquant avec le bouton droit sur un conteneur, vous disposez d’une liste de mouvements qui déclenchent un runtime Spark ou SQL. L’écriture dans un conteneur se produit via le magasin transactionnel d’Azure Cosmos DB et consomme des unités de requête.