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