Looker–Tableau Connector (Pratinjau Publik)

Pratinjau

Seperti yang digunakan dengan Looker (asli), fitur ini tunduk pada "Persyaratan Penawaran Fitur Beta" dalam Persyaratan Spesifik Per Layanan Looker untuk Looker (asli).

Sebagaimana digunakan dengan Looker (Google Cloud core), fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" dalam Persyaratan Layanan Umum pada Persyaratan Spesifik Per Layanan (untuk Google Cloud Platform). Adendum Pemrosesan Data Cloud (Pelanggan) akan berlaku selama fitur tersebut berinteraksi dengan data produksi di instance Looker Anda.

Fitur ini tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas.

Looker–Tableau Connector memungkinkan Anda menggunakan Tableau Desktop untuk terhubung ke data dari Jelajah Looker. Looker–Tableau Connector dibuat berdasarkan Looker Open SQL Interface, yang memungkinkan akses ke model LookML dan Jelajah untuk aplikasi yang menggunakan JDBC untuk terhubung ke sumber data. Lihat dokumentasi Antarmuka SQL Terbuka untuk detail selengkapnya.

Panduan ini ditujukan untuk Pratinjau Publik Konektor Looker–Tableau. Untuk mengajukan pertanyaan atau memberikan masukan, kirim email ke [e-mail].

Persyaratan

Komponen berikut diperlukan untuk menggunakan Looker–Tableau Connector:

• Instance Looker yang dihosting Looker dan menjalankan Looker 23.18 atau yang lebih baru.
• Project LookML yang menggunakan data dari koneksi Google BigQuery. (Project LookML harus memiliki file model yang menentukan koneksi Google BigQuery dalam parameter connection.)
• Peran pengguna Looker yang mencakup izin explore pada model LookML yang ingin Anda akses dari Tableau.

Selain itu, Anda harus menyelesaikan langkah-langkah berikut sebelum menyiapkan Looker–Tableau Connector:

• Untuk instance Looker (asli), aktifkan fitur Lab eksperimental Antarmuka SQL pada instance Looker.
• Untuk instance Looker (Google Cloud core), isi formulir minat Perjanjian Pra-GA Antarmuka SQL Looker. Tim Google akan mengaktifkan fitur Antarmuka SQL untuk instance Anda.

Menyiapkan Tableau Desktop untuk terhubung ke Looker

Untuk menggunakan Konektor Looker–Tableau dalam Pratinjau Publik, Anda perlu melakukan hal berikut:

Catatan: Prosedur ini mengasumsikan bahwa Anda sudah menginstal Tableau Desktop di komputer.

1. Tambahkan aplikasi Tableau OAuth ke instance Looker Anda: Admin Looker harus menggunakan Looker API untuk mendaftarkan aplikasi Tableau OAuth untuk Looker–Tableau Connector di instance Looker Anda. Aplikasi OAuth Tableau hanya perlu didaftarkan sekali untuk setiap instance Looker dan berlaku untuk semua pengguna di instance Looker.
2. Download dan simpan file Konektor Tableau dan file driver JDBC: Setiap pengguna yang ingin mengakses Looker–Tableau Connector harus mendownload file avatica-<release_number>-looker.jar dan file konektor Tableau (.taco) yang dipaketkan, lalu menyimpan file tersebut di direktori tertentu di komputer mereka.

Bagian berikut menjelaskan langkah-langkah ini secara detail.

Menambahkan aplikasi OAuth Tableau ke instance Looker Anda

Looker–Tableau Connector mengharuskan Anda memiliki aplikasi OAuth Tableau di instance Looker. Cara termudah untuk mendaftarkan aplikasi OAuth Tableau pada instance Looker Anda adalah melalui Looker API Explorer.

Jika instance Looker Anda sudah menginstal API Explorer, Anda dapat mengaksesnya dengan format URL berikut:

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

Jika instance Looker tidak memiliki API Explorer, Anda dapat menginstalnya dari Looker Marketplace. Lihat halaman Menggunakan API Explorer untuk mendapatkan informasi.

Gunakan API Explorer untuk mendaftarkan aplikasi OAuth Tableau pada instance Looker Anda, seperti yang dijelaskan pada langkah-langkah berikut:

1. Buka Looker API Explorer (lihat halaman Menggunakan API Explorer untuk mendapatkan informasi).
2. Pada kolom Search di API Explorer, masukkan Register OAuth App.
3. Di hasil penelusuran, klik Daftarkan Aplikasi OAuth.
4. Di halaman Register OAuth App, klik tombol Run It.

