mongosqld

Como iniciar o mongosqld com um arquivo de esquema

Use a opção para especificar um arquivo de esquema --schema ao mongosqld iniciar.

mongosqld --schema /path/to/schema-file.drdl

Use mongodrdl para criar um arquivo de esquema a partir de uma instância do MongoDB.

Iniciando o mongosqld com um Banco de Dados de Esquema

Use a opção para especificar um banco de dados para armazenar informações de --schemaSource esquema.

mongosqld --schemaSource sampleDb

Iniciando mongosqld com namespaces especificados

Use a opção para especificar bancos --sampleNamespaces mongosqld de dados e coleções para obter amostras de dados para criar o esquema.

mongosqld --sampleNamespaces contacts.addresses

Veja exemplos de uso adicionais abaixo.

Opções principais

--help

Retorna informações sobre as opções e uso mongosqld de.

--addr

Padrão: 127.0.0.1:3307

Especifica o endereço do host para escutar.

--version

Retorna o mongosqld número de versão do.

--config <path>

Especifica o caminho para um arquivo de configuração.

--mongo-uri <uri>

Padrão: mongodb://localhost:27017

Especifica uma cadeia de conexão do MongoDB à qual se conectar.

A opção suporta as seguintes opções dentro da string de --mongo-uri conexão:

• readPreference

• readPreferenceTags

• replicaSet

• connect

Para obter mais informações sobre essas opções de URI, consulte Opções de preferência de leitura e Opção de conjunto de réplicas.

Para opções definidas na URI do Mongo não incluídas na lista acima, utilize a mongosqld opção equivalente. Para a lista completa de mongosqld opçõesdo, consulte Opções de linha de comando.

Observação

Em vez de especificar um username e um password em sua string de conexão, execute mongosqld com a opção --auth mongosqld para direcionar a passar as credenciais de autenticação fornecidas pelo cliente SQL para o servidor MongoDB .

Da mesma forma, em vez de ativar na string de conexão,ssl execute mongosqld --mongo-sslcom.

Para desativar a lógica de descoberta automática do servidor de conjunto de réplicas e forçar uma conexão com o servidor especificado, use a opção connect=direct.

mongosqld --mongo-uri "mongodb://<hostname>:<port>/?connect=direct"

As opções de URI que não estão na lista acima nem na lista de opções suportadas mongosqld não são suportadas.

--mongo-versionCompatibility <version-number>

Restringe mongosqld ao uso de recursos compatíveis com a versão especificada do MongoDB . Necessário apenas quando usado com conjuntos de réplicas nos quais os membros usam versões diferentes do MongoDB ou ao realizar uma atualização contínua do MongoDB. Suporta apenas a versão do MongoDB 3.2 ou posterior.

Por exemplo, se o conjunto de réplicas contiver membros executando 3.2 o MongoDB e outros membros executando o MongoDB,3.4 defina a seguinte opção para restringir a usar somente recursos suportados pelo mongosqld MongoDB.:32

mongosqld --mongo-versionCompatibility 3.2

--maxVarcharLength <length>

Novidades na versão 2.2.

Especifica o tamanho máximo, em caracteres, para todos os campos varchar. Se encontrar uma string maior mongosqld mongosqld que o tamanho máximo, a reduzirá até o tamanho máximo e registrará um aviso.

--mongo-username <username>, -u <username>

Novidades na versão 2.3.

Especifica o nome de usuário de autenticação a ser usado na descoberta do esquema. Necessário somente se o estiver habilitado. O usuário especificado --auth pelo --mongo-username deve ser um usuário MongoDB válido com o listDatabases privilégio do.Consulte Permissões de usuário mongosqld.

--mongo-password <password>, -p <password>

Novidades na versão 2.3.

Especifica a senha de autenticação a ser usada na descoberta do esquema. Necessário somente se o estiver habilitado. Use em --auth conjunto --mongo-username com.

--mongo-authenticationSource <auth-db-name>

Padrão: admin

Novidades na versão 2.3.

Especifica o banco de dados que contém as credenciais do usuário de descoberta de esquema. Disponível apenas se estiver ativado. Use em conjunto com as opções de --auth credenciais --mongo-username --mongo-passworde.

--mongo-authenticationMechanism <authMechanism>

Padrão: SCRAM-SHA-1

Novidades na versão 2.3.

