MongoSQL

Hubungkan Looker ke cluster MongoSQL Anda secara langsung menggunakan dialek MongoSQL (didukung oleh MongoSQL Interface). Menghubungkan Looker ke MongoSQL memungkinkan Anda menganalisis data dokumen dengan menggunakan kueri SQL relasional dan membangun dasbor Looker interaktif.

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

Prasyarat dan konfigurasi MongoSQL

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

Membangun skema relasional menggunakan SQL Schema Builder

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

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

Lihat dokumentasi MongoSQL Schema Builder untuk mendefinisikan dan mempublikasikan skema tabular Anda sebelum membuat koneksi di Looker.

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

Menambahkan alamat IP Looker ke daftar akses IP Atlas

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

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

Membuat 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 di bawah Keamanan, pilih Akses Basis Data.
  3. Klik Tambahkan Pengguna Basis Data Baru.
  4. Pilih Sandi sebagai Metode Autentikasi. Masukkan NamaPengguna (misalnya, looker) dan kata 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 Tambahkan Pengguna untuk menyimpan kredensial pengguna.

Mendapatkan parameter koneksi Atlas SQL

Untuk membuat koneksi Looker, Anda perlu memasukkan parameter koneksi untuk koneksi Atlas SQL. 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 Hubungkan aplikasi Anda menggunakan SQL).
  4. Pilih Driver JDBC.
  5. Perhatikan Host, Port (biasanya 27017), Database, dan persyaratan SSL yang dihasilkan. Anda akan memasukkan detail ini saat Anda membuat koneksi Looker.

Buat koneksi Looker ke basis data 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 umum untuk sebagian besar dialek database. Lihat halaman dokumentasi Menghubungkan Looker ke database Anda untuk mengetahui informasi selengkapnya. Beberapa setelan akan dijelaskan selanjutnya. Gunakan nilai default di semua kolom lainnya, atau biarkan kosong.

    • Name: Masukkan nama koneksi yang unik.
    • Dialek: 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).
    • Parameter JDBC tambahan: (Opsional) Parameter JDBC tambahan yang didukung oleh driver MongoDB, seperti authSource=admin atau connectTimeoutMS=10000. Lihat Parameter JDBC yang didukung.

  3. Untuk memverifikasi konektivitas basis data, klik Uji Koneksi.

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

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

Parameter JDBC yang didukung

Untuk dialek MongoSQL, Looker mendukung parameter JDBC berikut di kolom Parameter JDBC tambahan:

  • 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 Antarmuka SQL, perhatikan karakteristik dialek berikut:

  • Persyaratan SQL Schema Builder: Seperti yang tercantum dalam prasyarat, kueri SQL memerlukan skema relasional yang telah dikonfigurasi sebelumnya yang didefinisikan dalam 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 standar adalah menyimpan dan memodelkan tanggal sebagai kolom timestamp.
  • Zona waktu Semua stempel waktu yang diakses dari antarmuka MongoSQL diperlakukan dalam UTC. Looker tidak mengonversi zona waktu dalam database untuk koneksi MongoDB.

Dukungan fitur

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

MongoSQL 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