Inicio rápido: Creación de una base de datos, un contenedor y elementos de Azure Cosmos desde Azure Portal

  • Artículo
  • 9 minutos para leer

SE APLICA A: SQL API

Azure Cosmos DB es un servicio de base de datos con varios modelos y de distribución global de Microsoft. Puede usar Azure Cosmos DB para crear rápidamente una clave de consulta y bases de datos de valores, así como bases de datos de documentos y de grafos, y realizar consultas en ellas. Todas estas bases de datos se beneficiarán de las funcionalidades de distribución global y escala horizontal de Azure Cosmos DB.

En este inicio rápido se muestra cómo usar Azure Portal para crear una cuenta de SQL API de Azure Cosmos DB, crear una base de datos de documentos y un contenedor, y agregar datos a dicho contenedor.

Requisitos previos

Una suscripción a Azure o una cuenta de evaluación gratuita de Azure Cosmos DB

Creación de una cuenta de Azure Cosmos DB

  1. En el menú de Azure Portal o en la página principal, seleccione Crear un recurso.

  2. En la página Nuevos, busque y seleccione Azure Cosmos DB.

  3. En la página Azure Cosmos DB, seleccione Crear.

  4. En la página Creación de una cuenta de Azure Cosmos DB , especifique la configuración básica de la nueva cuenta de Azure Cosmos.

    Configuración Valor Descripción
    Suscripción Nombre de suscripción Seleccione la suscripción de Azure que desea usar para esta cuenta de Azure Cosmos.
    Grupo de recursos Definición de un nombre de grupo de recursos Seleccione un grupo de recursos o seleccione Crear nuevo y escriba un nombre único para el grupo de recursos nuevo.
    Nombre de cuenta Un nombre único Escriba un nombre para identificar la cuenta de Azure Cosmos. Dado que documents.azure.com se anexa al nombre que se proporciona para crear el identificador URI, debe usar un nombre único.

    El nombre solo puede contener letras minúsculas, números y el carácter de guion (-). Debe tener una longitud de entre 3 y 44 caracteres.
    API El tipo de cuenta que se va a crear Seleccione Core(SQL) para crear una base de datos de documentos y consultarla mediante la sintaxis SQL.

    La API determina el tipo de cuenta que se va a crear. Azure Cosmos DB proporciona cinco API: Core (SQL) y MongoDB para datos de documento, Gremlin para datos de gráfico, Azure Table y Cassandra. Actualmente, debe crear una cuenta independiente para cada API.

    Más información acerca de SQL API.
    Location Región más cercana a los usuarios Seleccione una ubicación geográfica para hospedar la cuenta de Azure Cosmos DB. Use la ubicación más cercana a los usuarios para que puedan acceder de la forma más rápida posible a los datos.
    Capacity mode (Modo de capacidad) Rendimiento aprovisionado o sin servidor Seleccione Provisioned throughput (Rendimiento aprovisionado) para crear una cuenta en modo de rendimiento aprovisionado. Seleccione Serverless (Sin servidor) para crear una cuenta en modo sin servidor.
    Aplicar el descuento del nivel Gratis de Azure Cosmos DB Aplicar o No aplicar Con el nivel Gratis de Azure Cosmos DB, recibirá los primeros 1000 RU/s y 25 GB de almacenamiento gratis en una cuenta. Más información acerca del nivel Gratis.

    Nota

    Puede tener una cuenta de Azure Cosmos DB de nivel Gratis por cada suscripción de Azure y debe optar por tenerla al crear la cuenta. Si no ve la opción para aplicar el descuento por nivel Gratis, significará que en otra cuenta de la suscripción ya se ha habilitado el nivel Gratis.

    Página de la nueva cuenta de Azure Cosmos DB

  5. En la pestaña Distribución global, configure los detalles siguientes. Puede dejar los valores predeterminados para este inicio rápido:

    Configuración Valor Descripción
    Redundancia geográfica Deshabilitar Habilite o deshabilite la distribución global en su cuenta. Para ello, debe emparejar su región con una región de par. Puede agregar más regiones a su cuenta más adelante.
    Escrituras en varias regiones Deshabilitar La funcionalidad de escrituras en varias regiones le permite aprovechar el rendimiento aprovisionado para sus bases de datos y contenedores de todo el mundo.

    Nota

    Las siguientes opciones no están disponibles si selecciona Serverless (Sin servidor) en Capacity mode (Modo de capacidad):

    • Aplicación de descuento por nivel Gratis
    • Redundancia geográfica
    • Escrituras en varias regiones

  6. Opcionalmente, puede configurar detalles adicionales en las pestañas siguientes:

    • Redes: configure el acceso desde una red virtual.
    • Directiva de copia de seguridad: configure una directiva de copia de seguridad periódica o continua.
    • Cifrado: use una clave administrada por el servicio o una clave administrada por el cliente.
    • Etiquetas: son pares nombre-valor que permiten categorizar los recursos y ver una facturación consolidada mediante la aplicación de la misma etiqueta en varios recursos y grupos de recursos.

  7. Seleccione Revisar + crear.

  8. Revise la configuración de la cuenta y seleccione Crear. La operación de creación de la cuenta tarda unos minutos. Espere hasta que la página del portal muestre Se completó la implementación .

    Panel de notificaciones de Azure Portal

  9. Seleccione Ir al recurso para ir a la página de la cuenta de Azure Cosmos DB.

    Página de la cuenta de Azure Cosmos DB

