Setelan admin - Koneksi

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

Catatan: Jika Anda memiliki izin yang memberikan akses hanya ke halaman tertentu di panel Admin, seperti manage_schedules, manage_themes, atau see_admin, tetapi Anda tidak memiliki Peran admin, halaman yang dijelaskan di sini mungkin tidak terlihat oleh Anda di panel Admin.

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. 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 Databases.

Anda dapat mengklik Public IP Addresses 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.

Catatan: Tombol Alamat IP Publik tidak tersedia untuk instance Looker (Google Cloud core). Jika Anda menggunakan instance Looker (Google Cloud core) yang disiapkan untuk koneksi aman publik atau untuk koneksi hybrid, gunakan alamat IP yang tercantum di kolom Egress Public IP pada tab Details di halaman Instances di konsol Google Cloud .

Jika memiliki peran Admin, Anda dapat mengklik tombol Test Reachability di bagian atas halaman Connections Looker untuk memeriksa apakah Looker dapat menjangkau nama host dan port melalui jaringan. Untuk mengetahui informasi selengkapnya, lihat Diagnostik keterjangkauan jaringan.

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 bawah 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 server SSH diaktifkan di instance Looker Anda.
SSL	Apakah Anda menggunakan enkripsi SSL untuk melindungi data yang dikirim antara Looker dan database Anda (ada opsi aman lainnya selain SSL).
Jenis	Dialek SQL koneksi database.
Tindakan	Tindakan yang dapat Anda lakukan untuk koneksi: menguji koneksi, mengedit koneksi, melihat informasi lain tentang koneksi, membuka daftar link ke Explore 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 yang dikelola Looker.

Tab Server SSH

Tab server SSH tidak tersedia untuk instance Looker (Google Cloud core).

Opsi SSH Server tersedia jika instance Looker (orisinal) 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 Anda dan Anda ingin mengaktifkannya, hubungi Google Cloud spesialis penjualan 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 secara default memproses 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 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 Server SSH:

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 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 server SSH, 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 diizinkan di server SSH Anda. Lihat halaman dokumentasi Menggunakan server SSH untuk mengetahui informasi selengkapnya dan contohnya.
8. Pastikan alamat IP Looker yang sesuai ditambahkan ke daftar yang diizinkan di server SSH Anda agar Looker dapat terhubung ke server SSH.
9. Klik Test & Request Fingerprint 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 Options tiga titik di baris server SSH yang dipilih.
2. Pilih Test Connections.

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

Catatan: Jika Anda membuat perubahan pada file sshd_config server SSH, sebelum menguji koneksi, Anda harus memulai ulang daemon sshd di server SSH agar perubahan diterapkan.

Menambahkan koneksi database ke server SSH

Untuk menambahkan koneksi database baru menggunakan server SSH:

1. Klik menu Options tiga titik di baris server SSH yang dipilih.
2. Pilih Add Connection.

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 Options 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 baik. 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 dapat berhasil menggunakan koneksi database.

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

Catatan: 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 Anda atau untuk 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 yang sering menyebabkan kebingungan:

• Dapat menemukan skema sementara
• Dapat menggunakan tabel turunan persisten

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

Diagnostik jaringan

Looker menyediakan dua alat yang membantu Anda mengetahui apakah masalah koneksi disebabkan oleh jaringan, seperti aturan firewall atau rute yang tidak ada, atau oleh database, seperti kredensial yang salah:

• Diagnostik jaringan dalam hasil pengujian koneksi: Jika pengujian koneksi tidak dapat terhubung ke database, Looker akan menambahkan diagnostik jaringan ke pesan error.
• Diagnostik keterjangkauan jaringan: Jika Anda memiliki peran Admin Looker, Anda dapat menggunakan tombol Test Reachability di bagian atas halaman Connections Looker untuk memeriksa apakah Looker dapat menjangkau nama host dan port apa pun.

Kedua alat tersebut mencari nama host di DNS, lalu mencoba membuka koneksi TCP ke setiap alamat IP yang ditampilkan oleh pencarian. Karena menggunakan koneksi TCP, bukan permintaan ping ICMP, host yang memblokir permintaan ping masih dapat ditampilkan sebagai dapat dijangkau.

