Dela via


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.

Screenshot showing source tab.

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.

      Screenshot showing query.

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

    Screenshot showing preferred regions.

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

    Screenshot showing additional columns.

Mål

Följande egenskaper stöds för Azure Cosmos DB för NoSQL under fliken Mål för en kopieringsaktivitet.

Screenshot showing destination tab.

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.

      Screenshot showing write behavior.

  • 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