Adición de una base de datos y un contenedor

Para crear una base de datos y un contenedor, puede usar Data Explorer en Azure Portal.

  1. Seleccione Data Explorer en el panel de navegación izquierdo de la página de la cuenta de Azure Cosmos DB y, después, seleccione Nuevo contenedor.

    Es posible que deba desplazarse hacia la derecha para ver la ventana Agregar contenedor.

    Explorador de datos de Azure Portal, panel Agregar contenedor

  2. En el panel Agregar contenedor, especifique la configuración del nuevo contenedor.

    Configuración Valor sugerido Descripción
    Identificador de base de datos ToDoList Escriba ToDoList como nombre de la nueva base de datos. Los nombres de base de datos tienen que tener entre 1 y 255 caracteres y no pueden contener /, \\, #, ? o espacios finales. Seleccione la opción Share throughput across containers (Compartir rendimiento entre contenedores) para compartir el rendimiento aprovisionado de la base de datos entre todos los contenedores de esta. Esta opción también le ayudará a reducir los costos.
    Rendimiento de base de datos Puede aprovisionar rendimiento de escalado automático o manual. El rendimiento manual le permite escalar RU/s por su cuenta, mientras que el rendimiento de escalabilidad automática permite que el sistema escale RU/s en función del uso. En este ejemplo, seleccione Manual.

    Deje el rendimiento en 400 unidades de solicitud por segundo (RU/s). Si quiere reducir la latencia, puede escalar verticalmente el rendimiento más adelante mediante la estimación de las RU/s necesarias con la calculadora de capacidad.

    Nota: Este valor no está disponible cuando se crea un contenedor en una cuenta sin servidor.
    ID de contenedor Elementos Escriba Elementos como nombre del nuevo contenedor. Los identificadores de contenedor tienen los mismos requisitos de caracteres que los nombres de las bases de datos.
    Clave de partición /categoría El ejemplo que se describe en este artículo usa /category como clave de partición.

    En este ejemplo, no agregue claves únicas ni active el almacén analítico. Las claves únicas le permiten agregar una capa de integridad de datos a la base de datos mediante la garantía de unicidad de uno o varios valores por clave de partición. Para más información, consulte Claves únicas en Azure Cosmos DB. El almacén analítico se usa para permitir el análisis a gran escala de datos operativos sin ningún efecto sobre las cargas de trabajo transaccionales.

  3. Seleccione Aceptar. Data Explorer muestra la nueva base de datos y el contenedor que ha creado.

Adición de datos a la base de datos

