Revisión de las operaciones básicas

  • 5 minutos

Hay algunas operaciones básicas que tendrá que realizar cada vez que cree cualquier recurso de cuenta de Azure Cosmos DB for NoSQL en Azure.

Creación de una cuenta

El primer paso para empezar a trabajar con Azure Cosmos DB es crear una cuenta.

Al crear una cuenta en el portal, primero debe seleccionar una API para la carga de trabajo. No se puede cambiar la selección de la API después de crear la cuenta. En el resto de esta sección, se asumirá que ha seleccionado la API NoSQL.

Captura de pantalla en la que se muestra la selección de la opción de la API en el portal con una lista de todas las API actuales, incluidas SQL, MongoDB, Graph, Table y Cassandra.

A continuación, Azure Portal usará un asistente paso a paso con pestañas para varias opciones de configuración. Aquí puede configurar opciones como las siguientes:

  • Nombre único global de la cuenta
  • Ubicación (región de Azure) de la cuenta
  • Modo de capacidad (rendimiento aprovisionado o sin servidor)

Captura de pantalla en la que se muestra el asistente con varias pestañas y opciones para crear una cuenta de Azure Cosmos DB for NoSQL.

Nota:

Solo se necesitan las opciones de la pestaña Aspectos básicos para crear una cuenta de Azure Cosmos DB.

Crear una base de datos

Las bases de datos son unidades lógicas de administración en Azure Cosmos DB for NoSQL y no necesitan mucho para crearse. Solo necesita un nombre de base de datos único en la cuenta para crear una base de datos.

Nota:

Sin embargo, si decide aprovisionar el rendimiento en el nivel de base de datos, la configuración de la base de datos puede requerir pasos adicionales. Esto se explora con más detalle en otros temas de Azure Cosmos DB for NoSQL.

Creación de un contenedor

Los contenedores son la unidad principal de escalabilidad en Azure Cosmos DB for NoSQL. Al crear un contenedor, debe especificar lo siguiente:

  • La base de datos principal
  • Un nombre único para el contenedor con la base de datos
  • La ruta de acceso para el valor de la clave de partición
  • Opcional: rendimiento aprovisionado si no usa una cuenta sin servidor.

El servicio Azure Cosmos DB dividirá los datos de forma automática y transparente en función del valor de la clave de partición para cada elemento individual.

Creación de elementos simples

Una vez que existan los recursos de la base de datos y del contenedor, podrá crear su primer elemento. Azure Cosmos DB for NoSQL, un elemento es un documento JSON.

Nota:

La notación de objetos JavaScript (JSON) es un formato de archivo estándar abierto y un formato de intercambio de datos que utiliza texto legible por humanos para almacenar y transmitir objetos de datos que consisten en pares valor-atributo y tipos de datos de matriz (o cualquier otro valor serializable).

JSON es un formato de datos independiente del lenguaje con tipos de datos bien definidos y compatibilidad casi universal en una amplia gama de servicios y lenguajes de programación. Este es un ejemplo de un documento JSON que podría ser un elemento de una cuenta de Azure Cosmos DB:

{
  "id": "0012D555-C7DE",
  "type": "customer",
  "fullName": "Franklin Ye",
  "title": null,
  "emailAddress": "fye@cosmic.works",
  "creationDate": "2014-02-05",
  "addresses": [
    {
      "addressLine": "1796 Westbury Drive",
      "cityStateZip": "Melton, VIC 3337 AU"
    },
    {
      "addressLine": "9505 Hargate Court",
      "cityStateZip": "Bellflower, CA 90706 US"
    }
  ],
  "password": {
    "hash": "GQF7qjEgMk=",
    "salt": "12C0F5A5"
  },
  "salesOrderCount": 2
}