Sauvegarde de collections à l'aide de snapshots - Amazon OpenSearch Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Sauvegarde de collections à l'aide de snapshots

Les snapshots sont point-in-time des sauvegardes de vos collections Amazon OpenSearch Serverless qui fournissent des fonctionnalités de reprise après sinistre. OpenSearch Serverless crée et gère automatiquement des instantanés de vos collections, garantissant ainsi la continuité des activités et la protection des données. Chaque instantané contient des métadonnées d'index (paramètres et mappages pour vos index), des métadonnées de cluster (modèles d'index et alias) et des données d'index (tous les documents et données stockés dans vos index).

OpenSearch Serverless fournit des sauvegardes automatiques toutes les heures sans configuration manuelle, sans frais de maintenance, sans frais de stockage supplémentaires, avec une restauration rapide en cas de perte de données accidentelle et la possibilité de restaurer des index spécifiques à partir d'un instantané.

Avant de travailler avec des instantanés, prenez connaissance de ces considérations importantes. La création d'un instantané prend du temps et n'est pas instantanée. Les nouveaux documents ou les mises à jour pendant la création d'un instantané ne seront pas inclus dans l'instantané. Vous pouvez restaurer les instantanés uniquement dans leur collection d'origine et non dans une nouvelle. Une fois restaurés, les index reçoivent de nouvelles UUIDs versions différentes de leurs versions d'origine. Vous ne pouvez exécuter qu'une seule opération de restauration à la fois, et vous ne pouvez pas démarrer plusieurs opérations de restauration simultanément sur la même collection. Toute tentative de restauration d'index pendant une opération de restauration active entraîne l'échec de l'opération. Lors d'une opération de restauration, vos demandes adressées aux index échouent.

Autorisations requises

Pour utiliser des instantanés, configurez les autorisations suivantes dans votre politique d'accès aux données. Pour plus d'informations sur les politiques d'accès aux données, consultezStratégies d'accès aux données ou politiques IAM.

Politique d'accès aux données APIs
aoss : DescribeSnapshot

GET /_ -automatisé cat/snapshots/aoss

OBTENEZ _snapshot/aoss-automated/snapshot/

aoss : RestoreSnapshot POST /_ /_restore snapshot/aoss-automated/snapshot
aoss : DescribeCollectionItems OBTENEZ /_cat/recovery

Vous pouvez configurer les politiques à l'aide des AWS CLI commandes suivantes :

Voici un exemple de commande CLI pour créer une politique d'accès. Dans la commande, remplacez le example contenu par vos informations spécifiques.

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." } ]'

Utilisation des instantanés

Par défaut, lorsque vous créez une nouvelle collection, OpenSearch Serverless crée automatiquement des instantanés toutes les heures. Aucune action de votre part n'est requise. Chaque instantané inclut tous les index de la collection. Une fois que OpenSearch Serverless a créé des instantanés, vous pouvez les répertorier et consulter les détails de l'instantané à l'aide des procédures suivantes.

Répertorier les instantanés

Utilisez les procédures suivantes pour répertorier tous les instantanés d'une collection et vérifier leurs détails.

Console
  1. Ouvrez la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/.

  2. Dans le volet de navigation de gauche, choisissez Serverless, puis Collections.

  3. Choisissez le nom de votre collection pour ouvrir sa page de détails.

  4. Choisissez l'onglet Instantanés pour afficher tous les instantanés générés.

  5. Passez en revue les informations de l'instantané, notamment :

    • ID de capture d'écran : identifiant unique pour l'instantané

    • État - État actuel (disponible, en cours)

    • Heure de création : date à laquelle le cliché a été pris

AWS CLI
  • Utilisez la commande suivante pour répertorier tous les instantanés d'une collection :

    GET /_cat/snapshots/aoss-automated

    OpenSearch Serverless renvoie une réponse semblable à la suivante :

    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

Obtenir des informations sur les instantanés

Utilisez les procédures suivantes pour récupérer des informations détaillées sur un instantané spécifique.

Console
  1. Ouvrez la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/.

  2. Dans le volet de navigation de gauche, choisissez Serverless, puis Collections.

  3. Choisissez le nom de votre collection pour ouvrir sa page de détails.

  4. Choisissez l'onglet Instantanés.

  5. Choisissez l'ID de la tâche de capture instantanée pour afficher des informations détaillées sur la capture instantanée, notamment les métadonnées, les index inclus et les informations temporelles.

