Konfigurace služby Azure Cosmos DB for NoSQL v aktivitě kopírování

Tento článek popisuje, jak pomocí aktivity kopírování v datovém kanálu kopírovat data z a do Azure Cosmos DB for NoSQL.

Podporovaná konfigurace

Konfigurace každé karty v aktivitě kopírování najdete v následujících částech.

OBECNÉ

Informace o konfiguraci karty Obecné nastavení najdete v doprovodných materiálech k obecným nastavením.

Source

Následující vlastnosti jsou podporované pro Službu Azure Cosmos DB for NoSQL na kartě Zdroj aktivity kopírování.

Screenshot showing source tab.

Jsou vyžadovány následující tři vlastnosti:

  • Typ úložiště dat: Vyberte externí.
  • Připojení ion: Ze seznamu připojení vyberte připojení Azure Cosmos DB for NoSQL. Pokud žádné připojení neexistuje, vytvořte nové připojení Ke službě Azure Cosmos DB for NoSQL výběrem možnosti Nový.
  • Kontejner: Vyberte kontejner, který chcete použít. Pokud chcete název kontejneru zadat ručně, vyberte Upravit .

V části Upřesnit můžete zadat následující pole:

  • Použít dotaz: Jako dotaz pro použití můžete zvolit tabulku nebo dotaz . Následující seznam popisuje konfiguraci jednotlivých nastavení.

    • Tabulka: Čte data z tabulky, kterou jste zadali v tabulce.

    • Dotaz: Určuje dotaz služby Azure Cosmos DB pro čtení dat.

      Screenshot showing query.

  • Velikost stránky: Počet dokumentů na stránku výsledku dotazu. Výchozí hodnota je -1, což znamená, že použijete dynamickou velikost stránky na straně služby až 1 000.

  • Zjistit datum a čas: Určuje, jestli se má zjistit datum a čas z řetězcových hodnot v dokumentech. Povolené hodnoty jsou true (výchozí), false.

  • Upřednostňované oblasti: Upřednostňovaný seznam oblastí pro připojení při načítání dat ze služby Azure Cosmos DB. Po výběru možnosti Nový vyberte jednu upřednostňovanou oblast z rozevíracího seznamu.

    Screenshot showing preferred regions.

  • Další sloupce: Přidejte další datové sloupce pro ukládání relativní cesty nebo statické hodnoty zdrojových souborů. U druhého výrazu se podporuje. Další informace najdete v tématu Přidání dalších sloupců během kopírování.

    Screenshot showing additional columns.

Cíl

Následující vlastnosti jsou podporované pro Službu Azure Cosmos DB for NoSQL na kartě Cíl aktivity kopírování.

Screenshot showing destination tab.

Jsou vyžadovány následující tři vlastnosti:

  • Typ úložiště dat: Vyberte externí.
  • Připojení ion: Ze seznamu připojení vyberte připojení Azure Cosmos DB for NoSQL.
  • Kontejner: Vyberte Procházet a zvolte soubor, který chcete zkopírovat, nebo cestu vyplňte ručně.

V části Upřesnit můžete zadat následující pole:

  • Chování zápisu: Definuje chování zápisu, pokud je cílem soubory ze souborového úložiště dat. V rozevíracím seznamu můžete zvolit Přidat dynamický obsah, Vložit nebo Upsert .

    • Přidat dynamický obsah: Otevřete podokno Přidat dynamický obsah . Tím se otevře tvůrce výrazů, kde můžete vytvářet výrazy z podporovaných systémových proměnných, výstupu aktivity, funkcí a uživatelem zadaných proměnných nebo parametrů. Informace o jazyce výrazů najdete v části Výrazy a funkce.

    • Vložit: Tuto možnost zvolte, pokud zdrojová data obsahuje vložení.

    • Upsert: Chování upsertu je nahradit dokument, pokud dokument se stejným ID již existuje; jinak vložte dokument.

      Screenshot showing write behavior.

  • Časový limit dávky zápisu: Počkejte, než se operace dávkového vložení dokončí, než vyprší časový limit. Povolené hodnoty jsou Timespan. Příklad je 00:30:00 (30 minut).

  • Velikost dávky zápisu: Zadejte počet řádků, které se mají vložit do tabulky SQL na dávku. Povolená hodnota je celé číslo (počet řádků). Ve výchozím nastavení služba dynamicky určuje odpovídající velikost dávky na základě velikosti řádku.

  • Maximální počet souběžných připojení: Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Zadejte hodnotu pouze v případech, kdy chcete omezit souběžná připojení.

  • Zakázat analýzu metrik výkonu: Toto nastavení řídí shromažďování metrik, jako jsou DTU, DWU, RU atd. pro optimalizaci výkonu kopírování a doporučení. Pokud máte obavy o toto chování, vypněte tuto funkci.

