Konektor BI Looker–Tableau

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

Sebelum memulai

Instance Looker Anda harus memenuhi persyaratan berikut untuk menggunakan Konektor BI Looker–Tableau:

  • Menjalankan Looker 24.14 atau yang lebih baru.
  • Diaktifkan untuk konektor BI Tableau Desktop. Admin Looker harus mengaktifkan tombol Tableau Desktop di halaman BI Connector Looker.
  • Berisi project LookML yang menggunakan data dari koneksi Google BigQuery:
    • Project LookML harus dikonfigurasi sehingga kolom Koneksi yang Diizinkan ditetapkan ke opsi Hanya koneksi ini dengan setidaknya satu koneksi Google BigQuery yang dipilih. Lihat halaman dokumentasi Mengakses dan mengedit informasi project untuk mengetahui informasi tentang cara mengonfigurasi model dan melihat koneksi yang diizinkan untuk model tersebut.
    • Project LookML harus memiliki file model yang menentukan koneksi BigQuery dalam parameter connection-nya.

Selain itu, setiap orang yang menggunakan Konektor BI Looker–Tableau harus memiliki akun Looker dengan peran pengguna yang menyertakan izin explore pada model LookML yang ingin mereka akses dari Tableau.

Menyiapkan Tableau Desktop untuk terhubung ke Looker

Setelah semua persyaratan terpenuhi, Anda dapat menyiapkan Tableau Desktop untuk terhubung ke data Looker.

Setiap pengguna yang ingin mengakses Konektor BI Looker–Tableau harus mendownload file avatica-<release_number>-looker.jar dan file konektor Tableau yang dipaketkan (TACO), lalu menyimpan file tersebut di direktori tertentu di komputer mereka. Bagian berikut memberikan petunjuk untuk mendownload file ini dan tempat menyimpannya di komputer Anda:

File konektor Tableau (TACO)

File konektor Tableau disebut looker_v1.0.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_v1.0.0.taco

  2. Setelah download selesai, pindahkan file looker_v1.0.0.taco ke subdirektori Connectors di direktori My Tableau Repository. Berikut adalah jalur direktori default:

    • Windows:

      C:\Users\\Windows user\Documents\My Tableau Repository\Connectors

    • MacOS:

      /Users/Mac 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 ke komputer mereka dengan mengikuti langkah-langkah berikut:

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

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

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

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

Menghubungkan ke data Looker dari Tableau Desktop

Setelah mendownload dan menyimpan looker_v1.0.0.taco dan file avatica-<release_number>-looker.jar, Anda dapat menggunakan Tableau Desktop untuk terhubung ke data dari instance Looker dengan mengikuti langkah-langkah berikut:

  1. Di Tableau Desktop, dari panel Connect di sebelah kiri, di bagian To a Server, pilih opsi More....
  2. Di kotak penelusuran, masukkan Looker by Google.
  3. Pilih opsi Looker 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
    • URL Instance OAuth: 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 dan mengautentikasi akun Anda dengan OAuth.
  6. Jika diminta, login ke Looker. Jika sudah login, Anda akan melihat pesan di jendela browser bahwa Tableau menggunakan jendela browser untuk mengautentikasi ke Looker dan Anda sekarang dapat menutup jendela browser.
  7. Setelah Anda diautentikasi ke Looker, Tableau akan membuka halaman Sumber Data dengan koneksi ke instance Looker Anda.
  8. Gunakan menu drop-down Skema untuk memilih model Looker dengan data yang ingin Anda lihat di Tableau Desktop. Tableau akan mengisi daftar Tabel dengan Jelajahi Looker dari model Looker yang Anda pilih.
  9. Untuk mulai menjelajahi data, pilih dan tarik objek dari daftar Tables ke kanvas.

Mengidentifikasi kueri Konektor BI Looker–Tableau di UI Looker

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

Kueri dari Konektor BI Looker–Tableau memiliki nilai Sumber "sql_interface" atau "SQL Interface".

Menggunakan Konektor BI Looker–Tableau di Tableau Server