AWS CLI
  • Utilisez la commande suivante pour récupérer les informations relatives à un instantané. Dans la commande, remplacez le example contenu par vos informations spécifiques.

    GET _snapshot/aoss-automated/snapshot/

    Exemple de demande :

    GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/

    Exemple de réponse :

    { "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 } } ] }

La réponse instantanée inclut plusieurs champs clés : id fournit un identifiant unique pour l'opération de capture instantanée, status renvoie l'état actuel SUCCESS ou IN_PROGRESS duration indique le temps nécessaire pour terminer l'opération de capture instantanée et indexes renvoie le nombre d'index inclus dans l'instantané.

Restaurer à partir d’un instantané

La restauration à partir d'un instantané permet de récupérer les données d'une sauvegarde effectuée précédemment. Ce processus est crucial pour la reprise après sinistre et la gestion des données en mode OpenSearch Serverless. Avant de procéder à la restauration, sachez que les index restaurés seront différents de leurs versions d'origine, UUIDs que les instantanés ne peuvent être restaurés que dans leur collection d'origine (la restauration entre collections n'est pas prise en charge) et que les opérations de restauration auront un impact sur les performances du cluster. Planifiez donc en conséquence.

Utilisez les procédures suivantes pour restaurer des index sauvegardés à partir d'un instantané.

Console
  1. Ouvrez la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/.

  2. Dans le volet de navigation de gauche, choisissez Serverless, puis Collections.

  3. Choisissez le nom de votre collection pour ouvrir sa page de détails.

  4. Choisissez l'onglet Instantanés pour afficher les instantanés disponibles.

  5. Choisissez l'instantané à partir duquel vous souhaitez effectuer la restauration, puis choisissez Restaurer à partir d'un instantané.

  6. Dans la boîte de dialogue Restaurer à partir d'un instantané :

    • Pour le nom du snapshot, vérifiez l'ID du snapshot sélectionné.

    • Pour Snapshot Scope, choisissez l'une des options suivantes :

      • Tous les index de la collection - Restaurez tous les index à partir de l'instantané

      • Index spécifiques : sélectionnez les index individuels à restaurer

    • Pour Destination, choisissez la collection vers laquelle vous souhaitez effectuer la restauration.

    • (Facultatif) Configurez les paramètres de renommage pour renommer les index restaurés :

      • Ne pas renommer : conserver les noms d'index d'origine

      • Ajouter un préfixe aux noms d'index restaurés - Ajoutez un préfixe pour éviter les conflits

      • Renommer à l'aide d'une expression régulière - Utiliser des modèles de renommage avancés

    • (Facultatif) Configurez les paramètres de notification pour être averti lorsque la restauration est terminée ou qu'elle rencontre des erreurs.

  7. Choisissez Enregistrer pour démarrer l'opération de restauration.

  8. Surveillez la progression de la restauration dans l'onglet Activité de restauration, qui indique l'état, l'heure de début, l'heure de fin et les index concernés.

AWS CLI
  1. Exécutez la commande suivante pour identifier le snapshot approprié.

    GET /_snapshot/aoss-automated/_all

    Pour réduire la liste des instantanés, exécutez la commande suivante.

    GET /_cat/snapshots/aoss-automated
  2. Exécutez la commande suivante pour vérifier les détails du snapshot avant de le restaurer. Dans la commande, remplacez le example contenu par vos informations spécifiques.

    GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/
  3. Exécutez la commande suivante pour effectuer une restauration à partir d'un instantané spécifique.

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

    Vous pouvez personnaliser l'opération de restauration en incluant un corps de demande. Voici un exemple :

    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. Exécutez la commande suivante pour voir la progression de la restauration.

    GET /_cat/recovery
Note

Lorsque vous restaurez un instantané à l'aide d'une commande incluant un corps de requête, vous pouvez utiliser plusieurs paramètres pour contrôler le comportement de restauration. Le indexes paramètre indique les index à restaurer et prend en charge les modèles de caractères génériques. Configurez ignore_unavailable pour poursuivre l'opération de restauration même s'il manque un index dans le cliché. include_global_stateÀ utiliser pour déterminer s'il faut restaurer l'état du cluster et include_aliases pour contrôler s'il faut restaurer les alias associés. Les rename_replacement paramètres rename_pattern et renomment les index pendant l'opération de restauration.