Crie um DSN de sistema

• Install the connector BI and configure it para se conectar ao definir de réplicas.

  Observação

  Este pré-requisito não se aplica se você estiver usando o Conector BI for Atlas.

• Baixe e instale o Visual C++ Redistributable para Visual Studio 2015.

• Baixe e instale o MongoDB Conector BI ODBC Driver.

• Install the connector BI and configure it para se conectar ao definir de réplicas.

  Observação

  Este pré-requisito não se aplica se você estiver usando o Conector BI for Atlas.

• Baixe e instale o MongoDB Conector BI ODBC Driver.

• Instala o BI Connector no Linux baseado em Red Hat Enterprise ou Linux baseado em Debian e configure-o para conectar a seu conjunto de réplicas.

  Observação

  Este pré-requisito não se aplica se você estiver usando o Conector BI for Atlas.

• Baixe e extraia o Driver ODBC do MongoDB BI Connector para sua plataforma.

1. Inicie o programa Microsoft ODBC Data Sources.

   Escolha a versão do programa (64 bits ou 32 bits) que é apropriado para o seu sistema e versão do driver ODBC.

2. Selecione a guia System DSN.

3. Clique no botão Add.

   

   clique para ampliar

4. Selecione um conector de BI do MongoDB ODBC Driver na lista de drivers disponíveis.

   Selecione o MongoDB ODBC ANSI Driver ou o MongoDB ODBC Unicode Driver e clique em OK.

   Observação

   O driver ODBC ANSI oferece desempenho máximo, mas tem um definir limitado. O driver ODBC Unicode supports a wider character set, but may have slightly less performant as a result.

5. Preencha os campos de formulário necessários.

   Clique no botão Details para expor a metade inferior do formulário.

   Os seguintes campos de formulário são obrigatórios:

   Nome do campo	Descrição
   Data Source Name	Um nome de sua escolha.
   TCP/IP Server	Endereço do servidor onde seu processo mongosqld está sendo executado. Se você habilitou o BI Connector no MongoDB Atlas, você pode encontrar o hostname do servidor onde mongosqld está sendo executado nas informações de conexão do seu cluster.
   Port	Número da porta do seu processo mongosqld.
   Database	O nome do banco de dados ao qual se conectar, por exemplo, test.

6. (Opcional) Se a autenticação estiver habilitada, forneça informações de conexão.

   Os campos a seguir são obrigatórios ao executar com --auth habilitado ou ao se conectar a um connector BI para instância do Atlas.

   Nome do campo	Descrição
   User	Nome de usuário do usuário do MongoDB que está autenticado para usar o banco de dados de destino. Você pode especificar as seguintes opções de autenticação após seu nome de usuário como parâmetros de consulta de estilo URI: Opção de conexão Descrição source Especifica o nome do banco de dados que armazena as credenciais do usuário. Se você não especificar esta opção, o MongoDB Connector para BI tornará padrão o banco de dados atual associado à conexão MySQL. Para mecanismos de autenticação como PLAIN (LDAP) ou GSSAPI (Kerberos) que delegam o armazenamento de credenciais a outros serviços, defina o valor source como $external. Não é exigido se o defaultSource estiver configurado em seu arquivo de configuração do MongoDB Connector para BI. mechanism Especifique o mecanismo que o MongoDB Connector para BI deve usar para autenticar a conexão. Os valores aceitos incluem: SCRAM-SHA-1 (padrão) SCRAM-SHA-256 PLAIN (LDAP SASL) GSSAPI (Kerberos) LDAP e Kerberos exigem MongoDB Enterprise. Configure a origem como $external ao usar LDAP ou Kerberos. Não é exigido se o defaultMechanism estiver configurado em seu arquivo de configuração do MongoDB Connector para BI. X.509 não é compatível. Nome de usuário e Senha LDAP Kerberos Por exemplo, para autenticar como usuário grace utilizando o banco de banco de dados do admin e o mecanismo de autenticação Desafio e Resposta (SCRAM-SHA-1), escreva o nome de usuário neste formato: grace?source=admin Por exemplo, para autenticar como usuário grace com o mecanismo de autenticação LDAP (PLAIN), escreva o nome de usuário neste formato: grace?mechanism=PLAIN&source=$external Por exemplo, para autenticar como usuário grace no EXAMPLE.COM Realm Kerberos com o mecanismo de autenticação Kerberos, escreva o nome de usuário neste formato: grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Para obter mais informações sobre a configuração do Kerberos, consulte Configurar Kerberos para BI Connector.
   Password	A senha do usuário autenticado. Você não pode usar chaves ({ }) na senha do seu banco de dados porque esses são caracteres especiais no driver ODBC .
   Authentication	O método de autenticação padrão. Ao usar o MongoDB BI Connector ODBC Driver, este campo não é obrigatório. Para usar o plug-in de autenticação em conjunto com outro driver ODBC, preencha este campo com a string mongosql_auth.

