Definición
removeShardFromZoneLa
removeShardFromZoneEl comando administrativo elimina la asociación entre un fragmento y un zona.Tip
En
mongosh, este comando también se puede ejecutar a través del método asistentesh.removeShardFromZone().Los métodos asistente son convenientes para usuarios de
mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.
Compatibilidad
Este comando está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Sintaxis
Solo puede ejecutar en removeShardFromZone la admin base de datos desde una mongos instancia.
El comando tiene la siguiente sintaxis:
db.adminCommand( { removeShardFromZone: <string>, zone: <string> } )
Campos de comandos
El comando toma los siguientes campos:
Campo | Tipo | Descripción |
|---|---|---|
string | El nombre de la partición del que se removerá la asociación de zona. | |
string | El nombre de la zona cuya asociación con la partición deseas remover. |
mongosh proporciona el método asistente sh.removeShardFromZone().
Comportamiento
removeShardFromZone no remueve los rangos asociados con la zona.
Para remover completamente una zona del clúster, debes ejecutar removeShardFromZone en cada partición asociado con la zona.
Si la partición especificada es la última partición asociada con la zona, se debe asegurar que no queden rangos de claves de partición asociados con la zona. Utiliza updateZoneKeyRange para remover cualquier rango existente asociado con la zona antes de ejecutar removeShardFromZone.
Consulte la página del manual de zonas para obtener más información sobre las zonas en clústeres particionados.
Seguridad
Para los clústeres fragmentados que aplican el control de acceso, debe autenticarse como:
un usuario cuyos privilegios incluyen:
updatesobre la colecciónshardsen la base de datosconfig, yfinden la coleccióntagsen la base de datosconfig;
o, alternativamente
un usuario cuyos privilegios incluyan
enableShardingsobre el recurso clúster.
Los roles clusterAdmin integrados o clusterManager tienen los permisos adecuados para removeShardFromZone emitir. Consulte la página del manual de Control de acceso basado en roles para obtener más información.
Ejemplo
El siguiente ejemplo elimina la asociación entre shard0000 y la zona NYC:
db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )