Azure DocumentDB-fürt skálázása és konfigurálása

Az Azure DocumentDB zökkenőmentes méretezhetőséget és régión belüli magas rendelkezésre állást (HA) biztosít. Ez a dokumentum gyors útmutatóként szolgál azoknak a fejlesztőknek, akik szeretnék megtudni, hogyan méretezhetik és konfigurálhatják fürtöiket.

Előfeltételek

• Azure-előfizetés

  • Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot

• Meglévő Azure DocumentDB-fürt

  • Ha nincs klasztere, hozzon létre egy új klasztert

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: Az Azure Cloud Shell használatának első lépései.

  

• Ha a CLI referencia parancsokat helyben szeretnéd futtatni, telepítsd az Azure CLI-t. Ha Windows vagy macOS rendszeren fut, fontolja meg az Azure CLI-t egy Docker-konténerben futtatni. További információkért lásd: Az Azure CLI használata Docker-konténerben.

  • Ha egy helyileg telepített verziót használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. Az azonosítási folyamat befejezéséhez kövesse a terminálján megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Hitelesítés az Azure-ba az Azure CLI használatával.

  • Amikor megjelenik a felszólítás, az első használatkor telepítse az Azure CLI bővítményt. További információ a bővítményekről: Bővítmények használata és kezelése az Azure CLI-vel.

  • Futtasd a az version parancsot, hogy megtudd a telepített verziót és függő könyvtárakat. A legújabb verzióra való frissítéshez futtassa a az upgrade parancsot.

Számítási fürt skálázása

A fürtszint lehetővé teszi a virtuális magok számának és a ram mennyiségének konfigurálását a fürt fizikai szegmenseihez. A fürtszintet bármikor, megszakítás nélkül módosíthatja az igényeinek megfelelően. Növelheti például az M50-rőlaz M60-ra , vagy csökkentheti az M50-etM40-re.

Azure Portál

1. A fürt oldalsávjának Beállítások csoportjában válassza a Méretezés lehetőséget.

2. A klaszter szint módosításához válassza ki az új szintet a legördülő menüből.

   

3. A módosítás megőrzéséhez válassza a Mentés lehetőséget.

Azure CLI

1. A fürt számítási rétegének fel- vagy leskálázásához frissítse a meglévő fürtöt egy update művelettel a tulajdonság értékének MXXXcompute.tier módosításával.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.compute.tier="<compute-tier>"
   

REST API-k

Az Azure REST API-t közvetlenül vagy az Azure CLI-környezetből az rest csomagolva használhatja.

1. Ezzel a paranccsal módosíthatja a fürt számítási szintjét:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"
   

   Jótanács

   Ha az Azure Cloud Shellt használja, közvetlenül a rendszerhéjba tölthet fel/tölthet le fájlokat. További információ: felügyelt fájlok az Azure Cloud Shellben.

Megjegyzés:

A normál számítási szintről a kipukkasztható szintre való visszalépés nem támogatott.

Növelje a tárterület méretét

Növelheti a tárterület méretét , hogy az adatbázis több helyet biztosítson a növekedéshez. A tárterület például 128 GiB-ről256 GiB-ra növelhető.

Azure Portál

1. A tárterület méretének növeléséhez válassza ki az új méretet a legördülő menüből.

   

2. A módosítás megőrzéséhez válassza a Mentés lehetőséget.

Azure CLI

1. A fürttároló méretének növeléséhez frissítse a meglévő fürtöt egy update művelettel a storage.sizeGb tulajdonság értékének növelésével. A támogatott tárolóméretek a támogatott tárterület lapon jelennek meg.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.storage.sizeGb="<new-size-in-GiB>"
   

REST API-k

Az Azure REST API-t közvetlenül vagy az Azure CLI-környezetből az rest csomagolva használhatja.

1. Ezzel a paranccsal módosíthatja a fürt számítási szintjét:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"storage\":{\"sizeGb\":\"<new-size-in-GiB>\"}}}"
   

   Jótanács

   Ha az Azure Cloud Shellt használja, közvetlenül a rendszerhéjba tölthet fel/tölthet le fájlokat. További információ: felügyelt fájlok az Azure Cloud Shellben.

Fontos

A tárterület mérete csak növelhető, nem csökkenthető.

Magas rendelkezésre állás engedélyezése vagy letiltása

Az igényeinek megfelelően engedélyezheti vagy letilthatja a régión belüli magas rendelkezésre állást (HA). A régión belüli magas rendelkezésre állás elkerüli az adatbázis állásidejét azáltal, hogy a fürt minden elsődleges szegmensének replika szegmenseit fenntartja. Ha egy elsődleges törzs leáll, a rendszer automatikusan átirányítja a bejövő kapcsolatokat a replika törzsére, biztosítva a minimális leállási időt.

Azure Portál

1. A régión belüli HA engedélyezéséhez vagy letiltásához kapcsolja be a jelölőnégyzetet.

   

2. A módosítás megőrzéséhez válassza a Mentés lehetőséget.

Azure CLI

