Ansluta till Azure Synapse Link för Azure Cosmos DBConnect to Azure Synapse Link for Azure Cosmos DB

Den här artikeln beskriver hur du kommer åt en Azure Cosmos DB databas från Azure Synapse Analytics Studio med Azure Synapse-länken.This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link.

FörutsättningarPrerequisites

Innan du ansluter en Azure Cosmos DB databas till din arbets yta behöver du:Before you connect an Azure Cosmos DB database to your workspace, you'll need an:

Om du vill köra storskalig analys i Azure Cosmos DB utan att påverka drifts prestanda rekommenderar vi att du aktiverar Synapse-länken för Azure Cosmos DB.To run large-scale analytics into Azure Cosmos DB without affecting your operational performance, we recommend enabling Synapse Link for Azure Cosmos DB. Synapse-länken ger HTAP-kapacitet till en behållare och inbyggt stöd i Azure Synapse.Synapse Link brings HTAP capability to a container and built-in support in Azure Synapse.

Gå till Synapse StudioGo to Synapse Studio

Från din Azure Synapse-arbetsyta väljer du Starta Synapse Studio.From your Azure Synapse workspace, select Launch Synapse Studio. På Start sidan för Synapse Studio väljer du data, som tar dig till data Object Explorer.On the Synapse Studio home page, select Data, which takes you to the Data Object Explorer.

Ansluta en Azure Cosmos DB-databas till en Azure Synapse-arbetsytaConnect an Azure Cosmos DB database to an Azure Synapse workspace

Anslutning av en Azure Cosmos DB databas görs som en länkad tjänst.Connecting an Azure Cosmos DB database is done as a linked service. Med en Azure Cosmos DB länkad tjänst kan du söka efter och utforska data, läsa och skriva från Apache Spark för Azure Synapse Analytics eller SQL till Azure Cosmos DB.With an Azure Cosmos DB linked service, you can browse and explore data, read, and write from Apache Spark for Azure Synapse Analytics or SQL into Azure Cosmos DB.

Från data Object Explorer kan du ansluta direkt till en Azure Cosmos DB-databas genom att följa dessa steg:From the Data Object Explorer, you can directly connect to an Azure Cosmos DB database by following these steps:

  1. Välj + ikonen nära data.Select the + icon near Data.
  2. Välj Anslut till externa data.Select Connect to external data.
  3. Välj det API som du vill ansluta till, till exempel SQL API eller API för MongoDB.Select the API that you want to connect to, for example, SQL API or API for MongoDB.
  4. Välj Fortsätt.Select Continue.
  5. Använd ett eget namn för att namnge den länkade tjänsten.Use a friendly name to name the linked service. Namnet kommer att visas i data Object Explorer och används av Azure Synapse-körningar för att ansluta till databasen och behållarna.The name will appear in the Data Object Explorer and is used by Azure Synapse runtimes to connect to the database and containers.
  6. Välj det Azure Cosmos DB konto namnet och databas namnet.Select the Azure Cosmos DB account name and the database name.
  7. Valfritt Om ingen region anges dirigeras Azure Synapse runtime-åtgärder mot den närmaste region där analys lagret är aktiverat.(Optional) If no region is specified, Azure Synapse runtime operations will be routed toward the nearest region where the analytical store is enabled. Du kan också manuellt ange den region som du vill att användarna ska använda för att få åtkomst till den Azure Cosmos DB analytiska butiken.You can also manually set the region you want your users to use to access the Azure Cosmos DB analytical store. Välj Ytterligare egenskaper för anslutning och välj sedan ny.Select Additional connection properties, and then select New. Under egenskaps namn, anger du PreferredRegions.Under Property Name, enter PreferredRegions. Ange värdet till den region som du vill ha, till exempel WestUS2.Set the Value to the region you want, for example, WestUS2. (Det finns inga blank steg mellan orden och talet.)(There are no spaces between the words and the number.)
  8. Välj Skapa.Select Create.

Azure Cosmos DB databaser visas på fliken länkad under avsnittet Azure Cosmos DB .Azure Cosmos DB databases appear on the Linked tab under the Azure Cosmos DB section. Med Azure Cosmos DB kan du särskilja en HTAP-aktiverad behållare från en OLTP-behållare via följande ikoner:With Azure Cosmos DB, you can differentiate an HTAP-enabled container from an OLTP-only container through the following icons:

Endast OLTP-behållare:OLTP-only container:

Visualisering som visar ikonen för OLTP-behållare.

HTAP-aktive rad behållare:HTAP-enabled container:

Visualisering som visar HTAP container-ikonen.

Interagera snabbt med kod genererade åtgärderQuickly interact with code-generated actions

Genom att högerklicka på en behållare har du en lista med gester som utlöser en spark-eller SQL-körning.By right-clicking into a container, you have a list of gestures that will trigger a Spark or SQL runtime. Att skriva till en behållare sker via transaktions lagringen för Azure Cosmos DB och kommer att förbruka enheter för programbegäran.Writing into a container will happen through the Transactional Store of Azure Cosmos DB and will consume Request Units.

Nästa stegNext steps