Ejemplos de Go de Azure Cosmos DB

SE APLICA A: NoSQL

En el repositorio de GitHub azure-documentdb-go se incluyen soluciones de ejemplo que realizan operaciones CRUD y otras operaciones comunes sobre recursos de Azure Cosmos DB. Este artículo ofrece:

• Vínculos a las tareas de cada uno de los archivos de proyecto de ejemplo de Go.
• Vínculos al contenido de referencia de la API relacionada.

Requisitos previos

• Una cuenta de Azure Cosmos DB. Tendrá las siguientes opciones:
  • Dentro de una suscripción activa de Azure:
    • Cree una cuenta gratuita de Azure o use la suscripción existente
    • Créditos mensuales de Visual Studio
    • Nivel gratis de Azure Cosmos DB
  • Sin una suscripción activa de Azure:
    • Pruebe Azure Cosmos DB gratis, un entorno de pruebas que dura 30 días.
    • Emulador de Azure Cosmos DB
• Go instalado en el equipo y conocimientos de cómo funciona.
• Visual Studio Code.
• Extensión Go para Visual Studio Code.
• Git.
• SDK de Azure Cosmos DB for NoSQL para Go

Ejemplos de base de datos

Para obtener información sobre las bases de datos de Azure Cosmos DB antes de ejecutar los siguientes ejemplos, consulte el artículo conceptual Uso de bases de datos, contenedores y elementos.

Tarea	Referencia de API
Creación de una base de datos	Client.CreateDatabase
Lectura de una base de datos por identificador	Client.NewDatabase
Eliminación de una base de datos	DatabaseClient.Delete

Ejemplos de contenedor

Para información sobre las colecciones de Azure Cosmos DB antes de ejecutar los siguientes ejemplos, consulte el artículo conceptual Uso de bases de datos, contenedores y elementos.

Tarea	Referencia de API
Creación de un contenedor	DatabaseClient.CreateContainer
Obtención de un contenedor por su identificador	DatabaseClient.NewContainer
Eliminación de un contenedor	ContainerClient.Delete

Ejemplos de elementos

En el ejemplo cosmos_container.go de Go, se muestra cómo realizar las siguientes tareas. Para información sobre los documentos de Azure Cosmos DB antes de ejecutar los ejemplos siguientes, consulte el artículo conceptual Uso de bases de datos, contenedores y elementos.

Tarea	Referencia de API
Creación de un elemento en un contenedor	ContainerClient.CreateItem
Lectura de un elemento por su identificador	ContainerClient.ReadItem
Elementos de consulta	ContainerClient.NewQueryItemsPager
Reemplazo de un elemento	ContainerClient.ReplaceItem
Realización de una operación upsert en un elemento	ContainerClient.UpsertIitem
Eliminación de un elemento	ContainerClient.DeleteItem

Pasos siguientes

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

• Si lo único que sabe es el número de núcleos virtuales y servidores del clúster de bases de datos existente, lea sobre el cálculo de unidades de solicitud mediante núcleos o CPU virtuales.
• Si conoce las tasas de solicitudes típicas de la carga de trabajo de la base de datos actual, obtenga información sobre el cálculo de unidades de solicitud mediante la herramienta de planeamiento de capacidad de Azure Cosmos DB.