Especifica o mecanismo de autenticação a ser usado na descoberta do esquema. Disponível apenas se--authestiver ativado. Use em conjunto com as opções de credenciais--mongo-usernamee--mongo-password.

Valor	Descrição
SCRAM-SHA-1	RFC 5802 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a1 função de hash SHA.
SCRAM-SHA-256	Novidades na versão 2.6: RFC 7677 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a2 função de hash SHA.
PLAIN (LDAP SASL)	Autenticação externa usando LDAP. Você também pode utilizar o PLAIN para autenticar usuários do banco de dados. PLAIN transmite senhas em texto simples. Esse mecanismo está disponível somente no MongoDB Enterprise.
GSSAPI (Kerberos)	Autenticação externa usando Kerberos. Esse mecanismo está disponível somente no MongoDB Enterprise.

Opções de esquema

--schema <filename>

Especifica o caminho para um arquivo de esquema ou o diretório de esquema.

--schemaDirectory <directoryname>

Obsoleto desde a versão 2.2.

Em vez disso,--schema use.

--sampleNamespaces <db.collection>

Novidades na versão 2.5.

--sampleNamespaces especifica um banco de dados e uma coleção para inclusão ou exclusão do processo de amostragem de dados que cria o esquema. Também é possível especificar múltiplas coleções de um único banco de dados ou múltiplas coleções de múltiplos bancos de dados. Veja exemplos abaixo.

Se você não usar a --sampleNamespaces opção ou a opção --schema , mongosqld amostras de dados de todos os bancos de dados e collections do MongoDB admin local disponíveis, exceto os bancos de dados e .

--schemaMode <[custom|auto]>

Padrão: custom

Novidades na versão 2.11.

Configura o modo de mongosqld amostragem do. Deve ser utilizado com a --schemaSource opção. Os seguintes valores determina a forma de amostragem:

Valor	--schemaMode Comportamento
custom	mongosqld lê um esquema armazenado do banco de dados MongoDB especificado pela --schemaSource opção.
auto	mongosqld faz uma amostra do esquema e grava os dados do esquema no banco de dados MongoDB especificado pela --schemaSource opção.

Para obter mais informações sobre como configurar o modo de amostra, consulte o Gráfico de referência do modo de amostragem.

Importante

Se mongosqld estiverauthenticationativado, o usuário autenticado deverá ter o privilégio de gravação no banco de dados--schemaSourceespecificado. Consulte Funções Integradas para obter mais informações sobre a função readWrite.

--schemaSource <db-name>

Novidades na versão 2.11.

Obrigatório sempre que estiver definido. Especifica o banco de dados onde as informações do esquema são --schemaMode armazenadas.

Observação

Se você não especificar nenhuma das --schema --schemaMode --schemaSource opções, e , manterá seu esquema namongosqld memória.

Para saber mais sobre os modos de amostragem, consulte o Gráfico de referência do modo de amostragem.

--schemaName <db-name>

Padrão: defaultSchema

Novidades na versão 2.11.

Opcional. O nome do esquema a ser carregado ou gravado --schemaSource no banco de dados. A especificação de nomes de esquema permite armazenar vários esquemas no --schemaSource banco de dados. A forma depende do valor --schemaMode de:

--schemaMode Valor	--schemaName Comportamento
custom	O nome do esquema para carregar a partir do banco de dados especificado pela --schemaSource opção.
auto	O nome do esquema a ser gravado no --schemaSource banco de dados após o BI Connector fazer uma amostra do esquema na inicialização.

Importante

Se você carregar um esquema personalizado, você deverá armazená-lo com seu nome especificado, utilizandoname-schemae então especificar este nome para omongosqldcom--schemaName. Se você não armazenar o nome do esquema ao carregá-lo, o nome do esquema padrão será defaultSchema. Se o nome do esquema não existir, isto resultará em um erro demongosqldsemelhante ao seguinte: Esquema MongoDB ainda não disponível. Erro ao inicializar esquema: nenhum esquema encontrado para o nome.

Para saber mais sobre os modos de amostragem, consulte o Gráfico de referência do modo de amostragem.

--sampleSize <number>

Padrão: 1000

Novidades na versão 2.3.

O número de documentos por namespace a serem amostrados ao coletar o esquema informação.

Configure --sampleSize para 0 para incluir todos os documentos no namespace especificado ao construir o esquema. Se você não especificar um namespace, definir --sampleSize como 0 mongosqld fará com que considere todos os documentos em todos os bancos de dados local (exceto, admin systeme) ao criar o esquema. Veja um exemplo abaixo.

--schemaRefreshIntervalSecs <number>

Padrão: 0

Alterado na versão 2.11:

Renomeado --sampleRefreshIntervalSecs para --schemaRefreshIntervalSecs

O intervalo, em segundos, no qual faz uma nova amostragem dos dados para criar seu esquema. O valor mongosqld padrão 0 é, o que significa que, após a amostragem inicial, não ocorrerá nenhuma reamostragem automática. O valor especificado deve ser um número inteiro positivo.

Para forçar uma atualização única do esquema, use o comando FLUSH SAMPLE do seu cliente SQL.

--uuidSubtype3Encoding <old|csharp|java>, -b <old|csharp|java>

Especifique a codificação usada para gerar o subtipo binário UUID 3. Escolha um dos seguintes valores:

• old: Representação antiga do subtipo binário BSON

• csharp: A representação legada de UUID em C#/.NET

• java: A representação legada de UUID em Java

--prejoin

Novidades na versão 2.6.

Opção de esquema para combinar dados de matriz e não matriz em uma única tabela.

Documentos MongoDB que contêm arrays são normalmente traduzidos em formato tabular com tabelas separadas para dados de array e dados não-matriz. Considere uma collection MongoDB chamada test com o seguinte documento:

{ "_id" : 1, "a" : 3, "b" : [ "orange", "apple", "pear" ] }

A coleção acima se traduz nas duas tabelas a seguir em formato tabular:

mysql> select * from test;
+------+------+
| _id  | a    |
+------+------+
|    1 |    3 |
+------+------+
mysql> select * from test_b;
+------+--------+-------+
| _id  | b      | b_idx |
+------+--------+-------+
|    1 | orange |     0 |
|    1 | apple  |     1 |
|    1 | pear   |     2 |
+------+--------+-------+

O sinalizador faz com que os dados --prejoin da a coluna sejam incluídos na test_b tabela:

mysql> select * from test_b;
+------+------+--------+-------+
| _id  | a    | b      | b_idx |
+------+------+--------+-------+
|    1 |    3 | orange |     0 |
|    1 |    3 | apple  |     1 |
|    1 |    3 | pear   |     2 |
+------+------+--------+-------+

Opções de log

--logAppend

Acrescenta nova saída de log a um arquivo de log existente especificado --logPath por.

Requer --logRotate.

--logPath <filename>

Default: stderr

Especifica um caminho para um arquivo de registro para armazenar saída de registro.

--logRotate reopen | rename

Padrão: renomear

Especifica que você deseja girar logs e como eles devem ser girados.

Quando esta opção estiver definida, os logs giram quando você emite um comando FLUSH LOGS para o Conector MongoDB para BI ou quando você reiniciar o mongosqld.

Se você --logRotate configurar rename para:

O arquivo de log existente é fechado. Um timestamp formatado em RFC3339é anexado ao arquivo de log fechado. Um novo arquivo de log é criado.

Se você --logRotate configurar reopen para:

O arquivo de registro existente é fechado e reaberto.

Observação

Em plataformas UNIX e macOS, você pode emitir um sinal do SIGUSR1 para reiniciar o processo do mongosqld e girar os logs.

--usageLogInterval <number>

Padrão: 60

Novidades na versão 2.14.

O intervalo, em segundos, no qual as estatísticas de uso são escritas no log. Defina como 0 para desativar o registro de uso.

Observação

O registro de uso não está habilitado para Windows.

--verbose, -v

Especifica que deve fornecer uma saída de registro mais mongosqld detalhada.

A tabela a seguir descreve as informações fornecidas em cada nível de log:

Opção de Carta	Nível de registro	Conteúdo da mensagem
--quiet	none	Não registre nada.
No flag	Default	Mensagens de registro que notificam o usuário sobre mongosqld eventos básicos e alterações de estado.
-v	Administrador	Mensagens de registro que fornecem informações aos mongosqld administradores.
-vv	Desenvolvedor	Mensagens de log úteis para suporte e desenvolvimento do MongoDB.

--quiet

Oculta todas as saídas de registro.

Opções de TLS/SSL do MongoDB

--mongo-ssl

Padrão: falso

