MongoDB Connector for BI

Bermigrasi ke MongoSQL dari MongoBI

Looker kini mendukung MongoSQL dan merekomendasikan migrasi ke MongoSQL dari MongoDB Connector for BI.

Karena perbedaan sintaksis SQL antara MongoDB Connector for BI (MongoBI) dan MongoSQL, model LookML yang ada yang menggunakan blok SQL kustom, pemformatan tanggal, atau fungsi database mungkin memerlukan penyesuaian sintaksis. Jangan langsung beralih koneksi produksi yang ada ke MongoSQL tanpa memvalidasi kode LookML Anda terlebih dahulu, karena hal ini dapat merusak dasbor, Look, dan jadwal atau pemberitahuan.

Untuk bermigrasi dari MongoBI ke MongoSQL dengan aman, ikuti langkah-langkah berikut:

  1. Tinjau perbedaan sintaksis SQL antara MongoBI dan MongoSQL dalam dokumentasi MongoDB Transisi dari Atlas BI Connector ke MongoSQL.
  2. Buat koneksi baru untuk MongoSQL di Looker sebagai koneksi sekunder.
  3. Di cabang pengembangan baru dalam project LookML Anda, perbarui parameter connection dalam file model Anda untuk mengarah ke koneksi MongoSQL baru.
  4. Di SQL Runner, uji dan jalankan contoh kueri dari Jelajah Anda untuk memverifikasi sintaksis dan hasil kueri.
  5. Validasi project dan konten Anda:
    • Gunakan Validator Konten untuk memindai semua dasbor dan Look untuk menemukan kolom atau referensi yang rusak.
    • Gunakan Validator SQL Looker CI untuk memvalidasi dimensi di Jelajah Anda terhadap database.
  6. Setelah menyelesaikan error validasi, deploy perubahan Anda ke produksi.

Menggunakan MongoDB Connector for BI (MongoBI)

Looker dapat mengakses MongoDB menggunakan MongoDB Connector for BI menggunakan dua opsi:

  • Menggunakan MongoDB Connector for BI di MongoDB Atlas.
  • Menggunakan MongoDB Connector for BI yang diinstal di server yang sama dengan database MongoDB.

MongoDB Atlas

MongoDB Atlas Anda harus menggunakan cluster M10+. Agar Looker dapat menggunakan database MongoDB yang berjalan di MongoDB Atlas, Anda harus menggunakan MongoDB Connector for BI (MongoBI). Mengaktifkan BI Connector untuk Atlas mengharuskan MongoDB Atlas menggunakan cluster M10+.

Anda juga harus membuat akun pengguna yang memiliki izin baca untuk database yang dipilih.

Mengonfigurasi MongoDB Connector for BI

Sebelum membuat koneksi di Looker, administrator MongoDB atau Atlas Anda harus menyiapkan MongoDB Connector for BI menggunakan langkah-langkah berikut, yang dijelaskan di halaman ini:

Menambahkan server Looker ke daftar akses IP Atlas

Atlas hanya mengizinkan koneksi klien dari entri dalam daftar akses IP project. Tambahkan alamat IP Looker ke daftar akses IP project Atlas:

  1. Dapatkan alamat IP Looker.
  2. Ikuti petunjuk penyiapan daftar akses IP Atlas untuk menambahkan alamat IP Looker ke daftar akses IP Atlas.

Mengaktifkan MongoDB Connector for BI

Aktifkan MongoDB Connector for BI:

  1. Pastikan Anda berada di cluster M10+.
  2. Di Atlas, buka halaman Connect untuk cluster. Catat nama host, port, dan pengguna. Anda harus menggunakan informasi tersebut saat mengonfigurasi koneksi di Looker.

MongoDB di server yang sama

Sebelum membuat koneksi di Looker, administrator MongoDB Anda harus menyiapkan MongoDB dan Mongo Connector for BI menggunakan langkah-langkah berikut, yang dijelaskan di halaman ini:

Menginstal Mongo Connector for BI

Instal MongoDB Connector for BI di server yang sama dengan database MongoDB, seperti yang dijelaskan di halaman dokumentasi MongoDB Menginstal BI Connector On Premises .

Mengenkripsi traffic jaringan

MongoDB Connector for BI mengharuskan penggunaan enkripsi SSL antara server MongoDB dan aplikasi Looker. Ikuti petunjuk penyiapan SSL di halaman dokumentasi MongoDB Mengonfigurasi SSL untuk BI Connector.

Menyiapkan pengguna dan izin Looker

