cloneCollectionAsCapped

Nesta página

Definição

Compatibilidade
Sintaxe
Comportamento

Definição

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.

Compatibilidade

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

Sintaxe

O comando tem a seguinte sintaxe:

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

Campos de comando

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: mensagens de log do mongod, no campo `attr.command.cursor.comment`. Saída do perfil do banco de dados, no campo `command.comment`. Saída de `currentOp`, no campo `command.comment`. 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 .

Comportamento

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

Administração

CollMod