Setelan admin - Koneksi

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

Melihat koneksi

Di halaman Connections, 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 Databases menampilkan informasi dasar tentang koneksi database yang telah Anda tentukan. Tabel 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 Databases.

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 ini dan alamat IP tepercaya lainnya, adalah cara mudah untuk membatasi akses data.

Tabel berikut menjelaskan elemen di tab Databases:

Kolom Deskripsi
Nama Nama koneksi, yang Anda pilih, 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 tersebut 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 Server diaktifkan di instance Looker Anda.
SSL Apakah Anda menggunakan enkripsi SSL atau tidak untuk melindungi data yang berpindah antara Looker dan database (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 lainnya 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 setiap koneksi yang dikelola Looker.

Tab SSH Servers

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

Looker akan otomatis memilih port localhost saat membuat tunnel SSH. Saat ini, 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 secara default akan memprosesnya di port 443. Untuk membuat tunnel SSH, Looker harus menetapkan port localhost ke 443, yang sudah digunakan oleh Looker. Hal ini akan menyebabkan kegagalan pengaturan terowongan SSH. Untuk memperbaiki masalah ini, konfigurasikan database PrestoDB atau Trino untuk memantau port selain port 443 saat SSL diaktifkan.

Tab SSH Servers mencantumkan konfigurasi server SSH yang telah Anda tambahkan, menunjukkan status koneksi ke server SSH, dan mencantumkan koneksi database yang menggunakan setiap server SSH. Dari tab SSH Servers, 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 Anda pilih, 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 Tindakan yang dapat Anda lakukan untuk konfigurasi server SSH: uji koneksi ke server SSH, tambahkan koneksi database ke server SSH, edit konfigurasi server SSH, atau hapus konfigurasi server SSH.

Menambahkan atau mengedit konfigurasi server SSH

Untuk menambahkan konfigurasi server SSH baru:

  1. Di tab SSH Server, klik Tambahkan Server
  2. Pada kolom Server Tanpa Nama di pojok kanan atas, masukkan nama untuk konfigurasi server SSH.
  3. Klik Download Kunci untuk mendownload kunci publik ke file teks. Pastikan Anda menyimpan file ini untuk digunakan nanti.
  4. Di kolom Nama Pengguna Server, masukkan nama pengguna yang akan digunakan Looker untuk terhubung ke server SSH.
  5. Di kolom Alamat IP Server atau Nama Host, 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 lebih lanjut dan contoh.
  8. Pastikan alamat IP Looker yang sesuai ditambahkan ke daftar yang diizinkan di server SSH agar 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 di baris server SSH yang diinginkan, lalu pilih Server Details.

Menguji koneksi ke server SSH

Untuk menguji semua koneksi database ke server SSH:

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

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

Menambahkan koneksi database ke server SSH

Untuk menambahkan koneksi database baru menggunakan server SSH:

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

Looker akan menampilkan halaman Connection Settings, dengan server SSH yang tercantum di kolom SSH Server.

Menghapus konfigurasi server SSH

Untuk menghapus konfigurasi server SSH:

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

Menguji koneksi

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

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

Potensi masalah ditampilkan dengan warna kuning; error ditampilkan dengan warna merah. Jika koneksi "lulus", koneksi akan muncul dengan 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 Test di ujung kanan koneksi tersebut
  • Semua koneksi dengan mengklik tombol Test All Connections di bagian atas halaman

Dua pemeriksaan adalah penyebab umum kebingungan:

  • Dapat menemukan skema sementara
  • Dapat menggunakan tabel turunan persisten

Pemeriksaan ini tidak perlu lulus pemeriksaan Looker untuk berfungsi. Namun, Anda harus meneruskan kode tersebut agar dapat menggunakan tabel turunan persisten yang merupakan fitur pemodelan yang sangat bermanfaat.

Menambahkan koneksi

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

Mengedit koneksi

Untuk mengedit koneksi yang ada, klik tombol Edit di ujung kanan setiap koneksi. Halaman yang sama yang Anda gunakan untuk membuat koneksi akan muncul (dijelaskan di halaman dokumentasi Menghubungkan Looker ke database Anda), tetapi dengan informasi yang relevan sudah diisi. Lakukan perubahan yang diperlukan, lalu klik Update Connection.

Tindakan yang tersedia untuk semua koneksi

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

Opsi Deskripsi
Runner SQL Opsi ini mengarahkan Anda ke SQL Runner Looker, dengan koneksi dan skema yang tepat sudah dipilih.
Eksplorasi Opsi ini akan membawa Anda ke daftar opsi Jelajah dasar yang dibuat secara otomatis untuk koneksi Anda. Model tersebut tidak didasarkan pada model data yang disesuaikan, tetapi memungkinkan beberapa pelaporan cepat tentang data mentah pada tabel koneksi Anda. Hal ini biasanya hanya berguna untuk mendapatkan gambaran tentang isi 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 begitu Anda melakukannya, Anda tidak dapat membatalkannya. Jika koneksi dihapus secara tidak sengaja, semua kueri yang menggunakannya akan dinonaktifkan. Namun, jika Anda membuat ulang koneksi baru dengan nama yang sama, fungsinya akan dipulihkan.

Tindakan yang tersedia untuk beberapa koneksi

Tergantung pada dialek koneksi, menu drop-down roda gigi di sebelah kanan sambungan mungkin menawarkan opsi tambahan berikut:

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