5. Di tab Request pada dialog Run It, masukkan informasi berikut ke kolom yang sesuai:

   • client_guid:

     35FBB268-0CB0-4822-AFE3-28638C1C6269
     

   • body:

     {
     "redirect_uri": "http://localhost:55556/Callback",
     "display_name": "Tableau Desktop",
     "description": "Tableau Desktop client for JDBC Server",
     "enabled": true,
     "group_id": ""
     }
     

6. Centang kotak Saya memahami bahwa endpoint API ini akan mengubah data.

7. Klik Run.

8. Anda dapat memverifikasi bahwa Anda berhasil mendaftarkan aplikasi OAuth Tableau dengan menggunakan metode Get OAuth Client App di API Explorer:

   • Di kolom Penelusuran Penjelajah API, masukkan Dapatkan Aplikasi Klien OAuth.
   • Klik Run It.

   • Di kolom client_guid, masukkan nilai aplikasi OAuth Tableau:

     35FBB268-0CB0-4822-AFE3-28638C1C6269
     

   Jika Anda berhasil mendaftarkan aplikasi Tableau OAuth, tab Response akan menampilkan nilai yang Anda masukkan saat mendaftarkan aplikasi.

Langkah ini tidak diperlukan. Namun, jika di masa mendatang Anda tidak lagi menggunakan Looker–Tableau Connector dan ingin menghapus aplikasi OAuth Tableau, lihat Menghapus aplikasi OAuth.

Download dan simpan file konektor

Untuk menggunakan Looker–Tableau Connector, setiap pengguna Tableau harus mendownload dua file berikut:

• File konektor Tableau (.taco)
• File driver JDBC (looker.jar)

Bagian berikut memberikan petunjuk untuk mendownload file tersebut dan tempat meletakkannya di komputer.

File konektor Tableau (.taco)

File konektor Tableau disebut looker-jdbc-v0.2.0.taco. Setiap pengguna harus mendownload file .taco dan menyimpannya ke komputer menggunakan langkah-langkah berikut:

1. Untuk mendownload file konektor Tableau, klik link berikut: looker-jdbc-v0.2.0.taco.

2. Setelah download selesai, pindahkan file looker-jdbc-v0.2.0.taco ke subdirektori Connectors dari direktori My Tableau Repository. Berikut adalah jalur direktori default:

   • Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors

   • MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors

     Catatan: Jika penyiapan Anda tidak menggunakan lokasi default untuk direktori My Tableau Repository, Anda bisa mendapatkan lokasi sebenarnya dengan memilih File > Repository Location dari aplikasi Tableau Desktop di komputer.

File driver JDBC (looker.jar)

Driver JDBC disebut avatica-<release_number>-looker.jar. Setiap pengguna harus mendownload file looker.jar dari GitHub dan menyimpan file tersebut ke komputer dengan mengikuti langkah-langkah berikut:

1. Buka https://github.com/looker-open-source/calcite-avatica/releases.
2. Download versi terbaru file avatica-<release_number>-looker.jar.

3. Simpan file avatica-<release_number>-looker.jar ke setiap komputer pengguna di lokasi berikut:

   • Windows: C:\Program Files\Tableau\Drivers

   • MacOS: /Library/JDBC atau ~/Library/JDBC

     Catatan: Untuk macOS, buat direktori JDBC secara manual jika belum ada.

Menghubungkan ke data Looker dari {i>Tableau Desktop<i}

Setelah menambahkan aplikasi Tableau OAuth ke instance Looker Anda dan mendownload looker-jdbc-v0.2.0.taco dan file avatica-<release_number>-looker.jar, Anda dapat menggunakan Tableau Desktop untuk terhubung ke data dari instance Looker Anda dengan mengikuti langkah-langkah berikut:

1. Di Tableau Desktop, dari panel Connect di sisi kiri, di bagian To a Server, pilih opsi More....
2. Di kotak penelusuran, masukkan Looker JDBC by Google.
3. Pilih opsi Looker JDBC by Google.
4. Di jendela dialog, masukkan parameter berikut:
   • Server: Masukkan URL instance Looker Anda tanpa https://. Contoh: example.cloud.looker.com
   • Port: 443
   • Autentikasi: OAuth
   • OAuth Instance Url: Masukkan URL instance Looker lengkap Anda dengan https://. Contoh: https://example.cloud.looker.com
