Konfigurer Azure Cosmos DB for NoSQL i en kopiaktivitet

I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i en datapipeline til at kopiere data fra og til Azure Cosmos DB for NoSQL.

Understøttet konfiguration

For konfigurationen af hver fane under kopiaktiviteten skal du gå til henholdsvis følgende afsnit.

• Generelt
• Source
• Destination
• Kortlægning
• Indstillinger

Generelt

Se vejledningen til generelle indstillinger for at konfigurere fanen Generelle indstillinger.

Kilde

Følgende egenskaber understøttes for Azure Cosmos DB for NoSQL under fanen Kilde i en kopiaktivitet.

Følgende tre egenskaber er påkrævet:

• Datalagertype: Vælg ekstern.
• Forbind ion: Vælg en Azure Cosmos DB til NoSQL-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Azure Cosmos DB for NoSQL-forbindelse ved at vælge Ny.
• Objektbeholder: Vælg den objektbeholder, du vil bruge. Vælg Rediger for at angive objektbeholdernavnet manuelt.

Under Avanceret kan du angive følgende felter:

• Brug forespørgsel: Du kan vælge enten Tabel eller Forespørgsel som din brugsforespørgsel . På følgende liste beskrives konfigurationen af hver indstilling.

  • Tabel: Læser data fra den tabel, du har angivet i Table.

  • Forespørgsel: Angiver Azure Cosmos DB-forespørgslen til læsning af data.

    

• Sidestørrelse: Antallet af dokumenter pr. side i forespørgselsresultatet. Standard er "-1", hvilket betyder at bruge den dynamiske sidestørrelse på tjenestesiden op til 1000.

• Registrer datetime: Om datetime skal registreres fra strengværdierne i dokumenterne. Tilladte værdier er: true (default), false.

• Foretrukne områder: Den foretrukne liste over områder, der skal oprettes forbindelse til, når der hentes data fra Azure Cosmos DB. Vælg ét foretrukket område på rullelisten, når du har valgt Ny.

  

• Flere kolonner: Tilføj flere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. Du kan finde flere oplysninger ved at gå til Tilføj flere kolonner under kopiering.

  

Destination

Følgende egenskaber understøttes for Azure Cosmos DB for NoSQL under fanen Destination for en kopiaktivitet.

Følgende tre egenskaber er påkrævet:

• Datalagertype: Vælg ekstern.
• Forbind ion: Vælg en Azure Cosmos DB til NoSQL-forbindelse på forbindelseslisten.
• Objektbeholder: Vælg Gennemse for at vælge den fil, du vil kopiere, eller udfyld stien manuelt.

Under Avanceret kan du angive følgende felter:

• Skrivefunktion: Definerer skrivefunktionsmåden, når destinationen er filer fra et filbaseret datalager. Du kan vælge Tilføj dynamisk indhold, Indsæt eller Upsert på rullelisten.

  • Tilføj dynamisk indhold: Åbn ruden Tilføj dynamisk indhold . Dette åbner udtryksgeneratoren, hvor du kan oprette udtryk fra understøttede systemvariabler, aktivitetsoutput, funktioner og brugerdefinerede variabler eller parametre. Du kan få oplysninger om udtrykssproget ved at gå til Udtryk og funktioner.

  • Indsæt: Vælg denne indstilling, hvis kildedataene indeholder indsættelser.

  • Upsert: Funktionsmåden for upsert er at erstatte dokumentet, hvis der allerede findes et dokument med det samme id. Ellers skal du indsætte dokumentet.

    

• Timeout for skrivning af batch: Vent på, at batchindsætningshandlingen fuldføres, før der opstår timeout. Tilladte værdier er Timespan. Et eksempel er 00:30:00 (30 minutter).

• Skriv batchstørrelse: Angiv det antal rækker, der skal indsættes i SQL-tabellen pr. batch. Den tilladte værdi er et heltal (antal rækker). Tjenesten bestemmer som standard dynamisk den relevante batchstørrelse baseret på rækkestørrelsen.

• Maksimalt antal samtidige forbindelser: Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.

• Deaktiver analyse af målepunkter for ydeevne: Denne indstilling styrer samlingen af målepunkter, f.eks. DTU, DWU, RU osv. til optimering af kopiydeevne og anbefalinger. Hvis du er bekymret for denne funktionsmåde, skal du deaktivere denne funktion.

