API de Azure Cosmos DB

Por qué varias API

Al crear una cuenta de Cosmos DB se elige la API. Esa elección decide cómo interactúa la aplicación: qué formato envía, qué lenguaje de consulta usa y con qué bibliotecas de cliente trabaja. Internamente Cosmos DB guarda los datos en su propio formato; la API es una capa de abstracción encima.

Las cinco API admitidas son NoSQL, MongoDB, Table, Apache Cassandra y Apache Gremlin. Azure Cosmos DB for PostgreSQL es una oferta aparte en proceso de retirada, no recomendada para proyectos nuevos.

API for NoSQL

Es la API nativa de Cosmos DB. Guarda los datos como documentos JSON y permite consultarlos con una sintaxis parecida a SQL. Antes se llamaba SQL API: si la documentación antigua dice «SQL API», es el mismo servicio.

SELECT *
FROM customers c
WHERE c.id = "joe@litware.com"

-- Resultado: un documento JSON
{
  "id": "joe@litware.com",
  "name": "Joe Jones",
  "address": { "street": "1 Main St.", "city": "Seattle" }
}

• Microsoft la recomienda para escenarios de gran escala que necesitan SLA del 99,999 %, escalado automático instantáneo y conmutación por error automática entre regiones.
• Admite Fabric mirroring: replica los datos operativos en Microsoft Fabric sin pipeline ETL, para analizarlos casi en tiempo real sin consumir RU ni afectar a la carga transaccional.

API for MongoDB

Compatible con los controladores y bibliotecas de cliente de MongoDB, así que las aplicaciones existentes se conectan sin cambios importantes. Los datos se guardan en BSON (JSON binario) y se consultan con MQL (MongoDB Query Language), una sintaxis orientada a objetos en la que se llama a métodos sobre colecciones.

db.products.find({id: 123})

-- Resultado
{ "id": 123, "name": "Hammer", "price": 2.99 }

API for Table

Guarda pares clave-valor en tablas con el mismo modelo de programación que Azure Table Storage. Una app de Table Storage se conecta con cambios mínimos y gana escalabilidad, distribución global e indexación automática de todas las propiedades.

Cada fila se identifica con PartitionKey + RowKey y se recupera con un punto de conexión de estilo REST, por ejemplo Customers(PartitionKey='1',RowKey='124').

API for Apache Cassandra

Compatible con Apache Cassandra, una base de código abierto con modelo de familia de columnas: las filas no tienen que contener las mismas columnas, a diferencia de una tabla relacional.

SELECT * FROM Employees WHERE ID = 2

Usa CQL (Cassandra Query Language), de sintaxis parecida a SQL. Encaja para migrar una carga de Cassandra a una base gestionada en la nube.

API for Apache Gremlin

Diseñada para datos de grafo: las entidades son vértices (nodos) y las relaciones, aristas. Útil cuando las conexiones importan tanto como los datos: redes sociales, motores de recomendación, detección de fraude y jerarquías organizativas.

g.addV('employee').property('id', '3').property('firstName', 'Alice')
g.V('3').addE('reports to').to(g.V('1'))

g.V().hasLabel('employee').order().by('id')

Gremlin es el lenguaje para recorrer y manipular el grafo: el ejemplo añade una empleada, la conecta con su responsable y luego lista los empleados ordenados.

Cómo elegir la API

Escenarios de examen

Trampas frecuentes del examen