MongoSQL

Hubungkan Looker ke cluster MongoSQL Anda secara langsung dengan menggunakan dialek MongoSQL (yang didukung oleh MongoSQL Interface). Dengan menghubungkan Looker ke MongoSQL, Anda dapat menganalisis data dokumen menggunakan kueri SQL relasional dan membuat dasbor Looker interaktif.

Looker menyertakan driver JDBC yang dibundel secara resmi dan berlisensi Apache-2.0 untuk MongoSQL Interface. Tidak seperti dialek MongoBI lama, tidak diperlukan penginstalan manual file JAR driver JDBC kustom yang tidak dikemas.

Prasyarat dan konfigurasi MongoSQL

Sebelum membuat koneksi di Looker, selesaikan langkah-langkah konfigurasi berikut di MongoSQL:

Buat skema relasional menggunakan SQL Schema Builder

MongoDB menyimpan data dalam format dokumen non-relasional yang fleksibel (JSON/BSON). Sebelum Looker dapat membuat kueri koleksi MongoDB Anda menggunakan SQL standar, Anda harus menggunakan SQL Schema Builder di MongoSQL untuk membuat skema SQL.

MongoSQL Interface mengandalkan skema relasional yang dibuat oleh SQL Schema Builder untuk memetakan struktur dokumen, kolom bertingkat, dan array ke tabel, baris, dan kolom SQL standar. Tanpa skema SQL aktif, SQL Interface tidak akan dapat menerjemahkan kueri SQL terhadap koleksi MongoDB Anda.

Lihat dokumentasi MongoSQL Schema Builder untuk menentukan dan memublikasikan skema tabel Anda sebelum membuat koneksi di Looker.

Untuk instance lokal MongoDB Enterprise, gunakan MongoDB SQL Schema Builder CLI untuk menentukan skema Anda.

Tambahkan alamat IP Looker ke daftar akses IP Atlas

MongoSQL membatasi koneksi klien ke alamat IP yang diotorisasi. Untuk membuat kueri MongoSQL dari instance Looker Anda, Anda harus menambahkan alamat IP Looker ke daftar akses IP Atlas dengan melakukan langkah-langkah berikut:

  1. Dapatkan daftar alamat IP Looker untuk region instance Looker Anda.
  2. Tambahkan alamat IP ini ke daftar akses IP project Atlas Anda sesuai dengan dokumentasi daftar akses IP Atlas.

Buat akun pengguna MongoDB untuk Looker

Gunakan Konsol Web MongoDB Atlas untuk membuat akun pengguna database untuk Looker dengan melakukan langkah-langkah berikut:

  1. Login ke Konsol MongoDB Atlas.
  2. Di menu navigasi utama pada bagian Security, pilih Database Access.
  3. Klik Add New Database User.
  4. Pilih Password sebagai Metode Autentikasi. Masukkan Username (misalnya, looker) dan sandi yang aman.
  5. Di bagian Database User Privileges, pilih Built-in Role dan tetapkan peran read (atau izin baca kustom) untuk database yang akan diakses Looker.
  6. Klik Add User untuk menyimpan kredensial pengguna.

Dapatkan parameter koneksi SQL Atlas

Untuk membuat koneksi Looker, Anda harus memasukkan parameter koneksi untuk koneksi SQL Atlas. Anda bisa mendapatkan informasi parameter dengan melakukan langkah-langkah berikut:

  1. Login ke Konsol MongoDB Atlas.
  2. Buka cluster Anda, lalu klik Connect.
  3. Pilih Atlas SQL (atau Connect your application using SQL).
  4. Pilih JDBC Driver.
  5. Perhatikan persyaratan Host, Port (biasanya 27017), Database, dan SSL yang dihasilkan. Anda akan memasukkan detail ini saat Anda membuat koneksi Looker.

Buat koneksi Looker ke database Anda

Ikuti langkah-langkah berikut untuk membuat koneksi dari Looker ke MongoSQL:

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

  2. Isi detail koneksi. Sebagian besar setelan sama untuk sebagian besar dialek database. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya. Beberapa setelan akan dijelaskan berikutnya. Gunakan nilai default di semua kolom lainnya, atau biarkan kosong.

    • Nama: Masukkan nama koneksi yang unik.
    • Dialect: Pilih MongoSQL dari menu drop-down.
    • Host: Nama host yang disediakan oleh MongoSQL Interface (misalnya, <cluster-name>.a.query.mongodb.net).
    • Port: Nomor port untuk Atlas SQL (default: 27017).
    • Database: Nama database yang skemanya Anda buat menggunakan SQL Schema Builder.
    • Nama Pengguna: Nama pengguna database yang dibuat untuk Looker.
    • Sandi: Sandi pengguna database.
    • SSL: Aktifkan SSL (ssl=true).
    • Additional JDBC parameters: (Opsional) Parameter JDBC tambahan yang didukung oleh driver MongoDB, seperti authSource=admin atau connectTimeoutMS=10000. Lihat Parameter JDBC yang didukung.

  3. Untuk memverifikasi konektivitas database, klik Test Connection.

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

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

Parameter JDBC yang didukung

Untuk dialek MongoSQL, Looker mendukung parameter JDBC berikut di kolom Additional JDBC parameters:

  • appName
  • authSource
  • clientinfo
  • connectTimeoutMS
  • directConnection
  • disableclientcache
  • extjsonmode
  • heartbeatFrequencyMS
  • journal
  • localThresholdMS
  • maxIdleTimeMS
  • maxWaitTimeMS
  • readPreference
  • replicaSet
  • retryReads
  • retryWrites
  • serverSelectionTimeoutMS
  • socketTimeoutMS
  • ssl
  • tls
  • tlsAllowInvalidHostnames
  • tlsInsecure
  • w
  • wtimeoutMS

Batasan kueri dan perilaku SQL

Saat membuat model LookML dan membuat kueri MongoSQL menggunakan SQL Interface, perhatikan karakteristik dialek berikut:

  • Persyaratan SQL Schema Builder: Seperti yang disebutkan dalam prasyarat, kueri SQL memerlukan skema relasional yang telah dikonfigurasi sebelumnya dan ditentukan di Atlas SQL Schema Builder.
  • Tabel turunan: Tabel turunan sementara (reguler) didukung, tetapi tabel turunan persisten (PDT) tidak didukung.
  • Jenis tanggal dan stempel waktu: Jenis data date tidak didukung; praktik standarnya adalah menyimpan dan memodelkan tanggal sebagai kolom timestamp.
  • Zona waktu: Semua stempel waktu yang diakses dari MongoSQL Interface diperlakukan dalam UTC. Looker tidak mengonversi zona waktu dalam database untuk koneksi MongoDB.

Dukungan fitur

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

Mulai Looker 26.14, MongoSQL mendukung fitur berikut:

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
Proses Tampilkan SQL Runner
Jelaskan Tabel SQL Runner
Tampilkan Indeks SQL Runner
Pilih 10 SQL Runner
Jumlah SQL Runner
Jelaskan SQL
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