Konfigurer Azure Cosmos DB for NoSQL i en kopiaktivitet

Denne artikkelen beskriver hvordan du bruker kopieringsaktiviteten i et datasamlebånd til å kopiere data fra og til Azure Cosmos DB for NoSQL.

Støttet konfigurasjon

Hvis du vil ha konfigurasjonen av hver fane under kopieringsaktiviteten, kan du gå til følgende inndelinger.

Generelt

Se veiledningen for generelle innstillinger for å konfigurere fanen Generelle innstillinger.

Source

Følgende egenskaper støttes for Azure Cosmos DB for NoSQL under Kilde-fanen for en kopiaktivitet.

Screenshot showing source tab.

Følgende tre egenskaper kreves:

  • Datalagertype: Velg ekstern.
  • Koble til ion: Velg en Azure Cosmos DB for NoSQL-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny Azure Cosmos DB for NoSQL-tilkobling ved å velge Ny.
  • Beholder: Velg beholderen du vil bruke. Velg Rediger for å angi beholdernavnet manuelt.

Under Avansert kan du angi følgende felt:

  • Bruk spørring: Du kan velge enten Tabell eller Spørring som bruksspørring. Listen nedenfor beskriver konfigurasjonen av hver innstilling.

    • Tabell: Leser data fra tabellen du har angitt i tabell.

    • Spørring: Angir Azure Cosmos DB-spørringen for å lese data.

      Screenshot showing query.

  • Sidestørrelse: Antall dokumenter per side i spørringsresultatet. Standard er «-1», som betyr å bruke dynamisk sidestørrelse på tjenestesiden opptil 1000.

  • Finn datetime: Om datetime skal oppdages fra strengverdiene i dokumentene. Tillatte verdier er: sann (standard), usann.

  • Foretrukne områder: Den foretrukne listen over områder å koble til når du henter data fra Azure Cosmos DB. Velg ett foretrukket område fra rullegardinlisten etter at du har valgt Ny.

    Screenshot showing preferred regions.

  • Flere kolonner: Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte. Hvis du vil ha mer informasjon, kan du gå til Legg til flere kolonner under kopieringen.

    Screenshot showing additional columns.

Mål

Følgende egenskaper støttes for Azure Cosmos DB for NoSQL under Mål-fanen i en kopiaktivitet.

Screenshot showing destination tab.

Følgende tre egenskaper kreves:

  • Datalagertype: Velg ekstern.
  • Koble til ion: Velg en Azure Cosmos DB for NoSQL-tilkobling fra tilkoblingslisten.
  • Beholder: Velg Bla gjennom for å velge filen du vil kopiere, eller fyll ut banen manuelt.

Under Avansert kan du angi følgende felt:

  • Skrivevirkemåte: Definerer skrivevirkemåten når målet er filer fra et filbasert datalager. Du kan velge Legg til dynamisk innhold, Sett inn eller Oppsett fra rullegardinlisten.

    • Legg til dynamisk innhold: Åpne ruten Legg til dynamisk innhold . Dette åpner uttrykksverktøyet der du kan bygge uttrykk fra støttede systemvariabler, aktivitetsutdata, funksjoner og brukerangitte variabler eller parametere. Hvis du vil ha informasjon om uttrykksspråket, kan du gå til Uttrykk og funksjoner.

    • Sett inn: Velg dette alternativet hvis kildedataene er satt inn.

    • Upsert: Virkemåten til upsert er å erstatte dokumentet hvis et dokument med samme ID allerede finnes. Ellers setter du inn dokumentet.

      Screenshot showing write behavior.

  • Tidsavbrudd for skrivegruppe: Ventetid for at den satsvise innsettingsoperasjonen skal fullføres før den blir tidsavbrutt. Tillatte verdier er Timespan. Et eksempel er 00:30:00 (30 minutter).

  • Skrive bunkestørrelse: Angi antall rader som skal settes inn i SQL-tabellen per bunke. Den tillatte verdien er et heltall (antall rader). Som standard bestemmer tjenesten dynamisk riktig satsvis størrelse basert på radstørrelsen.

  • Maks samtidige tilkoblinger: Den øvre grensen for samtidige tilkoblinger som ble opprettet i datalageret under aktivitetskjøringen. Angi en verdi bare når du vil begrense samtidige tilkoblinger.

  • Deaktiver analyse av ytelsesmåledata: Denne innstillingen styrer samlingen av måledata, for eksempel DTU, DWU, RU og så videre for kopiering av ytelsesoptimalisering og anbefalinger. Hvis du er opptatt av denne virkemåten, deaktiverer du denne funksjonen.

