Esta página descreve como se conectar a uma instância do banco de dados federado do Atlas ou a um banco de dados do MongoDB Enterprise local com o Tableau (desktop ou servidor) usando o conector personalizado do Tableau.
A interface SQL oferece suporte a conexões de clusters Atlas no MongoDB 5.0 e posteriores e de clusters autogerenciados no MongoDB 6.0 e posteriores.
Pré-requisitos
Antes de se conectar ao Tableau, verifique se você atende aos pré-requisitos a seguir:
Uma instância do banco de dados federado do Atlas ou um banco de dados EA autogerenciado.
Tableau desktop ou servidor. Para o Tableau Server, autenticação SCRAM é o único mecanismo de autenticação suportado no momento.
Procedimento
O procedimento para se conectar ao MongoDB com o Tableau compreende as seguintes etapas:
Baixe o driver JDBC e o conector Tableau
Certifique-se de ter habilitado a Interface SQL para seu cluster.
Consulte Início Rápido para obter instruções detalhadas sobre como ativar o Atlas SQL.
Consulte Configuração local para obter instruções detalhadas sobre como habilitar a interface SQL para bancos de dados EA.
Baixe o driver JDBC do MongoDB.
Baixe a versão mais recente do driver JDBC do MongoDB.
Observação
Consulte Conectar com o Driver JDBC para obter mais detalhes sobre o Driver JDBC do MongoDB.
Mova o arquivo ALL JAR baixado para o diretório correto do seu sistema operacional:
Sistema operacionalCaminho da pastaWindows
C:\Program Files\Tableau\DriversmacOS
~/Library/Tableau/DriversLinux
/opt/tableau/tableau_driver/jdbc
Baixe e instale o conector personalizado do Tableau.
Baixe o arquivo Tableau taco para a versão mais recente.
Mova o arquivo taco baixado para o diretório correto do seu sistema operacional:
Sistema operacionalCaminho da pastaWindows
C:\Users\<user>\Documents\My Tableau Repository\ConnectorsmacOS
~/Documents/My Tableau Repository/ConnectorsLinux
/opt/tableau/connectors
Importante
Atualizando seu conector
Se você baixar uma nova versão do conector personalizado do Tableau, exclua o arquivo antigo do conector personalizado do Tableau do seu diretório de conectores para garantir que o Tableau usará a versão mais recente.
Obtenha informações de conexão do banco de dados MongoDB
Execute as seguintes etapas para obter suas informações de conexão do banco de dados MongoDB :
Use sua string de conexão para mongosh.
Conecte-se com o Tableau
Insira suas informações de conexão do banco de dados :
Insira sua string de conexão da Interface SQL . Consulte Obter informações de conexão do banco de dados MongoDB para obter instruções detalhadas sobre como obter sua string de conexão.
Selecione seu método de autenticação.
Escolha seu Authentication Mechanism no menu suspenso.
Username: Insira seu nome de usuário MongoDB .
Password: Insira sua senha do MongoDB .
Configure seu certificado PEM usando um dos seguintes métodos:
Usar um caminho de arquivo PEM:
No seu arquivo
mongodb_jdbc.properties, defina a propriedadex509pempathpara o caminho do arquivo PEM. Por exemplo,x509pempath=/certs/client-cert.pem.Se seu arquivo PEM não estiver criptografado,não Provide PEM Contents selecione. Nenhuma ação adicional é necessária.
Se o seu arquivo PEM estiver criptografado,selecione Provide PEM Contents e digite a senha do arquivo no Password campo.
Fornecer conteúdo PEM:
Marque a caixa de seleção ao lado de Provide PEM Contents e insira os dados do seu certificado no campo Password :
Conteúdo não criptografado: cole o conteúdo completo do certificado diretamente no campo}.
Conteúdo criptografado: cole um objeto JSON contendo o conteúdo e a senha:
{ "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }
Insira o nome principal do Kerberos no campo Username. Por exemplo, user@EXAMPLE.COM.
Nenhuma propriedade ou campo adicional é necessário na caixa de diálogo de conexão do OIDC.