Setelan admin - Koneksi

Untuk mengakses halaman Connections, buka menu Admin, lalu di bagian Database, pilih Connections.

Catatan: Untuk mengakses semua halaman admin di Looker, Anda harus memiliki peran Admin. Jika Anda memiliki izin yang hanya mengaktifkan bagian panel Admin, seperti manage_schedules atau manage_themes, tetapi tidak memiliki peran Admin, Looker mungkin tidak menampilkan halaman yang dijelaskan dalam artikel ini di panel Admin. Selain itu, izin see_admin memberikan izin hanya baca ke sebagian besar (tetapi tidak semua) halaman Admin. Lihat deskripsi see_admin untuk mengetahui informasi selengkapnya.

Melihat koneksi

Di halaman Koneksi, Anda dapat melihat koneksi database dan alamat IP yang diperlukan untuk mengizinkan traffic jaringan. Jika kemampuan untuk membuat database baru telah diaktifkan untuk instance Anda, Anda juga dapat menambahkan koneksi baru.

Tab Database

Tab Database menampilkan informasi dasar tentang koneksi database yang telah Anda tentukan. Halaman ini juga menampilkan koneksi yang dikelola Looker yang telah Anda buat, jika kemampuan untuk membuat database baru telah diaktifkan untuk instance Anda. Anda juga dapat menguji status dan mengedit konfigurasi koneksi tersebut dari tab Database.

Anda dapat mengklik Alamat IP Publik untuk melihat daftar alamat IP yang diperlukan untuk mengizinkan traffic jaringan dari instance Looker Anda. Semua traffic jaringan dari Looker akan berasal dari salah satu alamat IP yang tercantum, berdasarkan region tempat instance Looker Anda dihosting. Melarang traffic ke database Anda, kecuali dari alamat IP ini dan alamat IP tepercaya lainnya, adalah cara untuk membatasi akses data.

Tabel berikut menjelaskan elemen di tab Database:

Kolom	Deskripsi
Nama	Nama koneksi, yang dipilih oleh Anda, yang digunakan dalam parameter LookML connection. Saat Anda menguji koneksi, Looker akan menampilkan daftar pemeriksaan status di bagian nama koneksi.
Database	Nama database yang akan dikueri Looker saat menggunakan koneksi ini.
Cakupan	Apakah koneksi dapat digunakan dengan semua project atau hanya satu project tertentu.
Server SSH	Nama konfigurasi server SSH yang digunakan untuk membuat tunnel SSH ke database Anda. Kolom ini hanya ditampilkan jika tab SSH Servers diaktifkan di instance Looker Anda.
SSL	Apakah Anda menggunakan enkripsi SSL untuk melindungi data yang dikirim antara Looker dan database Anda atau tidak (ada opsi aman lainnya selain SSL).
Jenis	Dialek SQL dari koneksi database.
Tindakan	Tindakan yang dapat Anda lakukan untuk koneksi: menguji koneksi, mengedit koneksi, melihat informasi lain tentang koneksi, membuka daftar link ke Jelajah koneksi, atau menghapus koneksi. Jika kemampuan untuk membuat database baru telah diaktifkan untuk instance Anda, Anda juga dapat menambahkan data dari sumber data tambahan ke koneksi apa pun yang dikelola Looker.

Tab Server SSH

Opsi Server SSH tersedia jika instance di-deploy di infrastruktur Kubernetes, dan hanya jika kemampuan untuk menambahkan informasi konfigurasi server SSH ke instance Looker Anda telah diaktifkan. Jika opsi ini tidak diaktifkan di instance Looker dan Anda ingin mengaktifkannya, hubungi spesialis penjualan Google Cloud atau buka permintaan dukungan.

Looker otomatis memilih port localhost untuk Anda saat membuat tunnel SSH; Anda tidak dapat menentukan port localhost.

Koneksi SSH ke database PrestoDB atau Trino mungkin memerlukan konfigurasi database tambahan. Jika SSL diaktifkan, database PrestoDB atau Trino akan diaktifkan secara default di port 443. Untuk membuat tunnel SSH, Looker harus menetapkan port localhost ke 443, yang sudah digunakan oleh Looker. Hal ini akan menyebabkan penyiapan tunnel SSH gagal. Untuk memperbaiki masalah ini, konfigurasikan database PrestoDB atau Trino Anda untuk memproses di port selain port 443 saat SSL diaktifkan.

