Zadania kopiowania kontenerów w usłudze Azure Cosmos DB (wersja zapoznawcza)

Artykuł
11/16/2023

DOTYCZY: Nosql Mongodb Cassandra

Kontenery można kopiować w trybie offline w ramach konta usługi Azure Cosmos DB, wykonując zadania kopiowania kontenerów.

Jeśli chcesz osiągnąć dowolny z następujących scenariuszy, może być konieczne skopiowanie danych na koncie usługi Azure Cosmos DB:

Skopiuj wszystkie elementy z jednego kontenera do drugiego.
Zmień stopień szczegółowości aprowizacji przepływności z bazy danych na kontener i na odwrót.
Zmień klucz partycji kontenera.
Zaktualizuj unikatowe klucze kontenera.
Zmień nazwę kontenera lub bazy danych.
Zmień tryb pojemności konta z bezserwerowego na aprowizowany lub odwrotnie.
Wdrażanie nowych funkcji, które są obsługiwane tylko w przypadku nowych kontenerów, np. hierarchicznych kluczy partycji.

Zadania kopiowania kontenerów można tworzyć i zarządzać nimi przy użyciu poleceń interfejsu wiersza polecenia platformy Azure.

Rozpocznij

Aby rozpocząć, zarejestruj się w celu uzyskania odpowiedniej funkcji w wersji zapoznawczej w witrynie Azure Portal.

Kopiowanie kontenerów między kontami usługi Azure Cosmos DB

Interfejs API NoSQL

Aby rozpocząć pracę z kopiowaniem kontenera trybu offline między kontami dla kont interfejsu API NoSQL dla usługi Azure Cosmos DB, zarejestruj się na potrzeby flagi funkcji kopiowania kontenerów trybu offline między kontami (NoSQL) w obszarze Funkcje w wersji zapoznawczej w witrynie Azure Portal. Po zakończeniu rejestracji wersja zapoznawcza będzie obowiązywać dla wszystkich kont interfejsu API NoSQL w subskrypcji.

Kopiowanie kontenera na koncie usługi Azure Cosmos DB

Interfejs API NoSQL i Cassandra

Aby rozpocząć pracę z kopią kontenera w trybie offline dla kont interfejsu API NoSQL i Cassandra, zarejestruj się na potrzeby kopiowania kontenerów w trybie offline (Cassandra i NoSQL) w obszarze Funkcje w wersji zapoznawczej w witrynie Azure Portal. Po zakończeniu rejestracji wersja zapoznawcza jest obowiązująca dla wszystkich kont Cassandra i API dla noSQL w subskrypcji.

Interfejs API dla bazy danych MongoDB

Aby rozpocząć pracę z kopią kontenera w trybie offline dla kont usługi Azure Cosmos DB dla bazy danych MongoDB, zarejestruj się pod kątem flagi funkcji kopiowania kolekcji offline wewnątrz konta (MongoDB) w obszarze Funkcje w wersji zapoznawczej w witrynie Azure Portal. Po zakończeniu rejestracji wersja zapoznawcza będzie obowiązywać dla wszystkich kont interfejsu API w usłudze MongoDB w subskrypcji.

Kopiowanie danych kontenera

Utwórz docelowy kontener usługi Azure Cosmos DB przy użyciu ustawień, których chcesz użyć (klucz partycji, stopień szczegółowości przepływności, jednostki żądania, unikatowy klucz itd.).
Zatrzymaj operacje w kontenerze źródłowym, wstrzymując wystąpienia aplikacji lub wszystkich klientów łączących się z nim.
Utwórz zadanie kopiowania kontenera.
Monitoruj postęp zadania kopiowania kontenera i poczekaj na jego ukończenie.
Wznów operacje, wskazując odpowiednio aplikację lub klienta na kopię źródłowego lub docelowego kontenera zgodnie z oczekiwaniami.

Jak działa kopiowanie kontenerów?