Instrui o para usar TLS/SSL ao conectar a uma instância MongoDB mongosqld .

--mongo-sslPEMKeyFile <filename>

Especifica o .pem arquivo contendo o certificado TLS/SSL e a chave para usar ao se conectar ao MongoDB. Você pode especificar o nome mongosqld do .pem arquivo utilizando um caminho relativo ou absoluto.

Esta opção é exigida ao utilizar a --mongo-ssl opção para conectar a um mongod ou que mongos tem CAFile habilitado allowConnectionsWithoutCertificatessem.

--mongo-sslPEMKeyPassword <password>

Especifica o caminho para um arquivo que contém o certificado e a chave privada para se conectar ao MongoDB.

--mongo-sslAllowInvalidHostnames

Permite que se conecte a um servidor MongoDB cujo nome de host seja diferente do nome do host em seu certificado mongosqld TLS/SSL.

--mongo-sslAllowInvalidCertificates

Permite que a instância MongoDB apresente um certificado SSL/TLS de servidor inválido. Ao usar a configuração, o MongoDB registra o uso do certificado inválido como um allowInvalidCertificates aviso.

--mongo-sslCAFile <filename>

Especifica o arquivo .pem da instância MongoDB contendo a cadeia de certificado raiz da Autoridade de certificação. Especifique o nome do arquivo .pem usando caminhos relativos ou absolutos.

Aviso

Nas versões 2.14.30 e anteriores do BI Connector :

Para conexões SSL ( --mongo-ssl ) paramongodemongos, se omongosqldexecutar sem o--mongo-sslCAFile, mongosqldnão tentará validar os certificados do servidor . Isso cria uma vulnerabilidade para certificadosmongodemongosexpirados, bem como para processos externos que se fazem passar por instânciasmongodoumongosválidas. Certifique-se de sempre especificar o arquivo de autoridade de certificação para validar os certificados do servidor nos casos em que a intrusão é uma possibilidade.

A partir do BI Connector 2.14.31 versão, se o --mongo-ssl sinalizador for fornecido, você também deverá especificar pelo menos uma das seguintes opções:

• --mongo-sslCAFile

• --mongo-sslAllowInvalidCertificates

--mongo-sslCRLFile <filename>

Especifica o arquivo .pem da instância MongoDB contendo a lista de revogação de certificado.

--mongo-sslFIPSMode

Habilita o modo FIPS na biblioteca OpenSSL instalada.

--mongo-minimumTLSVersion <TLS1_0|TLS1_1|TLS1_2>

Padrão: TLS1_1

Especifica a versão TLS mínima exigida para conexões de saída para um mongod ou. instância. O valor mongos padrão TLS1_1 corresponde à versão 1 do1 TLS..

Opções TLS/SSL do cliente

--sslMode <mode>

Padrão: desabilitado

Novidades na versão 2.3.

Habilite ou desabilite TLS/SSL para conexões com mongosqld. O argumento para a opção sslMode pode ser um dos seguintes:

Valor	Descrição
disabled	mongosqld não pode aceitar conexões seguras usando TLS/SSL.
allowSSL	mongosqld pode aceitar conexões seguras usando TLS/SSL.
requireSSL	mongosqld só pode aceitar conexões protegidas usando TLS/SSL.

--sslPEMKeyFile <filename>

Especifica o arquivo .pem contendo o certificado TLS/SSL e chave para clientes MySQL. Especificar o nome do arquivo .pem usando caminhos relativos ou absolutos.

--sslPEMKeyPassword <password>

Especifica a senha utilizada para descriptografar a chave privada especificada --sslPEMKeyFile por.

--sslAllowInvalidCertificates

Permite que os clientes MySQL apresentem certificados TLS/SSL de cliente inválidos.

--sslAllowInvalidHostnames

Permite que os clientes SQL se conectem a um cujo nome de host seja diferente do nome do host em seu certificado mongosqld TLS/SSL.

--sslCAFile <filename>

Especifica o mongosqld .pem arquivo contendo a cadeia de certificado raiz da Autoridade de Certificação. Especifique o nome do .pem arquivo usando caminhos relativos ou absolutos.

--sslCRLFile <filename>

Especifica o mongosqld .pem arquivo contendo a lista de revogação do certificado.

--auth

Requer autenticação para solicitações de clientes recebidas.

Importante

Alterado na versão 2.4.0.

Quando a autenticação mongodb.net.auth.password está habilitada, as credenciais de mongodb.net.auth.username administrador devem ser fornecidas com --mongo-username --mongo-passwordas opções e ou as configurações e no arquivo de configuração.

mongosqld usa as credenciais de administrador para coletar metadados nos namespaces de exemplo e usa as credenciais do cliente de conexão para restringir os dados apenas ao que o cliente está autorizado a ler. Para obter mais informações sobre as permissões necessárias para o usuário administrador, consulte Permissões de usuário para amostragem em cache.

--defaultAuthSource <authSource>

Padrão: admin

Especifica a origem de autenticação MongoDB padrão. Configure este valor para especificar uma origem padrão que o utiliza ao autenticar com um banco de dados MongoDB . Os mecanismos de mongosqld autenticação GSSAPI e PLAIN usam a $external origem, enquanto SCRAM-SHA-1 e SCRAM-SHA-256 usam um banco de dados MongoDB como origem.

Se nenhum valor for fornecido para esta opção, o padrão será o banco de dados MongoDB admin.

A origem de autenticação do $external armazena uma referência aos usuários do sistema em um banco de dados MongoDB chamado $external, mas as credenciais são armazenadas em um sistema externo, não MongoDB, como um servidor LDAP.

Qualquer conexão que use o valor padrão pode omitir o parâmetro source de seu nome de usuário MySQL ou Tableau .

--defaultAuthMechanism <authMechanism>

Padrão: SCRAM-SHA-1

Especifica o mecanismo de autenticação padrão. Defina esse valor para especificar um mecanismo padrão para se conectar ao. Qualquer conexão que use esse valor padrão especificado pode omitir mongosqld o mechanism valor de seu nome de usuário MySQL ou Tableau .

Valor	Descrição
SCRAM-SHA-1	RFC 5802 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a1 função de hash SHA.
SCRAM-SHA-256	Novidades na versão 2.6: RFC 7677 Mecanismo de Autenticação de Resposta de Desafio Salted padrão usando a2 função de hash SHA.
PLAIN (LDAP SASL)	Autenticação externa usando LDAP. Você também pode utilizar o PLAIN para autenticar usuários do banco de dados. PLAIN transmite senhas em texto simples. Esse mecanismo está disponível somente no MongoDB Enterprise.
GSSAPI (Kerberos)	Autenticação externa usando Kerberos. Esse mecanismo está disponível somente no MongoDB Enterprise.

--minimumTLSVersion <TLS1_0|TLS1_1|TLS1_2>

Padrão: TLS1_1

Especifica a versão mínima exigida de TLS para que os consumidores se conectem a. O valor mongosqld padrão TLS1_1 corresponde à versão 1 do1 TLS..

Opções de serviço

--serviceName <service-name>

Nome do serviço do sistema que executa mongosqld o.

--serviceDisplayName <service-name>

Nome de exibição do serviço do sistema que executa mongosqld o.

--serviceDescription <service-name>

Descrição do serviço do sistema que executa mongosqld o.

Kerberos Options

--gssapiHostname <hostname>

Padrão: primeiro endereço IP net.bindIp para.

Novidades na versão 2.5.

Um FQDN com a finalidade de configurar a autenticação Kerberos. O nome de host Kerberos substitui o nome de host somente para a configuração de Kerberos.

--gssapiServiceName <service-name>

Padrão: mongosql

Novidades na versão 2.5.

Nome registrado do serviço usando Kerberos. Esta opção permite que você substitua o componente padrão de nome de serviço Kerberos do Kerberos SPN, por instalação. Se não for especificado, o valor padrão será usado.

--mongo-gssapiServiceName <service-name>

Padrão: mongodb

Novidades na versão 2.5.

Defina o SPN Kerberos ao conectar-se a instâncias Kerberized MongoDB. Este valor deve corresponder ao nome do serviço definido nas instâncias do MongoDB.

--gssapiConstrainedDelegation

Padrão: falso

Novidades na versão 2.11.

Utilize credenciais proxy para autorização Kerberos , habilitando delegação restrita. Requer mongosqld que as credenciais de serviço estejam presentes no keytab do cliente e no keytab do serviço.Consulte Configurar Kerberos para BI Connector para obter mais informações sobre a configuração do Kerberos.

Opções de soquete

--filePermissions <mode>

Padrão: 0700

Especifique as permissões para o arquivo de soquete do domínio Unix.

--noUnixSocket

Desative a escuta em soquetes de domínio Unix.

--unixSocketPrefix <path>

Padrão: /tmp

Especifica um diretório alternativo para o soquete de domínio Unix mongosqld do.

mongosqld criará um arquivo de soquete chamado mysql.sock abaixo desse caminho. Se você não especificar, o soquete --unixSocketPrefix existirá /tmp/mysql.sock em.

Definir opção de parâmetro

--setParameter <parameter>

Parâmetro	Tipo	Corresponde a
"polymorphic_type_conversion_mode=<value>"	string	Determina como avalia os campos de documento especificados com vários tipos de dados. Os valores mongosqld aceitos off são, fast safee. Para saber mais sobre esses valores, consulte Variáveis do sistema.
"type_conversion_mode=<value>"	string	Especifica qual modo mongosqld usa para converter tipos de dados. O BI Connector usa seu próprio modomongosql () por padrão. Os valores aceitos são mongosql mysqle. Para saber mais sobre esses valores, consulte Variáveis do sistema.

O exemplo a seguir inicia e usa mongosqld a --setParameter opção para especificar o modo de conversão de tipo:

mongosqld --setParameter "type_conversion_mode=mongosql"

Opções de registro

systemLog:
  logAppend: <boolean>
  logRotate: "rename"|"reopen"
  path: <string>
  quiet: <boolean>
  verbosity: <integer>

Opções de esquema

schema:
  path: <string>
  maxVarcharLength: <integer>

Opções de amostragem de dados

schema:
  sample:
    size: <integer>
    prejoin: <boolean>
    namespaces: <array of strings>
    uuidSubtype3Encoding: <[old|csharp|java]>
  stored:
    mode: <[custom|auto]>
    source: <string>
    name: <db-name>
  refreshIntervalSecs: <integer>

Opções de tempo de execução

runtime:
  memory:
    maxPerStage: <integer>
    maxPerServer: <integer>
    maxPerConnection: <integer>

runtime.memory.maxPerStage

Tipo: inteiro

Default: unlimited

Especifica a quantidade máxima de memória em bytes que um estágio de execução de consulta pode usar.

runtime.memory.maxPerServer

Tipo: inteiro

Default: unlimited

Novidades na versão 2.5.

Especifica a quantidade máxima de memória em bytes que um processo do pode mongosqld utilizar.

runtime.memory.maxPerConnection

Tipo: inteiro

Default: unlimited

Novidades na versão 2.5.

Especifica a quantidade máxima de memória em bytes que um cliente pode mongosqld utilizar.

Opções de rede

net:
  bindIp: <string>
  port: <integer>
  unixDomainSocket:
    enabled: <boolean>
    pathPrefix: <string>
    filePermissions: <string>
  ssl:
    mode: <string>
    allowInvalidCertificates: <boolean>
    PEMKeyFile: <string>
    PEMKeyPassword: <string>
    CAFile: <string>

"72.198.41.200,72.198.41.201,72.198.41.202"

Opções de segurança

security:
  enabled: <boolean>
  defaultMechanism: <string>
  defaultSource: <string>
  gssapi:
    hostname: <string>
    serviceName: <string>

Opções de host do MongoDB

mongodb:
  versionCompatibility: <string>
  net:
    uri: <string>
    ssl:
      enabled: <boolean>
      allowInvalidCertificates: <boolean>
      allowInvalidHostnames: <boolean>
      PEMKeyFile: <string>
      PEMKeyPassword: <string>
      CAFile: <string>
      CRLFile: <string>
      FIPSMode: <boolean>
    auth:
      username: <username>
      password: <password>
      source: <auth-db-name>
      mechanism: <auth-mechanism>
      gssapiServiceName: <service>

Opções de gerenciamento de processos

processManagement:
  service:
    name: <string>
    displayName: <string>
    description: <string>

Definir opções de parâmetros

setParameter:
  polymorphic_type_conversion_mode: <string>
  type_conversion_mode: <string>

Essas opções de arquivo de configuração também estão disponíveis como variáveis do sistema. Para mais informações, consulte Variáveis do sistema.

Carregar valores de configuração externa

Você pode usar diretivas de expansão em seu arquivo de configuração para carregar valores de configuração de origem externa. As diretivas de expansão ocultam informações confidenciais, como certificados de segurança e senhas.

