drop
Nesta página
O comando drop remove a coleção ou exibição especificada da configuração de armazenamento da instância do banco de dados federado. Use o curinga "*" para remover todas as coleções geradas pela função de coleção curinga (ou seja, collectionName()), incluindo a própria regra de coleção curinga. Você não pode remover coleções geradas pela função de coleção curinga de maneira individual.
Sintaxe
db.runCommand({ "drop" : "<collection-name|*>" })
db.runCommand({ "drop" : "<view-name>" })
Parâmetros
Parâmetro | Tipo | Descrição | Obrigatório? |
|---|---|---|---|
<collection-name> | string | O nome da collection a ser descartada, ou o curinga
| sim |
Parâmetro | Tipo | Descrição | Obrigatório? |
|---|---|---|---|
<view-name> | string | O nome da visualização a ser descartada. | sim |
Saída
O comando imprime a seguinte saída se for bem-sucedido. Para verificar os resultados, execute o comando show collections. Se o comando falhar, consulte Solucionar erros para ver soluções recomendadas.
{ "ok" : 1, "ns" : "<database>.<collection>", "nIndexesWas" : 0 }
onde:
nsreflete o namespace da coleção, que inclui o nome do banco de dados, o separador de ponto (.) e o nome da coleção. Por exemplo:<database>.<collection>.nIndexesWasreflete o número de índices, cujo valor é sempre0no Data Federation.
O comando imprime a saída a seguir se for bem-sucedido. Para verificar os resultados, execute o comando storageGetConfig. Se o comando falhar, consulte Solucionar erros para ver soluções recomendadas.
{ "ok" : 1, "ns" : "<database>.<view>", "nIndexesWas" : 0 }
onde:
nsreflete o namespace da visualização, que inclui o nome do banco de dados, o separador de ponto (.) e o nome da visualização. Por exemplo:<database>.<view>.nIndexesWasreflete o número de índices, cujo valor é sempre0no Data Federation.
Exemplos
Exemplos de collections descartadas
Os exemplos a seguir usam o drop comando para remover coleções de amostras que foram mapeadas para o conjunto de dados de amostra, Airbnb e o tempo, no armazenamento AWS S3 .
Exemplo básico
O exemplo abaixo usa o comando drop para remover uma collection de exemplo chamada airbnb em um banco de dados chamado sample na configuração de armazenamento.
use sample db.runCommand({ "drop" : "airbnb"})
O comando anterior imprime a seguinte saída:
{ "ok" : 1, "ns" : "sample.airbnb", "nIndexesWas" : 0 }
Exemplo de curinga
O exemplo abaixo usa o comando drop para remover a função de collection de curinga (collectionName()) e todas as collections criadas pela função de collection de curinga em um banco de dados chamado sample na configuração de armazenamento.
use sample db.runCommand ({ "drop" : "*" })
O comando anterior imprime a seguinte saída:
{ "ok" : 1, "ns" : "sample.*", "nIndexesWas" : 0 }
Exemplo de visualizações descartadas
O comando a seguir remove uma exibição chamada "listings" no airbnb coleção no sample banco de dados :
use sample db.runCommand({ "drop" : "listings" })
O comando anterior retorna a seguinte saída:
Exemplo
{ "ok" : 1, "ns" : "sample.listings", "nIndexesWas" : 0 }
Solução de problemas de erros
Se o comando falhar, será gerado um dos seguintes erros.
Motivo: o namespace (banco de dados, collection ou visualização) não existe.
{ ok: 0, errmsg: "ns not found", code: 26, codeName: "NamespaceNotFound" }
Solução: Certifique-se de que o namespace especificado no comando seja válido e exista na configuração do armazenamento. Se necessário, use o comando getStorageConfig para recuperar a lista de bancos de dados, collections e visualizações válidos na configuração de armazenamento.
Motivo: Tentando remover uma collection criada pela função curinga da collection (collectionName()).
{ ok: 0, errmsg: "cannot drop a collection created from a wildcard", code: 26, codeName: "NamespaceNotFound" }
Solução: certifique-se de que a collection que você está descartando não seja uma collection individual gerada dinamicamente pela função de collection de curinga (collectionName()). O Data Federation não aceita descartar collections individuais geradas pela função de collection de curinga.