MongoDB Connector for BI

Catatan: Looker kini dapat membuat kueri MongoSQL secara langsung menggunakan MongoSQL. MongoDB Connector for BI akan dihentikan (Looker akan mengirimkan pemberitahuan penghentian dengan pemberitahuan satu tahun sebelum tanggal penghentian). Lihat dokumentasi MongoDB Beralih dari Atlas BI Connector ke MongoSQL dan bagian Bermigrasi ke MongoSQL di halaman ini untuk mengetahui informasi tentang migrasi dari Atlas BI Connector ke Antarmuka SQL yang lebih baru.

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 alihkan koneksi produksi yang ada langsung 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 secara aman, ikuti langkah-langkah berikut:

1. Tinjau perbedaan sintaksis SQL antara MongoBI dan MongoSQL dalam dokumentasi MongoDB Beralih 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, perbarui parameter connection dalam file model untuk mengarah ke koneksi MongoSQL baru.
4. Di SQL Runner, uji dan jalankan contoh kueri dari Jelajah untuk memverifikasi sintaksis dan hasil kueri.
5. Memvalidasi project dan konten Anda:
   • Gunakan Validator Konten untuk memindai semua dasbor dan Look untuk menemukan kolom atau referensi yang rusak.
   • Gunakan SQL Validator dari Looker CI untuk memvalidasi dimensi di Eksplorasi terhadap database.
6. Setelah menyelesaikan semua error validasi, deploy perubahan Anda ke produksi.

Menggunakan MongoDB Connector for BI (MongoBI)

Catatan: Looker memerlukan setidaknya MongoDB versi 4.0+ dan MongoDB Connector for BI versi 2.6.0+ (tempat variabel sesi type_conversion_mode diperkenalkan).

Looker dapat mengakses MongoDB menggunakan MongoDB Connector for BI dengan 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 for 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
• 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 drop-down 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 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 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 berikut mulai Looker 26.14:

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 jenis milidetik, milidetikX, dan mikrodetik untuk dimensi.
• Looker memperlakukan semua stempel waktu yang diakses dari MongoBI sebagai berada di zona waktu coordinated universal time (UTC).