El comando drop elimina la colección o vista especificada de la configuración de almacenamiento de la instancia de base de datos federada. Utilice el comodín "*" para eliminar todas las colecciones generadas por el comando. Función de recopilación de comodines (escollectionName() decir,), incluida la propia regla de recopilación de comodines. No se pueden eliminar individualmente las recopilaciones generadas por la función de recopilación de comodines.
Sintaxis
db.runCommand({ "drop" : "<collection-name|*>" })
db.runCommand({ "drop" : "<view-name>" })
Parámetros
Parameter | Tipo | Descripción | ¿Obligatorio? |
|---|---|---|---|
| string | El nombre de la colección que se va a eliminar o el comodín
| sí |
Parameter | Tipo | Descripción | ¿Obligatorio? |
|---|---|---|---|
| string | El nombre de la vista que se va a descartar. | sí |
Salida
El comando imprime la siguiente salida si se ejecuta correctamente. Puede verificar los resultados ejecutando el comando show collections. Si el comando falla, consulte
Solucionar errores para obtener soluciones recomendadas.
{ "ok" : 1, "ns" : "<database>.<collection>", "nIndexesWas" : 0 }
dónde:
nsRefleja el espacio de nombres de la colección, que incluye el nombre de la base de datos, el punto (.) y el nombre de la colección. Por ejemplo:<database>.<collection>.nIndexesWasrefleja la cantidad de índices, cuyo valor siempre es0en la federación de datos.
El comando imprime la siguiente salida si se ejecuta correctamente. Puede verificar los resultados ejecutando el storageGetConfig comando. Si el comando falla, consulte Solución de errores para obtener soluciones recomendadas.
{ "ok" : 1, "ns" : "<database>.<view>", "nIndexesWas" : 0 }
dónde:
nsRefleja el espacio de nombres de la vista, que incluye el nombre de la base de datos, el punto (.) y el nombre de la vista. Por ejemplo:<database>.<view>.nIndexesWasrefleja la cantidad de índices, cuyo valor siempre es0en la federación de datos.
Ejemplos
Ejemplos de colecciones de Drop
Los siguientes ejemplos utilizan el drop comando para eliminar colecciones de muestra que se asignaron al conjunto de datos de muestra, airbnby el clima, en el AWS TiendaS.3
Ejemplo básico
El siguiente ejemplo utiliza el comando drop para eliminar una colección de muestra denominada airbnb en una base de datos denominada sample en la configuración de almacenamiento.
use sample db.runCommand({ "drop" : "airbnb"})
El comando anterior imprime la siguiente salida:
{ "ok" : 1, "ns" : "sample.airbnb", "nIndexesWas" : 0 }
Ejemplo de comodín
El siguiente ejemplo utiliza el comando drop para eliminar la función de recopilación de comodines (collectionName()) y todas las colecciones creadas por la función de recopilación de comodines en una base de datos denominada sample en la configuración de almacenamiento.
use sample db.runCommand ({ "drop" : "*" })
El comando anterior imprime la siguiente salida:
{ "ok" : 1, "ns" : "sample.*", "nIndexesWas" : 0 }
Ejemplo de vistas eliminadas
El siguiente comando remueve una vista llamada "listings" en la colección airbnb de la base de datos sample:
use sample db.runCommand({ "drop" : "listings" })
El comando anterior devuelve el siguiente resultado:
Ejemplo
{ "ok" : 1, "ns" : "sample.listings", "nIndexesWas" : 0 }
Solución de problemas de error
Si el comando falla, devuelve uno de los siguientes errores.
Motivo: El espacio de nombres (base de datos, colección o vista) no existe.
{ ok: 0, errmsg: "ns not found", code: 26, codeName: "NamespaceNotFound" }
Solución: Asegúrese de que el espacio de nombres especificado en el comando sea válido y exista en la configuración de almacenamiento. Si es necesario, utilice el getStorageConfig comando para recuperar la lista de bases de datos, colecciones y vistas válidas en la configuración de almacenamiento.
Motivo: Intentar eliminar una colección creada por la función de colección comodíncollectionName() ().
{ ok: 0, errmsg: "cannot drop a collection created from a wildcard", code: 26, codeName: "NamespaceNotFound" }
Solución: Asegúrese de que la colección que va a eliminar no sea una colección individual generada dinámicamente por la función de colección comodíncollectionName() (). La federación de datos no permite eliminar colecciones individuales generadas por la función de colección comodín.