5. Pilih Login. Tableau akan membuka jendela browser untuk terhubung ke instance Looker Anda dan mengautentikasi akun Anda dengan OAuth.
6. Jika diminta, masukkan kredensial OAuth Anda. Jika sudah login, Anda akan melihat pesan di jendela browser bahwa Tableau menggunakan jendela browser untuk mengautentikasi ke Looker dan sekarang Anda dapat menutup jendela browser tersebut.
7. Setelah Anda melakukan autentikasi ke Looker, Tableau akan membuka halaman Sumber Data yang terhubung ke instance Looker Anda.
8. Gunakan menu drop-down Schema untuk memilih model Looker dengan data yang ingin Anda lihat di Tableau Desktop. Tableau akan mengisi daftar Table dengan Jelajah Looker dari model Looker yang Anda pilih.
9. Untuk mulai menjelajahi data, pilih dan tarik objek dari daftar Tables ke kanvas.

Mengidentifikasi kueri Looker–Tableau Connector di Looker UI

Kueri dari Tableau dibuat melalui Antarmuka Open SQL. Admin Looker dapat menggunakan UI Looker untuk mengidentifikasi kueri yang berasal dari Antarmuka Open SQL, seperti yang dijelaskan dalam dokumentasi Antarmuka SQL Terbuka.

Kueri dari Looker–Tableau Connector memiliki nilai Source berupa "sql_interface" atau "Sql Interface".

Hal-hal yang perlu dipertimbangkan

Saat Anda mengeksplorasi data Looker dengan Tableau Desktop, perhatikan pertimbangan-pertimbangan berikut:

• Looker–Tableau Connector dibuat berdasarkan Looker Open SQL Interface, dan memiliki batasan LookML yang sama dengan Open SQL Interface. Lihat dokumentasi Antarmuka SQL Terbuka untuk detail selengkapnya.
• Tableau{i> <i}secara otomatis membuat kueri {i>database<i} setiap kali ada perubahan yang dilakukan pada kueri, termasuk ketika {i>field<i} ditambahkan dan dihapus menggunakan Looker–Tableau Connector. Anda dapat menonaktifkan pembaruan otomatis di Tableau: Lihat dokumentasi Tableau untuk informasi lebih lanjut.
• Anda tidak dapat menggunakan Tableau untuk bergabung dengan dua Jelajah Looker. Jika Anda ingin bergabung dengan Jelajah, gunakan Looker untuk membuat gabungan di model Looker Anda. Lihat halaman dokumentasi Looker Bekerja dengan gabungan di LookML dan parameter gabungan untuk mengetahui informasi tentang cara menggunakan gabungan di Looker.

Untuk melaporkan bug

Untuk melaporkan bug, kirim email ke [e-mail] dan sertakan informasi berikut:

• Daftar terperinci langkah-langkah yang diambil
• Perilaku yang diharapkan
• Perilaku yang sebenarnya (dengan screenshot, jika memungkinkan)

Menghapus aplikasi OAuth Tableau (opsional)

Langkah ini tidak diwajibkan. Namun, jika di masa mendatang Anda tidak lagi menggunakan Looker–Tableau Connector dan ingin menghapus aplikasi OAuth Tableau dari instance Looker, Anda dapat melakukannya menggunakan API Explorer dengan mengikuti langkah-langkah berikut:

1. Buka Looker API Explorer (lihat halaman Menggunakan API Explorer untuk mendapatkan informasi).
2. Di kolom Penelusuran Penjelajah API, masukkan Delete OAuth Client App.
3. Di hasil penelusuran, klik Hapus Aplikasi Klien OAuth.
4. Di halaman Delete OAuth Client App, klik tombol Run It.

5. Di tab Request pada dialog Run It, masukkan nilai client_guide aplikasi OAuth Tableau:

   35FBB268-0CB0-4822-AFE3-28638C1C6269
   

6. Centang kotak Saya memahami bahwa endpoint API ini akan mengubah data.

7. Anda dapat memverifikasi bahwa aplikasi OAuth Tableau berhasil dihapus dengan menggunakan metode Get OAuth Client App di API Explorer:

   • Di kolom Penelusuran Penjelajah API, masukkan Dapatkan Aplikasi Klien OAuth.
   • Klik Run It.

   • Di kolom client_guid, masukkan nilai aplikasi OAuth Tableau:

     35FBB268-0CB0-4822-AFE3-28638C1C6269
     

   Jika Anda berhasil menghapus aplikasi Tableau OAuth, tab Response akan menampilkan nilai isi kosong.