BI 用の MongoDB コネクタ

Looker は、次の 2 つのオプションを使用して BI 用の MongoDB コネクタを使用して MongoDB にアクセスできます。

  • MongoDB Atlas で BI 用の MongoDB コネクタを使用する。
  • MongoDB データベースと同じサーバーにインストールされた、BI 用の MongoDB コネクタを使用する。

MongoDB Atlas

MongoDB Atlas では、M10 以上のクラスタを使用する必要があります。Looker で、MongoDB Atlas で実行する MongoDB データベースを使用するには、BI 用のMongoDB コネクタ(MongoBI)を使用する必要があります。Atlas 向けの BI コネクタを有効にするには、MongoDB Atlas で M10 以上のクラスタを使用する必要があります。

また、目的のデータベースに対する読み取り権限を持つユーザー アカウントも作成する必要があります。

BI 用のMongoDB コネクタの構成

Looker で接続を作成する前に、MongoDB または Atlas 管理者は、このページで説明している以下の手順に沿って BI 用のMongoDB コネクタを設定する必要があります。

Looker サーバーの Atlas IP アクセスリストへの追加

Atlas は、プロジェクトの IP アクセスリストにあるエントリからのクライアント接続のみを許可します。Looker の IP アドレスを Atlas プロジェクトの IP アクセスリストに追加します。

  1. Looker の IP アドレスを取得します
  2. Atlas IP アクセスリストの設定手順に沿って、Looker の IP アドレスを Atlas の IP アクセスリストに追加します。

BI 用の MongoDB コネクタの有効化

BI 用の MongoDB コネクタを有効にします。

  1. M10 以上のクラスタを使用していることを確認します。
  2. Atlas でクラスタの [接続] ページを開きます。ホスト名、ポート、ユーザーをメモしておきます。この情報は、Looker で接続を構成するときに使用する必要があります。

同じサーバー上の MongoDB

Looker で接続を作成する前に、MongoDB 管理者はこのページに記載されている次の手順の沿って、MongoDB と BI 用の Mongo コネクタを設定する必要があります。

BI 用の Mongo コネクタのインストール

MongoDB ドキュメント ページのオンプレミスで BI コネクタをインストールするで説明されているように、MongoDB データベースと同じサーバーに BI 用の MongoDB コネクタをインストールします。

ネットワークトラフィックの暗号化

BI 用の MongoDB コネクタでは、MongoDB のサーバーと Looker アプリケーションの間で SSL 暗号化を使用する必要があります。MongoDB ドキュメント ページのBI コネクタ用の SSL の構成にある SSL 設定手順に従います。

Looker のユーザーと権限の設定

MongoDB シェルuse コマンドを入力し、Looker が接続するデータベースに切り替えます。次に、ロール readWritedb.createUser() を使って Looker のユーザーを作成します。

use looker_database

db.createUser({ user: looker,
                pwd: `some_password_here`,
                roles: [ "readWrite" ]
              })

MongoBI JDBC ドライバ ファイルのインストール

BI 用の MongoDB コネクタのオプションのどちらの場合でも、Lookerでは以下の手順で JDBC ドライバ ファイルを構成する必要があります。

次の 2 つの JAR ファイルをダウンロードします。

パッケージ化されていない JDBC ドライバのドキュメント ページの手順に沿って、次の値を使用します。

ドライバ シンボル: mongobi

ドライバ エントリ:

- name: mongobi
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

Looker 6.2 以前を使用している場合:

- name: maria15x
  dir_name: mongobi
  module_path: com.mysql.jdbc.Driver
  override_jdbc_url_subprotocol: mysql

ドライバを言語のディレクトリに配置する手順の場合、これらのファイルへのパスは次のようになります。

  • looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jar
  • looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

標準派生テーブルの使用の許可(推奨)

派生テーブルは分析の洗練度を高めることができるLookerの重要なツールです。クエリのパフォーマンスを向上させる重要な役割を担う可能性もあります。簡単に説明すると、Looker の派生テーブル機能は、データベースにまだ存在しない新たなテーブルを作成するための手段です。

BI 用の MongoDB コネクタは、一時的な標準派生テーブルをサポートしていますが、永続的な派生テーブルはサポートしていません。

標準派生テーブルは一時的なものであるため、保存する必要はありません。したがって、標準派生テーブルのスキーマを作成する必要はありません。 ただし、スキーマが存在しない場合でも、looker_tmp スキーマに dbOwner ロールを付与する必要はあります。

データベース ユーザーの構成に関するこの MongoDB ドキュメント ページの「MongoDB ユーザーの変更] セクションに沿って、Looker が接続に使用するユーザーの looker_tmpdbOwner ロールを追加します。

db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])

データベースへの Looker 接続の作成

Looker からデータベースへの接続を作成する手順は次のとおりです。

  1. Looker の [管理者] セクションで [接続] を選択し、[新しい接続] をクリックします。
  2. [言語] プルダウン メニューから [MongoBI] を選択します。

  3. 接続の詳細を入力します。設定の大部分は、ほとんどのデータベース言語に共通するものです。詳細については、Looker をデータベースに接続するのドキュメント ページをご覧ください。

  4. 接続が成功したことを確認するには、[テスト] をクリックします。トラブルシューティング情報については、データベース接続のテストのドキュメント ページをご覧ください。

  5. これらの設定を保存するには、[接続] をクリックします。

BI 用の MongoDB コネクタでの SQL 関数と演算子の使用

BI 接続で MongoDB コネクタを使用して開発する場合は、MongoDB のドキュメントに一覧表示されている SQL 関数と演算子を使用できます。

機能のサポート

一部の機能については、Looker でサポートするには、データベース言語が同じ機能に対応している必要があります。

MongoBI は、Looker 24.8 の時点で、次の機能をサポートしています。

特徴 サポート対象
サポート レベル
サポート対象
Looker(Google Cloud コア)
いいえ
対称集計
いいえ
派生テーブル
あり
永続的な SQL 派生テーブル
いいえ
永続的なネイティブ派生テーブル
いいえ
安定したビュー
いいえ
クエリの強制終了
あり
SQL ベースのピボット
いいえ
タイムゾーン
いいえ
SSL
あり
Subtotals
いいえ
JDBC の追加パラメータ
あり
Case Sensitive
あり
ロケーション タイプ
あり
リストのタイプ
いいえ
パーセンタイル
いいえ
個別のパーセンタイル
いいえ
SQL Runner の表示プロセス
あり
SQL Runner の説明テーブル
あり
SQL Runner 表示インデックス
あり
SQL Runner Select 10
あり
SQL ランナーの数
あり
SQL の説明
あり
Oauth 認証情報
いいえ
コンテキスト コメント
あり
接続プーリング
いいえ
HLL スケッチ
いいえ
集計認識
いいえ
増分PDT
いいえ
ミリ秒
いいえ
マイクロ秒
いいえ
マテリアライズド ビュー
いいえ
Approximate Count Distinct
いいえ

次の特長があります。