Tilknytning

For konfigurationen af fanen Tilknytning skal du gå til Konfigurer dine tilknytninger under fanen Tilknytning.

Indstillinger

For konfigurationen af fanen Indstillinger skal du gå til Konfigurer dine andre indstillinger under fanen Indstillinger.

Tabeloversigt

Følgende tabeller indeholder flere oplysninger om kopiaktiviteten i Azure Cosmos DB for NoSQL.

Kildetabel

Navn	Beskrivelse	Værdi	Obligatorisk	JSON-scriptegenskab
Datalagertype	Datalagertypen.	Eksternt	Ja	/
Forbind ion	Din forbindelse til kildedatalageret.	<din forbindelse>	Ja	Forbindelse
Container	Objektbeholderen for dine kildedata.	<objektbeholder til din kilde>	Ja	Container Filnavn
Brug forespørgsel	Du kan vælge Tabel eller Forespørgsel som din brugsforespørgsel .	• Tabel • Forespørgsel	Nr.	type
Sidestørrelse	Antallet af dokumenter pr. side i forespørgselsresultatet. Standard er "-1", hvilket betyder at bruge den dynamiske sidestørrelse på tjenestesiden op til 1000.	<din sidestørrelse>	Nr.	Pagesize
Slet datetime	Filerne i kildedatalageret slettes lige efter, at de er flyttet til destinationslageret. Filsletningen sker pr. fil, så når kopiaktiviteten mislykkes, vil du bemærke, at nogle filer allerede er blevet kopieret til destinationen og slettet fra kilden, mens andre stadig er i kildelageret.	Markeret eller fravælg	Nr.	detectDatetime
Foretrukne områder	Den foretrukne liste over områder, der skal oprettes forbindelse til, når du henter data fra Azure Cosmos DB. Vælg ét foretrukket område på rullelisten, når du har valgt Ny.	<dine foretrukne områder>	Nr.	preferredRegions
Flere kolonner	Tilføj yderligere datakolonner for at gemme kildefilernes relative sti eller statiske værdi. Udtrykket understøttes for sidstnævnte. Du kan finde flere oplysninger ved at gå til Tilføj flere kolonner under kopiering.	<maks. antal samtidige forbindelser>	Nr.	additionalColumns

Destinationstabel

Navn	Beskrivelse	Værdi	Obligatorisk	JSON-scriptegenskab
Datalagertype	Datalagertypen.	Eksternt	Ja	/
Forbind ion	Din forbindelse til destinationsdatalageret.	<din forbindelse>	Ja	Forbindelse
Container	Objektbeholderen for dine destinationsdata.	<objektbeholder til kilde>	Ja	Container Filnavn
Skrivefunktionsmåde	Beskriver, hvordan du skriver data til Azure Cosmos DB. Tilladte værdier: indsæt og indsæt. Funktionsmåden for upsert er at erstatte dokumentet, hvis der allerede findes et dokument med det samme id. Ellers skal du indsætte dokumentet.	• Tilføj dynamisk indhold • Indsæt • Upsert	Nr.	writeBehavior
Timeout for skrivning af batch	Vent på, at batchindsætningshandlingen fuldføres, før der udløber timeout. Tilladte værdier er Timespan. Et eksempel er 00:30:00 (30 minutter).	Timespan	Nr.	writeBatchTimeout
Skriv batchstørrelse	Det antal rækker, der skal indsættes i SQL-tabellen pr. batch. Den tilladte værdi er heltal (antal rækker). Tjenesten bestemmer som standard dynamisk den relevante batchstørrelse baseret på rækkestørrelsen.	<antal rækker > (heltal)	Nr.	writeBatchSize
Maks. antal samtidige forbindelser	Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.	<maks. antal samtidige forbindelser>	Nr.	maxConcurrent Forbind ions
Deaktiver analyse af målepunkter for ydeevne	Denne indstilling styrer indsamlingen af målepunkter som DTU, DWU, RU osv. for optimering af kopiydeevne og anbefalinger. Hvis du er bekymret for denne funktionsmåde, skal du deaktivere denne funktion.	Markeret eller fravælg	Nr.	disableMetricsCollection

Relateret indhold

• Konfigurer din Azure Cosmos DB til NoSQL-forbindelse