Para saber mais sobre o uso de diretivas de expansão, consulte Valores de arquivo de configuração de origem externa no manual MongoDB.

Exemplo de arquivo de configuração

systemLog:
  logAppend: false
  path: "/var/log/mongosqld/mongosqld.log"
  verbosity: 2
security:
  enabled: true
mongodb:
  net:
    uri: "mongo.example.com:27017"
    auth:
      username: "root"
      password: "changeme"
net:
  bindIp: 192.0.2.14
  port: 3307
  ssl:
    mode: "allowSSL"
    PEMKeyFile: "/vagrant/certificates/mongosqld-server.pem"
    CAFile: "/vagrant/certificates/ca.crt"
schema:
  sample:
    namespaces: "inventory.*"
processManagement:
  service:
    name: mongosqld
    displayName: mongosqld
    description: "BI Connector SQL proxy server"

mongosqld com um Arquivo de esquema

Utilize a opção --schema para especificar um arquivo de esquema para para mongosqld utilizar.

mongosqld --schema /path/to/schema-file.drdl

Especificar uma Coleção para Amostragem

Use a opção--sampleNamespacespara especificar um banco de dados e uma collection paramongosqldpara obter dados de amostra. Se você iniciar omongosqldsem a opção--sampleNamespaces, ele coletará amostras de dados de todos os bancos de dados disponíveis, exceto os bancos de dados admin e local.

Os seguintes exemplos de dados de amostras de uma collection denominada addresses em um banco de dados denominado contacts:

mongosqld --sampleNamespaces contacts.addresses

Especificar Múltiplas Coleções para Amostragem

Para obter amostras de dados de toda a collection em um banco de dados, use a opção com --sampleNamespaces um* curinga ().

Os seguintes exemplos de dados de amostras de todas as coleções em um banco de dados chamado inventory:

mongosqld --sampleNamespaces 'inventory.*'

Você pode repetir na --sampleNamespaces linha de comando para obter amostras de dados de diversas collections em um banco de dados ou de diversas collections em diversos bancos de dados.

Os seguintes exemplos de dados de amostras de todas as collections em bancos de dados denominados cars e boats:

mongosqld --sampleNamespaces 'cars.*' \
          --sampleNamespaces 'boats.*' \

Você pode misturar e combinar curingas e collections específicas com várias --sampleNamespaces opções.

O exemplo a seguir mostra dados de todas as collections em um banco de dados chamado orders, bem como as collections FY2015 e FY2016 do banco de dados expenses:

mongosqld --sampleNamespaces 'orders.*' \
          --sampleNamespaces expenses.FY2015 \
          --sampleNamespaces expenses.FY2016 \

Excluir Bancos de Dados e Coleções da Amostragem

Para excluir namespaces especificados do processo de amostragem de dados, preceda o namespace com um caractere ~ (tilde). O exemplo a seguir inclui todos os bancos de dados e collections , exceto a collection apples no banco de dados fruit:

mongosqld --sampleNamespaces ~fruit.apples

Use o caractere curinga * para indicar todas as collections em um banco de dados. O exemplo seguinte exclui todo o banco de dados do vehicles da amostragem de dados:

mongosqld --sampleNamespaces '~vehicles.*'

Amostra de Todos Documentos de uma Coleção

Se você tiver uma collection na qual alguns documentos tenham campos diferentes de outros e quiser garantir que o esquema leve todos eles em consideração, defina a --sampleSize opção 0 como. Isso faz com que examine todos mongosqld namespace os documentos no especificado ao criar seu esquema.

O exemplo a seguir instrui a criar o esquema com base em todos os documentos mongosqld no inventory.electronics namespace .

mongosqld --sampleNamespaces inventory.electronics \
          --sampleSize 0

Especifique um banco de dados para persistir um esquema

Utilize a opção para especificar um banco de dados --schemaSource no qual armazenar informações de esquema. Utilize a opção --schemaMode mongosqld para especificar se o pode gravar no banco de dados do esquema ou somente ler a partir dele.

O comando de exemplo a seguir usa um banco de dados chamado sampleDb para armazenar informações de esquema e --schemaMode define auto como.

mongosqld --schemaSource sampleDb --schemaMode auto

Especifique um intervalo de reamostragem de dados