Tab Server SSH mencantumkan konfigurasi server SSH yang telah Anda tambahkan, menunjukkan status koneksi ke server SSH, dan mencantumkan koneksi database menggunakan setiap server SSH. Dari tab Server SSH, Anda juga dapat menguji koneksi ke server SSH, dan menambahkan atau mengedit konfigurasi server SSH.

Tabel berikut menjelaskan elemen di tab SSH Servers:

Kolom	Deskripsi
Nama Server	Nama konfigurasi server SSH, yang dipilih oleh Anda, yang digunakan untuk terhubung ke database Anda.
Koneksi	Daftar koneksi database yang terhubung ke server SSH. Mengklik koneksi database akan membuka halaman Edit Connection untuk koneksi database tersebut.
Menu Opsi tiga titik	Tindakan yang dapat Anda lakukan untuk konfigurasi server SSH: menguji koneksi ke server SSH, menambahkan koneksi database ke server SSH, mengedit konfigurasi server SSH, atau menghapus konfigurasi server SSH.

Menambahkan atau mengedit konfigurasi server SSH

Untuk menambahkan konfigurasi server SSH baru:

1. Di tab SSH Server, klik Add Server
2. Di kolom Unnamed Server di pojok kanan atas, masukkan nama untuk konfigurasi server SSH.
3. Klik Download Kunci untuk mendownload kunci publik ke file teks. Pastikan untuk menyimpan file ini untuk digunakan nanti.
4. Di kolom Server Username, masukkan nama pengguna yang akan digunakan Looker untuk terhubung ke server SSH.
5. Di kolom Server IP Address or Hostname, masukkan alamat IP atau nama host server SSH.
6. Di kolom Server Port, masukkan nomor port yang digunakan untuk terhubung ke server SSH.
7. Tambahkan kunci publik yang didownload ke file kunci yang diotorisasi di server SSH Anda. Lihat halaman dokumentasi Menggunakan server SSH untuk mengetahui informasi selengkapnya dan contoh.
8. Pastikan alamat IP Looker yang sesuai ditambahkan ke daftar yang diizinkan di server SSH Anda sehingga Looker dapat terhubung ke server SSH.
9. Klik Uji & Minta Sidik Jari untuk memverifikasi koneksi Anda ke server SSH.
10. Lihat konfigurasi SSH baru. Di layar ini, Anda juga dapat mendownload atau melihat kunci publik dan melihat sidik jari unik konfigurasi server SSH.

Untuk mengedit konfigurasi server SSH yang ada, klik menu Options tiga titik di baris server SSH yang dipilih, lalu pilih Server Details.

Menguji koneksi ke server SSH

Untuk menguji semua koneksi database ke server SSH:

1. Klik menu Opsi tiga titik di baris server SSH yang dipilih.
2. Pilih Uji Koneksi.

Looker akan menguji semua koneksi database menggunakan server SSH tersebut dan menampilkan tanda centang hijau di samping nama server dan semua koneksi yang lulus pengujian koneksi. Ikon tanda seru merah menunjukkan bahwa koneksi gagal dalam pengujian.

Menambahkan koneksi database ke server SSH

Untuk menambahkan koneksi database baru menggunakan server SSH:

1. Klik menu Opsi tiga titik di baris server SSH yang dipilih.
2. Pilih Tambahkan Koneksi.

Looker menampilkan halaman Setelan Koneksi, dengan server SSH tercantum di kolom Server SSH.

Menghapus konfigurasi server SSH

Untuk menghapus konfigurasi server SSH:

1. Klik menu Opsi tiga titik di baris server SSH yang akan dihapus.
2. Pilih Hapus Server.

Menguji koneksi

Looker memungkinkan Anda menguji koneksi yang ada untuk memastikan koneksi tersebut berfungsi dengan benar. Anda juga dapat menguji koneksi saat menambahkannya, seperti yang dijelaskan di halaman dokumentasi Menghubungkan Looker ke database.

Setiap pengujian koneksi menyertakan daftar pemeriksaan status untuk memberi tahu Anda apakah Looker berhasil menggunakan koneksi database.

Kemungkinan masalah ditampilkan dalam warna kuning; error ditampilkan dalam warna merah. Jika "lulus", koneksi akan muncul dalam warna hijau.

Koneksi database yang menggunakan OAuth, seperti Snowflake dan Google BigQuery, memerlukan login pengguna. Jika Anda tidak login ke akun pengguna OAuth saat menguji salah satu koneksi ini, Looker akan menampilkan peringatan dengan link Login. Klik link untuk memasukkan kredensial OAuth atau mengizinkan Looker mengakses informasi akun OAuth Anda.

