Opções de connection string

Nesta página

Opção de conjunto de réplica

Opções de conexão
Opções de TLS
Opções de tempo limite
Opções de compressão
Opções do pool de conexões
Opções de write concern
readConcern Options
Opções de read preference
Opções de autenticação
Seleção de servidor e opções de descoberta
Configurações diversas

Esta página lista todas as opções de conexão para cadeias de conexão SRV e cadeias de conexão padrão.

As opções de conexão são pares no seguinte formulário: name=value.

A opção name diferencia maiúsculas de minúsculas ao utilizar um condutor.
A opção name diferencia maiúsculas de minúsculas ao utilizar o mongosh.
O(A) value sempre diferencia maiúsculas de minúsculas.

Separar as opções com o caractere ampersand (&) name1=value1&name2=value2. No exemplo a seguir, uma conexão inclui as opções replicaSet e connectTimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db1.example.net:27017,db2.example.net:2500/?replicaSet=test&connectTimeoutMS=300000

Observação

Separador de ponto e vírgula para argumentos de connection string

Para oferecer compatibilidade com versões anteriores, atualmente, os drivers aceitam ponto e vírgula (;) como separadores de opções.

Opção de conjunto de réplica

A seguinte cadeia de caracteres de conexão conecta a um conjunto de réplica denominado myRepl com membros executando nos hosts especificados. Ele autentica como usuário myDatabaseUser com a senha D1fficultP%40ssw0rd:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com:27017,db1.example.com:27017,db2.example.com:27017/?replicaSet=myRepl

Opção de conexão

Descrição

replicaSet

Especifica o nome doconjunto de réplicas do , se o mongod for um membro de um conjunto de réplicas. Defina a opção de conexão replicaSet para garantir um comportamento consistente entre drivers.

Ao conectar a um conjunto de réplicas, forneça uma lista de seeds dos membros do conjunto de réplicas para o componente host[:port] do uri. Para obter detalhes específicos, consulte a documentação do driver.

directConnection

Especifica se o cliente se conecta diretamente ao host[:port] no URI da conexão:

true: o cliente envia operações somente para o host especificado. Ele não tenta descobrir nenhum outro membro do conjunto de réplicas.
false: o cliente tenta descobrir todos os servidores no conjunto de réplicas e envia operações para o membro primário. Este é o valor padrão.

Opções de conexão

Opções de TLS

A seguinte string de conexão com um conjunto de réplicas inclui a opção tls=true. Ela autentica como usuário myDatabaseUser com a senha D1fficultP%40ssw0rd.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&tls=true

Além disso, você também pode utilizar a opção ssl=true equivalente:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&ssl=true

Opção de conexão	Descrição
`tls`	Habilita ou desabilita TLS/SSL para a conexão: `true`: inicia a conexão com TLS/SSL. Padrão para o formato de conexão SRV. `false`: inicie a conexão sem TLS/SSL. Padrão para o formato de string de conexão padrão. A opção `tls` é equivalente à opção `ssl`. Se o shell do `mongosh` especificar opções adicionais de tls/ssl da linha de comando, utilize a opção de linha de comando do `--tls`.
`ssl`	Um booleano para ativar ou desativar TLS/SSL para a conexão: `true`: inicia a conexão com TLS/SSL. Padrão para o formato de conexão SRV. `false`: inicie a conexão sem TLS/SSL. Padrão para o formato de string de conexão padrão. A opção `ssl` é equivalente à opção `tls`. Se o shell do `mongosh` especificar opções adicionais de tls/ssl da linha de comando, utilize a opção de linha de comando do `--ssl`.
`tlsCertificateKeyFile`	Especifica o local de um arquivo `.pem` local que contém o certificado TLS/SSL X.509 do cliente ou o certificado e chave TLS/SSL do cliente. O cliente apresenta este arquivo para a instância `mongod`/`mongos`. O `mongod` / `mongos` registra um aviso na conexão se o certificado x.509 apresentado expirar dentro de `30` dias do horário do sistema host `mongod/mongos`. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsCertificateKeyFilePassword`	Especifica a senha para descriptografar o `tlsCertificateKeyFile`. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsCAFile`	Especifica o local de um arquivo de `.pem` local que contém a cadeia de certificados raiz da Autoridade de Certificação. Esse arquivo é usado para validar o certificado apresentado pela instância`mongod` / `mongos`. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando.
`tlsAllowInvalidCertificates`	Ignora a validação dos certificados apresentados pela instância `mongod` / `mongos` Defina como `true` para se conectar às instâncias do MongoDB mesmo que o servidor apresente certificados inválidos. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.
`tlsAllowInvalidHostnames`	Desativa a validação do nome de host do certificado apresentado pela instância `mongod` / `mongos`. Configure para `true` para conectar às instâncias MongoDB mesmo que o nome de host nos certificados do servidor não correspondam ao host do servidor. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.
`tlsInsecure`	Desabilita várias validações de certificado. Configurar para `true` para desabilitar as validações do certificado. As validações exatas desativadas variam de acordo com os drivers. Consulte a documentação sobre os drivers. Esta opção de connection string não está disponível para o shell `mongo`. Use a opção de linha de comando. AVISO: a desativação da validação do certificado cria uma vulnerabilidade.

Opções de tempo limite

Opção de conexão	Descrição
`connectTimeoutMS`	O tempo em milissegundos para tentar uma conexão antes de atingir o tempo limite. O padrão é 10,000 milissegundos, mas drivers específicos podem ter outro padrão. Para obter detalhes, consulte a documentação do driver.
`socketTimeoutMS`	O tempo em milissegundos para tentar enviar ou receber em um soquete antes que a tentativa expire. O padrão é nunca atingir o tempo limite, embora drivers diferentes possam variar. Consulte a documentação do driver.

Opções de compressão

Opção de conexão

Descrição

compressors

String delimitada por vírgula de compressores para habilitar a compressão de rede para comunicação entre este cliente e uma instância mongod / mongos.

Você pode especificar os seguintes compressores:

Se você especificar vários compressores, a ordem na qual você lista os compressores importam, bem como o iniciador de comunicação. Por exemplo, se o cliente especificar os seguintes compressores de rede "zlib,snappy" e o mongod especificar "snappy,zlib", as mensagens entre o cliente e o mongod utilizarão zlib.

As mensagens são compactadas quando ambas as partes habilitam a compactação de rede. Caso contrário, as mensagens entre as partes serão descompactadas.

Se as partes não compartilharem pelo menos um compressor comum, as mensagens entre as partes serão descompactadas.

mongosh suporta a opção de string de conexão uri compressors.

zlibCompressionLevel

Um número inteiro que especifica o nível de compressão se utilizar zlib para network compression.

Você pode especificar um valor inteiro na faixa entre -1 e 9:

Valor	Notas
`-1`	Nível de compressão padrão, geralmente compressão nível `6`.
`0`	Sem compressão
`1` - `9`	Aumento do nível de compressão, mas ao custo da velocidade, com: `1` fornecendo a melhor velocidade, mas menor compactação, e `9` fornecendo a melhor compressão, mas na velocidade mais lenta.

Compatível com o mongosh.

Opções do pool de conexões

A maioria dos drivers implementa algum tipo de tratamento de pool de conexões. Alguns drivers não oferecem suporte a pool de conexões. Consulte a documentação do driver para obter mais informações sobre a implantação do pool de conexões. Essas opções permitem que os aplicativos configurem o pool de conexão ao se conectar à implantação do MongoDB.

Opção de conexão	Descrição
`maxPoolSize`	O número máximo de conexões no pool de conexões. O valor padrão é `100`.
`minPoolSize`	O número mínimo de conexões no pool de conexões. O valor padrão é `0`. A opção `minPoolSize` não é compatível com todos os drivers. Para obter informações sobre o driver, consulte a documentação Drivers .
`maxConnecting`	Número máximo de conexões que um pool pode estabelecer simultaneamente. O valor padrão é `2`. `maxConnecting` é compatível com todos os drivers, exceto o driver Rust. Aumentar o valor de `maxConnecting` permite que o cliente estabeleça conexão com o servidor mais rápido, mas aumenta a chance de tempestades de conexão. Se o valor de `maxConnecting` for muito baixo, o pool de conexões poderá sofrer fortes limitações e aumentar a latência da parte final para os clientes que estiverem checando as conexões.
`maxIdleTimeMS`	O número máximo de milissegundos que uma conexão pode permanecer inativa no pool antes de ser removida e fechada. Esta opção não é suportada por todos os drivers.
`waitQueueMultiple`	Um número ao qual o driver multiplica o valor de `maxPoolSize`, para fornecer o número máximo de threads permitidos para aguardar uma conexão se tornar disponível a partir do grupo. Para valores padrão, consulte a documentação do driver. Esta opção não é suportada por todos os drivers.
`waitQueueTimeoutMS`	O tempo máximo em milissegundos que uma thread pode esperar até que uma conexão fique disponível. Para valores padrão, consulte a documentação do driver. Esta opção não é suportada por todos os drivers.

Opções de write concern

A write concern descreve o nível de confirmação solicitado ao MongoDB. A opção write concern é suportada por:

Você pode especificar o write concern na connection string e como um parâmetro para métodos como insert ou update. Se o write concern for especificado em ambos os locais, o método parâmetro substituirá a connection string de configuração.

As connection strings de implantação do MongoDB Atlas usam "majority" por padrão. Se você não especificar o write concern para uma implantação do MongoDB Atlas, o MongoDB Atlas imporá"majority".

A string de conexão a seguir para um conjunto de réplicas especifica a preocupação de gravação de "majority" e um tempo limite de 5 segundos usando o parâmetro de preocupação de gravação wtimeoutMS:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&w=majority&wtimeoutMS=5000

Opção de conexão	Descrição
`w`	Corresponde à opção de `w` da preocupação de gravação. A opção `w` solicita a confirmação de que a operação de gravação se propagou para um número especificado de instâncias `mongod` ou para instâncias `mongod` com tags especificadas. Você pode especificar um `number`, a string `majority` ou um `tag set`. Para obter detalhes, consulte Opção `w`.
`wtimeoutMS`	Corresponde à preocupação de gravação `wtimeout`. `wtimeoutMS` especifica um limite de tempo, em milissegundos, para a preocupação de gravação. Quando `wtimeoutMS` é `0`, as operações de gravação nunca atingem o tempo limite. Para mais informações, consulte `wtimeout`.
`journal`	Corresponde à Opção`j` da preocupação de gravação. A opção `journal` solicita confirmação do MongoDB de que a operação de gravação foi registrada no diário. Para obter detalhes, consulte a Opção `j`. Se você definir `journal` como `true` e especificar um valor de `w` menor que 1, `journal` prevalecerá.

Para obter mais informações, consulte Preocupação de gravação.

readConcern Options

Para o mecanismo de armazenamento WiredTiger, o MongoDB introduz a opção readConcern para conjuntos de réplicas e fragmentos de conjuntos de réplicas.

Ler Preocupação permite que os clientes escolham um nível de isolamento para suas leituras a partir de conjuntos de réplica.

A seguinte string de conexão para um conjunto de réplica especifica readConcernLevel=majority:

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readConcernLevel=majority

Opção de conexão	Descrição
`readConcernLevel`	O nível de isolamento. Pode aceitar um dos seguintes valores: `local` `majority` `linearizable` `available` Esta opção de cadeia de conexão não está disponível para `mongosh`. Especifique a preocupação de leitura como uma opção para a operação específica.

Para obter mais informações, consulte Preocupação de leitura.

Opções de read preference

Read preferences descrevem o comportamento das operações de leitura em relação aos conjuntos de réplicas. Esses parâmetros permitem que você especifique preferências de leitura por conexão na connection string.

Por exemplo:

