Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

cloneCollectionAsCapped

Nesta página

  • Definição
  • Compatibilidade
  • Sintaxe
  • Comportamento
cloneCollectionAsCapped

O comando cloneCollectionAsCapped cria uma novacollection limitada a partir de uma collection existente e sem collection limitada no mesmo banco de dados de dados. A operação não afeta a collection limitada.

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Importante

Esse comando não é aceito em clusters M0, M2 e M5 ou em instâncias sem servidor. Para obter mais informações, consulte Comandos não suportados.

  • MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

  • MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

O comando tem a seguinte sintaxe:

db.runCommand(
{
cloneCollectionAsCapped: <existing collection>,
toCollection: <capped collection>,
size: <capped size>,
writeConcern: <document>,
comment: <any>
}
)

O comando utiliza os seguintes campos:

Campo
Descrição
cloneCollectionAsCapped
O nome da collection existente a ser copiada.
para a Coleção

O nome da nova collection limitada a ser criada.

O nome da nova capped collection deve ser distinto e não pode ser igual ao da collection original existente.

Tamanho
O tamanho máximo, em bytes, para a collection limitada.
writeConcern
Opcional. Um documento que Express a drop referência de escrita do comando . Omita para usar a referência de escrita padrão.
comment

Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais:

Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).

O comando copia um existing collection e cria um novo capped collection com um tamanho máximo especificado pelo capped size em bytes.

Para substituir a original collection sem limite por uma collection limitada, use o comando convertToCapped .

Se o capped size for menor que o tamanho da collection de origem, nem todos os documentos da collection de origem existirão na capped collection de destino.

Isso mantém uma trava exclusiva do banco de dados durante a operação. Outras operações que travam o mesmo banco de dados serão bloqueadas até a operação ser concluída. Consulte Quais travas são feitas por algumas operações comuns do cliente? para saber quais operações travam o banco de dados.

Voltar

bulkWrite