7. (Opcional) Se TLS/SSL estiver habilitado, preencha os campos do formulário TLS/SSL.

   Acesse os campos do formulário TLS/SSL clicando em Details >> e, em seguida, na guia SSL. Os parâmetros a seguir estão disponíveis e podem ser necessários, dependendo da configuração do TLS/SSL:

   Nome do campo	Descrição
   SSL Key	A localização do arquivo de chave do cliente/servidor.
   SSL Cert	O local do arquivo de certificado do cliente/servidor.
   SSL CA File	O local do arquivo que contém uma lista de autoridades de certificação confiáveis.
   SSL Cipher	O local do arquivo que contém uma lista de permitidos Cifras.
   SSL Mode	Defina como REQUIRED para exigir um canal criptografado. Se canal criptografado não for fornecido, a conexão falhará.
   RSA Public Key	O local do arquivo PEM que contém a chave pública RSA.

   Observação

   O BI Connector for Atlas usada TLS/SSL, mas não requer nenhuma configuração TLS/SSL para ser configurada em seu sistema DSN.

8. Clique no botão Test para testar a conexão ODBC.

   Se a conexão for bem-sucedida, clique em OK para adicionar o DSN. Se a conexão falhar, verifique se o usuário do MongoDB está autenticado corretamente para o banco de dados nomeado na conexão.

1. Inicie o ODBC Manager.

   Observação

   O ODBC Manager está incluído no Driver ODBC do MongoDB BI Connector.

   Importante

   A edição 1.0.16 do ODBC Manager incluída no driver ODBC no MongoDB BI Connector não é compatível com macOS Catalina ou versões posteriores do macOS. Se você estiver usando a versão Catalina ou uma versão posterior do macOS, baixe e instale a versão mais recente (1.0.19) do gerenciador ODBC.

2. Clique em System DSN e, em seguida, clique em Add.

   

3. Selecione um conector de BI do MongoDB ODBC Driver na lista de drivers disponíveis.

   Selecione o driver MongoDB ANSI ODBC ou o driver MongoDB Unicode ODBC e clique em OK.

   Observação

   O driver ODBC ANSI oferece desempenho máximo, mas tem um definir limitado. O driver ODBC Unicode supports a wider character set, but may have slightly less performant as a result.

4. Insira um Data Source Name (DSN).

   Ou insira um Description.

   Observação

   Não feche a janela de configuração. Prossiga para a próxima etapa.

5. Adicione as palavras-chave necessárias.

   1. Adicione um par de valores de palavra-chave clicando no botão Add .

   2. Modifique o Keyword clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   3. Modifique o Value clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   Usando o procedimento acima, adicione as seguintes palavras-chave:

   Keyword	Valor
   Servidor	O nome do host ou endereço IP do host do MongoDB Connector for BI . IMPORTANTE: Use 127.0.0.1 para conectar usando TCP ao localhost. Se você especificar um valor diferente de um endereço IP, o BI Connector tentará se conectar usando o soquete Unix.
   Porta	O número da porta IANA do MongoDB Connector for BI. O padrão é 3307.
   Banco de dados	O banco de dados a ser usado após a conexão. Você deve usar esta palavra-chave ao se conectar com o Microsoft Excel.

   Para a lista completa de parâmetros ODBC, consulte parâmetros de conexão do Connector/ODBC.

   Por exemplo, a configuração de DSN do usuário deve ser semelhante a esta:

   

   Observação

   Não feche a janela de configuração. Prossiga para a próxima etapa.

