O comando drop remove a collection ou exibição especificada da configuração de armazenamento da instância do banco de dados federado. Use o curinga "*" para remover todas as collections geradas pela função de collection de curinga (ou seja, collectionName()), incluindo a própria regra de collection de curinga. Você não pode remover collections geradas pela função de collection de curinga de forma individual.
Sintaxe
db.runCommand({ "drop" : "<collection-name|*>" })
db.runCommand({ "drop" : "<view-name>" })
Parâmetros
Parâmetro | Tipo | Descrição | Obrigatório? |
|---|---|---|---|
| string | O nome da collection a ser descartada, ou o curinga
| sim |
Parâmetro | Tipo | Descrição | Obrigatório? |
|---|---|---|---|
| string | O nome da visualização a ser descartada. | sim |
Saída
The command prints the following output if it succeeds. You can verify the results by running the show collections command. If the command fails, see Troubleshoot Errors for recommended solutions.
{ "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.
The command prints the following output if it succeeds. You can verify the results by running the storageGetConfig command. If the command fails, see Troubleshoot Errors for recommended solutions.
{ "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 comando drop para remover coleções de amostras que foram mapeadas para o conjunto de dados da amostra, airbnb e weather, no armazenamento do 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 abaixo remove uma exibição chamada "listings" na collection airbnb no banco de dados sample:
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.