Documentos

Azure Cosmos DB con DBine

Cómo conectar DBine a Azure Cosmos DB y qué podés hacer una vez conectado. Esta página sale de lo que el driver de Azure Cosmos DB dice de sí mismo, así que coincide con la versión de DBine que descargás.

Conectarse

  1. En DBine, abrí Nueva conexión.
  2. Elegí Azure Cosmos DB en la lista de motores.
  3. Completá los campos de abajo, apretá Probar conexión y después Guardar.

Puerto predeterminado: 443.

General

CampoDescripción
Endpoint obligatorioAPI NoSQL. Para la API de MongoDB de Cosmos DB usá el driver MongoDB con la cadena de conexión de la cuenta.
Ejemplo: https://cuenta.documents.azure.com:443/
Clave de la cuenta obligatorioSe guarda en el llavero del sistema, nunca en los archivos de DBine.
Base de datos
Solo lecturaActivado o desactivado.

Túnel SSH. La conexión puede pasar por un servidor SSH, incluso por una cadena de bastiones, con contraseña, clave privada o el agente SSH. La huella del servidor se verifica contra known_hosts o se confirma la primera vez.

SSL/TLS

CampoDescripción
Confiar en el certificado del servidorNecesario para el emulador local (certificado autofirmado).
Activado o desactivado.

Qué muestra el explorador

Debajo de la conexión: Bases de datos. Dentro de cada una:

Editor de consultas

El editor usa SQL, con autocompletado de los objetos de la conexión. Las sentencias y los comandos corren sobre la base elegida en la pestaña.

Lo que acepta el editor:

SQL de Cosmos DB sobre un contenedor. Indicá el contenedor con una directiva:
-- container: productos
SELECT TOP 10 * FROM c WHERE c.precio > 100 ORDER BY c.precio DESC
o con USE productos; o nombrándolo en el FROM: SELECT p.nombre FROM productos p.
Sentencias separadas con «;». Las consultas son entre particiones.

Además, DBine entiende estas sentencias (el JSON va tal cual lo toma la API REST):
CREATE CONTAINER [IF NOT EXISTS] "productos" {
"partitionKey": { "paths": ["/categoria"], "kind": "Hash" },
"indexingPolicy": {…}, "uniqueKeyPolicy": { "uniqueKeys": [{ "paths": ["/sku"] }] },
"defaultTtl": 3600, "throughput": 400 }   (o "autoscaleMaxThroughput": 4000)
DROP CONTAINER [IF EXISTS] "productos"
INSERT INTO "productos" { "id": "1", "categoria": "a", "precio": 10 }
UPSERT INTO "productos" { … }   (inserta o reemplaza por id y clave de partición)
UPDATE "productos" SET { "precio": 12 } WHERE { "id": "1" }   (cambia esos campos del documento)
DELETE FROM "productos" WHERE { "id": "1" }   (borra ese documento)
CREATE USER "ana" · DROP USER "ana"   (usuarios de la base, con tokens de recurso)
GRANT ALL|READ ON "productos" TO "ana" · REVOKE ALL|READ ON "productos" FROM "ana"

Plantillas listas para objetos nuevos:

Herramientas para Azure Cosmos DB

Disponibles

  • Planes de ejecución gráficos
  • Monitor del servidor
  • Uso de índices
  • Crear bases de datos
  • Eliminar bases de datos
  • Propiedades de la base
  • Diseñador visual de objetos nuevos
  • Comparar y sincronizar esquemas
  • Carga masiva nativa al migrar datos
  • Usuarios y permisos

No disponibles para Azure Cosmos DB

  • Profiler de consultas en vivo
  • Sesiones y consultas en curso
  • Terminar una sesión
  • Bloqueos: quién bloquea a quién
  • Cancelar la consulta de otra sesión desde la lista de sesiones
  • Transacciones manuales (commit y rollback)
  • Relaciones en el diagrama ER
  • Renombrar objetos
  • Clonar tablas
  • Backups

Por qué una herramienta no aplica a un motor, y el detalle de cada una, está en la referencia de soporte por motor (en inglés).

Generado a partir del driver de Azure Cosmos DB 0.1.10, que DBine descarga la primera vez que te conectás a Azure Cosmos DB.

Descargar DBineTodos los motores