Tilordning

Gå til Konfigurer tilordningene under tilordningsfanen for fanen Tilordning.

Innstillinger

Gå til Konfigurer de andre innstillingene under innstillinger-fanen for konfigurasjon av Innstillinger-fanen.

Tabellsammendrag

Tabellene nedenfor inneholder mer informasjon om kopieringsaktiviteten i Azure Cosmos DB for NoSQL.

Kildetabell

Name Beskrivelse Verdi Kreves JSON-skriptegenskap
Datalagertype Datalagertypen. Ekstern Ja /
Koble til ion Tilkoblingen til kildedatalageret. <tilkoblingen> Ja Tilkobling
Beholder Beholderen for kildedataene. <beholder for kilden> Ja Beholder
Filnavn
Bruk spørring Du kan velge Tabell eller Spørring som bruksspørring. Tabell
Spørring
No type
Sidestørrelse Antall dokumenter per side i spørringsresultatet. Standard er «-1», som betyr å bruke dynamisk sidestørrelse på tjenestesiden opptil 1000. <sidestørrelsen> No pageSize
Slett datetime Filene i kildedatalageret slettes rett etter at de er flyttet til mållageret. Filslettingen er per fil, så når kopieringsaktiviteten mislykkes, vil du være oppmerksom på at noen filer allerede er kopiert til målet og slettet fra kilden, mens andre fremdeles er i kildelageret. Merket eller fjern merking No detectDatetime
Foretrukne områder Den foretrukne listen over områder å koble til når du henter data fra Azure Cosmos DB. Velg ett foretrukket område fra rullegardinlisten etter at du har valgt Ny. <dine foretrukne områder> No preferredRegions
Flere kolonner Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte. Hvis du vil ha mer informasjon, kan du gå til Legg til flere kolonner under kopieringen. <maks samtidige tilkoblinger> No additionalColumns

Måltabell

Name Beskrivelse Verdi Kreves JSON-skriptegenskap
Datalagertype Datalagertypen. Ekstern Ja /
Koble til ion Tilkoblingen til måldatalageret. <tilkoblingen> Ja Tilkobling
Beholder Beholderen for måldataene. <beholder med kilde> Ja Beholder
Filnavn
Skrivevirkemåte Beskriver hvordan du skriver data til Azure Cosmos DB. Tillatte verdier: insert and upsert. Virkemåten til upsert er å erstatte dokumentet hvis et dokument med samme ID allerede finnes. Hvis ikke, setter du inn dokumentet. Legge til dynamisk innhold
Sett inn
Oppsett
No writeBehavior
Tidsavbrudd for skrivegruppe Ventetiden for at den satsvise innsettingsoperasjonen skal fullføres før den blir tidsavbrutt. Tillatte verdier er Timespan. Et eksempel er 00:30:00 (30 minutter). Tidsrom No writeBatchTimeout
Skrive bunkestørrelse Antall rader som skal settes inn i SQL-tabellen per bunke. Den tillatte verdien er heltall (antall rader). Som standard bestemmer tjenesten dynamisk riktig satsvis størrelse basert på radstørrelsen. <antall rader >
(heltall)
No writeBatchSize
Maksimalt antall samtidige tilkoblinger Den øvre grensen for samtidige tilkoblinger som ble opprettet i datalageret under aktivitetskjøringen. Angi en verdi bare når du vil begrense samtidige tilkoblinger. <maks samtidige tilkoblinger> No maxConcurrent Koble til ions
Deaktiver analyse av ytelsesmåledata Denne innstillingen styrer samling av måledata som DTU, DWU, RU og så videre for kopiering av ytelsesoptimalisering og anbefalinger. Hvis du er opptatt av denne virkemåten, deaktiverer du denne funksjonen. Merket eller fjern merking No disableMetricsCollection