Di shell MongoDB, masukkan perintah use untuk beralih ke database yang akan terhubung ke Looker. Kemudian, buat pengguna untuk Looker dengan db.createUser() dengan peran readWrite:

use looker_database

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

Menginstal file driver JDBC MongoBI

Untuk kedua opsi MongoDB Connector for BI, Looker mengharuskan konfigurasi file driver JDBC dengan melakukan langkah-langkah berikut:

Download dua file JAR ini:

Ikuti langkah-langkah di halaman dokumentasi Driver JDBC yang tidak dikemas menggunakan nilai berikut:

simbol driver: mongobi

entri driver:

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

Jika Anda menggunakan Looker 6.2 atau yang lebih lama:

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

Untuk langkah menempatkan driver di direktori dialek Anda, jalur ke file ini akan terlihat seperti ini:

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

Mengizinkan penggunaan tabel turunan reguler (direkomendasikan)

Tabel turunan adalah alat penting di Looker yang memungkinkan Anda memperluas kecanggihan analisis. Tabel turunan juga dapat berperan penting dalam meningkatkan performa kueri. Secara umum, kemampuan tabel turunan Looker menyediakan cara untuk membuat tabel baru yang belum ada di database Anda.

MongoDB Connector for BI mendukung tabel turunan reguler sementara, tetapi tidak mendukung tabel turunan persisten.

Karena tabel turunan reguler bersifat sementara, tabel tersebut tidak perlu disimpan. Oleh karena itu, Anda tidak perlu membuat skema untuk tabel tersebut. Namun, Anda harus memberikan peran dbOwner ke skema looker_tmp, meskipun skema tersebut tidak ada.

Ikuti bagian Mengubah Pengguna MongoDB di halaman dokumentasi MongoDB ini tentang mengonfigurasi pengguna database untuk menambahkan peran dbOwner di looker_tmp untuk pengguna yang akan digunakan Looker untuk terhubung.

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

Membuat koneksi Looker ke database Anda

Ikuti langkah-langkah berikut untuk membuat koneksi dari Looker ke database Anda:

  1. Di bagian Admin Looker, pilih Connections, lalu klik Add Connection.

  2. Pilih MongoBI dari menu drop-down Dialect.

  3. Isi detail koneksi. Sebagian besar setelan sama untuk sebagian besar dialek database. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya.

  4. Untuk memverifikasi bahwa koneksi berhasil, klik tombol Test Connection di bagian Status details di bagian bawah halaman Connections Settings.

  5. Jika Looker menampilkan Can Connect, tekan Connect untuk membuat koneksi.

Koneksi database Anda kemudian akan ditambahkan ke daftar di halaman Looker Connections Admin.

Menggunakan fungsi dan operator SQL dengan MongoDB Connector for BI

Saat mengembangkan menggunakan koneksi MongoDB Connector for BI, Anda dapat menggunakan fungsi dan operator SQL yang tercantum dalam dokumentasi MongoDB.

Parameter JDBC yang didukung

Untuk MongoDB Connector for BI, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters untuk koneksi. Lihat dokumentasi untuk database Anda guna mengetahui informasi tentang parameter ini.

  • allowMultiQueries
  • appName
  • authSource
  • autoReconnect
  • cachePrepStmts
  • characterEncoding
  • connectTimeout
  • connectTimeoutMS
  • elideSetAutoCommits
  • enabledSslProtocolSuites
  • enabledTLSProtocols
  • explainSlowQueries
  • maxAllowedPacket
  • password
  • queryInterceptors
  • queryTimeoutKillsConnection
  • replicaSet
  • rewriteBatchedStatements
  • socketTimeout
  • ssl
  • sslMode
  • tcpKeepAlive
  • useCompression
  • useCursorFetch
  • useLocalSessionState
  • user
  • useServerPrepStmts
  • useSSL
  • verifyServerCertificate
  • zeroDateTimeBehavior

Dukungan fitur

Agar Looker dapat mendukung beberapa fitur, dialek database Anda juga harus mendukungnya.

MongoBI mendukung fitur berikut per Looker 26.20:

Fitur Didukung?
Looker (Google Cloud core)
Agregat simetris
Tabel turunan
Tabel turunan SQL persisten
Tabel turunan native persisten
Tampilan stabil
Penghentian kueri
Pivot berbasis SQL
Zona waktu
SSL
Subtotal
Parameter tambahan JDBC
Peka huruf besar/kecil
Jenis lokasi
Jenis daftar
Persentil
Persentil berbeda
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Metrik dari periode ke periode
Jumlah perkiraan berbeda
Model analisis dalam database
Kalender kustom

Selain itu: