Snabbstart: Anslut till Azure Synapse Link för Azure Cosmos DB
Den här artikeln beskriver hur du kommer åt en Azure Cosmos DB databas från Azure Synapse Analytics Studio med Synapse Link.
Förutsättningar
Innan du ansluter ett Azure Cosmos DB-konto till din arbetsyta finns det några saker som du behöver.
- Befintligt Azure Cosmos DB konto eller skapa ett nytt konto efter den här snabbstarten
- Befintlig Synapse-arbetsyta eller skapa en ny arbetsyta efter den här snabbstarten
Aktivera Azure Cosmos DB analysarkiv
Om du vill köra storskaliga analyser Azure Cosmos DB utan att påverka driftprestanda rekommenderar vi att du aktiverar Synapse Link för Azure Cosmos DB. Den här funktionen ger HTAP-funktioner till en container och inbyggt stöd i Azure Synapse. Följ den här snabbstarten för att Synapse Link för Cosmos DB containrar.
Gå till Synapse Studio
Från Synapse-arbetsytan väljer du Starta Synapse Studio. På Synapse Studio sidan väljer du **Data, vilket tar dig till data-Object Explorer.
Anslut en Azure Cosmos DB till en Synapse-arbetsyta
Anslutning av en Azure Cosmos DB-databas görs som en länkad tjänst. En Cosmos DB länkad tjänst gör det möjligt för användare att bläddra bland och utforska data, läsa och skriva från Apache Spark för Azure Synapse Analytics eller SQL till Azure Cosmos DB.
Från Data Object Explorer kan du ansluta en databas Azure Cosmos DB genom att göra följande:
- Ikonen + Välj nära Data
- Välj Anslut till externa data
- Välj det API som du vill ansluta till: SQL eller MongoDB
- Välj Fortsätt
- Ge den länkade tjänsten ett namn. Namnet visas i den här Object Explorer används av Synapse-körningar för att ansluta till databasen och containrarna. Vi rekommenderar att du använder ett eget namn.
- Välj Cosmos DB och databasnamn
- (Valfritt) Om ingen region anges dirigeras Synapse-körningsåtgärder till den närmaste region där analysarkivet är aktiverat. Du kan dock ange manuellt vilken region du vill att användarna ska få åtkomst Cosmos DB analysarkivet. Välj Ytterligare anslutningsegenskaper och sedan Ny. Under Egenskapsnamn skriver du PreferredRegions_ och anger _ Värde till den region du vill ha (exempel: WestUS2, det finns inget blanksteg mellan ord och siffror)
- Välj Skapa
Azure Cosmos DB databaser visas under fliken Länkad i Azure Cosmos DB avsnitt. Du kan skilja en HTAP-aktiverad Azure Cosmos DB från en behållare med endast OLTP med följande ikoner:
Synapse-container:
Endast OLTP-container:
Interagera snabbt med kodgenererade åtgärder
När du högerklickar till en container visas en lista över gester som utlöser en Spark- eller SQL-körning. Skrivning till en container sker via transaktionslagret för Azure Cosmos DB och förbrukar enheter för begäran.