Konektor BI Looker–Tableau tidak tersedia di Tableau Exchange, tetapi Anda dapat menginstal Konektor BI Looker–Tableau di Tableau Server dengan melakukan prosedur di bagian berikut:

Sebelum memulai

Instance Looker Anda harus memenuhi persyaratan berikut untuk menggunakan Konektor BI Looker–Tableau di Tableau Server:

  • Menjalankan Looker 24.14 atau yang lebih baru.
  • Berisi project LookML yang menggunakan data dari koneksi Google BigQuery:
    • Project LookML harus dikonfigurasi sehingga kolom Koneksi yang Diizinkan ditetapkan ke opsi Hanya koneksi ini dengan setidaknya satu koneksi Google BigQuery yang dipilih. Lihat halaman dokumentasi Mengakses dan mengedit informasi project untuk mengetahui informasi tentang cara mengonfigurasi model dan melihat koneksi yang diizinkan untuk model tersebut.
    • Project LookML harus memiliki file model yang menentukan koneksi BigQuery dalam parameter connection-nya.

Selain itu, setiap orang yang menggunakan Konektor BI Looker–Tableau harus memiliki akun Looker dengan peran pengguna yang menyertakan izin explore pada model LookML yang ingin mereka akses dari Tableau.

Menyiapkan OAuth untuk Konektor BI Looker–Tableau

Untuk menggunakan Konektor BI Looker–Tableau untuk Tableau Server, Anda harus menyiapkan integrasi OAuth di instance Looker.

Anda dapat menggunakan API Explorer Looker untuk menyiapkan integrasi OAuth untuk Konektor BI Looker–Tableau:

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

    https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

  • Jika instance Looker Anda tidak memiliki API Explorer, Anda dapat menginstalnya dari Looker Marketplace. Lihat halaman Menggunakan API Explorer untuk mengetahui informasinya.

