removeShardFromZone (comando de base de datos)

Definición

removeShardFromZone: El comando administrativo removeShardFromZone elimina la asociación entre una partición y una zona.
Tip
En mongosh, este comando también se puede ejecutar a través del método asistente sh.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 se puede ejecutar removeShardFromZone en la base de datos de admin desde una instancia de mongos.

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
removeShardFromZone	string	El nombre de la partición del que se removerá la asociación de zona.
zona	string	El nombre de la zona cuya asociación con la partición desea eliminar.

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 clústeres que aplican control de acceso, se debe autenticar como:

un usuario cuyos privilegios incluyen:
- update sobre la colección shards en la base de datos config, y
- find en la colección tags en la base de datos config;
o, alternativamente
un usuario cuyos privilegios incluyan enableSharding sobre el recurso clúster.

Los clusterAdmin o los clusterManager roles de funcionalidades incorporadas tienen los permisos necesarios para emitir removeShardFromZone. Consulta la página del manual de Control de Acceso Basado en Roles (RBAC) para obtener más información.

Ejemplo

El siguiente ejemplo remueve la asociación entre shard0000 y la zona NYC:

db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )

Volver

removeShard

reshardCollection