Azure Cosmos DB for NoSQL configureren in een kopieeractiviteit

In dit artikel wordt beschreven hoe u de kopieeractiviteit in een gegevenspijplijn gebruikt om gegevens van en naar Azure Cosmos DB voor NoSQL te kopiëren.

Ondersteunde configuratie

Voor de configuratie van elk tabblad onder de kopieeractiviteit gaat u respectievelijk naar de volgende secties.

• Algemeen
• Source
• Bestemming
• Toewijzing
• Instellingen

Algemeen

Raadpleeg de richtlijnen voor algemene instellingen voor het configureren van het tabblad Algemene instellingen.

Bron

De volgende eigenschappen worden ondersteund voor Azure Cosmos DB for NoSQL op het tabblad Bron van een kopieeractiviteit.

De volgende drie eigenschappen zijn vereist:

• Gegevensarchieftype: Selecteer Extern.
• Verbinding maken ion: Selecteer een Azure Cosmos DB for NoSQL-verbinding in de lijst met verbindingen. Als er geen verbinding bestaat, maakt u een nieuwe Azure Cosmos DB for NoSQL-verbinding door Nieuw te selecteren.
• Container: Selecteer de container die u wilt gebruiken. Selecteer Bewerken om de containernaam handmatig in te voeren.

Onder Geavanceerd kunt u de volgende velden opgeven:

• Query gebruiken: u kunt tabel of query kiezen als uw gebruiksquery. In de volgende lijst wordt de configuratie van elke instelling beschreven.

  • Tabel: leest gegevens uit de tabel die u hebt opgegeven in Tabel.

  • Query: Hiermee geeft u de Azure Cosmos DB-query op om gegevens te lezen.

    

• Paginaformaat: het aantal documenten per pagina van het queryresultaat. De standaardwaarde is -1, wat betekent dat u het dynamische paginaformaat aan de servicezijde tot 1000 wilt gebruiken.

• Datum/tijd detecteren: hiermee wordt aangegeven of datum/tijd moet worden gedetecteerd op basis van de tekenreekswaarden in de documenten. Toegestane waarden zijn: true (standaard), false.

• Voorkeursregio's: de voorkeurslijst met regio's waarmee u verbinding kunt maken bij het ophalen van gegevens uit Azure Cosmos DB. Selecteer één voorkeursregio in de vervolgkeuzelijst nadat u Nieuw hebt geselecteerd.

  

• Aanvullende kolommen: voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste. Ga naar Extra kolommen toevoegen tijdens het kopiëren voor meer informatie.

  

Doel

De volgende eigenschappen worden ondersteund voor Azure Cosmos DB for NoSQL op het tabblad Bestemming van een kopieeractiviteit.

De volgende drie eigenschappen zijn vereist:

• Gegevensarchieftype: Selecteer Extern.
• Verbinding maken ion: Selecteer een Azure Cosmos DB for NoSQL-verbinding in de lijst met verbindingen.
• Container: Selecteer Bladeren om het bestand te kiezen dat u wilt kopiëren of vul het pad handmatig in.

Onder Geavanceerd kunt u de volgende velden opgeven:

• Schrijfgedrag: Definieert het schrijfgedrag wanneer de bestemming bestanden is uit een gegevensarchief op basis van bestanden. U kunt dynamische inhoud toevoegen, Invoegen of Upsert kiezen in de vervolgkeuzelijst.

  • Dynamische inhoud toevoegen: Open het deelvenster Dynamische inhoud toevoegen. Hiermee opent u de opbouwfunctie voor expressies, waarin u expressies kunt bouwen op basis van ondersteunde systeemvariabelen, activiteitsuitvoer, functies en door de gebruiker opgegeven variabelen of parameters. Ga naar Expressies en functies voor informatie over de expressietaal.

  • Invoegen: Kies deze optie als de brongegevens worden ingevoegd.

  • Upsert: Het gedrag van upsert is om het document te vervangen als er al een document met dezelfde id bestaat; anders voegt u het document in.

    

• Time-out voor batch schrijven: wachttijd voordat de batchinvoegbewerking is voltooid voordat er een time-out optreedt. Toegestane waarden zijn Timespan. Een voorbeeld is 00:30:00 (30 minuten).

• Batchgrootte schrijven: geef het aantal rijen op dat in de SQL-tabel per batch moet worden ingevoegd. De toegestane waarde is een geheel getal (aantal rijen). Standaard bepaalt de service dynamisch de juiste batchgrootte op basis van de rijgrootte.

• Maximum aantal gelijktijdige verbindingen: de bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken.