Untuk menggunakan API Explorer guna menyiapkan integrasi OAuth di instance Looker, ikuti langkah-langkah berikut:

  1. Buka Looker API Explorer (lihat halaman Menggunakan API Explorer untuk mengetahui informasinya).
  2. Di kolom Telusuri API Explorer, masukkan Daftarkan Aplikasi OAuth.
  3. Di hasil penelusuran, klik Register OAuth App.
  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:
    tableau-server
    • body:
    {
  "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
  "display_name": "Looker-Tableau-Server (manual)",
  "description": "Client for Looker-Tableau Server integration (manually added)",
  "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 menyiapkan autentikasi menggunakan metode Get OAuth Client App di API Explorer:

    • Di kolom Telusuri API Explorer, masukkan Get OAuth Client App.
    • Klik Run It.
    • Di kolom client_guid, masukkan nilai ini: tableau-server

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

Menginstal Konektor BI Looker–Tableau di Tableau Server

Untuk menginstal Konektor BI Looker–Tableau di Tableau Server, lakukan langkah-langkah berikut:

  1. Download file konektor Tableau dengan mengklik link berikut: looker_v1.0.0.taco
  2. Download file avatica-<release_number>-looker.jar versi terbaru dari https://github.com/looker-open-source/calcite-avatica/releases.
  3. Instal file TACO dan JAR di komputer host Tableau Server Anda. Lokasi file bergantung pada sistem operasi server. Jalur penginstalan Tableau default ditampilkan dalam tabel berikut:
Lokasi file TACO Lokasi file JAR
Server Linux 
/opt/tableau/connectors

/opt/tableau/tableau_driver/jdbc
Server Windows 
C:\Program Files\Tableau\Connectors

C:\Program Files\Tableau\Drivers

Menyelesaikan penyiapan di Tableau Server

Setelah menyiapkan OAuth untuk Konektor BI Looker–Tableau dan menginstal Konektor BI Looker–Tableau, Anda dapat menyelesaikan penyiapan dengan melakukan prosedur berikut di mesin host Tableau Server:

Hal-hal yang perlu dipertimbangkan

Saat menjelajahi data Looker dengan Tableau Desktop, perhatikan pertimbangan berikut:

  • Konektor BI Looker–Tableau dibuat berdasarkan Antarmuka SQL Terbuka Looker, dan memiliki batasan LookML dan batasan SQL yang sama dengan Antarmuka SQL Terbuka. Lihat dokumentasi Open SQL Interface untuk mengetahui detail selengkapnya.
  • Tableau otomatis membuat kueri database setiap kali perubahan dilakukan pada kueri, termasuk saat kolom ditambahkan dan dihapus menggunakan Konektor BI Looker–Tableau. Anda dapat menonaktifkan update otomatis di Tableau: Lihat dokumentasi Tableau untuk mengetahui informasi selengkapnya.
  • Anda tidak dapat menggunakan Tableau untuk menggabungkan dua Looker Explore. Jika Anda ingin menggabungkan Jelajah, gunakan Looker untuk membuat join di model Looker. Lihat halaman dokumentasi Looker Menggunakan join di LookML dan parameter join untuk mengetahui informasi tentang cara menggunakan join di Looker.
  • Konektor BI Looker–Tableau dirancang untuk berfungsi dengan koneksi live di Tableau. Mode ekstrak data Tableau mengekstrak ukuran Looker dengan nilai "null" sehingga tidak akan menghasilkan hasil yang akurat. Jika ingin menggunakan mode ekstrak, Anda dapat membuat kolom gabungan di Tableau langsung dari kolom dimensi Looker, bukan menggunakan ukuran Looker.

Mengupgrade dari Pratinjau Publik Konektor BI Looker–Tableau

Jika Anda adalah bagian dari Pratinjau Publik Konektor BI Looker–Tableau, penyiapan yang ada akan terus berfungsi seperti biasa. Namun, sebaiknya upgrade ke versi Konektor BI Looker–Tableau terbaru.

Untuk mengupgrade ke versi Konektor Looker–Tableau BI terbaru, admin Looker harus melakukan tugas berikut:

  1. Verifikasi bahwa instance Looker memenuhi persyaratan.
  2. Di instance Looker, aktifkan tombol Tableau Desktop di halaman BI Connectors.

Setelah admin Looker mengaktifkan tombol Tableau Desktop di instance Looker, pengguna instance Looker dapat melakukan hal berikut untuk menggunakan Konektor BI Looker–Tableau terbaru:

Setelah pengguna mendownload dan menyimpan file Konektor Tableau dan file driver JDBC, pengguna dapat terhubung ke data Looker dari Tableau Desktop. Pengguna harus melakukan autentikasi ke akun Looker mereka di Konektor BI Looker–Tableau yang diupgrade.

Setelah semua pengguna instance Looker mengupgrade ke Konektor BI Looker–Tableau baru, Anda dapat mengikuti prosedur untuk menghapus aplikasi OAuth Tableau yang ditambahkan ke instance Looker sebagai bagian dari penyiapan untuk Pratinjau Publik.

Menghapus aplikasi OAuth Tableau (opsional)

Prosedur ini tidak diperlukan. Namun, setelah semua pengguna instance Looker mengupgrade ke file konektor Tableau looker_v1.0.0.taco, Anda dapat menghapus aplikasi Tableau OAuth versi Pratinjau Pribadi dari instance Looker dengan melakukan langkah-langkah berikut:

  1. Buka Looker API Explorer (lihat halaman Menggunakan API Explorer untuk mengetahui informasinya).
  2. Di kolom Telusuri API Explorer, masukkan Delete OAuth Client App.
  3. Di hasil penelusuran, klik Delete OAuth Client App.
  4. Di halaman Delete OAuth Client App, klik tombol Run It.

  5. Di tab Request pada dialog Run It, masukkan nilai client_guid aplikasi OAuth Tableau. Untuk versi Konektor BI Looker–Tableau Pratinjau Publik (v0.2.0), nilai client_guid adalah:

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

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

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

    • Di kolom Telusuri API Explorer, masukkan Get OAuth Client App.
    • Klik Run It.
    • Di kolom client_guid, masukkan nilai aplikasi OAuth Tableau: 35FBB268-0CB0-4822-AFE3-28638C1C6269

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