Looker–Tableau Connector (Pratinjau Publik)

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 tableau-looker@google.com.

Persyaratan

Komponen berikut diperlukan untuk menggunakan Looker–Tableau Connector:

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

Menyiapkan Tableau Desktop untuk terhubung ke Looker

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

  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:

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

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

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 tableau-looker@google.com 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.