A seguinte string de conexão para um conjunto de réplica especifica o modo de preferência de leitura do secondary e um valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readPreference=secondary&maxStalenessSeconds=120
```
A seguinte string de conexão para um cluster fragmentado especifica o modo de preferência de leitura do secondary e um valor de maxStalenessSeconds de 120 segundos:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&maxStalenessSeconds=120
```
A string de conexão a seguir para um cluster fragmentado especifica o modo de preferência de leitura secondary, bem como três readPreferenceTags:
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=dc:ny&readPreferenceTags=
```

A ordem é importante ao usar vários readPreferenceTags. Os readPreferenceTags são testados em ordem até que uma correspondência seja encontrada. Uma vez encontrada, essa especificação é usada para encontrar todos os membros correspondentes elegíveis e quaisquer readPreferenceTags restantes são ignorados. Para obter detalhes, consulte Ordem de correspondência de tags.

Opção de conexão	Descrição
`readPreference`	Especifica as preferências de leitura para esta conexão. Os valores possíveis são: `primary` (Padrão) `primaryPreferred` `secondary` `secondaryPreferred` `nearest` Transações distribuídas que contêm operações de leitura devem usar a read preference `primary`. Todas as operações em uma determinada transação devem ser roteadas para o mesmo membro. Esta opção de string de conexão não está disponível para a shell `mongo`. Consulte, então, `cursor.readPref()` e `Mongo.setReadPref()`.
`maxStalenessSeconds`	Especifica, em segundos, o quão obsoleto um secundário pode ser antes de o cliente parar de usá-lo para operações de leitura. Para detalhes, consulte Preferência de leitura `maxStalenessSeconds`. Por padrão, não há desatualização máxima e os clientes não considerarão o atraso do secundário ao escolher para onde direcionar uma operação de leitura. O valor mínimo `maxStalenessSeconds` é de 90 segundos. Especificar um valor entre 0 e 90 segundos produzirá um erro. Os drivers do MongoDB tratam um valor `maxStalenessSeconds` de `-1` como "no max staleness", o mesmo que se `maxStalenessSeconds` fosse omitido.
`readPreferenceTags`	Especifica o documento de tags como uma lista separada por vírgula de pares de valores-chave separados por dois pontos. Por exemplo, Para especificar o documento de etiquetas `{ "dc": "ny", "rack": "r1" }`, utilize `readPreferenceTags=dc:ny,rack:r1` na cadeia de ligação. Para especificar um documento de etiquetas vazias `{ }`, utilize `readPreferenceTags=` sem definir o valor. Para especificar uma lista de documentos de tags, use vários `readPreferenceTags`. Por exemplo, `readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=`. A ordem é importante ao usar vários `readPreferenceTags`. Os `readPreferenceTags` são testados em ordem até que uma correspondência seja encontrada. Para obter detalhes, consulte Ordem de correspondência de tags. Esta opção de string de conexão não está disponível para a shell `mongo`. Consulte, então, `cursor.readPref()` e `Mongo.setReadPref()`.

Para mais informações, consulte Preferências de leitura.

Opções de autenticação

A string de conexão a seguir para um conjunto de réplicas especifica o authSource para o banco de dados admin. Ou seja, as credenciais do usuário são autenticadas no banco de dados admin.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?replicaSet=myRepl&authSource=admin

Se o nome de usuário ou a senha incluir os caracteres a seguir, esses caracteres deverão ser convertidos usando a codificação de porcentagem:

$ : / ? # [ ] @

Opção de conexão

Descrição

authSource

Especifique o nome do banco de dados associado às credenciais do usuário. Se authSource não for especificado, authSource assumirá o valor padrão defaultauthdb especificado na string de conexão. Se defaultauthdb não for especificado, authSource assumirá o valor padrão admin.

Os mecanismos de autenticação PLAIN (LDAP), GSSAPI (Kerberos) e MONGODB-AWS (IAM) exigem que authSource seja definido como $external, pois esses mecanismos delegam o armazenamento de credenciais a serviços externos.

O MongoDB ignorará os valores authSource se nenhum nome de usuário for fornecido, seja na string de conexão ou por meio do parâmetro --username.

authMechanism

Padrão: SCRAM-SHA-256

Especifique o mecanismo de autenticação que o MongoDB usa para autenticar a conexão. Se você não especificar um authMechanism, mas fornecer credenciais de usuário, o MongoDB tentará usar o SCRAM-SHA-256. Se isso falhar, ele volta para SCRAM-SHA-1.

SCRAM-SHA-1
SCRAM-SHA-256
MONGODB-X509
MONGODB-AWS
GSSAPI (Kerberos)
PLAIN (LDAP SASL)
MONGODB-OIDC (OpenID conecta OIDC). Para usar MONGODB-OIDC, você deve:
- Defina a authMechanismProperties ENVIRONMENT variável .
- Forneça um retorno de chamada de resposta OIDC para o construtor do cliente .

Somente instâncias do MongoDB Enterprise mongod e mongos fornecem mecanismos do GSSAPI (Kerberos) e PLAIN (LDAP).

Para usar o MONGODB-X509, você deve ter TLS/SSL ativado.

Para usar MONGODB-AWS, você deve estar se conectando a um cluster do MongoDB Atlas que tenha sido configurado para ter compatibilidade com a autenticação por meio de credenciais do AWS IAM (um ID de chave de acesso da AWS e uma chave de acesso secreta e, opcionalmente, um token de sessão da AWS). O mecanismo de autenticação MONGODB-AWS exige que o authSource seja definido como $external.

Ao utilizar o MONGODB-AWS, forneça seu ID de chave de acesso da AWS como o nome de usuário e a chave de acesso secreta como a senha. Se você também estiver usando um token de sessão da AWS, insira o token junto com o valor AWS_SESSION_TOKEN authMechanismProperties.

Se o Amazon Web Services ID ID da chave de acesso do Amazon Web Services, a chave de acesso secreta ou o token de sessão incluírem os caracteres a seguir, esses caracteres deverão ser convertidos usando a codificação percentual.

$ : / ? # [ ] @

Como alternativa, se o ID da chave de acesso da AWS, a chave de acesso secreta ou o token de sessão estiverem definidos em sua plataforma usando suas respectivas variáveis de ambiente de AWS IAM mongosh usará esses valores de variável de ambiente para autenticar; você não precisa especificá-los na string de conexão.

Consulte Connect to an Atlas Cluster para ver, por exemplo , o uso do mecanismo de autenticação MONGODB-AWS usando uma string de conexão e o método de variáveis do ambiente.

Consulte Autenticação em implementações autogerenciadas para obter mais informações sobre o sistema de autenticação no MongoDB. Considere também Usar x.509 Certificados para autenticar clientes em implementações autogerenciadas para obter mais informações sobre a autenticação x509 .

authMechanismProperties

Especifique propriedades para o authMechanism especificado como uma lista separada por vírgulas de pares de valores-chave separados por dois pontos.

Os possíveis pares de chave-valor são:

SERVICE_NAME:<string>

Defina o nome do serviço Kerberos ao conectar-se a instâncias do MongoDB com suporte do Kerberos. Esse valor deve corresponder ao nome do serviço definido nas instâncias do MongoDB das quais você está se conectando. Válido apenas ao usar o mecanismo de autenticação GSSAPI.

SERVICE_NAME padrão para mongodb para todos os clientes e instâncias MongoDB. Se você alterar a configuração saslServiceName em uma instância do MongoDB, deverá definir SERVICE_NAME para corresponder a essa configuração. Válido apenas ao usar o mecanismo de autenticação GSSAPI.

CANONICALIZE_HOST_NAME:true|false

Canonize o nome de host da máquina host do cliente ao conectar ao servidor Kerberos. Isso pode ser necessário quando os hosts relatam nomes de host diferentes do que está no banco de dados Kerberos. Padrão é false. Válido apenas ao usar o mecanismo de autenticação GSSAPI.

SERVICE_REALM:<string>

Configure a região Kerberos para o serviço MongoDB. Isso pode ser necessário para suportar a autenticação entre domínios onde o usuário existe em um domínio e o serviço em outro. Válido apenas ao usar o mecanismo de autenticação GSSAPI.

AWS_SESSION_TOKEN:<security_token>

Definir o Amazon Web Services token de sessão do para autenticação com credenciais temporárias ao usar um AssumeRole solicitação ou ao trabalhar com Amazon Web Services recursos que especificam esse valor, como Lambda. Válido apenas ao usar o mecanismo de autenticação MONGODB-AWS . Você também deve ter um Amazon Web Services de chave de acesso ID e uma chave de acesso secreta. Consulte Conectar-se a um Atlas cluster para obter exemplo de uso.

ENVIRONMENT:<string>

Defina o ambiente OpenID Connect (OIDC). Para:

Microsoft Azure, conjunto ENVIRONMENT:azure
Google Cloud Platform, conjunto ENVIRONMENT:gcp

Você também deve definir authMechanism como MONGODB-OIDC.

gssapiServiceName

Defina o nome do serviço Kerberos ao conectar-se a instâncias Kerberized MongoDB. Esse valor deve corresponder ao nome do serviço definido nas instâncias do MongoDB às quais você está se conectando.

gssapiServiceName assume o valor padrão mongodb para todos os clientes e instâncias do MongoDB. Se você alterar a configuração saslServiceName em uma instância do MongoDB, deverá definir gssapiServiceName para corresponder a essa configuração.

gssapiServiceName é um alias obsoleto de authMechanismProperties=SERVICE_NAME:mongodb. Para obter mais informações sobre as opções suportadas por seu driver e a prioridade relativa entre essas opções, consulte a documentação da versão do driver de sua preferência.

Seleção de servidor e opções de descoberta

O MongoDB fornece as seguintes opções para configurar como drivers do MongoDB e instâncias do mongos selecionam um servidor para o qual direcionar operações de leitura ou gravação.

Opção de conexão	Descrição
`localThresholdMS`	O tamanho (em milissegundos) da janela de latência para selecionar entre várias instâncias MongoDB adequadas. Padrão: 15 milissegundos. Todos os drivers usam o `localThresholdMS`. Utilize o alias `localThreshold` ao especificar o tamanho da janela de latência para `mongos`.
`serverSelectionTimeoutMS`	Especifica por quanto tempo (em milissegundos) bloquear para seleção de servidor antes de lançar uma exceção. Padrão: 30.000 milissegundos.
`serverSelectionTryOnce`	Somente drivers de thread único. Quando `true`, instrui o driver a verificar a implantação do MongoDB exatamente uma vez após a falha na seleção do servidor e então seleciona um servidor ou gera um erro. Quando `false`, o driver faz o bloqueio e busca um servidor até o valor `serverSelectionTimeoutMS`. Padrão: `true`. Os drivers de threads múltiplas e o `mongos` não suportam `serverSelectionTryOnce`.
`heartbeatFrequencyMS`	`heartbeatFrequencyMS` controla quando o driver verifica o estado da implantação do MongoDB. Especifique o intervalo (em milissegundos) entre verificações, contado desde o final da verificação anterior até o início da próxima. Padrão: Drivers de thread único: 60 segundos. Drivers multithread: 10 segundos. `mongos` não oferece suporte à alteração da frequência das verificações de pulsação.
`socketCheckIntervalMS`	Somente clientes de thread único. Controla com que frequência o cliente verifica o estado da conexão CPU com a implantação do MongoDB . Se você especificar um valor mais baixo, o cliente detectará os problemas de rede mais rapidamente, mas usará mais CPU. Padrão: 5 segundos. Esta opção não é compatível com todos os drivers. Consulte a documentação sobre os drivers.

Configurações diversas

Opção de conexão	Descrição
`appName`	Especifique um nome de aplicativo personalizado. O nome do aplicativo aparece em: `mongod` e `mongos` logs o campo `currentOp.appName` no comando `currentOp` e saída do método `db.currentOp()` O campo `system.profile.appName` na saída do analisador de banco de dados A opção de conexão do `appName` está disponível para: MongoDB Drivers `mongosh` começando em `mongosh` 1.1.9 MongoDB Compass começando em Compass 1.28.4
`retryReads`	Habilite leituras repetíveis Os valores possíveis são: `true`. Habilita leituras repetíveis para a conexão. Os drivers oficiais do MongoDB são padronizados como `true`. `false`. Desativa leituras repetíveis para a conexão. `mongosh` não oferece suporte a leituras repetíveis.
`retryWrites`	Habilite gravações repetíveis. Os valores possíveis são: `true`. Permite gravações que podem ser repetidas na conexão. Os drivers oficiais do MongoDB são padronizados como `true`. `false`. Desativa as gravações que podem ser repetidas na conexão. Os drivers do MongoDB repetem operações de confirmação e anulam transações, independentemente do valor de `retryWrites`. Para obter mais informações sobre a capacidade de repetição de transações, consulte Tratamento de erros de transação.
`uuidRepresentation`	Os valores possíveis são: `standard` A representação binária padrão. `csharpLegacy` A representação predefinida para o condutor C#. `javaLegacy` A representação padrão para o driver Java. `pythonLegacy` A representação padrão do driver Python. Para saber qual é o padrão, consulte a documentação dos drivers do seu driver. Nem todos os drivers suportam a opção `uuidRepresentation`. Para obter informações sobre seu driver, consulte a documentação do driver.
`loadBalanced`	Especifica se o cliente está se conectando a um balanceador de carga. Esta opção é `false` por padrão. Você só poderá definir esta opção como `true` se atender aos seguintes requisitos: Você especifica apenas um nome de host. Você não está se conectando a um conjunto de réplicas. A opção `srvMaxHosts` não está definida ou tem um valor de `0`. A opção `directConnection` não está definida ou tem um valor de `false`.
`srvMaxHosts`	Especifica o número de conexões `mongos` que podem ser criadas para topologias fragmentadas. Defina esta opção como um número inteiro não negativo. `0` é o valor padrão e significa que não há limite para o número de conexões `mongos` .

Voltar

Cadeias de conexão

Exemplos de connection string