mapování.

Konfigurace karty Mapování naleznete v části Konfigurace mapování na kartě Mapování.

Nastavení

Konfiguraci karty Nastavení získáte v části Konfigurace dalších nastavení na kartě Nastavení.

Souhrn tabulky

Následující tabulky obsahují další informace o aktivitě kopírování ve službě Azure Cosmos DB for NoSQL.

Zdrojová tabulka

Název Popis Hodnota Požaduje se Vlastnost skriptu JSON
Typ úložiště dat Váš typ úložiště dat. Externí Ano /
Připojení Vaše připojení ke zdrojovému úložišti dat. <vaše připojení> Ano připojení
Kontejner Kontejner zdrojových dat. <kontejner vašeho zdroje> Ano Kontejner
fileName
Použití dotazu Jako dotaz můžete zvolit tabulku nebo dotaz . Tabulka
Dotaz
No type
Velikost stránky Počet dokumentů na stránku výsledku dotazu. Výchozí hodnota je -1, což znamená, že použijete dynamickou velikost stránky na straně služby až 1 000. <velikost stránky> No Pagesize
Odstranění data a času Soubory ve zdrojovém úložišti dat se odstraní hned po přesunutí do cílového úložiště. Odstranění souboru je na jeden soubor, takže když aktivita kopírování selže, všimněte si, že některé soubory už byly zkopírovány do cíle a odstraněny ze zdroje, zatímco jiné jsou stále ve zdrojovém úložišti. Výběr nebo zrušení výběru No detectDatetime
Upřednostňované oblasti Upřednostňovaný seznam oblastí pro připojení při načítání dat ze služby Azure Cosmos DB. Po výběru možnosti Nový vyberte jednu upřednostňovanou oblast z rozevíracího seznamu. <upřednostňované oblasti> No preferredRegions
Další sloupce Přidejte další datové sloupce pro ukládání relativní cesty ke zdrojovým souborům nebo statické hodnotě. U druhého výrazu se podporuje. Další informace najdete v tématu Přidání dalších sloupců během kopírování. <maximální počet souběžných připojení> No additionalColumns

Cílová tabulka

Název Popis Hodnota Požaduje se Vlastnost skriptu JSON
Typ úložiště dat Váš typ úložiště dat. Externí Ano /
Připojení Vaše připojení k cílovému úložišti dat. <vaše připojení> Ano připojení
Kontejner Kontejner cílových dat. <kontejner zdroje> Ano Kontejner
fileName
Chování zápisu Popisuje, jak zapisovat data do služby Azure Cosmos DB. Povolené hodnoty: vložení a upsert. Chování upsertu je nahradit dokument, pokud dokument se stejným ID již existuje; v opačném případě vložte dokument. Přidat dynamický obsah
Vložit
Upsert
No writeBehavior
Časový limit zápisu dávky Počkejte, než se operace dávkového vložení dokončí, než vyprší časový limit. Povolené hodnoty jsou časový rozsah. Příklad je 00:30:00 (30 minut). timespan No writeBatchTimeout
Velikost dávky zápisu Počet řádků, které se mají vložit do tabulky SQL na dávku Povolená hodnota je celé číslo (počet řádků). Ve výchozím nastavení služba dynamicky určuje odpovídající velikost dávky na základě velikosti řádku. <počet řádků >
(celé číslo)
No writeBatchSize
Maximální počet souběžných připojení Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Zadejte hodnotu pouze v případech, kdy chcete omezit souběžná připojení. <maximální počet souběžných připojení> No maxConcurrent Připojení ions
Zakázání analýz metrik výkonu Toto nastavení řídí shromažďování metrik, jako jsou DTU, DWU, RU atd. pro optimalizaci výkonu kopírování a doporučení. Pokud máte obavy o toto chování, vypněte tuto funkci. Výběr nebo zrušení výběru No disableMetricsCollection