As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Propriedade do índice: expirar AfterSeconds

Tipos de índice compatíveis

Use a AfterSeconds opção expirar para criar um índice de tempo de vida (TTL). Os índices TTL permitem que você exclua documentos com base na idade, com base na condição de tempo limite de cada documento. Quando um documento atinge a idade TTL especificada, ele é excluído da coleção.

Para obter as melhores práticas com exclusões de TTL, consulte. Workloads de TTL e séries temporais

Exemplos

Os exemplos a seguir mostram como criar índices TTL no seguinte documento de amostra:

{
  "productId": "PROD133726",
  "sku": "SKU24224",
  "name": "Basic Printer",
  "manufacturer": "The Manufacturer",
  "tags": [ "printer", "basic", "electronics", "business" ],
  "barcodes": [ "542364671", "886330670", "437445606" ],
  "reviews": [
    {
      "review_date": ISODate('2024-01-19T21:37:10.585Z'),
      "rating": 4,
      "comment": "Good product"
    },
    {
      "review_date": ISODate('2024-03-15T14:22:33.120Z'),
      "rating": 5,
      "comment": "Excellent printer"
    },
    {
      "review_date": ISODate('2024-06-08T09:45:18.890Z'),
      "rating": 3,
      "comment": "Average quality"
    }
  ],
  "material": "Polycarbonate",
  "color": "Space Gray",
  "supplier": {
    "supplierId": "SUP4",
    "location": {
      "type": "Point",
      "coordinates": [ -71.0589, 42.3601 ]
    }
  },
  "productEmbedding": [
    -0.019320633663838058,
    0.019672111388113596
  ],
  "lastUpdated": ISODate('2025-10-20T21:37:10.585Z')
}

campo único

Crie um índice TTL no LastUpdated para excluir documentos que não foram atualizados em 90 dias:

db.collection.createIndex(
  {
    "lastUpdated": 1
  },
  {
    "name": "lastUpdated_ttl",
    "expireAfterSeconds": 7776000
  }
)

tecla múltipla

Crie um índice TTL em reviews.review_date para excluir documentos que não tiveram avaliações no ano passado:

db.collection.createIndex(
  {
    "reviews.review_date": 1
  },
  {
    "name": "reviews_review_date_ttl",
    "expireAfterSeconds": 31536000
  }
)

Observe que, se o índice TTL estiver em um campo de matriz, todos os itens na matriz serão verificados. Se algum carimbo de data/hora na matriz atender à condição de tempo limite, o documento será excluído.