Snabbstart: Ansluta till Azure Synapse Link för Azure Cosmos DB
Den här artikeln beskriver hur du får åtkomst till 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
Vi rekommenderar att du aktiverar Synapse Link för Azure Cosmos DB om du vill köra storskaliga analyser i Azure Cosmos DB utan att påverka driftprestandan. 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.
Gå till Synapse Studio
Från Synapse-arbetsytan väljer du Starta Synapse Studio. På startsidan för Synapse Studio väljer du **Data, som tar dig till 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 göra följande:
- 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-kontonamn och databasnamn
- (Valfritt) Om ingen region anges dirigeras Synapse-körningsåtgärder mot närmaste region där analysarkivet är aktiverat. Du kan dock ange manuellt den region där du vill att användarna ska få åtkomst till Azure Cosmos DB-analysarkivet. Välj Ytterligare anslutningsegenskaper och sedan Nytt. Under Egenskapsnamn skriver du PreferredRegions och anger värdet till den region du vill ha (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 programbegäran.