1. Ha engedélyezni szeretné a régión belüli magas rendelkezésre állást a fürtön, frissítse a meglévő fürtöt egy update művelettel a tulajdonság highAvailability.targetModeértékének ZoneRedundantPreferred beállításával.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.highAvailability.targetMode="ZoneRedundantPreferred"
   

2. Ha le szeretné tiltani a régión belüli magas rendelkezésre állást a fürtön, frissítse a meglévő fürtöt egy update művelettel a tulajdonság highAvailability.targetModeértékének Disabled beállításával.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.highAvailability.targetMode="Disabled"
   

REST API-k

Az Azure REST API-t közvetlenül vagy az Azure CLI-környezetből az rest csomagolva használhatja.

1. Ezzel a paranccsal engedélyezheti a régión belüli magas rendelkezésre állást a fürtön:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"ZoneRedundantPreferred\"}}}"
   

2. Ezzel a paranccsal letilthatja a régión belüli magas rendelkezésre állást a fürtön:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"Disabled\"}}}"
   

A fizikai szegmensek számának növelése

Ha egy adatbázis egy fizikai szegmensfürt kapacitásán túlnő, növelheti a tárterület méretét , vagy további fizikai szegmenseket vehet fel. Miután hozzáadtak egy új fizikai szegmenst a fürthöz, fürt-újraegyensúlyozási műveletet kell végrehajtania az adatok újraelosztásához a szegmensek között. A fürtök minden fizikai szegmense mindig ugyanazzal a számítási és tárolási konfigurációval rendelkezik.

Azure Portál

1. Fizikai szegmensek hozzáadásához válassza ki az új szegmensek számát a listából.

   

2. A módosítás megőrzéséhez válassza a Mentés lehetőséget.

3. A módosítás megőrzéséhez válassza a Folytatás lehetőséget az előugró ablakban.

Azure CLI

1. Ha fizikai szegmenst szeretne hozzáadni a fürthöz, frissítse a meglévő fürtöt egy update művelettel a tulajdonság értékének sharding.shardCount eggyel történő növelésével.

   az resource update \
     --resource-type "Microsoft.DocumentDB/mongoClusters" \
     --name "<cluster-name>" \
     --resource-group "<resource-group>" \
     --set properties.sharding.shardCount="<current-shard-count-plus-one>"
   

   Megjegyzés:

   Egyszerre csak egy fizikai szegmenst adhat hozzá. Ha több fizikai szegmenst kell hozzáadnia a fürthöz, ezt egymás után kell elvégeznie.

REST API-k

Az Azure REST API-t közvetlenül vagy az Azure CLI-környezetből az rest csomagolva használhatja.

1. Ezzel a paranccsal adhat hozzá fizikai szegmenst a fürthöz:

   az rest \
      --method "PATCH" \
      --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
      --body "{\"location\":\"<cluster-region>\",\"properties\":{\"sharding\":{\"shardCount\":\"<current-shard-count-plus-one>\"}}}"
   

   Megjegyzés:

   Egyszerre csak egy fizikai szegmenst adhat hozzá. Ha több fizikai szegmenst kell hozzáadnia a fürthöz, ezt egymás után kell elvégeznie.

Jótanács

Ha több mint 10 fizikai szilánkra van szüksége a fürtön, nyisson támogatási jegyet.

Adatok újraegyensúlyozása

Miután hozzáadtak egy fizikai szegmenst egy fürthöz, vagy ha a több szegmenses fürt a fizikai szegmensei között egyenetlen tárterület-használattal rendelkezik, az adatok újraelosztása állásidő nélkül újraosztja az adatokat a szegmensek között.

Előzetes verzióban engedélyezni kell az adategyensúlyozást a fürtön:

1. Nyissa meg a(z) fürt tulajdonságait az Azure portálon.
2. A Szolgáltatások lap Beállítások területén válassza a Több szegmenses fürtök újraegyensúlyozója lehetőséget.
3. A több szegmenses fürtök rebalancer paneljén válassza az Engedélyezés lehetőséget.

Az adategyensúlyozás elindításához csatlakozzon a fürthöz egy felügyeleti eszközzel, például a Mongo shell-lel.

1. Indítsa el az újraegyensúlyozót a sh.startBalancer() paranccsal.

2. Ellenőrizze a kiegyensúlyozó állapotát a következővel sh.isBalancerRunning().

3. Állítsa le az újraegyensúlyozót a sh.stopBalancer() paranccsal.

Megjegyzés:

Az újraegyensúlyozási folyamat időtartama a fizikai szegmensek között áthelyezett adatok mennyiségétől függ. A művelet interneten keresztül történik, és nem befolyásolja a fürt rendelkezésre állását vagy működését.

Következő lépések

Ebben az útmutatóban bemutattuk, hogy az Azure DocumentDB-fürt skálázása és konfigurálása az Azure Portalon egyszerű folyamat. Az Azure Portal lehetővé teszi a fürtszint módosítását, a tárterület méretének növelését, a magas rendelkezésre állás engedélyezését vagy letiltását, valamint fizikai szegmensek hozzáadását állásidő nélkül.

• Számítási és tárolási lehetőségek
• Tekintsd meg a sharding alapjait

Azure DocumentDB-fürt visszaállítása