Úlohy kopírování kontejnerů ve službě Azure Cosmos DB (Preview)
PLATÍ PRO: NoSQL MongoDB Cassandra
K offline kopírování kontejnerů v rámci účtu služby Azure Cosmos DB můžete využít úlohy kopírování kontejnerů.
Pokud chcete dosáhnout některého z těchto scénářů, budete možná muset zkopírovat data v rámci účtu služby Azure Cosmos DB:
- Kopírování všech položek z jednoho kontejneru do druhého
- Změňte členitost zřizování propustnosti z databáze na kontejner a naopak.
- Změna klíče oddílu kontejneru
- Aktualizace jedinečných klíčů pro kontejner
- Přejmenujte kontejner nebo databázi.
- Změňte režim kapacity účtu z bezserverové na zřízený nebo naopak.
- Přijměte nové funkce, které jsou podporovány pouze pro nové kontejnery, například hierarchické klíče oddílů.
Úlohy kopírování kontejnerů je možné vytvářet a spravovat pomocí příkazů Azure CLI.
Začínáme
Začněte tím, že na webu Azure Portal zaregistrujete příslušnou funkci Preview.
Kopírování kontejnerů mezi účty Azure Cosmos DB
NoSQL API
Pokud chcete začít s offline kopírováním kontejnerů mezi účty azure Cosmos DB for NoSQL API, zaregistrujte si příznak funkce Offline kopírování kontejnerů Typu NoSQL (NoSQL) mezi účty ve verzi Preview na webu Azure Portal. Po dokončení registrace je verze Preview platná pro všechny účty rozhraní API NoSQL v předplatném.
Kopírování kontejnerů v rámci účtu služby Azure Cosmos DB
Rozhraní API NoSQL a Cassandra
Pokud chcete začít s offline kopírováním kontejnerů v rámci účtu pro účty NoSQL a Cassandra API, zaregistrujte si příznak funkce Offline kopírování kontejnerů v rámci účtu (Cassandra &NoSQL) ve verzi Preview na webu Azure Portal. Po dokončení registrace je verze Preview platná pro všechny účty Cassandra a API pro NoSQL v předplatném.
Rozhraní API pro MongoDB
Pokud chcete začít s offline kopírováním kontejneru v rámci účtu pro účty Azure Cosmos DB pro MongoDB, zaregistrujte si příznak funkce offline kolekce uvnitř účtu (MongoDB) na webu Azure Portal. Po dokončení registrace je verze Preview platná pro všechny účty rozhraní API pro MongoDB v předplatném.
Kopírování dat kontejneru
- Vytvořte cílový kontejner Azure Cosmos DB pomocí nastavení, která chcete použít (klíč oddílu, členitost propustnosti, jednotky žádostí, jedinečný klíč atd.).
- Zastavte operace ve zdrojovém kontejneru tím, že pozastavíte instance aplikace nebo všechny klienty, kteří se k němu připojují.
- Vytvořte úlohu kopírování kontejneru.
- Monitorujte průběh úlohy kopírování kontejneru a počkejte, až se dokončí.
- Pokračujte v operacích tím, že odpovídajícím způsobem nasměrujte aplikaci nebo klienta na zdroj nebo cílovou kopii kontejneru podle očekávání.
Jak funguje kopírování kontejneru?
Úlohy kopírování kontejnerů provádějí offline kopírování dat pomocí protokolu přírůstkového kanálu změn zdrojového kontejneru.
- Platforma přidělí výpočetní instance na straně serveru pro cílový účet služby Azure Cosmos DB.
- Tyto instance jsou přiděleny při vytvoření jedné nebo více úloh kopírování kontejneru v rámci účtu.
- Úlohy kopírování kontejneru se spouštějí v těchto instancích.
- V každém okamžiku se spustí jedna úloha ve všech instancích.
- Instance jsou sdíleny všemi úlohami kopírování kontejneru, které jsou spuštěné ve stejném účtu.
- Platforma může uvolnit instance, pokud jsou nečinné déle než 15 minut.
Poznámka:
V současné době podporujeme pouze offline úlohy kopírování kontejnerů. Důrazně doporučujeme, abyste před zahájením kopírování kontejneru přestali provádět všechny operace se zdrojovým kontejnerem. Odstranění položek a aktualizace provedené ve zdrojovém kontejneru po spuštění úlohy kopírování nemusí být zachyceny. Pokud budete pokračovat v provádění operací se zdrojovým kontejnerem, zatímco probíhá úloha kontejneru, můžete mít duplicitní nebo chybějící data v cílovém kontejneru.
Faktory, které ovlivňují rychlost úlohy kopírování kontejneru
Rychlost průběhu úlohy kopírování kontejneru je určena těmito faktory:
Nastavení propustnosti zdrojového kontejneru nebo databáze
Nastavení propustnosti cílového kontejneru nebo databáze.
Tip
Nastavte propustnost cílového kontejneru na alespoň dvakrát propustnost zdrojového kontejneru.
Výpočetní instance na straně serveru, které jsou přiděleny k účtu služby Azure Cosmos DB pro provádění přenosu dat.
Důležité
Výchozí skladová položka nabízí pro každý účet dvě 16GB instance na straně serveru 4 vCPU.
Omezení
Kritéria způsobilosti pro verzi Preview
Úlohy kopírování kontejnerů nefungují s účty, které mají povolené následující funkce. Před spuštěním úloh kopírování kontejneru tyto funkce zakažte:
Konfigurace účtu
Nastavení TTL (Time to Live) se v cílovém kontejneru neupravuje. V důsledku toho, pokud ve zdrojovém kontejneru nevypršela platnost dokumentu, spustí se jeho odpočítávání znovu v cílovém kontejneru.
Nejčastější dotazy
Existuje smlouva o úrovni služeb pro úlohy kopírování kontejnerů?
Úlohy kopírování kontejnerů se v současné době podporují na základě maximálního úsilí. Neposkytujeme žádné záruky smlouvy o úrovni služeb (SLA) za dobu potřebnou k dokončení úloh.
Můžu v rámci účtu vytvořit více úloh kopírování kontejneru?
Ano, v rámci stejného účtu můžete vytvořit více úloh. Úlohy běží po sobě. Můžete zobrazit seznam všech úloh vytvořených v rámci účtu a sledovat jejich průběh.
Můžu zkopírovat celou databázi v rámci účtu služby Azure Cosmos DB?
Pro každý kontejner v databázi musíte vytvořit úlohu.
Mám účet služby Azure Cosmos DB s několika oblastmi. Ve které oblasti se spustí úloha kopírování kontejneru?
Úloha kopírování kontejneru se spustí v oblasti zápisu. V účtu, který je nakonfigurovaný pro zápisy do více oblastí, se úloha spustí v jedné z oblastí v seznamu oblastí zápisu.
Co se stane s úlohami kopírování kontejneru při změně oblasti zápisu účtu?
Oblast zápisu účtu se může změnit ve vzácném scénáři výpadku oblasti nebo kvůli ručnímu převzetí služeb při selhání. V tomto scénáři se nezdaří neúplné úlohy kopírování kontejneru vytvořené v rámci účtu. Tyto neúspěšné úlohy byste museli znovu vytvořit. Znovu vytvořené úlohy se pak spustí v nové (aktuální) oblasti zápisu.
Podporované oblasti
V současné době se kopírování kontejnerů podporuje v následujících oblastech:
Amerika | Evropa a Afrika | Asie a Tichomoří |
---|---|---|
Brazílie – jih | Francie – střed | Austrálie – střed |
Střední Kanada | Francie – jih | Austrálie – střed 2 |
Kanada – východ | Německo – sever | Austrálie – východ |
USA – střed | Německo – středozápad | Indie – střed |
USA – střed (EUAP) | Severní Evropa | Japonsko – východ |
USA – východ | Norsko – východ | Jižní Korea – střed |
USA – východ 2 | Norsko – západ | Southeast Asia |
USA – východ 2 (EUAP) | Švýcarsko – sever | Spojené arabské emiráty – střed |
Severní střed USA | Švýcarsko – západ | Západ Indie |
Středojižní USA | Velká Británie – jih | Východní Asie |
Středozápad USA | Velká Británie – západ | Malajsie – jih |
USA – západ | Západní Evropa | Japonsko – západ |
Západní USA 2 | Izrael - střed | Austrálie – jihovýchod |
Nepodporováno | Jižní Afrika – sever | Nepodporováno |
Známé a běžné problémy
Chyba – Prostředek vlastníka neexistuje.
Pokud se vytvoření úlohy nezdaří a zobrazí se chyba Vlastník prostředku neexistuje (kód chyby 404), cílový kontejner ještě nebyl vytvořen nebo název kontejneru použitý k vytvoření úlohy neodpovídá skutečnému názvu kontejneru.
Před spuštěním úlohy podle přehledu se ujistěte, že je cílový kontejner vytvořen, a ujistěte se, že název kontejneru v úloze odpovídá skutečnému názvu kontejneru.
"code": "404", "message": "Response status code does not indicate success: NotFound (404); Substatus: 1003; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {\"Errors\":[\"Owner resource does not exist\"]
Chyba – Požadavek je neautorizovaný.
Pokud požadavek selže a zobrazí chybu Neautorizováno (kód chyby 401), může být místní autorizace zakázaná. Zjistěte, jak povolit místní autorizaci.
Úlohy kopírování kontejnerů používají k ověření primární klíče. Pokud je místní autorizace zakázaná, vytvoření úlohy se nezdaří. Aby úlohy kopírování kontejnerů fungovaly, musí být povolená místní autorizace.
"code": "401", "message": " Response status code does not indicate success: Unauthorized (401); Substatus: 5202; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: Local Authorization is disabled. Use an AAD token to authorize all requests."
Chyba – Chyba při získávání prostředků pro úlohu
K této chybě může dojít kvůli interním problémům se serverem. Pokud chcete tento problém vyřešit, obraťte se na podpora Microsoftu otevřením nové žádosti o podporu na webu Azure Portal. V případě typu problému vyberte Migraci dat. V podtypu Problém vyberte kopii kontejneru uvnitř účtu.
"code": "500" "message": "Error while getting resources for job, StatusCode: 500, SubStatusCode: 0, OperationId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Další kroky
- Naučte se vytvářet, monitorovat a spravovat úlohy kopírování kontejnerů v účtu služby Azure Cosmos DB pomocí příkazů rozhraní příkazového řádku.
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro