View a markdown version of this page

Guide de programmation Java pour Amazon DocumentDB - Amazon DocumentDB

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.

Guide de programmation Java pour Amazon DocumentDB

Ce guide complet explique en détail comment utiliser Amazon DocumentDB à l'aide des pilotes Java de MongoDB. Il couvre les aspects essentiels du fonctionnement et de la gestion des bases de données.

Introduction

Le guide commence par la connectivité et explique comment établir des connexions sécurisées aux clusters DocumentDB à l'aide du pilote Java MongoDB. Il détaille les composants de la chaîne de connexion, la SSL/TLS mise en œuvre et les différentes options de connexion, notamment l'authentification IAM et le regroupement de connexions, ainsi que des stratégies robustes de gestion des erreurs.

Dans la section des opérations CRUD (créer, lire, mettre à jour, supprimer), le guide aborde en détail la manipulation de documents et explique comment créer, lire, mettre à jour et supprimer des documents à l'aide d'opérations uniques et groupées. Il explique l'utilisation de filtres, de requêtes et de diverses options de fonctionnement, tout en mettant l'accent sur les meilleures pratiques en matière de gestion des erreurs et de mise en œuvre d'une logique de nouvelle tentative pour une fiabilité accrue. Le guide couvre également de manière approfondie la gestion des index, en détaillant la création et la maintenance de différents types d'index, notamment les index à champ unique, composés, épars et textuels. Il explique comment optimiser les performances des requêtes grâce à une sélection d'index appropriée et à l'utilisation de la explain() fonction pour analyser les plans d'exécution des requêtes.

La dernière section se concentre sur la programmation pilotée par les événements à l'aide des flux de modifications d'Amazon DocumentDB, et montre comment implémenter la surveillance des modifications de données en temps réel dans les applications Java. Il couvre la mise en œuvre de curseurs de flux de modifications, la gestion des jetons de reprise pour un fonctionnement continu et les opérations temporelles pour le traitement des données historiques. Tout au long du guide, des exemples de code pratiques et des bonnes pratiques sont fournis, ce qui en fait une ressource précieuse pour vous lorsque vous créez des applications Java robustes avec Amazon DocumentDB.

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Modèles de données pour ce guide

Tous les exemples de code de ce guide supposent une connexion à une base de données de test « ProgGuideData » contenant une collection « Restaurants ». Tous les exemples de codes de ce guide fonctionnent sur un système de liste de restaurants. Vous trouverez ci-dessous un exemple de ce à quoi ressemble un document dans ce système :

{ "_id": "ab6ad8f119b5bca3efa2c7ae", "restaurantId": "REST-CRT9BL", "name": "Thai Curry Palace", "description": "Amazing Restaurant, must visit", "cuisine": "Thai", "address": { "street": "914 Park Street", "city": "Bryan", "state": "AL", "zipCode": "96865", "location": { "type": "Point", "coordinates": [-25.4619, 8.389] } }, "contact": { "phone": "(669) 915-9056 x6657" }, "rating": { "average": 3.4, "totalReviews": 275 }, "priceRange": "$", "menu": [{ "category": "Appetizers", "items": [{ "name": "Buffalo Chicken Wings", "price": 13.42 }] }], "features": [ "Private Dining" ], "isActive": false“ michelin”: {“ star”: 3, “ranking_years”: 4 } }

Tous les exemples de code illustrant le CRUD, la gestion des index et la programmation pilotée par les événements supposent que vous avez un MongoClient objetdbClient, un MongoDatabase objet connectionDB et un objet. MongoCollection collection

Note

Tous les exemples de code de ce guide ont été testés avec la version 5.3.0 du pilote Java MongoDB.