Diagnostik jaringan dalam hasil uji koneksi

Jika pengujian koneksi tidak dapat terhubung ke database, Looker akan menguji endpoint berikut dan menambahkan hasilnya ke akhir pesan error, di bagian Network Diagnostics::

• Untuk semua koneksi, host dan port yang dikonfigurasi untuk koneksi.
• Untuk koneksi Amazon Athena, endpoint AWS Glue untuk Region AWS koneksi, di port 443, seperti glue.us-east-1.amazonaws.com.
• Untuk koneksi Cloud SQL yang kolom Host-nya berisi nama koneksi instance, seperti my-project:us-central1:my-instance, endpoint sqladmin.googleapis.com di port 443. Konektor Cloud SQL menggunakan endpoint ini untuk mendapatkan informasi instance dan sertifikat.

Looker menguji hingga tiga alamat IP untuk setiap endpoint, dan diagnostik memerlukan waktu maksimal 3 detik. Looker tidak menjalankan diagnostik jaringan untuk koneksi yang menggunakan tunnel SSH.

Misalnya, diagnostik berikut menunjukkan bahwa Looker dapat menjangkau endpoint Athena, tetapi koneksi ke endpoint AWS Glue mengalami waktu tunggu habis:

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

Setiap alamat IP menampilkan salah satu hasil berikut:

• success: Looker membuka koneksi TCP ke alamat IP dan port. Jika setiap alamat IP menampilkan success, tetapi pengujian masih gagal, periksa setelan koneksi, seperti kredensial, setelan SSL, dan izin pengguna database.
• timeout (3000ms): Looker tidak mendapatkan respons dalam waktu 3 detik. Hasil ini sering kali berarti bahwa aturan firewall, grup keamanan, atau rute jaringan yang tidak ada akan menghapus traffic.
• failed: diikuti dengan alasan: koneksi ditolak, atau jaringan tidak dapat dijangkau. Misalnya, Connection refused berarti tidak ada yang memproses port, atau firewall menolak koneksi.
• blocked (sensitive IP): Looker tidak menguji alamat IP karena berada dalam rentang yang dibatasi.

Jika pencarian DNS gagal, endpoint akan menampilkan DNS resolution failed: diikuti dengan alasannya. Periksa apakah ada kesalahan ketik pada nama host. Jika database menggunakan nama host pribadi, pastikan Looker dapat me-resolve-nya.

Diagnostik keterjangkauan jaringan

Jika memiliki peran Admin Looker, Anda dapat menguji host database sebelum menambahkan koneksi, atau menguji endpoint yang menjadi dependensi koneksi, seperti sqladmin.googleapis.com di port 443.

Untuk menguji keterjangkauan jaringan, ikuti langkah-langkah berikut:

1. Di halaman Connections, klik tombol Test Reachability di bagian atas halaman.
2. Pada dialog Network Reachability Diagnostics, di kolom Hostname or Domain, masukkan nama host atau alamat IP.
3. Di kolom Port, masukkan port yang akan diuji. Defaultnya adalah 443.
4. Klik Uji.

Looker menguji hingga lima alamat IP untuk nama host, dan pengujian memerlukan waktu maksimal 3 detik. Berikut adalah contoh dialog Network Reachability Diagnostics yang menampilkan hasil pengujian untuk nama host dan port:

Untuk setiap alamat IP, dialog akan menampilkan pesan, durasi koneksi dalam milidetik jika berhasil, dan salah satu status berikut:

• Connected: Looker membuka koneksi TCP ke alamat IP dan port.
• Waktu Habis: Looker tidak mendapatkan respons dalam waktu 3 detik.
• Gagal: koneksi ditolak, atau jaringan tidak dapat dijangkau. Pesan akan menampilkan alasannya.
• SSRF Blocked: Looker tidak menguji alamat IP karena berada dalam rentang yang dibatasi. Pembatasan ini melindungi dari pemalsuan permintaan sisi server (SSRF).

Jika Looker tidak dapat me-resolve nama host, atau jika port dibatasi, dialog akan menampilkan pesan error, bukan hasil.

