Overview
mongosqldは、MongoDB インスタンスを BI ツールに接続する BI Connector プログラムです。 mongosqldには MongoDB のコレクションとデータベースにマッピングするデータ スキーマが必要です。 スキーマを作成し、 mongosqldを起動するには、いくつかのオプションがあります。 このガイドは、ニーズに最適なオプションを選択するのに役立ちます。
デフォルトでは、 mongosqldはデフォルトのデータ スキーマを生成し、それをメモリに保存します。 あるいは、カスタム スキーマを作成し、手動で編集する場合は、次の 2 つの方法のいずれかを使用します。
mongodrdlプログラムを使用してカスタムの.drdlスキーマ ファイルを作成し、 オプションを使用してmongosqld--schemaを起動し、このファイルを指すようにします。以前に
uploadコマンドでカスタム スキーマをアップロードした場合は、name-schemaコマンドを使用して、指定されたカスタム名でスキーマを内部的に保存する必要があります。mongosqld--schemaSource次に、 、 、 オプションを使用して--schemaMode--schemaNameを開始できます。
スキーマとデータ サンプリングの作成の詳細については、「 MongoDB へのリレーショナル スキーマのマッピング 」を参照してください。
前提条件
BI Connectorのインストール
の起動 mongosqld
mongosqldを起動して実行するには 3 つのオプションがあります。 ここでは、次の作業が可能です。
MongoDB Atlas でホスト型サービスとして
mongosqldを実行コマンドラインから
mongosqldを起動システム サービスとして
mongosqldをインストール
MongoDB Atlas で BI Connector をホストするサービスとして実行
では 用のMongoDBConnector business intelligenceMongoDB Atlasをホストできます。Atlas がホストする BI Connector を有効にして接続する方法については、「 BI Connector for Atlas 経由で接続する 」を参照してください。
mongosqldコマンドラインから を起動
コマンドライン オプションを使用して、サンプリングするコレクションとデータベース、ユーザー認証情報、およびその他の構成オプションを指定できます。 コマンドライン オプションの完全なリストは、「コマンドライン オプション 」を参照してください。
コマンドラインからmongosqldを起動するには、必要なコマンドライン オプションを使用して、BI Connector プログラム ディレクトリ内のmongosqld実行可能ファイルを実行します。
次の例では、 --sampleNamespacesオプションを使用して、 testデータベース内のbooksコレクションを指定しています。
"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" --sampleNamespaces test.books
次の例では、 --sampleNamespacesオプションを使用して、 testデータベース内のbooksコレクションを指定しています。
mongosqld --sampleNamespaces test.books
次の例では、 --sampleNamespacesオプションを使用して、 testデータベース内のbooksコレクションを指定しています。
mongosqld --sampleNamespaces test.books
次の例では、 --sampleNamespacesオプションを使用して、 testデータベース内のbooksコレクションを指定しています。
mongosqld --sampleNamespaces test.books
mongosqld と構成ファイルの併用
構成ファイルを使用して、 mongosqldのすべての構成オプションを保持できます。 構成ファイルを指定するには、 --configオプションを使用してmongosqldを起動します。
"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
システム サービスとして をインストールmongosqld
BI Connector は、システム サービスとして実行する場合に指定されたmongosqld.systemLog.path設定を含む構成ファイルが必要です。 お好みのテキスト エディターを使用して、 mongosqld.confファイルを作成します。 構成ファイルのオプションを確認するには、 構成ファイルを参照してください。 例:
systemLog: path: 'C:\logs\mongosqld.log' net: bindIp: '127.0.0.1' port: 3307
注意
構成ファイル内のすべてのファイル パスは絶対パスであり、一重引用符でラップする必要があります。 例:
systemLog: path: 'C:\logs\mongosqld.log'
mongosqldをインストールしてシステム サービスとして実行するには、次のコマンドを実行します。
"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" install --config "<pathToConfigFile>\mongosqld.conf" net start mongosql
インストールが成功した場合、Windows はmongosql service installedを返します。
systemLog: path: '/logs/mongosqld.log' net: bindIp: '127.0.0.1' port: 3307
mongosqldをインストールしてシステム サービスとして実行するには、次のコマンドを実行します。
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
mongosqldをインストールしてシステム サービスとして実行するには、次のコマンドを実行します。
sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf sudo systemctl start mongosql.service
起動時に自動的に開始されるようにサービスを有効にするには、次のコマンドを実行します。
systemctl enable mongosql.service
systemLog: path: '/logs/mongosqld.log' net: bindIp: '127.0.0.1' port: 3307
mongosqldをインストールしてシステム サービスとして実行するには、次のコマンドを実行します。
sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf sudo systemctl start mongosql.service
起動時に自動的に開始されるようにサービスを有効にするには、次のコマンドを実行します。
systemctl enable mongosql.service
次のステップ
BI Connector を起動して実行したら、希望する BI ツールで使用を開始できます。 接続チュートリアルの選択リストについては、「 BI ツールの接続 」を参照してください。