Azure Cosmos DB avec DBine
Comment connecter DBine à Azure Cosmos DB et ce que vous pouvez faire une fois connecté. Cette page est générée à partir de ce que le pilote Azure Cosmos DB 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 Azure Cosmos DB dans la liste des moteurs.
- Remplissez les champs ci-dessous, cliquez sur Tester la connexion puis sur Enregistrer.
Port par défaut : 443.
Général
| Champ | Description |
|---|---|
| Endpoint obligatoire | API NoSQL. Pour l'API MongoDB de Cosmos DB, utilisez le pilote MongoDB avec la chaîne de connexion du compte. Exemple : https://compte.documents.azure.com:443/ |
| Clé du compte obligatoire | Conservé dans le trousseau du système, jamais dans les fichiers de DBine. |
| Base de données | |
| 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 |
|---|---|
| Faire confiance au certificat du serveur | Nécessaire pour l'émulateur local (certificat auto-signé). Activé ou désactivé. |
Ce que montre l’explorateur
Sous la connexion : Bases de données. Dans chacune :
- Conteneurs
Éditeur de requêtes
L’éditeur utilise SQL, 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 :
SQL de Cosmos DB sur un conteneur. Indiquez le conteneur avec une directive :
-- container: produits
SELECT TOP 10 * FROM c WHERE c.prix > 100 ORDER BY c.prix DESC
ou avec USE produits ; ou en le nommant dans le FROM : SELECT p.nom FROM produits p.
Instructions séparées par «;». Les requêtes sont inter-partitions.
En outre, DBine comprend ces instructions (le JSON est transmis tel que l'API REST le reçoit) :
CREATE CONTAINER [IF NOT EXISTS] "produits" {
"partitionKey": { "paths": ["/categorie"], "kind": "Hash" },
"indexingPolicy": {…}, "uniqueKeyPolicy": { "uniqueKeys": [{ "paths": ["/sku"] }] },
"defaultTtl": 3600, "throughput": 400 } (ou "autoscaleMaxThroughput": 4000)
DROP CONTAINER [IF EXISTS] "produits"
INSERT INTO "produits" { "id": "1", "categorie": "a", "prix": 10 }
UPSERT INTO "produits" { … } (insère ou remplace selon l'id et la clé de partition)
UPDATE "produits" SET { "prix": 12 } WHERE { "id": "1" } (modifie ces champs du document)
DELETE FROM "produits" WHERE { "id": "1" } (supprime ce document)
CREATE USER "ana" · DROP USER "ana" (utilisateurs de la base, avec des jetons de ressource)
GRANT ALL|READ ON "produits" TO "ana" · REVOKE ALL|READ ON "produits" FROM "ana"Modèles prêts à l’emploi pour les nouveaux objets :
- Nouveau conteneur avec clé hiérarchique
- Nouveau conteneur avec mise à l'échelle automatique
Outils pour Azure Cosmos DB
Disponibles
- Plans d’exécution graphiques
- Moniteur du serveur
- 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
- Comparer et synchroniser des schémas
- Chargement en masse natif lors de la migration des données
- Utilisateurs et permissions
Non disponibles pour Azure Cosmos DB
- Profileur de requêtes en direct
- 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
- Transactions manuelles (commit et rollback)
- Relations dans le diagramme ER
- Renommer des objets
- 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 Azure Cosmos DB 0.1.10, que DBine télécharge la première fois que vous vous connectez à Azure Cosmos DB.