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á.

Fazer backup de coleções usando snapshots

Snapshots são point-in-time backups de suas coleções Amazon OpenSearch Serverless que fornecem recursos de recuperação de desastres. OpenSearch O Serverless cria e gerencia automaticamente instantâneos de suas coleções, garantindo a continuidade dos negócios e a proteção dos dados. Cada snapshot contém metadados de índice (configurações e mapeamentos para seus índices), metadados de cluster (modelos de índice e aliases) e dados de índice (todos os documentos e dados armazenados em seus índices).

OpenSearch O Serverless fornece backups automáticos de hora em hora, sem configuração manual, sem sobrecarga de manutenção, sem custos adicionais de armazenamento, recuperação rápida da perda acidental de dados e a capacidade de restaurar índices específicos a partir de um instantâneo.

Antes de trabalhar com instantâneos, entenda essas considerações importantes. A criação de um instantâneo leva tempo para ser concluída e não é instantânea. Novos documentos ou atualizações durante a criação do instantâneo não serão incluídos no instantâneo. Você só pode restaurar os snapshots para a sua coleção original, não para uma nova coleção. Quando restaurados, os índices recebem novos UUIDs que diferem de suas versões originais. Você pode executar somente uma operação de restauração por vez e não pode iniciar várias operações de restauração na mesma coleção simultaneamente. A tentativa de restaurar índices durante uma operação de restauração ativa faz com que a operação falhe. Durante uma operação de restauração, suas solicitações aos índices falham.

Permissões obrigatórias

Para trabalhar com snapshots, configure as seguintes permissões em sua política de acesso a dados. Para saber mais sobre políticas de acesso a dados, consulte Políticas de acesso a dados versus políticas do IAM.

Você pode configurar políticas usando os seguintes AWS CLI comandos:

Aqui está um exemplo de comando da CLI para criar uma política de acesso. No comando, substitua o example conteúdo por suas informações específicas.

aws opensearchserverless create-access-policy \
--type data \
--name Example-data-access-policy \
--region aws-region \
--policy '[
  {
    "Rules": [
      {
        "Resource": [
          "collection/Example-collection"
        ],
        "Permission": [
          "aoss:DescribeSnapshot",
          "aoss:RestoreSnapshot",
          "aoss:DescribeCollectionItems"
        ],
        "ResourceType": "collection"
      }
    ],
    "Principal": [
      "arn:aws:iam::111122223333:user/UserName"
    ],
    "Description": "Data policy to support snapshot operations."
  }
]'

Trabalhar com snapshots

Por padrão, quando você cria uma nova coleção, o OpenSearch Serverless cria automaticamente instantâneos a cada hora. Medida a ser tomada Cada instantâneo inclui todos os índices da coleção. Depois que o OpenSearch Serverless criar instantâneos, você poderá listá-los e revisar os detalhes do instantâneo usando os procedimentos a seguir.

Listar instantâneos

Use os procedimentos a seguir para listar todos os instantâneos em uma coleção e revisar seus detalhes.

Console

1. Abra o console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/.

2. No painel de navegação esquerdo, escolha Sem servidor e, em seguida, selecione Coleções.

3. Escolha o nome da sua coleção para abrir a página de detalhes.

4. Escolha a guia Instantâneos para exibir todos os instantâneos gerados.

5. Analise as informações do snapshot, incluindo:

   • ID do instantâneo - Identificador exclusivo do instantâneo

   • Status - Estado atual (disponível, em andamento)

   • Hora de criação - Quando o instantâneo foi tirado

AWS CLI

• Use o comando a seguir para listar todos os instantâneos em uma coleção:

  GET /_cat/snapshots/aoss-automated

  OpenSearch O Serverless retorna uma resposta como a seguinte:

  
  id                                 status  start_epoch start_time end_epoch  end_time    duration    indexes successful_shards failed_shards total_shards
  snapshot-ExampleSnapshotID1     SUCCESS 1737964331  07:52:11   1737964382 07:53:02    50.4s       1                                             
  snapshot-ExampleSnapshotID2     SUCCESS 1737967931  08:52:11   1737967979 08:52:59    47.7s       2                                             
  snapshot-ExampleSnapshotID3     SUCCESS 1737971531  09:52:11   1737971581 09:53:01    49.1s       3                                             
  snapshot-ExampleSnapshotID4 IN_PROGRESS 1737975131  10:52:11   -          -            4.8d       3

Obtenha detalhes do instantâneo

Use os procedimentos a seguir para recuperar informações detalhadas sobre um instantâneo específico.

Console

1. Abra o console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/.

2. No painel de navegação esquerdo, escolha Sem servidor e, em seguida, selecione Coleções.

3. Escolha o nome da sua coleção para abrir a página de detalhes.

4. Escolha a guia Snapshots.