6. (Opcional) Se a autenticação estiver habilitada, adicione as palavras-chave de autenticação.

   1. Adicione um par de valores de palavra-chave clicando no botão Add .

   2. Modifique o Keyword clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   3. Modifique o Value clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   Usando o procedimento acima, adicione as seguintes palavras-chave:

   Keyword	Valor
   UID	O nome de usuário do usuário autorizado a acessar o banco de dados ativo do MongoDB Connector for BI. Você pode especificar as seguintes opções de autenticação após seu nome de usuário como parâmetros de consulta de estilo URI: Opção de conexão Descrição source Especifica o nome do banco de dados que armazena as credenciais do usuário. Se você não especificar esta opção, o MongoDB Connector para BI tornará padrão o banco de dados atual associado à conexão MySQL. Para mecanismos de autenticação como PLAIN (LDAP) ou GSSAPI (Kerberos) que delegam o armazenamento de credenciais a outros serviços, defina o valor source como $external. Não é exigido se o defaultSource estiver configurado em seu arquivo de configuração do MongoDB Connector para BI. mechanism Especifique o mecanismo que o MongoDB Connector para BI deve usar para autenticar a conexão. Os valores aceitos incluem: SCRAM-SHA-1 (padrão) SCRAM-SHA-256 PLAIN (LDAP SASL) GSSAPI (Kerberos) LDAP e Kerberos exigem MongoDB Enterprise. Configure a origem como $external ao usar LDAP ou Kerberos. Não é exigido se o defaultMechanism estiver configurado em seu arquivo de configuração do MongoDB Connector para BI. X.509 não é compatível. Nome de usuário e Senha LDAP Kerberos Por exemplo, para autenticar como usuário grace utilizando o banco de banco de dados do admin e o mecanismo de autenticação Desafio e Resposta (SCRAM-SHA-1), escreva o nome de usuário neste formato: grace?source=admin Por exemplo, para autenticar como usuário grace com o mecanismo de autenticação LDAP (PLAIN), escreva o nome de usuário neste formato: grace?mechanism=PLAIN&source=$external Por exemplo, para autenticar como usuário grace no EXAMPLE.COM Realm Kerberos com o mecanismo de autenticação Kerberos, escreva o nome de usuário neste formato: grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Para obter mais informações sobre a configuração do Kerberos, consulte Configurar Kerberos para BI Connector.
   PWD	A senha associada ao UID. Você não pode usar chaves ({ }) na senha do seu banco de dados porque esses são caracteres especiais no driver ODBC .

   Para a lista completa de parâmetros ODBC, consulte parâmetros de conexão do Connector/ODBC.

   Por exemplo, a configuração de DSN do usuário deve ser semelhante a esta:

   

7. (Opcional) Se TLS/SSL estiver habilitado, adicione as palavras-chave TLS/SSL.

   1. Adicione um par de valores de palavra-chave clicando no botão Add .

   2. Modifique o Keyword clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   3. Modifique o Value clicando duas vezes nele, digitando a palavra-chave desejada e pressionando Enter.

   Observação

   O BI Connector for Atlas usada TLS/SSL, mas não requer nenhuma configuração TLS/SSL para ser configurada em seu sistema DSN.

   Usando o procedimento acima, adicione as seguintes palavras-chave dependendo da configuração do TLS/SSL:

   Keyword	Valor
   SSLKEY	O caminho para o arquivo de chave .pem.
   SSLCERT	O caminho para o certificado SSL.
   SSLMODE	Defina como REQUIRED.
   SSLCA	O caminho para o arquivo de autoridade de certificação SSL.
   SSLCIPHER	O caminho para o arquivo que contém uma lista de cifras permitidas.
   RSAKEY	Caminho completo para o arquivo PEM contendo a chave pública RSA.
   ENABLE_CLEARTEXT_PLUGIN	Defina como 1 para habilitar a autenticação de texto simples.

   Observação

   Se você estiver se conectando ao Microsoft Excel, os certificados devem estar localizados no diretório /Library/ODBC/.

   Para a lista completa de parâmetros ODBC, consulte parâmetros de conexão do Connector/ODBC.

   Por exemplo, a configuração de DSN do usuário deve ser semelhante a esta:

   

8. Clique em OK para finalizar a criação do DSN.

O procedimento a seguir foi testado com Ubuntu e RHEL e deve funcionar de forma semelhante com outras distribuições Linux.

[MongoDBODBC]
DESCRIPTION = ODBC for MongoDB BI Connector
DRIVER      = /usr/local/lib/libmdbodbcw.so
TRACE       = Off
TRACEFILE   = stderr
READONLY    = yes
SERVER      = <server address>
PORT        = <port number>
USER        = <username>
PASSWORD    = <password>
DATABASE    = <dbname>
; optional SSL configuration
SSLKEY      = </path/to/.pem-key-file>
SSLCERT     = </path/to/ssl-certificate>
SSLMODE     = DISABLED|PREFERRED|REQUIRED
SSLCA       = </path/to/ssl-ca-list-file>
SSLCAPATH   = </path/to/ssl-ca-file-directory>
SSLCIPHER   = </path/to/ssl-cipher-file>
RSAKEY      = </path/to/rsa-public-key-file>

sudo apt-get install unixodbc

sudo yum install unixODBC

iusql -v MongoDBODBC

SQL> use test;
SQL> show tables;