Agregue datos a una base de datos nueva mediante Data Explorer.

  1. En Data Explorer, expanda la base de datos ToDoList y el contenedor Items. A continuación, seleccione Elementos y, después, Nuevo elemento.

    Creación de documentos en el Explorador de datos En Azure Portal

  2. Agregue la siguiente estructura al documento de la derecha del panel Documentos:

    {
    "id": "1",
    "category": "personal",
    "name": "groceries",
    "description": "Pick up apples and strawberries.",
    "isComplete": false
}

  3. Seleccione Guardar.

    Copiar los datos JSON y seleccionar Guardar en el Explorador de datos en Azure Portal

  4. Vuelva a seleccionar Nuevo documento y cree y guarde otro documento con un valor de id único y las restantes propiedades y valores que desee. Los documentos pueden tener cualquier estructura, ya que Azure Cosmos DB no impone ningún esquema en los datos.

Consulta de los datos

Ahora puede usar consultas en Data Explorer para recuperar y filtrar los datos.

  1. En la parte superior de la pestaña Elementos de Data Explorer, examine la consulta predeterminada SELECT * FROM c. Esta consulta recupera y muestra todos los documentos del contenedor ordenados por identificador.

    La consulta predeterminada del Explorador de datos es SELECT * FROM c

  2. Para cambiar la consulta, seleccione Editar filtro, reemplace la consulta predeterminada por ORDER BY c._ts DESCy, después, seleccione Aplicar filtro.

    Cambiar la consulta predeterminada mediante la incorporación de ORDER BY c._ts DESC y haciendo clic en Aplicar filtro

    Esta consulta modificada muestra los documentos en orden descendente según su marca de tiempo, por lo que ahora el segundo documento aparece en primer lugar.

    Consulta cambiada a ORDER BY c._ts DESC y clic en Aplicar filtro

Si está familiarizado con la sintaxis de SQL, puede especificar cualquiera de las consultas SQL admitidas en el cuadro de predicado de consulta. También puede usar Data Explorer para crear procedimientos almacenados, UDF y desencadenadores para la lógica de negocios del servidor.

Data Explorer proporciona un acceso sencillo en Azure Portal a todas las características de acceso a datos mediante programación integrado que está disponible en las API. Use también el portal para escalar el rendimiento, obtener las claves y cadenas de conexión, y revisar las métricas y los contratos de nivel de servicio de la cuenta de Azure Cosmos DB.

Limpieza de recursos

Cuando haya terminado tanto con la aplicación como con la cuenta de Azure Cosmos DB, puede eliminar los recursos de Azure que creó para no tener más gastos. Para eliminar los recursos:

  1. En la barra de búsqueda de Azure Portal, busque y seleccione Grupos de recursos.

  2. En la lista, seleccione el grupo de recursos que creó para este inicio rápido.

    Selección del grupo de recursos que se eliminará

  3. En la página Información general del grupo de recursos, seleccione Eliminar grupo de recursos.

    Eliminar el grupo de recursos

  4. En la ventana siguiente, escriba el nombre del grupo de recursos que desea eliminar y, después, seleccione Eliminar.

Si desea eliminar solo la base de datos y usar la cuenta de Azure Cosmos en el futuro, puede eliminar la base de datos con los pasos siguientes:

  • Vaya a la cuenta de Azure Cosmos.
  • Abra Explorador de datos, haga clic con el botón derecho en la base de datos que desee eliminar y seleccione Eliminar base de datos.
  • Escriba el nombre de la base de datos o su identificador para confirmar la eliminación.

Pasos siguientes

En esta guía de inicio rápido ha aprendido a crear una cuenta de Azure Cosmos DB, una base de datos y un contenedor con el Explorador de datos. Ahora puede importar datos adicionales en la cuenta de Azure Cosmos DB.

¿Intenta planear la capacidad para una migración a Azure Cosmos DB? Para ello, puede usar información sobre el clúster de base de datos existente.

Importación de datos a Azure Cosmos DB