Menu Docs
Página inicial do Docs
/
BI Connector
/
Conectar ferramentas de BI

Conectar do cliente MySQL

Nesta página

  • Conectar do MySQL sem autenticação ou TLS/SSL
  • Conectar do MySQL com Autenticação
  • Conectar do MySQL com autenticação e TLS/SSL

Você pode usar o cliente MySQL de linha de comando para se conectar ao Conector MongoDB para BI.

Conectar do MySQL sem autenticação ou TLS/SSL

Para se conectar a uma instância do mongosqld escutando na porta padrão do MySQL 3307, execute o seguinte comando:

Windows 32-bits

"C:\Program Files (x86)\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --protocol tcp --port 3307

Windows 64-bits

"C:\Program Files\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --protocol tcp --port 3307
mysql --protocol tcp --port 3307
mysql --protocol tcp --port 3307

Conectar do MySQL com Autenticação

Instale o plug-in de autenticação C conforme descrito em Plug-in de autenticação C.

Importante

O plugin C Authentication foi desenvolvido em relação ao MySQL 5.7.X Community Edition (64-bit) e testado com o MySQL 5.7.X Community Edition e a versão mais recente do MongoDB Connector for BI. O plugin não é compatível com MySQL Server ou Connector/ODBC driver versão 8 e posterior.

O exemplo a seguir usa o plug-in de autenticação C para se conectar a uma instância mongosqld que escuta na porta 3307 como usuário reportsUser. O shell do MySQL solicita a senha após a inserção do comando.

Windows 32-bits

"C:\Program Files (x86)\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --user='reportsUser?source=admin' ^
  --default-auth=mongosql_auth -p

Windows 64-bits

"C:\Program Files\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --user='reportsUser?source=admin' ^
  --default-auth=mongosql_auth -p

Observação

Este exemplo pressupõe que o arquivo de plugin de autenticação mongosql_auth.so esteja localizado na pasta de plugin MySQL padrão:

Plataforma
Localização padrão
Windows 32-bits
C:\Program Files (x86)\MySQL\MySQL Server 5.7\lib\plugin
Windows 64-bits
C:\Program Files\MySQL\MySQL Server 5.7\lib\plugin
mysql --user='reportsUser?source=admin' --default-auth=mongosql_auth -p

Observação

Este exemplo pressupõe que o arquivo de plugin de autenticação mongosql_auth.so esteja localizado na pasta de plugin MySQL padrão. A localização da pasta de plugin varia de acordo com a plataforma, mas você pode localizá-la executando o seguinte comando:

mysql_config --plugindir

mysql_config.pl pode encontrar o diretório de plug-ins apenas em hosts macOS e Linux.

mysql --user='reportsUser?source=admin' --default-auth=mongosql_auth -p

Observação

Este exemplo pressupõe que o arquivo de plugin de autenticação mongosql_auth.so esteja localizado na pasta de plugin MySQL padrão. A localização da pasta de plugin varia de acordo com a plataforma, mas você pode localizá-la executando o seguinte comando:

mysql_config --plugindir

mysql_config.pl pode encontrar o diretório de plug-ins apenas em hosts macOS e Linux.

Para opções adicionais, consulte os Comandos MySQL.

Conectar do MySQL com autenticação e TLS/SSL

Importante

A distribuição da Comunidade MySQL usa o yaSSL BibliotecaSSL para criptografar conexões. MySQL Enterprise usa OpenSSL que é compatível com o MongoDB connector para BI. Use o MySQL Enterprise para conectar - se ao BI Connector por TLS / SSL.

Para conectar-se a uma instância mongosqld escutando na porta 3307, como usuário grace usando mecanismo de autenticação PLAINe usando certificados TLS/SSL CA e x.509 específicos, execute o seguinte comando:

Windows 32-bits

"C:\Program Files (x86)\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --enable-cleartext-plugin --protocol tcp --port 3307 ^
  --user='grace?mechanism=PLAIN&source=$external' ^
  --ssl-ca=X:\path_to_the_CAcert\ca.crt ^
  --ssl-key=X:\path_to_my_certificate_key\mysql.key ^
  --ssl-cert=X:\path_to_my_client_certificate\mysql.crt ^
  -p

Windows 64-bits

"C:\Program Files\MySQL\MySQL Server 5.7\bin\mysql.exe" ^
  --enable-cleartext-plugin --protocol tcp --port 3307 ^
  --user='grace?mechanism=PLAIN&source=$external' ^
  --ssl-ca=X:\path_to_the_CAcert\ca.crt ^
  --ssl-key=X:\path_to_my_certificate_key\mysql.key ^
  --ssl-cert=X:\path_to_my_client_certificate\mysql.crt ^
  -p
mysql --enable-cleartext-plugin --protocol tcp --port 3307 \
  --user='grace?mechanism=PLAIN&source=$external' \
  --ssl-ca=/path_to_the_CAcert/ca.crt \
  --ssl-key=/path_to_my_certificate_key/mysql.key \
  --ssl-cert=/path_to_my_client_certificate/mysql.crt \
  -p
mysql --enable-cleartext-plugin --protocol tcp --port 3307 \
  --user='grace?mechanism=PLAIN&source=$external' \
  --ssl-ca=/path_to_the_CAcert/ca.crt \
  --ssl-key=/path_to_my_certificate_key/mysql.key \
  --ssl-cert=/path_to_my_client_certificate/mysql.crt \
  -p

Se estiver usando a fonte de autenticação $external, envolva seu nome de usuário entre aspas simples ou escape do caractere $ com uma barra invertida para impedir que seu shell execute a interpolação.

A autenticação exige que seu cliente envie sua senha em texto sem formatação. Para enviar a senha em texto simples:

  • Use a opção --enable-cleartext-plugin mostrada no exemplo anterior ou

  • Configure a variável de ambiente LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN=1.

Para opções adicionais, consulte os Comandos MySQL.

Consulte a documentação do MySQL para obter detalhes adicionais sobre como ativar o plug-in de texto não criptografado do MySQL.