Zadania kopiowania kontenerów wykonują kopiowanie danych w trybie offline przy użyciu przyrostowego dziennika zestawienia zmian kontenera źródłowego.

Platforma przydziela wystąpienia obliczeniowe po stronie serwera dla docelowego konta usługi Azure Cosmos DB.
Te wystąpienia są przydzielane po utworzeniu co najmniej jednego zadania kopiowania kontenera w ramach konta.
Zadania kopiowania kontenera są uruchamiane w tych wystąpieniach.
Pojedyncze zadanie jest wykonywane we wszystkich wystąpieniach w dowolnym momencie.
Wystąpienia są współużytkowane przez wszystkie zadania kopiowania kontenera, które są uruchomione na tym samym koncie.
Platforma może cofnąć przydział wystąpień, jeśli są bezczynne przez dłużej niż 15 minut.

Uwaga

Obecnie obsługujemy tylko zadania kopiowania kontenerów w trybie offline. Zdecydowanie zalecamy zaprzestanie wykonywania jakichkolwiek operacji w kontenerze źródłowym przed rozpoczęciem kopiowania kontenera. Usunięcie elementów i aktualizacje wykonywane w kontenerze źródłowym po uruchomieniu zadania kopiowania mogą nie zostać przechwycone. Jeśli nadal wykonujesz operacje w kontenerze źródłowym, gdy zadanie kontenera jest w toku, może istnieć zduplikowane lub brakujące dane w kontenerze docelowym.

Czynniki wpływające na szybkość zadania kopiowania kontenera

Szybkość postępu zadania kopiowania kontenera jest określana przez następujące czynniki:

Ustawienie przepływności źródłowego kontenera lub bazy danych.
Ustawienie przepływności kontenera docelowego lub bazy danych.

Napiwek

Ustaw przepływność kontenera docelowego na co najmniej dwa razy przepływność kontenera źródłowego.
Wystąpienia obliczeniowe po stronie serwera przydzielone do konta usługi Azure Cosmos DB na potrzeby przeprowadzania transferu danych.

Ważne

Domyślna jednostka SKU oferuje dwa wystąpienia po stronie serwera 4-vCPU 16 GB na konto.

Ograniczenia

Kryteria uprawnień wersji zapoznawczej

Zadania kopiowania kontenerów nie działają z kontami, które mają włączone następujące możliwości. Wyłącz te funkcje przed uruchomieniem zadań kopiowania kontenerów:

Konfiguracje kont

Ustawienie Czas wygaśnięcia (TTL) nie jest dostosowywane w kontenerze docelowym. W związku z tym, jeśli dokument nie wygasł w kontenerze źródłowym, uruchamia odliczanie w kontenerze docelowym.

Często zadawane pytania

Czy istnieje umowa dotycząca poziomu usług dla zadań kopiowania kontenerów?

Zadania kopiowania kontenerów są obecnie obsługiwane w sposób optymalny. Nie zapewniamy żadnych gwarancji dotyczących poziomu usług (SLA, Service Level Agreement) na czas potrzebny na zakończenie zadań.

Czy mogę utworzyć wiele zadań kopiowania kontenerów na koncie?

Tak, można utworzyć wiele zadań na tym samym koncie. Zadania są uruchamiane kolejno. Możesz wyświetlić listę wszystkich zadań utworzonych na koncie i monitorować ich postęp.

Czy mogę skopiować całą bazę danych na koncie usługi Azure Cosmos DB?

Musisz utworzyć zadanie dla każdego kontenera w bazie danych.

Mam konto usługi Azure Cosmos DB z wieloma regionami. W którym regionie zostanie uruchomione zadanie kopiowania kontenera?

Zadanie kopiowania kontenera jest uruchamiane w regionie zapisu. Na koncie skonfigurowanym z zapisami w wielu regionach zadanie jest uruchamiane w jednym z regionów na liście regionów zapisu.

Co się stanie z zadaniami kopiowania kontenera, gdy zmieni się region zapisu konta?

