Documentali

Azure Cosmos DB con DBine

Come connettere DBine a Azure Cosmos DB e cosa puoi fare una volta connesso. Questa pagina nasce da ciò che il driver di Azure Cosmos DB dice di sé, quindi corrisponde alla versione di DBine che scarichi.

Connettersi

  1. In DBine, apri Nuova connessione.
  2. Scegli Azure Cosmos DB nell’elenco dei motori.
  3. Compila i campi qui sotto, premi Prova connessione e poi Salva.

Porta predefinita: 443.

Generale

CampoDescrizione
Endpoint obbligatorioAPI NoSQL. Per l'API MongoDB di Cosmos DB usa il driver MongoDB con la stringa di connessione dell'account.
Esempio: https://account.documents.azure.com:443/
Chiave dell'account obbligatorioConservato nel portachiavi di sistema, mai nei file di DBine.
Database
Sola letturaAttivo o disattivo.

Tunnel SSH. La connessione può passare da un server SSH, anche attraverso una catena di bastion host, con password, chiave privata o l’agente SSH. L’impronta del server viene verificata in known_hosts o confermata la prima volta.

SSL/TLS

CampoDescrizione
Considera attendibile il certificato del serverNecessario per l'emulatore locale (certificato autofirmato).
Attivo o disattivo.

Cosa mostra l’explorer

Sotto la connessione: Database. Dentro ciascuno:

Editor di query

L’editor usa SQL, con il completamento degli oggetti della connessione. Le istruzioni e i comandi vengono eseguiti sul database scelto nella scheda.

Cosa accetta l’editor:

SQL di Cosmos DB su un contenitore. Indica il contenitore con una direttiva:
-- container: prodotti
SELECT TOP 10 * FROM c WHERE c.prezzo > 100 ORDER BY c.prezzo DESC
oppure con USE prodotti; o indicandolo nel FROM: SELECT p.nome FROM prodotti p.
Istruzioni separate da «;». Le query sono tra partizioni.

Inoltre, DBine comprende queste istruzioni (il JSON va esattamente come lo riceve l'API REST):
CREATE CONTAINER [IF NOT EXISTS] "prodotti" {
"partitionKey": { "paths": ["/categoria"], "kind": "Hash" },
"indexingPolicy": {…}, "uniqueKeyPolicy": { "uniqueKeys": [{ "paths": ["/sku"] }] },
"defaultTtl": 3600, "throughput": 400 }   (oppure "autoscaleMaxThroughput": 4000)
DROP CONTAINER [IF EXISTS] "prodotti"
INSERT INTO "prodotti" { "id": "1", "categoria": "a", "prezzo": 10 }
UPSERT INTO "prodotti" { … }   (inserisce o sostituisce per id e chiave di partizione)
UPDATE "prodotti" SET { "prezzo": 12 } WHERE { "id": "1" }   (modifica questi campi del documento)
DELETE FROM "prodotti" WHERE { "id": "1" }   (elimina questo documento)
CREATE USER "ana" · DROP USER "ana"   (utenti del database, con token di risorsa)
GRANT ALL|READ ON "prodotti" TO "ana" · REVOKE ALL|READ ON "prodotti" FROM "ana"

Modelli pronti per i nuovi oggetti:

Strumenti per Azure Cosmos DB

Disponibili

  • Piani di esecuzione grafici
  • Monitor del server
  • Uso degli indici
  • Creare database
  • Eliminare database
  • Proprietà del database
  • Designer visuale di nuovi oggetti
  • Confrontare e sincronizzare schemi
  • Caricamento massivo nativo durante la migrazione dei dati
  • Utenti e permessi

Non disponibili per Azure Cosmos DB

  • Profiler delle query in tempo reale
  • Sessioni e query in corso
  • Terminare una sessione
  • Lock: chi blocca chi
  • Annullare la query di un’altra sessione dall’elenco delle sessioni
  • Transazioni manuali (commit e rollback)
  • Relazioni nel diagramma ER
  • Rinominare oggetti
  • Clonare tabelle
  • Backup

Perché uno strumento non si applica a un motore, e i dettagli di ciascuno, sono nel riferimento sul supporto per motore (in inglese).

Generato dal driver di Azure Cosmos DB 0.1.10, che DBine scarica la prima volta che ti connetti a Azure Cosmos DB.

Scarica DBineTutti i motori