メインコンテンツへスキップ

はじめに

MongoDBは、構造的データをJSONのような動的スキーマを持ったドキュメントとして保管するオープンソースのドキュメント指向データベースシステムです。Domoが提供するコネクターを使用すると、MongoDBコレクションからデータを取得し、カスタマイズされたレポートを作成することができます。
  • MongoDBコネクターは、Javaドライバーバージョン3.2.1を使用し、検索と集計のクエリ方法をサポートします。MongoDBコネクターでコレクション名を手入力する必要があります。
  • MongoDB AdvancedコネクターはJavaドライバーのバージョン3.2.1を使用し、プレーンJSONクエリをサポートします。MongoDB Advancedコネクターでコレクション名を手入力する必要があります。
  • MongoDB V2コネクターはJavaドライバーのバージョン3.12.1を使用し、検索と集計のクエリ方法をサポートします。ドロップダウンからコレクション名を選択することも、MongoDB V2コネクターに手入力することもできます。また、MongoDB V2コネクターはCA証明書を必要としません。
  • MongoDB SSHコネクターはJavaドライバーのバージョン3.12.1を使用し、検索と集計のクエリ方法をサポートします。ドロップダウンからコレクション名を選択することも、MongoDB SSHコネクターに手入力することもできます。MongoDBコレクションからSSHトンネルを介してデータを取得するには、SSH認証情報(ホスト、ポート、ユーザー名、パスワード)が必要です。
この記事では MongoDB SSHコネクター について説明しますDomoのMongoDB SSHコネクターを使用すると、SSHトンネル経由でMongoDBコレクションからデータを取得し、カスタマイズされたレポートを作成することができます。JSONクエリフィルターを入力して、データを指定します。MongoDB APIの詳細については、http://api.mongodb.org/ を参照してください。 MongoDB SSHコネクターは「データベース」コネクターです。クエリを使用してデータベースからデータを取得します。Data Centerでは、ウィンドウ上部のツールバーで [データベース] をクリックすることで、このコネクターやほかのデータベースコネクターのページにアクセスできます。 このトピックでは、MongoDB SSHコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定およびDataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。
重要: このコネクターが機能するためにはSSL接続が必要です。

必要条件

MongoDB SSHアカウントに接続してDataSetを作成するには、以下が必要です。
  • SSHホストのログインに使用するユーザー名とパスワード
  • トンネルを確立するSSHホスト
  • SSHホストのポート番号
  • SSH秘密キーまたはSSHパスワード
  • MongoDBデータベースのログインに使用するユーザー名とパスワード
  • データベースサーバーのホスト名(例:db.company.com
  • データベースのポート番号
  • データベース名
また、MongoDBデータベースに接続する前に、接続先となるデータベースサーバーのポートで使用するIPアドレスをいくつかホワイトリストに登録する必要があります。IPアドレスの詳細なリストについては、「 コネクターのIPアドレスをホワイトリストに登録する 」を参照してください。
注記: Domoはssh-keygenを使用して生成されるSSHキーをサポートしていません。SSHキーは、OpenSSLが生成するDESまたはRSAキー(PEM形式)である必要があります。

MongoDBコレクションに接続する

このセクションでは、 MongoDB SSH コネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目にある [スケジュール設定][DataSetに名前を付け、説明を入力] に関しては、コネクタータイプのほとんどで共通です。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。

[認証情報]ペイン

このペインには、MongoDBデータベース内のコレクションに接続するための認証情報の入力フィールドが含まれています。下表は、各フィールドに必要な内容を説明しています。

フィールド

説明

SSH Host トンネルしたいSSHホスト。例: dmz.mydomain.com
SSH Port SSHホストのポート番号
SSH Username SSHホストのログインに使用するユーザー名
SSH Password SSHホストのログインに使用するパスワード
SSH Private Key SSH秘密キーまたはSSHパスワード
MongoDB Host MongoDBデータベースのホスト名を入力します。例: db.company.com
MongoDB Port MongoDBデータベースのポート番号を入力します。
MongoDB Database MongoDBデータベース名を入力します。
MongoDB Username MongoDBのユーザー名を入力します。
MongoDB Password MongoDBのパスワードを入力します。
有効な MongoDB SSH 認証情報を入力すると、新しい MongoDB SSH DataSetを作成するときにいつでも同じアカウントを使うことができます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

[詳細]ペイン

このペインでは、JSONクエリを作成して、MongoDBコレクションからデータを取得します。また、任意のWHERE、SELECT、GROUP、SORTの節を作成し、クエリフィルターを適用してコレクション内の文書を、JSON形式でも検索することもできます。

メニュー

説明

How would you like to select your collection name? コレクション名をどのように取得するかを選択します(手入力するか、ドロップダウンから選択するか)。
Query Method MongoDBコレクションからデータを取得するクエリ方法を選択します。
Find JSONクエリは「検索方法」で実行されます。
Aggregate JSONクエリは「集計方法」で実行されます。
JSON Query Filter コレクションに文書を集計するクエリフィルターを入力します。
Limit Row 返す行数を入力します。
Batch Size バッチサイズは、コネクターの内部で使用されるバッチごとに返される文書数です。2以上のバッチサイズを入力します。
Query Type コレクションの文書を集計するために使用するクエリフィルターを選択します。
Enter Query Filter JSON集計クエリフィルターを手入力するには「Enter Query Filter」を選択します。
JSON Aggregate Query Filter コレクションに文書を集計するクエリフィルターを入力します。
Custom Query Clause where節、select節、group節、sort節などのカスタム節を適用するには[Custom Query Clause]を選択します。
Where Clause JSON JSONフォーマットでWHERE節を入力します。
Select Clause JSON JSONフォーマットでSELECT節を入力します。
Group Clause JSON JSONフォーマットでGROUP節を入力します。
Sort Clause JSON JSONフォーマットでSORT節を入力します。

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。