Konfigurera Azure Cosmos DB för NoSQL i en kopieringsaktivitet

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en datapipeline för att kopiera data från och till Azure Cosmos DB för NoSQL.

Konfiguration som stöds

För konfigurationen av varje flik under kopieringsaktiviteten går du till följande avsnitt.

• Allmänt
• Source
• Mål
• Mappning
• Inställningar

Allmänt

Se vägledningen allmänna inställningar för att konfigurera fliken Allmänna inställningar.

Källa

Följande egenskaper stöds för Azure Cosmos DB för NoSQL under fliken Källa för en kopieringsaktivitet.

Följande tre egenskaper krävs:

• Datalagertyp: Välj Extern.
• Anslut ion: Välj en Azure Cosmos DB för NoSQL-anslutning i anslutningslistan. Om det inte finns någon anslutning skapar du en ny Azure Cosmos DB för NoSQL-anslutning genom att välja Ny.
• Container: Välj den container som du vill använda. Välj Redigera för att ange containernamnet manuellt.

Under Avancerat kan du ange följande fält:

• Använd fråga: Du kan välja tabell eller fråga som användningsfråga. I följande lista beskrivs konfigurationen för varje inställning.

  • Tabell: Läser data från den tabell som du angav i Tabellen.

  • Fråga: Anger Azure Cosmos DB-frågan för att läsa data.

    

• Sidstorlek: Antalet dokument per sida i frågeresultatet. Standardvärdet är "-1", vilket innebär att du använder den dynamiska sidstorleken på tjänstsidan upp till 1 000.

• Identifiera datetime: Om datetime ska identifieras från strängvärdena i dokumenten. Tillåtna värden är: true (standard), false.

• Prioriterade regioner: Den föredragna listan över regioner som ska anslutas till när data hämtas från Azure Cosmos DB. Välj en önskad region i listrutan när du har valt Ny.

  

• Ytterligare kolumner: Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare. Mer information finns i Lägg till ytterligare kolumner under kopiering.

  

Mål

Följande egenskaper stöds för Azure Cosmos DB för NoSQL under fliken Mål för en kopieringsaktivitet.

Följande tre egenskaper krävs:

• Datalagertyp: Välj Extern.
• Anslut ion: Välj en Azure Cosmos DB för NoSQL-anslutning i anslutningslistan.
• Container: Välj Bläddra för att välja den fil som du vill kopiera eller fyll i sökvägen manuellt.

Under Avancerat kan du ange följande fält:

• Skrivbeteende: Definierar skrivbeteendet när målet är filer från ett filbaserat datalager. Du kan välja Lägg till dynamiskt innehåll, Infoga eller Upsert i listrutan.

  • Lägg till dynamiskt innehåll: Öppna fönstret Lägg till dynamiskt innehåll . Då öppnas uttrycksverktyget där du kan skapa uttryck från systemvariabler som stöds, aktivitetsutdata, funktioner och användardefinierade variabler eller parametrar. Information om uttrycksspråket finns i Uttryck och funktioner.

  • Infoga: Välj det här alternativet om källdata har infogats.

  • Upsert: Upserts beteende är att ersätta dokumentet om det redan finns ett dokument med samma ID. Annars infogar du dokumentet.

    

• Tidsgräns för skrivning av batch: Väntetid för att batchinfogningsåtgärden ska slutföras innan tidsgränsen uppnås. Tillåtna värden är Timespan. Ett exempel är 00:30:00 (30 minuter).

• Skriv batchstorlek: Ange antalet rader som ska infogas i SQL-tabellen per batch. Det tillåtna värdet är ett heltal (antal rader). Som standard avgör tjänsten dynamiskt lämplig batchstorlek baserat på radstorleken.

• Maximalt antal samtidiga anslutningar: Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar.

• Inaktivera prestandamåttanalys: Den här inställningen styr insamlingen av mått, till exempel DTU, DWU, RU och så vidare för optimering och rekommendationer för kopieringsprestanda. Om du är intresserad av det här beteendet inaktiverar du den här funktionen.

