Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Consultar dados federados
/
Administração
/
Gerenciar a configuração

drop

Nesta página

  • Sintaxe
  • Parâmetros
  • Saída
  • Exemplos
  • Exemplos de collections descartadas
  • Exemplo de visualizações descartadas
  • Solução de problemas de erros

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 pelafunçã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?
<collection-name>
string

O nome da collection a ser descartada, ou o curinga "*". Você pode especificar o curinga "*" para descartar:

  • Todas as collections geradas pela função de collection curinga collectionName()

  • A regra da collection 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 obter soluções recomendadas.

{ "ok" : 1, "ns" : "<database>.<collection>", "nIndexesWas" : 0 }

onde:

  • ns reflete 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>.

  • nIndexesWas reflete o número de índices, cujo valor é sempre 0 no Data Federation.

O comando imprime a seguinte saída 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:

  • ns reflete o namespace de visualização, que inclui o nome do banco de dados, o separador de ponto (.) e o nome de visualização. Por exemplo: <database>.<view>.

  • nIndexesWas reflete o número de índices, cujo valor é sempre 0 no Data Federation.

Exemplos

Exemplos de collections descartadas

Os exemplos abaixo usam o drop comando para remover collections de amostras que foram mapeadas para o conjunto de dados de amostra, airbnb e condições meteorológicas, na loja 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.

Voltar

Renomear collections