Alamat dan port yang dibatasi

Untuk melindungi instance Anda, diagnostik jaringan Looker tidak menguji alamat IP dalam rentang berikut:

• Loopback, link-local, multicast, dan rentang alamat terbatas lainnya, termasuk alamat server metadata 169.254.169.254.
• Rentang alamat pribadi (10.0.0.0/8, 172.16.0.0/12, dan 192.168.0.0/16), di instance Looker (Google Cloud core) yang hanya menggunakan koneksi aman publik.

Selain itu, fungsi Uji Jangkauan tidak menguji beberapa port yang dibatasi karena alasan keamanan, seperti port 22. Jika Anda memasukkan salah satu port ini, dialog akan menampilkan pesan seperti Port 22 is restricted from diagnostic probing for security reasons.

Membuat 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, buka halaman Connections dengan memilih menu Admin, lalu di bagian Database, pilih Connections. 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 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
SQL Runner	Opsi ini akan mengarahkan Anda ke SQL Runner Looker, dengan koneksi dan skema yang sesuai sudah dipilih.
Jelajahi	Opsi ini akan mengarahkan Anda ke daftar opsi Explore dasar yang dibuat secara otomatis untuk koneksi Anda. Meskipun tidak didasarkan pada model data yang disesuaikan, eksplorasi ini memungkinkan 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 Anda melakukannya, tindakan ini tidak dapat diurungkan. Menghapus koneksi secara tidak sengaja akan menonaktifkan kueri apa pun yang menggunakannya dan dapat menyebabkan error validasi LookML bagi developer. 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 mungkin menawarkan opsi tambahan berikut:

Opsi	Deskripsi
Menampilkan Tabel	Opsi ini akan mengarahkan Anda ke halaman Eksplorasi Looker yang memungkinkan Anda membuat kueri Eksplorasi Looker berdasarkan metadata koneksi Anda. Meskipun opsi ini dimulai dengan nama skema, nama tabel, dan jumlah kolom yang dipilih, Anda dapat memanipulasinya seperti Eksplorasi Looker lainnya.
Menampilkan Database	Opsi ini akan mengarahkan Anda ke halaman Eksplorasi Looker yang memungkinkan Anda membuat kueri Eksplorasi 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 Eksplorasi Looker lainnya.
Tampilkan Proses	Opsi ini akan mengarahkan Anda ke halaman Looker Explore yang memungkinkan Anda membuat kueri Looker Explore berdasarkan proses yang berjalan di koneksi ini, statusnya, durasi prosesnya, dan info lainnya. Hal ini dapat membantu menentukan penyebab jika Looker berjalan lambat, atau jika kueri tidak berjalan sama sekali.
Tampilkan Log Peristiwa PDT	Opsi ini akan mengarahkan Anda ke halaman Looker Explore yang memungkinkan Anda membuat kueri Looker Explore berdasarkan aktivitas tabel turunan untuk koneksi ini. Kolom yang tersedia dijelaskan secara lebih mendetail di halaman dokumentasi Tabel turunan persisten.

Menghapus koneksi database dengan aman

Menghapus koneksi database yang masih dirujuk oleh model LookML akan menyebabkan error validasi yang dapat mencegah developer melakukan commit atau menggabungkan cabang. Untuk menghapus koneksi dengan aman, ikuti langkah-langkah berikut:

1. Identifikasi dependensi: Dalam Mode Pengembangan, gunakan Project Search untuk connection: CONNECTION_NAME guna menemukan semua file model LookML yang mereferensikan koneksi.
2. Hapus dependensi: Perbarui parameter connection dalam file model tersebut agar mengarah ke koneksi yang valid, atau hapus model dependen jika tidak lagi diperlukan.
3. Validasi konten: Jalankan Validator Konten untuk mengidentifikasi dan memperbaiki Look atau dasbor yang mengandalkan model yang menggunakan koneksi tersebut.
4. Deploy perubahan: Commit dan deploy perubahan LookML ini ke cabang produksi.
5. Hapus koneksi: Setelah semua referensi dihapus dari cabang produksi, buka Admin > Database > Connections, lalu hapus koneksi.