• Analyse van metrische gegevens voor prestaties uitschakelen: met deze instelling bepaalt u de verzameling metrische gegevens, zoals DTU, DWU, RU, enzovoort voor optimalisatie van kopieerprestaties en aanbevelingen. Als u zich zorgen maakt over dit gedrag, schakelt u deze functie uit.

Toewijzing

Ga voor de configuratie van het tabblad Toewijzing naar Uw toewijzingen configureren onder het tabblad Toewijzing.

Instellingen

Ga voor de configuratie van het tabblad Instellingen naar De andere instellingen configureren op het tabblad Instellingen.

Tabelsamenvatting

De volgende tabellen bevatten meer informatie over de kopieeractiviteit in Azure Cosmos DB for NoSQL.

Brontabel

Name	Beschrijving	Waarde	Vereist	JSON-scripteigenschap
Gegevensarchieftype	Het gegevensarchieftype.	Extern	Ja	/
Verbinding	Uw verbinding met het brongegevensarchief.	<uw verbinding>	Ja	verbinding
Container	De container van uw brongegevens.	<container van uw bron>	Ja	Container fileName
Query gebruiken	U kunt Tabel of Query kiezen als uw gebruiksquery.	• Tafel • Query	Nee	type
Paginaformaat	Het aantal documenten per pagina van het queryresultaat. De standaardwaarde is -1, wat betekent dat u het dynamische paginaformaat aan de servicezijde tot 1000 wilt gebruiken.	<uw paginaformaat>	Nee	Pagesize
Datum/tijd verwijderen	De bestanden in het brongegevensarchief worden direct verwijderd nadat ze naar het doelarchief zijn verplaatst. Het verwijderen van bestanden is per bestand, dus wanneer de kopieeractiviteit mislukt, ziet u dat sommige bestanden al naar het doel zijn gekopieerd en uit de bron zijn verwijderd terwijl anderen zich nog in het bronarchief bevinden.	Geselecteerd of selectie opheffen	Nee	detectDatetime
Voorkeursregio's	De voorkeurslijst met regio's waarmee u verbinding wilt maken bij het ophalen van gegevens uit Azure Cosmos DB. Selecteer één voorkeursregio in de vervolgkeuzelijst nadat u Nieuw hebt geselecteerd.	<uw voorkeursregio's>	Nee	preferredRegions
Aanvullende kolommen	Voeg extra gegevenskolommen toe om het relatieve pad of de statische waarde van bronbestanden op te slaan. Expressie wordt ondersteund voor de laatste. Ga naar Extra kolommen toevoegen tijdens het kopiëren voor meer informatie.	<maximum aantal gelijktijdige verbindingen>	Nee	additionalColumns

Doeltabel

Name	Beschrijving	Waarde	Vereist	JSON-scripteigenschap
Gegevensarchieftype	Het gegevensarchieftype.	Extern	Ja	/
Verbinding	Uw verbinding met het doelgegevensarchief.	<uw verbinding>	Ja	verbinding
Container	De container van uw doelgegevens.	<container van bron>	Ja	Container fileName
Schrijfgedrag	Hierin wordt beschreven hoe u gegevens schrijft naar Azure Cosmos DB. Toegestane waarden: invoegen en upsert. Het gedrag van upsert is om het document te vervangen als er al een document met dezelfde id bestaat; anders voegt u het document in.	• Dynamische inhoud toevoegen • Invoegen • Upsert	Nee	writeBehavior
Time-out voor batchbewerkingen schrijven	Wachttijd voordat de batchinvoegbewerking is voltooid voordat er een time-out optreedt. Toegestane waarden zijn Tijdspanne. Een voorbeeld is 00:30:00 (30 minuten).	tijdsbestek	Nee	writeBatchTimeout
Grootte van schrijfbatch	Het aantal rijen dat moet worden ingevoegd in de SQL-tabel per batch. De toegestane waarde is een geheel getal (aantal rijen). Standaard bepaalt de service dynamisch de juiste batchgrootte op basis van de rijgrootte.	<aantal rijen > (geheel getal)	Nee	writeBatchSize
Maximum aantal gelijktijdige verbindingen	De bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken.	<maximum aantal gelijktijdige verbindingen>	Nee	maxConcurrent Verbinding maken ions
Analyse van metrische prestatiegegevens uitschakelen	Deze instelling bepaalt het verzamelen van metrische gegevens, zoals DTU, DWU, RU, enzovoort voor optimalisatie en aanbevelingen voor kopieerprestaties. Als u zich zorgen maakt over dit gedrag, schakelt u deze functie uit.	Geselecteerd of selectie opheffen	Nee	disableMetricsCollection

Gerelateerde inhoud

• Uw Azure Cosmos DB for NoSQL-verbinding instellen