MongoDB Connector for BI

Catatan: Looker sekarang dapat melakukan query langsung ke MongoSQL dengan menggunakan MongoSQL. Konektor MongoDB untuk BI akan dihentikan dukungannya (Looker akan mengirimkan pemberitahuan penghentian dukungan satu tahun sebelum tanggal penghentian dukungan). Lihat dokumentasi MongoDB Transisi dari Atlas BI Connector ke MongoSQL dan bagian Migrasi ke MongoSQL di halaman ini untuk informasi tentang migrasi dari Atlas BI Connector ke Antarmuka SQL yang lebih baru.

Migrasi dari MongoBI ke MongoSQL

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

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

Untuk melakukan migrasi yang aman dari MongoBI ke MongoSQL, ikuti langkah-langkah berikut:

1. Tinjau perbedaan sintaks 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 proyek LookML Anda, perbarui parameter connection di file model Anda agar mengarah ke koneksi MongoSQL yang baru.
4. Di SQL Runner, uji dan jalankan contoh kueri dari Explores Anda untuk memverifikasi sintaks kueri dan hasilnya.
5. Validasi proyek dan konten Anda:
   • Gunakan Content Validator untuk memindai semua dasbor dan mencari kolom atau referensi yang rusak.
   • Gunakan SQL Validator dari Looker CI untuk memvalidasi dimensi dalam Explores Anda terhadap basis data.
6. Setelah mengatasi semua kesalahan validasi, terapkan perubahan Anda ke lingkungan produksi.

Menggunakan Konektor MongoDB untuk BI (MongoBI)

Catatan: Looker membutuhkan setidaknya MongoDB versi 4.0+ dan MongoDB Connector for BI versi 2.6.0+ (di manatype_conversion_mode variabel sesi diperkenalkan).

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

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

MongoDB Atlas

MongoDB Atlas Anda harus menggunakan klaster M10+. Agar Looker dapat menggunakan basis data MongoDB yang berjalan di MongoDB Atlas, Anda harus menggunakan MongoDB Connector for BI (MongoBI). Mengaktifkan BI Connector untuk Atlas memerlukan 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
• Aktifkan MongoDB Connector for BI
• Izinkan penggunaan tabel turunan reguler (direkomendasikan)

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 untuk BI menggunakan langkah-langkah berikut, yang dijelaskan di halaman ini:

• Menginstal Mongo Connector for BI
• Mengenkripsi traffic jaringan
• Menyiapkan pengguna dan izin Looker
• Mengizinkan penggunaan tabel turunan reguler (direkomendasikan)

Menginstal Mongo Connector for BI

Instal MongoDB Connector for BI di server yang sama dengan database MongoDB, seperti yang dijelaskan di halaman dokumentasi MongoDB Install 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 dihubungkan oleh 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 memerlukan konfigurasi file driver JDBC dengan melakukan langkah-langkah berikut:

Download dua file JAR ini:

• mongosql auth 1.0.0
• mysql connector java 5.1.47

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

simbol pengemudi: mongobi

entri pengemudi:

- 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. Indeks 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 untuknya. Namun, Anda perlu memberikan peran dbOwner ke skema looker_tmp, meskipun skema tersebut tidak ada.

Ikuti bagian Modify MongoDB Users di halaman dokumentasi MongoDB tentang mengonfigurasi pengguna database ini untuk menambahkan peran dbOwner di looker_tmp bagi 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 tarik-turun Dialek.

   Catatan: Jika Anda menggunakan instance Looker (Google Cloud core) dan tidak melihat dialek Anda tercantum di menu drop-down Dialek, lihat dokumentasi Looker (Google Cloud core) untuk memverifikasi bahwa dialek tersebut didukung untuk instance Looker (Google Cloud core).

3. Isi detail koneksi. Sebagian besar setelan umum 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 Uji Koneksi di bagian Detail status di bagian bawah halaman Setelan Koneksi.

5. Jika Looker menampilkan Dapat Terhubung, tekan Hubungkan untuk membuat koneksi.

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

Menggunakan fungsi dan operator SQL dengan MongoDB Connector untuk BI.

Saat mengembangkan aplikasi 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 bidang Parameter JDBC tambahan 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 mendukung beberapa fitur, dialek database Anda juga harus mendukungnya.

MongoBI mendukung fitur-fitur berikut sejak Looker 26.16:

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
Jumlah SQL Runner
Penjelasan SQL
Kredensial OAuth 2.0
Komentar konteks
Penggabungan koneksi
Sketsa HLL
Aggregate awareness
PDT inkremental
Milidetik
Mikrodetik
Tampilan terwujud
Pengukuran dari periode ke periode
Jumlah perkiraan berbeda
Model analitik dalam database
Kalender kustom

Selain itu:

• MongoDB tidak mendukung jangka waktu milidetik dan mikrodetik untuk grup dimensi.
• MongoDB tidak mendukung tipe milidetik, milidetikX, dan mikrodetik untuk dimensi.
• Looker memperlakukan semua stempel waktu yang diakses dari MongoBI sebagai berada dalam zona waktu universal terkoordinasi (UTC).