Konfigurer Azure Cosmos DB for MongoDB i en kopieringsaktivitet

Denne artikkelen beskriver hvordan du bruker kopieringsaktiviteten i datasamlebånd til å kopiere data fra og til Azure Cosmos DB for MongoDB.

Støttet konfigurasjon

For konfigurasjonen av hver fane under kopieringsaktivitet, gå til henholdsvis følgende deler.

• Generelt
• kilde
• Mål
• Kartlegging
• Innstillinger

Generelle

Se veiledningen for generelle innstillinger for å konfigurere fanen Generelle innstillinger.

Kilde

Gå til Kilde-fanen for å konfigurere kopieringsaktivitetskilden. Se følgende innhold for detaljert konfigurasjon.

Følgende egenskaper kreves:

• Tilkobling: Velg en Azure Cosmos DB for MongoDB-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny Azure Cosmos DB for MongoDB-tilkobling ved å velge Mer nederst i tilkoblingslisten.
• Database: Velg databasen fra rullegardinlisten.
• Samlingsnavn: Angi navnet på Azure Cosmos DB-samlingen. Du kan velge samlingen fra rullegardinlisten.
• Versjon: Versjonen du angir. Anbefale oppgradering til den nyeste versjonen for å dra nytte av de nyeste forbedringene. Hvis du vil lære forskjellen mellom ulike versjoner, kan du gå til denne inndelingen.

Under Avansert kan du angi følgende felt:

• Filter: Angir utvalgsfilter ved hjelp av spørringsoperatorer. Hvis du vil returnere alle dokumenter i en samling, utelater du denne parameteren eller sender et tomt dokument ({}).
• Markørmetoder: Velg + Ny for å angi måten den underliggende spørringen skal kjøres på. Måtene å utføre spørring på er:
  • prosjekt: Angir feltene som skal returneres i dokumentene for projeksjon. Hvis du vil returnere alle feltene i de samsvarende dokumentene, utelater du denne parameteren.
  • sortere: Angir rekkefølgen spørringen returnerer samsvarende dokumenter i. Gå til cursor.sort() for mer informasjon.
  • limit: Angir maksimalt antall dokumenter serveren returnerer. Gå til cursor.limit() for mer informasjon.
  • hopp over: Angir antall dokumenter som skal hoppes over, og hvor MongoDB begynner å returnere resultater. Gå til cursor.skip() for mer informasjon.
• Bunkestørrelse: Angir antall dokumenter som skal returneres i hver gruppe av svaret fra MongoDB-forekomsten. I de fleste tilfeller vil endring av batchstørrelsen ikke påvirke brukeren eller applikasjonen. Azure Cosmos DB begrenser at hver gruppe ikke kan overstige 40 MB i størrelse, som er summen av antall dokumenter i bunkestørrelse , så reduser denne verdien hvis dokumentstørrelsen er stor. Standardverdien er 100.
• Flere kolonner: Legg til flere datakolonner for å lagre kildefilenes relative bane eller statiske verdi. Uttrykk støttes for sistnevnte.

Mål

Gå til Mål-fanen for å konfigurere målet for kopieringsaktiviteten. Se følgende innhold for detaljert konfigurasjon.

Følgende egenskaper kreves:

• Tilkobling: Velg en Azure Cosmos DB for MongoDB-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny Azure Cosmos DB for MongoDB-tilkobling ved å velge Mer nederst i tilkoblingslisten.
• Database: Velg databasen fra rullegardinlisten.
• Samlingsnavn: Angi navnet på Azure Cosmos DB-samlingen. Du kan velge samlingen fra rullegardinlisten.

Under Avansert kan du angi følgende felt:

• Skrivevirkemåte: Beskriver hvordan du skriver data til Azure Cosmos DB for MongoDB. Tillatte verdier: Insert og Upsert.

  Upserts virkemåte er å erstatte dokumentet hvis det allerede finnes et dokument med det samme_id, ellers setter du inn dokumentet.

  Note

  Tjenesten genererer automatisk en _id for et dokument hvis en _id ikke er angitt verken i det opprinnelige dokumentet eller ved kolonnetilordning. Dette betyr at du må sørge for at dokumentet ditt har en ID for at Upsert skal fungere som forventet.

• Skriv satsvis tidsavbrudd: Angi ventetiden for at den satsvise innsettingsoperasjonen skal fullføres før den blir tidsavbrutt. Den tillatte verdien er tidsrom, og standardverdien er 00:30:00 (30 minutter).

• Skriv batchstørrelse: Denne egenskapen styrer størrelsen på dokumentene som skal skrives i hver batch. Du kan prøve å øke verdien for å forbedre ytelsen og redusere verdien hvis dokumentstørrelsen er stor. Standardverdien er 10 000.

Tilordning

Hvis du vil ha informasjon om konfigurasjon av tilordningsfanen , kan du se Konfigurere tilordningene under tilordningsfanen. Tilordning støttes ikke når både kilde- og måldata er hierarkiske data.

Datatypetilordning for Azure Cosmos DB for MongoDB

Når du kopierer data fra Azure Cosmos DB for MongoDB, brukes følgende tilordninger fra Azure Cosmos DB for MongoDB-datatyper til midlertidige datatyper som brukes av tjenesten internt.

Datatypen Azure Cosmos DB for MongoDB	Midlertidig tjenestedatatype (for versjon 1.1)	Midlertidig tjenestedatatype (for versjon 1.0)
Date	DateTime	Int64
Objekt-ID	Streng	Streng
Desimal 128	Streng	Streng
Tidsstempel	De viktigste 32 bitene –> DateTime De minst signifikante 32 bitene -> Int64	De viktigste 32 bitene -> Int64 De minst signifikante 32 bitene -> Int64
Streng	Streng	Streng
Dobbel	Dobbel	Dobbel
Int32	Int64	Int64
Int64	Int64	Int64
boolsk	boolsk	boolsk
Null	Null	Null
JavaScript	Streng	Streng
Regulært uttrykk	Streng	Streng
Min nøkkel	Streng	Int64
Maks nøkkel	Streng	Int64
Binary	GUID (når SubType er "04") Streng	Streng

Innstillinger

For konfigurasjon av Innstillinger-fanen går du til Konfigurer de andre innstillingene under innstillinger-fanen.

Forskjeller mellom Azure Cosmos DB for MongoDB-versjoner

Tabellen nedenfor viser funksjonsforskjellene mellom ulike versjoner.

Versjon 1.1	Versjon 1.0
Følgende tilordninger brukes fra Azure Cosmos DB for MongoDB-datatyper til midlertidige tjenestedatatyper. Dato -> Dato/klokkeslett TimeStamp (de mest betydningsfulle 32 bitene) -> DateTime Min nøkkel -> Streng Maks nøkkel -> Streng Binær –> GUID (når SubType er «04») / streng	Følgende tilordninger brukes fra Azure Cosmos DB for MongoDB-datatyper til midlertidige tjenestedatatyper. Dato -> Int64 TimeStamp (de mest betydningsfulle 32 bitene) -> Int64 Min nøkkel -> Int64 Maks nøkkel -> Int64 Binær –> streng

Tabellsammendrag

Tabellen nedenfor inneholder mer informasjon om kopieringsaktiviteten i Azure Cosmos DB for MongoDB.

Kilde informasjon

Name	Beskrivelse	Verdi	Kreves	JSON-skriptegenskap
Forbindelse	Tilkoblingen til kildedatalageret.	< Azure Cosmos DB for MongoDB-tilkoblingen >	Ja	forbindelse
Database	Databasen du bruker som kilde.	< databasen >	Ja	database
Navn på samling	Navnet på Azure Cosmos DB-samlingen.	< Din samling >	Ja	samling
Versjon	Versjonen du angir.	• 1.1 • 1.0	Ja	versjon: • 1.1 • 1.0
Filter	Utvalgsfilteret ved hjelp av spørringsoperatorer. Hvis du vil returnere alle dokumenter i en samling, utelater du denne parameteren eller sender et tomt dokument ({}).	< Ditt valgfilter >	No	filter
Markør metoder	Måten den underliggende spørringen utføres på.	• prosjekt • sortere • grense • hoppe over	No	markørMetoder: •prosjekt •sortere •grense •hoppe over
Batch størrelse	Antall dokumenter som skal returneres i hver bunke av svaret fra MongoDB-forekomsten. I de fleste tilfeller vil endring av batchstørrelsen ikke påvirke brukeren eller applikasjonen. Azure Cosmos DB begrenser at hver gruppe ikke kan overstige 40 MB i størrelse, som er summen av antall dokumenter i bunkestørrelse , så reduser denne verdien hvis dokumentstørrelsen er stor.	< skrivebatchstørrelsen din > (standard er 100)	No	batch-størrelse
Flere kolonner	Legg til flere datakolonner for å lagre kildefilenes relative bane eller statiske verdi. Uttrykk støttes for sistnevnte.	•Navn •Verdi	No	ytterligereKolonner: •navn •verdi

Informasjon om destinasjonen

Name	Beskrivelse	Verdi	Kreves	JSON-skriptegenskap
Forbindelse	Tilkoblingen til måldatalageret.	< Azure Cosmos DB for MongoDB-tilkoblingen >	Ja	forbindelse
Database	Databasen du bruker som mål.	< databasen >	Ja	database
Navn på samling	Navnet på Azure Cosmos DB-samlingen.	< Din samling >	Ja	samling
Skriveatferd	Beskriver hvordan du skriver data til Azure Cosmos DB for MongoDB. Tillatte verdier: Insert og Upsert. Upserts virkemåte er å erstatte dokumentet hvis det allerede finnes et dokument med det samme_id, ellers setter du inn dokumentet. Obs!: Tjenesten genererer automatisk en _id for et dokument hvis en _id ikke er angitt verken i det opprinnelige dokumentet eller ved kolonnetilordning. Dette betyr at du må sørge for at dokumentet ditt har en ID for at Upsert skal fungere som forventet.	• Sett inn (standard) • Upsert	No	writeBehavior: •sette inn • upsert
Tidsavbrudd for skriving av parti	Ventetiden for at batchinnsatsoperasjonen skal fullføres før den blir tidsavbrutt.	timespan (standard er 00:30:00 - 30 minutter)	No	writeBatchTimeout
Skriv batchstørrelse	Kontrollerer størrelsen på dokumentene som skal skrives i hver bunke. Du kan prøve å øke denne verdien for å forbedre ytelsen og redusere verdien hvis dokumentstørrelsen er stor.	< skrivebatchstørrelsen din > (standard er 10 000)	No	writeBatchSize

Relatert innhold

• Oversikt over Azure Cosmos DB for MongoDB