Crea un MongoClient

Overview

En esta guía, puede aprender cómo conectarse a un Implementación de MongoDB Atlas, una instancia de MongoDB o un conjunto de réplicas que utiliza el controlador Go.

Para conectarse a una implementación de MongoDB, necesita las siguientes dos cosas:

• URI de conexión, también conocido como cadena de conexión, que le indica al controlador Go a qué implementación de MongoDB conectarse.

• Objeto MongoClient, que establece la conexión y lleva a cabo operaciones en la implementación de MongoDB.

Puedes utilizar options.Client() para personalizar la forma en que se comporta el controlador Go mientras está conectado a MongoDB.

URI de conexión

Una cadena de conexión estándar incluye los siguientes componentes:

Para obtener más información sobre cómo crear una cadena de conexión, consulte Cadenas de conexión en la documentación de MongoDB Server.

uri := os.Getenv("MONGODB_URI")

MONGODB_URI=mongodb+srv://<db_username>:<db_password>@<cluster-url>?retryWrites=true&w=majority

Crear un cliente para conectarse a MongoDB Atlas

Para conectarse a MongoDB, debe crear un cliente. Un cliente administra sus conexiones y ejecuta comandos de la base de datos.

Puedes crear un cliente que use tu cadena de conexión y otras opciones del cliente si trasladas un objeto ClientOptions al método Connect().

Para especificar la URI de conexión, pásela al método ApplyURI(), que devuelve una nueva instancia ClientOptions. Para configurar otras opciones, llame al método auxiliar correspondiente del paquete de opciones.

Para obtener más información sobre las opciones de conexión, consulte la sección "Opciones de conexión". Para obtener más información sobre cómo crear un cliente, consulte la documentación de la API de Cliente y Connect().

Puedes configurar la versión estable de la API como opción para evitar cambios importantes al actualizar a una nueva versión del servidor. Para obtener más información sobre la función API estable, consulta la página API estable.

// Connects to MongoDB and sets a Stable API version
package main
import (
	"context"
	"fmt"
	"log"
	"os"
	"go.mongodb.org/mongo-driver/v2/bson"
	"go.mongodb.org/mongo-driver/v2/mongo"
	"go.mongodb.org/mongo-driver/v2/mongo/options"
)
func main() {
	var uri string
	if uri = os.Getenv("MONGODB_URI"); uri == "" {
		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://mongodb.com/es/docs/drivers/go/current/usage-examples/")
	}
	// Uses the SetServerAPIOptions() method to set the Stable API version to 1
	serverAPI := options.ServerAPI(options.ServerAPIVersion1)
	// Defines the options for the MongoDB client
	opts := options.Client().ApplyURI(uri).SetServerAPIOptions(serverAPI)
	// Creates a new client and connects to the server
	client, err := mongo.Connect(opts)
	if err != nil {
		panic(err)
	}
	defer func() {
		if err = client.Disconnect(context.TODO()); err != nil {
			panic(err)
		}
	}()
	// Sends a ping to confirm a successful connection
	var result bson.M
	if err := client.Database("admin").RunCommand(context.TODO(), bson.D{{"ping", 1}}).Decode(&result); err != nil {
		panic(err)
	}
	fmt.Println("Pinged your deployment. You successfully connected to MongoDB!")
}

Recursos adicionales

Para más información sobre los conceptos de esta guía, consulta la siguiente documentación:

• Cadenas de conexión en el manual del servidor

• Opciones de cadena de conexión en el manual del servidor

• Guía de conexión del controlador en la documentación de Atlas y seleccione Go desde el menú desplegable de idioma