Mappning

För konfigurationen av fliken Mappning går du till Konfigurera dina mappningar under mappningsfliken.

Inställningar

För Inställningar flikkonfiguration går du till Konfigurera dina andra inställningar under fliken Inställningar.

Tabellsammanfattning

Följande tabeller innehåller mer information om kopieringsaktiviteten i Azure Cosmos DB för NoSQL.

Källtabell

Name	Beskrivning	Värde	Obligatoriskt	JSON-skriptegenskap
Typ av datalager	Din datalagertyp.	Externt	Ja	/
Anslutning	Din anslutning till källdatalagret.	<din anslutning>	Ja	anslutning
Container	Containern för dina källdata.	<container för källan>	Ja	Behållare fileName
Använda fråga	Du kan välja Tabell eller Fråga som användningsfråga.	• Tabell • Fråga	Nej	type
Sidstorlek	Antalet dokument per sida i frågeresultatet. Standardvärdet är "-1", vilket innebär att du använder den dynamiska sidstorleken på tjänstsidan upp till 1 000.	<sidstorlek>	Nej	pageSize
Ta bort datetime	Filerna i källdatalagret tas bort direkt efter att de har flyttats till mållagret. Filborttagningen sker per fil, så när kopieringsaktiviteten misslyckas kommer du att märka att vissa filer redan har kopierats till målet och tagits bort från källan medan andra fortfarande finns i källarkivet.	Markera eller avmarkera	Nej	detectDatetime
Prioriterade regioner	Den föredragna listan över regioner att ansluta till när du hämtar data från Azure Cosmos DB. Välj en önskad region i listrutan när du har valt Ny.	<önskade regioner>	Nej	preferredRegions
Ytterligare kolumner	Lägg till ytterligare datakolumner för att lagra källfilernas relativa sökväg eller statiska värde. Uttrycket stöds för det senare. Mer information finns i Lägg till ytterligare kolumner under kopiering.	<maximalt antal samtidiga anslutningar>	Nej	additionalColumns

Måltabell

Name	Beskrivning	Värde	Obligatoriskt	JSON-skriptegenskap
Typ av datalager	Din datalagertyp.	Externt	Ja	/
Anslutning	Din anslutning till måldatalagret.	<din anslutning>	Ja	anslutning
Container	Containern för dina måldata.	<källcontainer>	Ja	Behållare fileName
Skrivbeteende	Beskriver hur du skriver data till Azure Cosmos DB. Tillåtna värden: infoga och upsert. Upserts beteende är att ersätta dokumentet om det redan finns ett dokument med samma ID. annars infogar du dokumentet.	• Lägg till dynamiskt innehåll • Infoga • Upsert	Nej	writeBehavior
Tidsgräns för skrivning av batch	Vänta tills batchinfogningsåtgärden har slutförts innan tidsgränsen uppnås. Tillåtna värden är Tidsintervall. Ett exempel är 00:30:00 (30 minuter).	tidsintervall	Nej	writeBatchTimeout
Skriv batchstorlek	Antalet rader som ska infogas i SQL-tabellen per batch. Det tillåtna värdet är heltal (antal rader). Som standard avgör tjänsten dynamiskt lämplig batchstorlek baserat på radstorleken.	<antal rader > (heltal)	Nej	writeBatchSize
Maximalt antal samtidiga anslutningar	Den övre gränsen för samtidiga anslutningar som upprättats till datalagret under aktivitetskörningen. Ange endast ett värde när du vill begränsa samtidiga anslutningar.	<maximalt antal samtidiga anslutningar>	Nej	maxConcurrent Anslut ions
Inaktivera analys av prestandamått	Den här inställningen styr insamling av mått som DTU, DWU, RU och så vidare för optimering och rekommendationer för kopieringsprestanda. Om du är intresserad av det här beteendet inaktiverar du den här funktionen.	Markera eller avmarkera	Nej	disableMetricsCollection

Relaterat innehåll

• Konfigurera din Azure Cosmos DB för NoSQL-anslutning