Use a opção--schemaRefreshIntervalSecspara especificar um intervalo em segundos paramongosqldredefinir a amostra de dados e gerar novamente o esquema. O valor padrão para esta opção é 0, o que significa quemongosqldnunca reamostra de dados.

Se você definir um intervalo de reamostragem com--schemaRefreshIntervalSecse especificar um banco de dados de esquema com--schemaSource, não poderá definir--schemaModecomo custom.

O exemplo a seguir não especifica um banco de dados de esquema ou um arquivo de esquema, portanto, ele mantém seu esquema na memória. Utiliza para especificar um intervalo de reamostragem de dados --schemaRefreshIntervalSecs de 3600 segundos.

mongosqld --schemaRefreshIntervalSecs 3600

mongosqld com Autenticação Ativada

Para conectar o a uma mongosqld instância MongoDB executando com autenticação habilitada, utilize a opção e forneça credenciais de usuário MongoDB --auth .

O exemplo a seguir começa com as credenciais de um usuário mongosqld chamado reportsUser com a reportsPass senha, que tem acesso ao reports.inventory namespace.

mongosqld --auth \
          --mongo-username reportsUser \
          --mongo-password reportsPass \
          --sampleNamespaces reports.inventory

Este exemplo não especifica um banco de dados de autenticação com a --mongo-authenticationSource opção, portanto, o padrão admin é. Ele não especifica um mecanismo de autenticação com a --mongo-authenticationMechanism opção, portanto, o padrão SCRAM-SHA-1 é.

mongosqld com um arquivo de configuração

Se você deseja especificar um arquivo de configuração que salva logs em /var/log/mongosqld.log e carrega um esquema de /var/schema.drdl, Você pode salvar um arquivo como o seguinte para /etc/mongosqld.conf

systemLog:
  path: /var/log/mongosqld.log
schema:
  path: /var/schema.drdl

Você pode então iniciar mongosqld com a --config opção:

mongosqld --config /etc/mongosqld.conf

Para obter mais informações sobre como iniciar mongosqld como um serviço do sistema, consulte o Guia de instalação do seu sistema operacional.

Uso com Atlas

O Atlas é um serviço de nuvem para executar, monitorar e manter implantações do MongoDB, incluindo o provisionamento de servidores dedicados para instâncias do MongoDB.

O Atlas usa TLS/SSL para criptografar conexões e impõe autenticação por padrão.

mongosqld pode usar qualquer certificado TLS válido emitido por um autoridade de certificação ou um certificado autoassinado. Se você usa um certificado autoassinado, embora o canal de comunicação seja criptografado, não haverá validação da identidade do servidor. Embora essa situação impeça a espionagem da conexão, ela o deixa vulnerável a um ataque man-in-the-middle. O uso de um certificado assinado por uma autoridade de certificação confiável permitirá que seu cliente MySQL verifique a identidade do servidor.

Para fins de teste, você pode criar um arquivo de chave .pem denominado test.pem usando a ferramenta openssl:

openssl req -nodes -newkey rsa:2048 -keyout test.key -out test.crt -x509 -days 365 -subj "/C=US/ST=test/L=test/O=test Security/OU=IT Department/CN=test.com"
cat test.crt test.key > test.pem

Inicie o com as seguintes mongosqld opções:

• --mongo-ssl

• --auth

• --sslPEMKeyFile

• --mongo-uri

• --sslMode

• --mongo-username

• --mongo-password

Se você tiver nomeado o arquivo de chave test.pem como no exemplo anterior, poderá executar o seguinte, substituindo o URI do cluster e as credenciais de login:

mongosqld --mongo-ssl \
          --auth \
          --sslPEMKeyFile test.pem \
          --mongo-uri <uri> \
          --sslMode allowSSL \
          --mongo-username <username> \
          --mongo-password <password>

Passe seu nome de usuário, senha e banco de dados de autenticação para seu cliente SQL. Por exemplo, usando mysql sem verificar seu mongosqld certificado de servidor:

mysql --host <mongosqld-host> --port <mongosqld-port> -u <username>?source=admin -p --ssl-mode required --enable-cleartext-plugin

Consulte Conectar a partir do cliente MySQL para obter mais detalhes sobre como usar o cliente mysql com o BI Connector.

Configurações inválidas

As seguintes configurações de opção são inválidas e causam um erro na mongosqld inicialização.