Snabbstart: Ansluta 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 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 i Azure Cosmos DB utan att påverka driftprestandan 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 aktivera Synapse Link för Azure Cosmos DB-containrar.
Navigera till Synapse Studio
Från Synapse-arbetsytan väljer du Starta Synapse Studio. På Synapse Studio-startsidan väljer du **Data, vilket tar dig till Data object Explorer.
Ansluta en Azure Cosmos DB-databas till en Synapse-arbetsyta
Du ansluter en Azure Cosmos DB-databas som länkad tjänst. Med en länkad Azure Cosmos DB-tjänst kan användarna 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 Azure Cosmos DB-databas direkt genom att utföra följande steg:
- Välj + ikon 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
- Namnge den länkade tjänsten. Namnet visas i Object Explorer och används av Synapse-körningstider för att ansluta till databasen och containrarna. Vi rekommenderar att du använder ett eget namn.
- Välj Cosmos DB-kontonamnet och databasnamnet
- (Valfritt) Om ingen region anges dirigeras Synapse-körningsåtgärder mot närmaste region där analysarkivet är aktiverat. Du kan dock ange den region där du vill att dina användare ska få åtkomst till Azure Cosmos DB-analysarkivet manuellt. Välj Ytterligare anslutningsegenskaper och sedan Nytt. Under Egenskapsnamn skriver du PreferredRegions och anger Värdet till önskad region (exempel: WestUS2, det finns inget utrymme mellan ord och siffror)
- Välj Skapa
Azure Cosmos DB-databaser visas under fliken Länkad i avsnittet Azure Cosmos DB. Du kan skilja en HTAP-aktiverad Azure Cosmos DB-container från en OLTP-container med följande ikoner:
Synapse-container:
ENDAST OLTP-container:
Interagera snabbt med kodgenererade åtgärder
När du högerklickar i en container har du en lista med gester som utlöser en Spark- eller SQL-körning. Att skriva till en container sker via Transaktionsarkivet i Azure Cosmos DB och kommer att använda enheter för begäranden.