Informações do conceito
O MongoDB é um serviço de dados na nuvem. Use o conector de dados do MongoDB para importar dados da sua empresa residentes no MongoDB.
Nota
O Analytics oferece o MongoDB como um conector opcional. Se esse conector não estiver disponível na janela Acesso a dados, é provável que o coletor não tenha sido selecionado durante a instalação. Para obter mais informações, consulte Instale opcionalmente os conectores de dados do Analytics e o mecanismo do Python.
Antes de começar
Para conectar-se ao MongoDB, você deve obter:
-
o nome ou o endereço IP do servidor que hospeda o banco de dados MongoDB
- a porta de conexão correta
- o nome do banco de dados MongoDB
Para obter ajuda na coleta dos pré-requisitos de conexão, entre em contato com o administrador do MongoDB na sua organização. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte da MongoDB.
Criar uma conexão ao MongoDB
- No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
- Na guia Novas conexões, na seção Conectores do ACL, selecione MongoDB.
Dica
Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.
- No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.
Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.
A conexão do MongoDB é salva na guia Conexões existentes. No futuro, você poderá reconectar o MongoDB usando a conexão salva.
Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do MongoDB, consulte Trabalho com a Janela de Acesso a Dados.
Configurações de conexão
Configurações básicas
| Configuração | Descrição | Exemplo |
|---|---|---|
| Servidor | O nome de host ou o endereço IP do servidor que hospeda o banco de dados MongoDB. | |
| Porta |
O número da porta TCP usada pelo servidor do MongoDB para ouvir as conexões dos clientes. O valor padrão é 27017. |
27017 |
| Banco de dados | O nome do banco de dados MongoDB. | |
| Conectar ao conjunto de réplica |
Especifica se o driver pode acessar conjuntos de réplica na sua implementação do MongoDB:
|
Desabilitado |
| Nome do conjunto de réplica | O nome do conjunto de réplica que será acessado pelo driver. | |
| Servidores secundários |
Uma lista de servidores, separados por vírgula, que serão usados na conexão a um conjunto de réplica. Para indicar a porta TCP que o servidor está usando para ouvir as conexões dos clientes, anexe dois pontos (:) e o número da porta ao nome ou endereço IP do servidor. |
|
| Mecanismo de autenticação |
O mecanismo de autenticação usado pelo MongoDB para autenticar a conexão:
|
Sem autenticação |
| Nome do serviço | O nome principal do serviço do Kerberos do servidor do MongoDB. | mongodb |
| Origem de autenticação |
O nome do banco de dados MongoDB para autenticação. Esse valor somente é necessário se o banco de dados de autenticação é diferente do banco de dados de recuperação de dados. |
administrador |
| Nome de usuário | O nome do usuário utilizado para autenticação no MongoDB. | |
| Senha | A senha usada para autenticação no MongoDB. |
Configurações avançadas
| Configuração | Descrição | Exemplo |
|---|---|---|
| Ativar SSL | Especifica se o driver usa SSL para conexão ao servidor. | Desabilitado |
| Permitir certificado autoassinado | Especifica se o driver permite certificados SSL autoassinados do servidor. | Desabilitado |
| Arquivo de chave PEM | O caminho completo do arquivo .pem que contém o certificado para verificação do cliente. | |
| Senha da chave PEM | A senha do arquivo de certificado do cliente especificada no campo Arquivo de chave PEM. | |
| Arquivo de autoridade de certificado | O caminho completo do arquivo .pem usado para verificar o servidor. | |
| Diretório de autoridade de certificado | O caminho completo do diretório que contém os arquivos .pem usados para verificar o servidor. Essa configuração habilita o driver a acessar vários arquivos .pem para verificação de SSL. | |
| Arquivo de lista de revogações de certificados | O caminho completo do arquivo .pem que contém a lista de certificados revogados. | |
| Ativar armazenamento em buffer duplo |
Especifica se o driver recupera dados usando buffers duplicados. O driver do MongoDB consegue usar buffers duplicados para aumentar o desempenho do driver em operações SELECT. |
Habilitado |
| Expor cadeias como SQL_WVARCHAR |
Especifica se o tipo de dados cadeia é mapeado para SQL_WVARCHAR ou SQL_VARCHAR. |
Habilitado |
| Expor binários como SQL_LONGVARBINARY | Especifica se o driver retorna colunas binárias como dados do tipo SQL_LONGVARBINARY ou SQL_VARBINARY. | Habilitado |
| Ativar transferência de otimizações | Especifica se o driver otimiza associações entre tabelas virtuais e passa otimizações de filtragem e agregação ao banco de dados MongoDB para processamento. | Habilitado |
| Documentos a recuperar por bloco |
O número máximo de documentos que uma consulta retorna por vez. Essa configuração também determina o tamanho do buffer usado quando os buffers duplicados estão habilitados. O valor padrão é 4096. |
4096 |
| Tamanho da coluna de cadeia |
O número máximo de caracteres que pode estar contido em colunas STRING. O valor padrão é 255. |
255 |
| Tamanho da coluna de binários |
O comprimento de dados máximo para colunas binárias. O valor padrão é 32767. |
32767 |
| Mecanismo de metadados |
Especifica onde o driver procura a definição do esquema:
|
Banco de dados |
| Arquivo local | O caminho completo de um arquivo JSON local que contém a definição do esquema a ser usado pelo driver na conexão ao MongoDB. | |
| Método de amostragem |
Especifica como o driver amostra dados ao gerar uma definição de esquema temporário:
|
Avançar |
| Documentos a amostrar (0 para todos os documentos) |
O número máximo de registros que o driver pode amostrar para gerar uma definição de esquema temporário. Quando essa opção está definida como 0, o driver amostra todos os documentos no banco de dados. O valor padrão é 100. |
100 |
| Tamanho do incremento de amostragem |
O intervalo da amostragem de registros pelo driver ao percorrer o banco de dados para gerar uma definição de esquema temporário. Por exemplo, quando essa opção está definida como 2, o driver amostra cada segundo registro no banco de dados. O valor padrão é 1. |
1 |
| Tamanho do lote de writeback (1 a 1000) |
O número máximo de documentos que o driver pode processar de uma vez durante uma operação de gravação. O valor padrão é 500. |
500 |
| Preocupação com gravação |
Número total de servidores primários e secundários que devem reconhecer uma operação de gravação para que o driver informe uma operação de gravação bem-sucedida. Quando essa opção está definida como 0, o driver não exige o reconhecimento de operações de gravação. O valor padrão é 1. |
1 |
| Tempo limite de preocupação com gravação |
O número máximo de segundos que o driver aguarda que um servidor secundário reconheça uma operação de gravação antes de informar que a operação falhou. Quando essa opção está definida como 0, o driver não aguarda até um tempo limite. Em vez disso, o driver aguarda até que todos os servidores secundários reconheçam a operação de gravação e informa que a operação foi bem-sucedida. O valor padrão é 0. |
0 |
| Gravações registradas de preocupação com gravação | Especifica se o driver exige que os dados de uma operação de gravação sejam confirmados no registro antes que a operação de gravação possa ser reconhecida. | Desabilitado |
Atualizações de conector de dados
Quando atualiza o Analytics, o Agente do Robôs ou o Servidor AX, você deve testar todos os scripts que importam dados usando um dos conectores de dados do Analytics (comando ACCESSDATA).
É possível que alterações feitas por fornecedores externos de fontes de dados ou drivers ODBC exigiram atualizações em um ou mais conectores de dados. Pode ser necessário atualizar as conexões de dados com script para que continuem a funcionar corretamente.
- Execute novamente a importação A maneira mais fácil de atualizar uma conexão é executar manualmente uma importação usando a janela Acesso a Dados na versão atualizada do Analytics. Copie o comando ACCESSDATA do log e use-o para atualizar o script.
Nota
Antes de se conectar a uma fonte de dados e executar novamente a importação, limpe o cache do conector para remover o conjunto existente de nomes de tabelas.
Na guia Conexões existentes na janela Acesso a Dados, ao lado do nome do conector, selecione
> Limpar cache. - Atualize as especificações de campos Também pode ser necessário atualizar as especificações de campos no corpo do script para compatibilizá-lo com as alterações do esquema da tabela na fonte de dados ou no driver ODBC. As possíveis alterações incluem nomes de campos, tipos de dados de campos e comprimentos de campos e registro.
- Verifique os resultados de todas as filtragens Você também deve verificar os resultados de qualquer filtragem aplicada durante a importação de dados. Confirme se a filtragem de importação está incluindo e excluindo corretamente os registros.
Alterações do conector de dados do MongoDB
As alterações específicas efetuadas no conector de dados do MongoDB são listadas a seguir.
| Versão do Analytics | Alterar |
|---|---|
|
14.2 |
O conector não é mais compatível com o MongoDB versões 3.0 e 3.2. As conexões podem ser efetuadas com o MongoDB nas versões 3.4, 3.6 e 4.0. |
