Amazon DocumentDB avec DBine
Comment connecter DBine à Amazon DocumentDB et ce que vous pouvez faire une fois connecté. Cette page est générée à partir de ce que le pilote Amazon DocumentDB dit de lui-même : elle correspond donc à la version de DBine que vous téléchargez.
Se connecter
- Dans DBine, ouvrez Nouvelle connexion.
- Choisissez Amazon DocumentDB dans la liste des moteurs.
- Remplissez les champs ci-dessous, cliquez sur Tester la connexion puis sur Enregistrer.
Port par défaut : 27017.
Général
| Champ | Description |
|---|---|
| Serveur | Plusieurs membres séparés par des virgules : host1:27017,host2:27017. Exemple : mon-cluster.cluster-xxxx.us-east-1.docdb.amazonaws.com |
| Port | |
| Base de données | Base initiale ; vide = celle de la chaîne de connexion ou « test ». |
| Utilisateur | |
| Mot de passe | Conservé dans le trousseau du système, jamais dans les fichiers de DBine. |
| Chaîne de connexion | Si renseigné, il remplace les autres champs. Exemple : mongodb://utilisateur:motdepasse@cluster.docdb.amazonaws.com:27017/?tls=true&replicaSet=rs0&retryWrites=falseConservé dans le trousseau du système, jamais dans les fichiers de DBine. |
| Lecture seule | Activé ou désactivé. |
Tunnel SSH. La connexion peut passer par un serveur SSH, même par une chaîne de bastions, avec un mot de passe, une clé privée ou l’agent SSH. L’empreinte du serveur est vérifiée dans known_hosts ou confirmée la première fois.
SSL/TLS
| Champ | Description |
|---|---|
| Chiffrer la connexion (TLS) | Activé ou désactivé. |
| Faire confiance au certificat du serveur | Nécessaire si vous vous connectez via un tunnel (le certificat ne correspond pas à localhost). Activé ou désactivé. |
| Certificat de l'AC d'AWS | Le bundle d'AC d'Amazon RDS/DocumentDB (global-bundle.pem), téléchargeable depuis la documentation AWS. Un fichier de cet ordinateur. Exemple : global-bundle.pem |
Avancé
| Champ | Description |
|---|---|
| Base d'authentification | Exemple : admin |
| Replica set | rs0 pour se connecter au cluster ; vide = connexion directe à l'instance (utile avec un tunnel SSH). Exemple : rs0 |
Ce que montre l’explorateur
Sous la connexion : Bases de données. Dans chacune :
- Collections
- Vues
Éditeur de requêtes
L’éditeur utilise la syntaxe de requête de Amazon DocumentDB, en JSON, avec la complétion des objets de la connexion. Les instructions et les commandes s’exécutent sur la base choisie dans l’onglet.
Ce que l’éditeur accepte :
Syntaxe de type mongosh, une instruction par ligne ou séparées par `;` :
db.collection.find({ age: { $gt: 30 } }, { nom: 1 }).sort({ age: -1 }).limit(10)
db.collection.aggregate([{ $group: { _id: "$ville", n: { $sum: 1 } } }])
db.collection.countDocuments({}) · db.collection.distinct("champ", {})
db.collection.insertOne({…}) · updateMany(filtre, { $set: {…} }) · deleteOne(filtre)
db.getCollectionNames() · db.runCommand({ dbStats: 1 })
db.createCollection("c", { capped: true, size: 4096 }) · db.createView("v", "c", [{ $match: {} }])
db.getCollection("c").createIndex({ champ: 1, date: -1 }, { unique: true }) · dropIndex("champ_1") · db.dropDatabase()
Extension de DBine : db.createCollection("c", {…}, { ifNotExists: true }) n'échoue pas si la collection existe déjà.
Une commande brute en JSON est aussi acceptée : { "find": "collection", "filter": {} }.
Clés sans guillemets, guillemets simples, ObjectId("…"), ISODate("…"), NumberLong(…) et /regex/i.Modèles prêts à l’emploi pour les nouveaux objets :
- Nouvelle vue
- Nouvelle série temporelle
- Nouvelle collection capped
- Modifier le validateur ($jsonSchema)
- Nouvel index
Outils pour Amazon DocumentDB
Disponibles
- Plans d’exécution graphiques
- Profileur de requêtes en direct
- Moniteur du serveur
- Sessions et requêtes en cours
- Fermer une session
- Verrous : qui bloque qui
- Annuler la requête d’une autre session depuis la liste des sessions
- Utilisation des index
- Créer des bases de données
- Supprimer des bases de données
- Propriétés de la base
- Concepteur visuel de nouveaux objets
- Renommer des objets
- Comparer et synchroniser des schémas
- Chargement en masse natif lors de la migration des données
- Utilisateurs et permissions
Non disponibles pour Amazon DocumentDB
- Transactions manuelles (commit et rollback)
- Relations dans le diagramme ER
- Cloner des tables
- Sauvegardes
Pourquoi un outil ne s’applique pas à un moteur, et le détail de chacun, se trouvent dans la référence de prise en charge par moteur (en anglais).
Généré à partir du pilote Amazon DocumentDB 0.1.12, que DBine télécharge la première fois que vous vous connectez à Amazon DocumentDB.