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
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 |