Anda dapat memeriksa status:

• Satu koneksi dengan mengklik Uji di ujung kanan koneksi tersebut
• Semua koneksi dengan mengklik tombol Test All Connections di bagian atas halaman

Dua pemeriksaan ini sering kali membingungkan:

• Dapat menemukan skema sementara
• Dapat menggunakan tabel turunan persisten

Pemeriksaan ini tidak perlu lulus agar Looker dapat berfungsi. Namun, Anda memerlukannya untuk lulus agar dapat menggunakan tabel turunan persisten, yang merupakan fitur pemodelan yang sangat berharga.

Menambahkan koneksi

Untuk menambahkan koneksi database baru, ikuti langkah-langkah yang dijelaskan di halaman dokumentasi Menghubungkan Looker ke database.

Mengedit koneksi

Untuk mengedit koneksi yang ada, buka halaman Koneksi dengan memilih menu Admin, lalu di bagian Database, pilih Koneksi. Klik tombol Edit untuk koneksi. Halaman yang sama dengan yang Anda gunakan untuk membuat koneksi akan muncul (dijelaskan di halaman dokumentasi Menghubungkan Looker ke database Anda), tetapi dengan informasi yang relevan sudah terisi. Lakukan perubahan yang diperlukan, lalu klik Perbarui Koneksi.

Tindakan yang tersedia untuk semua koneksi

Semua koneksi menawarkan opsi ini dari menu drop-down roda gigi di ujung kanan setiap koneksi:

Opsi	Deskripsi
SQL Runner	Opsi ini akan mengarahkan Anda ke SQL Runner Looker, dengan koneksi dan skema yang sesuai telah dipilih.
Eksplorasi	Opsi ini akan mengarahkan Anda ke daftar opsi Jelajah dasar yang dibuat secara otomatis untuk koneksi Anda. Laporan ini tidak didasarkan pada model data yang disesuaikan, tetapi memungkinkan beberapa pelaporan cepat tentang data mentah dalam tabel koneksi Anda. Hal ini biasanya hanya berguna untuk mendapatkan gambaran tentang konten tabel sebelum pemodelan, bukan untuk tujuan analisis data yang sebenarnya.
Hapus	Untuk menghapus koneksi yang ada, klik menu drop-down roda gigi di ujung kanan koneksi, lalu pilih Hapus. Anda akan diberi kesempatan untuk mengonfirmasi penghapusan, tetapi setelah melakukannya, penghapusan tidak dapat diurungkan. Menghapus koneksi secara tidak sengaja akan menonaktifkan kueri yang menggunakannya. Namun, jika Anda membuat ulang koneksi baru dengan nama yang sama, fungsi akan dipulihkan.

Tindakan yang tersedia untuk beberapa koneksi

Bergantung pada dialek koneksi, menu drop-down roda gigi di sebelah kanan koneksi dapat menawarkan opsi tambahan berikut:

Opsi	Deskripsi
Menampilkan Tabel	Opsi ini akan mengarahkan Anda ke halaman Jelajah Looker yang memungkinkan Anda membuat kueri Jelajah Looker berdasarkan metadata koneksi Anda. Meskipun opsi ini dimulai dengan nama skema, nama tabel, dan jumlah kolom yang dipilih, Anda dapat memanipulasinya seperti Jelajah Looker lainnya.
Menampilkan Database	Opsi ini akan mengarahkan Anda ke halaman Jelajah Looker yang memungkinkan Anda membuat kueri Jelajah Looker berdasarkan metadata koneksi Anda. Meskipun opsi ini dimulai dengan nama skema, nama katalog, jumlah tabel, dan jumlah kolom yang dipilih, Anda dapat memanipulasinya seperti Jelajah Looker lainnya.
Menampilkan Proses	Opsi ini akan mengarahkan Anda ke halaman Jelajah Looker yang memungkinkan Anda membuat kueri Jelajah Looker berdasarkan proses yang berjalan di koneksi ini, statusnya, berapa lama proses tersebut berjalan, dan info lainnya. Hal ini dapat berguna untuk membantu menentukan penyebab jika Looker berjalan lambat, atau jika kueri tidak berjalan sama sekali.
Menampilkan Log Aktivitas PDT	Opsi ini akan mengarahkan Anda ke halaman Jelajah Looker yang memungkinkan Anda membuat kueri Jelajah Looker berdasarkan aktivitas tabel turunan untuk koneksi ini. Kolom yang tersedia dijelaskan secara lebih mendetail di halaman dokumentasi Tabel turunan persisten.