Menu Docs
Página inicial do Docs
/
BI Connector

Iniciar conector de BI

Nesta página

  • Visão geral
  • Pré-requisitos
  • Lançamento mongosqld
  • Próximos passos

Visão geral

mongosqld é o programa de Connector BI que conecta sua instância MongoDB à sua ferramenta de BI. O mongosqld exige um esquema de dados que mapeia para suas coleções e bancos de dados MongoDB. Você tem várias opções para criar um esquema e iniciar o mongosqld. Este guia ajudará você a escolher a melhor opção para suas necessidades.

Por padrão, o mongosqld gera um esquema de dados padrão e o armazena na memória. Alternativamente, se preferir criar um esquema personalizado e editá-lo manualmente, use um destes dois métodos:

  • Utilize o programa mongodrdl para criar um arquivo de esquema do .drdl personalizado e então iniciar o mongosqld com a opção --schema para apontar este arquivo.

  • Se você carregou anteriormente um esquema personalizado com o comando upload, você deverá utilizar o comando name-schema para armazenar o esquema internamente sob o nome personalizado fornecido. Em seguida, você pode começar mongosqld com --schemaSource, --schemaModee --schemaName opções.

Para saber mais sobre como criar um esquema e amostragem de dados, consulte Mapear Esquemas Relacionais para MongoDB.

Pré-requisitos

Lançamento mongosqld

Há três opções para iniciar e executar o mongosqld. Você pode:

  • Executar o mongosqld como um serviço hospedado do com o MongoDB Atlas

  • Iniciar mongosqld a partir da linha de comando

  • Instalar o mongosqld como um serviço do sistema

Execute o connector BI como um serviço hospedado com o MongoDB Atlas

Você pode hospedar o MongoDB Connector para Business Intelligence no MongoDB Atlas. Para saber como habilitar e conectar a um BI Connector hospedado no Atlas, consulte Como conectar via BI Connector para Atlas.

Iniciar a partir mongosqld da Linha de Comando

Você pode utilizar opções de linha de comando para especificar coleções e bancos de dados para amostra, credenciais de usuário e outras opções de configuração. Para obter uma lista completa de opções de linha de comando, consulte Opções de linha de comando.

Para iniciar o mongosqld a partir da linha de comando, execute o mongosqld executável no diretório do programa Connector BI com quaisquer opções de linha de comando necessárias.

O exemplo a seguir usa a opção --sampleNamespaces para especificar a coleção books no banco de dados test.

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" --sampleNamespaces test.books

O exemplo a seguir usa a opção --sampleNamespaces para especificar a coleção books no banco de dados test.

mongosqld --sampleNamespaces test.books

O exemplo a seguir usa a opção --sampleNamespaces para especificar a coleção books no banco de dados test.

mongosqld --sampleNamespaces test.books

O exemplo a seguir usa a opção --sampleNamespaces para especificar a coleção books no banco de dados test.

mongosqld --sampleNamespaces test.books

Observação

mongosqld padroniza para a porta 3307. Você pode definir o número da porta manualmente, fornecendo a opção --addr com o endereço do host e a porta.

mongosqld com um arquivo de configuração

Você pode utilizar um arquivo de configuração para manter todas as suas opções de configuração do mongosqld. Inicie o mongosqld com a opção --config para especificar um arquivo de configuração.

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" --config <pathToConfigFile>\mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf

Instale mongosqld como um serviço de sistema

O Connector BI requer um arquivo de configuração com a configuração mongosqld.systemLog.path especificada ao ser executado como um serviço do sistema. Utilizando seu editor de texto preferido, crie um arquivo mongosqld.conf. Para revisar as opções do arquivo de configuração, consulte Arquivo de Configuração. Por exemplo:

systemLog:
  path: 'C:\logs\mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

Observação

Todos os caminhos de arquivo em seu arquivo de configuração devem ser absolutos e envoltos em aspas simples. Por exemplo:

systemLog:
  path: 'C:\logs\mongosqld.log'

Para instalar e executar o mongosqld como um serviço de sistema, execute os seguintes comandos:

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" install --config "<pathToConfigFile>\mongosqld.conf"
net start mongosql

O Windows gerará mongosql service installed se a instalação for bem-sucedida.

systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

Para instalar e executar o mongosqld como um serviço de sistema, execute os seguintes comandos:

mongosqld install --config <pathToConfigFile>/mongosqld.conf
launchctl load -w /Library/LaunchDaemons/mongosql.plist
systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

Para instalar e executar o mongosqld como um serviço de sistema, execute os seguintes comandos:

sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf
sudo systemctl start mongosql.service

Para habilitar o serviço para que ele seja iniciado automaticamente no momento da inicialização, execute o seguinte:

systemctl enable mongosql.service
systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

Para instalar e executar o mongosqld como um serviço de sistema, execute os seguintes comandos:

sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf
sudo systemctl start mongosql.service

Para habilitar o serviço para que ele seja iniciado automaticamente no momento da inicialização, execute o seguinte:

systemctl enable mongosql.service

Próximos passos

Quando o connector BI estiver instalado e funcionando, você estará pronto para começar a usá-lo com sua ferramenta de BI preferida. Consulte Conectar ferramentas de BI para obter uma lista selecionada de tutoriais de conexão.