5. Escolha o ID do trabalho de snapshot para exibir informações detalhadas sobre o snapshot, incluindo metadados, índices incluídos e informações de tempo.

AWS CLI

• Use o comando a seguir para recuperar informações sobre um instantâneo. No comando, substitua o example conteúdo por suas informações específicas.

  GET _snapshot/aoss-automated/snapshot/

  Exemplo de solicitação:

  GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/

  Exemplo de resposta:

  {
      "snapshots": [
          {
              "snapshot": "snapshot-ExampleSnapshotID1-5e01-4423-9833Example",
              "uuid": "Example-5e01-4423-9833-9e9eb757Example",
              "version_id": 136327827,
              "version": "2.11.0",
              "remote_store_index_shallow_copy": true,
              "indexes": [
                  "Example-index-0117"
              ],
              "data_streams": [],
              "include_global_state": true,
              "metadata": {},
              "state": "SUCCESS",
              "start_time": "2025-01-27T09:52:11.953Z",
              "start_time_in_millis": 1737971531953,
              "end_time": "2025-01-27T09:53:01.062Z",
              "end_time_in_millis": 1737971581062,
              "duration_in_millis": 49109,
              "failures": [],
              "shards": {
                  "total": 0,
                  "failed": 0,
                  "successful": 0
              }
          }
      ]
  }

A resposta do instantâneo inclui vários campos principais: id fornece um identificador exclusivo para a operação do instantâneo, status retorna o estado atual SUCCESS ou IN_PROGRESS duration indica o tempo gasto para concluir a operação do instantâneo e indexes retorna o número de índices incluídos no instantâneo.

Restauração a partir de um snapshot

A restauração a partir de um instantâneo recupera dados de um backup feito anteriormente. Esse processo é crucial para recuperação de desastres e gerenciamento de dados no OpenSearch Serverless. Antes da restauração, entenda que os índices restaurados serão diferentes UUIDs das versões originais, os instantâneos só poderão ser restaurados na coleção original (a restauração entre coleções não é suportada) e as operações de restauração afetarão o desempenho do cluster, portanto, planeje adequadamente.

Use os procedimentos a seguir para restaurar índices de backup a partir de um snapshot.

Console

1. Abra o console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/.

2. No painel de navegação esquerdo, escolha Sem servidor e, em seguida, selecione Coleções.

3. Escolha o nome da sua coleção para abrir a página de detalhes.

4. Escolha a guia Instantâneos para exibir os instantâneos disponíveis.

5. Escolha o instantâneo do qual você deseja restaurar e, em seguida, escolha Restaurar do instantâneo.

6. Na caixa de diálogo Restaurar a partir do instantâneo:

   • Em Nome do instantâneo, verifique o ID do instantâneo selecionado.

   • Para Escopo do Snapshot, escolha uma das seguintes opções:

     • Todos os índices na coleção - Restaure todos os índices do instantâneo

     • Índices específicos - Selecione índices individuais para restaurar

   • Em Destino, escolha a coleção para a qual restaurar.

   • (Opcional) Defina as configurações de renomeação para renomear os índices restaurados:

     • Não renomeie - mantenha os nomes dos índices originais

     • Adicionar prefixo aos nomes de índices restaurados - Adicione um prefixo para evitar conflitos

     • Renomear usando expressão regular - Use padrões avançados de renomeação

   • (Opcional) Defina as configurações de notificação para ser notificado quando a restauração for concluída ou encontrar erros.

7. Escolha Salvar para iniciar a operação de restauração.

8. Monitore o progresso da restauração na guia Atividade de restauração, que mostra o status, a hora de início, a hora de conclusão e os índices afetados.

AWS CLI

1. Execute o comando a seguir para identificar o snapshot apropriado.

   GET /_snapshot/aoss-automated/_all

   Para obter uma lista menor de snapshots, execute o comando a seguir.

   GET /_cat/snapshots/aoss-automated

2. Execute o comando a seguir para verificar os detalhes do snapshot antes de restaurar. No comando, substitua o example conteúdo por suas informações específicas.

   GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/

3. Execute o comando a seguir para restaurar a partir de um snapshot específico.

   POST /_snapshot/aoss-automated/snapshot-ID/_restore

   Você pode personalizar a operação de restauração incluindo um corpo de solicitação. Aqui está um exemplo.

   POST /_snapshot/aoss-automated/snapshot-ExampleSnapshotID1-5e01-4423-9833Example/_restore
   {
     "indexes": "opensearch-dashboards*,my-index*",
     "ignore_unavailable": true,
     "include_global_state": false,
     "include_aliases": false,
     "rename_pattern": "opensearch-dashboards(.+)",
     "rename_replacement": "restored-opensearch-dashboards$1"
   }

4. Execute o seguinte comando para visualizar o progresso da restauração.

   GET /_cat/recovery