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. Las opciones son:
- 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
- Dentro de una suscripción activa de Azure:
- 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.