cloneCollectionAsCapped
Nesta página
Definição
cloneCollectionAsCappedO comando
cloneCollectionAsCappedcria uma novacapped collection a partir de uma collection existente e sem limite dentro do mesmo banco de dados. A operação não afeta a collection original sem limite.
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. |
Escreva preocupaçã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 .
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.