Region zapisu konta może ulec zmianie w rzadkim scenariuszu awarii regionu lub z powodu ręcznego przejścia w tryb failover. W tym scenariuszu niekompletne zadania kopiowania kontenera utworzone w ramach konta kończą się niepowodzeniem. Należy ponownie utworzyć te zadania, które zakończyły się niepowodzeniem. Ponownie utworzone zadania zostaną uruchomione w nowym (bieżącym) regionie zapisu.

Obsługiwane regiony

Obecnie kopiowanie kontenera jest obsługiwane w następujących regionach:

Ameryka Północna i Południowa	Europa i Afryka	Azja i Pacyfik
Brazylia Południowa	Francja Środkowa	Australia Środkowa
Kanada Środkowa	Francja Południowa	Australia Środkowa 2
Kanada Wschodnia	Niemcy Północne	Australia Wschodnia
Central US	Niemcy Środkowo-Zachodnie	Indie Środkowe
Środkowe stany USA — EUAP	Europa Północna	Japonia Wschodnia
Wschodnie stany USA	Norwegia Wschodnia	Korea Środkowa
Wschodnie stany USA 2	Norwegia Zachodnia	Azja Południowo-Wschodnia
Wschodnie stany USA 2 — EUAP	Szwajcaria Północna	Środkowe Zjednoczone Emiraty Arabskie
Północno-środkowe stany USA	Szwajcaria Zachodnia	Indie Zachodnie
South Central US	Południowe Zjednoczone Królestwo	Azja Wschodnia
Zachodnio-środkowe stany USA	Zachodnie Zjednoczone Królestwo	Malezja Południowa
Zachodnie stany USA	Europa Zachodnia	Japonia Zachodnia
Zachodnie stany USA 2	Izrael Centralny	Australia Południowo-Wschodnia
Nieobsługiwane	Północna Republika Południowej Afryki	Nieobsługiwane

Znane i typowe problemy

Błąd — zasób właściciela nie istnieje.

Jeśli tworzenie zadania zakończy się niepowodzeniem i zostanie wyświetlony błąd Właściciel zasobu nie istnieje (kod błędu 404), kontener docelowy nie został jeszcze utworzony lub nazwa kontenera użyta do utworzenia zadania nie jest zgodna z rzeczywistą nazwą kontenera.

Upewnij się, że kontener docelowy jest tworzony przed uruchomieniem zadania zgodnie z opisem w przeglądzie i upewnij się, że nazwa kontenera w zadaniu jest zgodna z rzeczywistą nazwą kontenera.
```
"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\"]
```
Błąd — żądanie jest nieautoryzowane.

Jeśli żądanie zakończy się niepowodzeniem i zostanie wyświetlony błąd Brak autoryzacji (kod błędu 401), autoryzacja lokalna może być wyłączona. Dowiedz się, jak włączyć autoryzację lokalną.

Zadania kopiowania kontenerów używają kluczy podstawowych do uwierzytelniania. Jeśli autoryzacja lokalna jest wyłączona, tworzenie zadania zakończy się niepowodzeniem. Aby zadania kopiowania kontenerów działały, należy włączyć autoryzację lokalną.
```
"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."
```
Błąd — błąd podczas pobierania zasobów dla zadania.

Ten błąd może wystąpić z powodu wewnętrznych problemów z serwerem. Aby rozwiązać ten problem, skontaktuj się z pomoc techniczna firmy Microsoft, otwierając nowe żądanie pomocy technicznej w witrynie Azure Portal. W polu Typ problemu wybierz pozycję Migracja danych. W obszarze Podtyp problemu wybierz pozycję Kopiowanie kontenera wewnątrz konta.
```
"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
```

Następne kroki

Dowiedz się , jak tworzyć, monitorować zadania kopiowania kontenerów i zarządzać nimi na koncie usługi Azure Cosmos DB przy użyciu poleceń interfejsu wiersza polecenia.