Guía de Conexión

Partes de una URI de conexión

El siguiente ejemplo explica cada parte de una URI de conexión de muestra:

En este ejemplo, utilizamos mongodb Para el protocolo, que especifica el formato de cadena de conexión estándar. También puede usar el formato de conexión de lista de semillas DNS si desea mayor flexibilidad de implementación y la posibilidad de cambiar los servidores en rotación sin reconfigurar los clientes.

La siguiente parte de la cadena de conexión contiene el nombre de usuario de la base de datos y, si utiliza autenticación basada en contraseña, su contraseña. Reemplace el valor user con el nombre de usuario de la base de datos y pass con su contraseña. Si utiliza un mecanismo de autenticación que no requiere nombre de usuario ni contraseña, omita esta parte del URI de conexión.

La siguiente parte de la cadena de conexión especifica el nombre de host o la dirección IP y el puerto de su instancia de MongoDB. En el ejemplo anterior, usamos sample.host como nombre de host y 27017 como puerto. Reemplace estos valores para apuntar a su instancia de MongoDB.

La última parte de la cadena de conexión especifica las opciones de conexión y autenticación. En el ejemplo, se establecen dos opciones de conexión: maxPoolSize=20 w=majorityy. Para obtener más información sobre las opciones de conexión, consulte la sección "Opciones de conexión" de esta guía.

Ejemplo de conexión

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 options.

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.

El siguiente código muestra cómo crear un cliente que use una cadena de conexión Atlas y la versión API estable, conectarse a MongoDB y verificar que la conexión sea exitosa:

// Connects to MongoDB and sets a Stable API version
package main
import (
	"context"
	"fmt"
	"go.mongodb.org/mongo-driver/bson"
	"go.mongodb.org/mongo-driver/mongo"
	"go.mongodb.org/mongo-driver/mongo/options"
)
// Replace the placeholder with your Atlas connection string
const uri = "<connection string>"
func main() {
	// Use the SetServerAPIOptions() method to set the Stable API version to 1
	serverAPI := options.ServerAPI(options.ServerAPIVersion1)
	opts := options.Client().ApplyURI(uri).SetServerAPIOptions(serverAPI)
	// Create a new client and connect to the server
	client, err := mongo.Connect(context.TODO(), opts)
	if err != nil {
		panic(err)
	}
	defer func() {
		if err = client.Disconnect(context.TODO()); err != nil {
			panic(err)
		}
	}()
	// Send 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!")
}

Realizar la conexión a MongoDB Server en la máquina local

Si debe ejecutar un servidor MongoDB en su máquina local para fines de desarrollo, complete los siguientes pasos:

1. Descarga la versión Community o Empresa de MongoDB Server.

2. Instale y configure MongoDB Server.

3. Inicia el servidor.

Después de iniciar MongoDB Server correctamente, se debe especificar la cadena de conexión en el código de conexión del driver.

Si MongoDB Server se está ejecutando localmente, se puede utilizar la cadena de conexión "mongodb://localhost:<port>" en que <port> es el número de puerto que se configuró para que el servidor escuche las conexiones entrantes.

Si desea especificar un nombre de host o una dirección IP diferente, consulte nuestra entrada del Manual del servidor sobre cadenas de conexión.

Para probar si puede conectarse a su servidor, reemplace la cadena de conexión con la cadena de conexión de su host local en el ejemplo de código anterior.

Conectarse a un set de réplicas

Una implementación de un conjunto de réplicas de MongoDB es un grupo de instancias conectadas que almacenan el mismo conjunto de datos. Esta configuración proporciona redundancia y alta disponibilidad de datos.

Para conectarse a una implementación de conjunto de réplicas, especifique el nombre de host y los números de puerto de cada instancia, separados por comas, y el nombre del conjunto de réplicas como valor del parámetro replicaSet en la cadena de conexión. En el siguiente ejemplo, los nombres de host son host1, host2 y host3, y los números de puerto son 27017. El nombre del conjunto de réplicas es myRS.

mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myRS

Al conectarse a un conjunto de réplicas, el controlador realiza las siguientes acciones de forma predeterminada:

• Descubre todos los miembros del conjunto de réplicas cuando se le proporciona la dirección de cualquiera de los miembros.

• Envía operaciones al miembro apropiado, como instrucciones para escribir contra el principal.

Configuración de tiempo de espera único

Puede configurar una única opción Timeout en su Client para controlar la cantidad de tiempo que puede tardar en ejecutarse una sola operación utilizando el método SetTimeout() o especificando la opción timeoutMS en su cadena URI de conexión. Las instancias Database, Collection, Session, ChangeStream y Bucket en otras partes de su código heredan la opción Timeout de Client si no configura un Contexto para operaciones contra la misma entidad.

Si se pasa un contexto a una operación con fecha límite, el controlador utiliza dicha fecha límite para la operación. Si el contexto no tiene fecha límite, el controlador deriva un nuevo contexto a partir del contexto dado utilizando la opción Timeout establecida en Client.

El siguiente código muestra cómo establecer la opción Timeout en un Client con la opción SetTimeout:

opts := options.Client().SetTimeout(5 * time.Second)

El siguiente ejemplo muestra cómo se puede establecer un único tiempo de espera con la opción URI y ejecutar una operación que herede esta configuración:

uri := "mongodb://user:pass@sample.host:27017/?timeoutMS=5000"
client := mongo.Connect(context.TODO(), uri)
coll := client.Database("<db>").Collection("<collection>")
...
coll.InsertOne(context.Background(), doc)