SQL Runner menyediakan cara untuk langsung mengakses database Anda dan memanfaatkan akses tersebut dengan berbagai cara. Dengan SQL Runner, Anda dapat dengan mudah menavigasi tabel di skema, menggunakan Explore ad hoc dari kueri SQL, menjalankan kueri deskriptif yang telah ditulis sebelumnya pada data, melihat histori Runner SQL, mendownload hasil, membagikan kueri, menambahkan ke Project LookML sebagai tabel turunan, dan melakukan tugas berguna lainnya.
Halaman ini menjelaskan cara menjalankan kueri di SQL Runner, membuat Jelajah ad hoc, dan cara menggunakan SQL Runner untuk men-debug kueri. Lihat halaman dokumentasi lainnya untuk mendapatkan informasi tentang:
- Dasar-dasar Runner SQL
- Menggunakan SQL Runner untuk membuat tabel turunan
- Mengelola fungsi database dengan SQL Runner
Menjalankan kueri di SQL Runner
Untuk menjalankan kueri di database, Anda dapat menulis kueri SQL dari awal, menggunakan Explore untuk membuat kueri, atau menjalankan kueri terhadap model LookML. Anda juga dapat menggunakan history untuk menjalankan kembali kueri sebelumnya.
Menulis kueri SQL dari awal
Anda dapat menggunakan SQL Runner untuk menulis dan menjalankan kueri SQL sendiri terhadap database. Looker meneruskan kueri ke database seperti yang telah Anda tulis. Jadi, pastikan sintaksis kueri SQL valid untuk dialek database Anda. Misalnya, setiap dialek memiliki fungsi SQL yang sedikit berbeda dengan parameter tertentu yang harus diteruskan ke fungsi.
- Masukkan kueri SQL di kotak teks di bawah kolom Kueri.
- Anda juga dapat memilih nama tabel atau kolom dari daftar kolom untuk menyertakannya dalam kueri di lokasi kursor.
- Pilih Run untuk menjalankan kueri terhadap database Anda.
- Lihat hasilnya di area Hasil. SQL Runner akan memuat hingga 5.000 baris kumpulan hasil kueri. Untuk dialek SQL yang mendukung streaming, Anda dapat mendownload hasil untuk melihat seluruh kumpulan hasil.
Beberapa program SQL memungkinkan Anda menjalankan beberapa kueri secara berurutan. Namun, Anda hanya dapat menjalankan satu kueri dalam satu waktu di SQL Runner. SQL Runner juga memiliki batas 65.535 karakter pada kueri, termasuk spasi kosong.
Setelah menjalankan kueri, Anda dapat menambahkan kueri ke project, mendapatkan LookML untuk tabel turunan, atau membagikan kueri.
Anda juga dapat menggunakan SQL Runner untuk bermain dengan kueri baru atau menguji kueri yang ada. Penandaan error Runner SQL membantu menguji dan men-debug kueri.
Menggunakan Explore untuk membuat kueri SQL
Anda juga dapat menggunakan Explore untuk membuat kueri, lalu mendapatkan perintah SQL untuk kueri tersebut untuk digunakan di SQL Runner:
- Dari bagian Explore, pilih tab SQL dari panel Data.
- Kueri SQL akan muncul di bawah bilah Data.
- Pilih Buka di SQL Runner atau Jelaskan di SQL Runner untuk membuka kueri di SQL Runner.
Setelah kueri ditambahkan ke kotak teks di bawah panel Query, Anda dapat memilih Run untuk melakukan kueri database. Atau, Anda dapat mengedit kueri, lalu menjalankan kueri baru.
Membuat visualisasi dengan SQL Runner
Jika admin Looker Anda telah mengaktifkan fitur Lab SQL Runner Vis, Anda dapat membuat visualisasi langsung di SQL Runner.
Dengan mengaktifkan SQL Runner Vis, panel Runner SQL telah diatur ulang. Panel visualisasi muncul di bagian atas, panel hasil berada di tengah, dan panel kueri muncul di bagian bawah.
- Setelah kueri SQL dibuat dan dijalankan, Anda dapat membuka tab Visualisasi untuk melihat visualisasi dan memilih jenis visualisasi, seperti yang Anda lakukan di halaman Eksplorasi.
- Anda dapat mengedit visualisasi menggunakan menu Setelan.
- Anda dapat berbagi visualisasi yang dibuat menggunakan SQL Runner dengan membagikan URL. Setiap penyesuaian yang Anda lakukan menggunakan menu Setelan visualisasi akan disimpan dan tautannya tidak akan berubah.
Ada beberapa hal yang perlu diingat tentang cara kerja visualisasi SQL Runner:
- Tabel dan visualisasi hasil menafsirkan kolom numerik sebagai ukuran.
- Nama kolom lengkap selalu digunakan dalam visualisasi dan tabel hasil. Oleh karena itu, opsi Tampilkan Nama Kolom Lengkap di menu Setelan tidak aktif.
- Untuk menggunakan kolom kustom, penghitungan tabel, pivot, total kolom, dan subtotal, jelajahi dari kueri Runner SQL Anda.
- Visualisasi peta statis (wilayah) tidak didukung oleh visualisasi SQL Runner, tetapi peta yang menggunakan data lintang dan bujur (visualisasi peta dan peta statis (titik)) didukung.
- Visualisasi linimasa tidak didukung oleh visualisasi SQL Runner.
Dimensi pivot
Anda dapat mengedit hasil kueri untuk mengubah satu atau beberapa dimensi dalam visualisasi SQL Runner. Untuk melakukan pivot pada kolom:
- Pilih menu roda gigi kolom di area Hasil untuk menampilkan opsi kolom.
- Pilih Pivot Column.
Hasil pivot ditampilkan dalam visualisasi SQL Runner.
Hasil di area Hasil tidak tampak tergeser.
Untuk membatalkan perubahan hasil, pilih menu roda gigi pada kolom pivot dan pilih Unpivot Column.
Mengubah jenis kolom
Saat menampilkan hasil dan visualisasi kueri Anda, SQL Runner secara otomatis menafsirkan kolom numerik sebagai ukuran dan kolom non-numerik sebagai dimensi. Anda dapat mengganti jenis kolom default dan mengonversi dimensi menjadi ukuran – atau sebaliknya – dengan mengikuti langkah-langkah berikut:
- Pilih menu roda gigi kolom di area Hasil untuk menampilkan opsi kolom.
- Pilih Konversikan ke Dimensi atau Konversikan ke Mengukur untuk mengubah jenis kolom.
Visualisasi akan menampilkan jenis kolom baru.
Menjalankan kueri terhadap model LookML
Anda dapat menggunakan SQL Runner untuk menulis dan menjalankan kueri SQL terhadap model LookML, bukan secara langsung terhadap database Anda. Saat membuat kueri terhadap model, Anda dapat menggunakan operator substitusi LookML, seperti ${view_name.field_name} atau ${view_name.SQL_TABLE_NAME}. Ini dapat menghemat waktu saat membuat kueri untuk memecahkan masalah tabel turunan, misalnya.
Looker akan me-resolve setiap substitusi LookML, lalu meneruskan kueri Anda ke database, sehingga kueri tersebut harus berupa SQL yang valid untuk dialek database Anda. Misalnya, setiap dialek memiliki fungsi SQL yang sedikit berbeda dengan parameter tertentu yang harus diteruskan ke fungsi.
Untuk menjalankan kueri terhadap model LookML Anda di SQL Runner:
- Pilih tab Model.
- Pilih model yang ingin Anda kueri.
- Dalam kotak teks di bawah kolom Data, masukkan kueri SQL Anda menggunakan kolom LookML.
- Jika perlu, pilih tampilan dalam daftar tampilan untuk menyertakan tampilan dalam kueri Anda di lokasi kursor.
- Untuk melihat daftar kolom dalam tampilan, pilih tampilan di bagian Tampilan. Anda juga dapat memilih kolom dalam daftar kolom untuk menyertakannya dalam kueri di lokasi kursor.
- Di area Prepared SQL Query, Anda dapat melihat kueri SQL yang dihasilkan yang dibuat setelah substitusi LookML telah diterjemahkan ke SQL.
- Pilih Run untuk menjalankan kueri pada model Anda.
- Lihat hasilnya di area Hasil. SQL Runner memuat hingga 5.000 baris kumpulan hasil kueri. Untuk dialek SQL yang mendukung streaming, Anda dapat mendownload hasil untuk melihat seluruh kumpulan hasil.
Anda dapat menggunakan SQL Runner untuk bermain dengan kueri baru, menguji kueri yang ada, atau membuka Jelajah baru dari hasil. Penandaan error Runner SQL membantu menguji dan men-debug kueri.
Saat memiliki kueri yang disukai, Anda dapat membagikan kueri tersebut dan bahkan menambahkan kueri tersebut ke project LookML.
Melihat LookML kolom dari SQL Runner
Dari daftar kolom di tab Model, Anda juga dapat melihat LookML untuk sebuah kolom. Arahkan kursor ke kolom pada daftar kolom, lalu pilih ikon Looker di sebelah kanan nama kolom.
Looker akan membuka LookML IDE, dan memuat file tempat kolom ditentukan.
Histori SQL Runner
Anda juga dapat melihat histori terbaru dari semua kueri yang telah dijalankan di SQL Runner.
Untuk melihat histori Anda, pilih tab Histori di bagian atas panel navigasi. SQL Runner menampilkan semua kueri yang dijalankan pada koneksi database. Merah menunjukkan kueri yang tidak berjalan karena terjadi error.
Pilih kueri dalam histori untuk mengisi kueri tersebut ke SQL Runner, lalu pilih Run untuk menjalankan kembali kueri.
Mengurutkan kueri
Urutan tabel ditunjukkan dengan panah ke atas atau ke bawah di samping nama kolom yang diurutkan, bergantung pada apakah hasilnya dalam urutan menaik atau menurun. Anda dapat mengurutkan menurut beberapa kolom dengan menahan tombol Shift kemudian memilih tajuk kolom dalam urutan yang Anda inginkan. Urutan pengurutan kolom juga ditunjukkan dengan angka yang membedakan urutannya jika dibandingkan dengan kolom lain, dengan tanda panah di samping nama kolom yang menunjukkan arah pengurutan (menaik atau menurun), dan dengan pop-up yang muncul saat Anda mengarahkan kursor ke nama kolom.
Untuk mengetahui informasi dan contoh selengkapnya, lihat bagian Mengurutkan data di halaman dokumentasi Menjelajahi data di Looker.
Kueri berbagi
Anda dapat membagikan kueri di SQL Runner dengan pengguna lain yang memiliki akses SQL Runner. Untuk membagikan kueri, salin URL di kolom URL browser Anda.
Mendownload hasil
Setelah Anda menjalankan kueri SQL Anda, Anda dapat mengunduh hasilnya dalam berbagai format.
- Tulis kueri di kotak SQL Query. (Anda tidak perlu menjalankan kueri di SQL Runner pada saat ini.)
- Pilih Download dari menu roda gigi di kanan atas.
- Pilih format file yang didownload (file teks, CSV, JSON, dll.).
Pilih Buka di Browser untuk melihat hasil di jendela browser baru, atau pilih Download untuk mendownload hasil ke file di komputer.
Saat Anda memilih Buka di Browser atau Download, Looker akan menjalankan kembali kueri, lalu melakukan download.
Untuk dialek SQL yang mendukung streaming, opsi Download Runner SQL akan mendownload seluruh kumpulan hasil. Untuk dialek SQL yang tidak mendukung streaming, opsi Download SQL Runner hanya akan mendownload baris kueri yang ditampilkan di bagian Results (hingga 5.000 baris).
Menyalin nilai kolom
Anda dapat menyalin nilai kolom dari bagian Results di SQL Runner. Pilih menu roda gigi di kolom untuk menyalin nilai tersebut ke papan klip. Dari sana, Anda dapat menempelkan nilai kolom ke dalam {i>file<i} teks, {i>spreadsheet <i}Excel, atau lokasi lainnya.
Jika admin Looker Anda telah mengaktifkan fitur SQL Runner Vis Labs, Anda juga memiliki opsi lain di menu roda gigi kolom:
Anda juga dapat memindahkan, menyematkan, dan resize kolom secara manual di tabel hasil.
Estimasi biaya untuk kueri SQL Runner
Untuk koneksi BigQuery, MySQL, Amazon RDS for MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL untuk PostgreSQL, dan Microsoft Azure PostgreSQL, SQL Runner memberikan perkiraan biaya kueri. Setelah Anda memasukkan kueri SQL, SQL Runner akan menghitung jumlah data yang diperlukan kueri dan menampilkan informasi di dekat tombol Run.
Untuk koneksi BigQuery, MySQL, dan Amazon RDS untuk MySQL, estimasi biaya selalu diaktifkan. Untuk koneksi database Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL untuk PostgreSQL, dan Microsoft Azure PostgreSQL, Anda harus mengaktifkan opsi Cost Estimate untuk koneksi tersebut. Anda dapat mengaktifkan Estimasi Biaya saat membuat koneksi. Untuk koneksi yang ada, Anda dapat mengedit koneksi dari halaman Connections di bagian Database pada panel Admin Looker.
Membuat Explore ad hoc
Dari SQL Runner, Anda dapat memperoleh insight cepat tentang data dengan membuat Explore ad hoc untuk kueri SQL atau tabel database. Anda dapat menggunakan Jelajah Looker untuk memilih kolom, menambahkan filter, memvisualisasikan hasil, dan membuat kueri SQL.
Ada dua cara untuk membuka Explore ad hoc dari SQL Runner:
- Melakukan eksplorasi dari hasil kueri SQL Runner
- Melakukan eksplorasi dari daftar tabel Runner SQL
Mempelajari hasil kueri SQL Runner
SQL Runner memungkinkan Anda membuka Explore dari kueri SQL. Tindakan ini akan membuat Jelajah sementara dari kueri yang ditulis dalam SQL Runner. Hal tersebut memungkinkan Anda menguji hasil yang ditampilkan kueri, serta memvisualisasikan hasilnya. Ini dapat digunakan untuk kueri apa pun, tetapi sangat berguna untuk menguji kueri yang akan Anda gunakan untuk tabel turunan.
Jika admin Looker Anda telah mengaktifkan fitur SQL Runner Vis Labs, Anda dapat membuat visualisasi langsung di SQL Runner.
- Gunakan SQL Runner untuk membuat kueri SQL yang ingin Anda gunakan.
- Pilih Jelajahi dari menu roda gigi di kanan atas. Tindakan ini akan membawa Anda ke Explore baru, tempat Anda dapat menjelajahi kueri SQL seolah-olah itu adalah tabel tersimpan dalam model Anda.
- Anda dapat menyalin URL ke Explore ini untuk dibagikan.
- Untuk menambahkan kueri ini sebagai tabel turunan di project Anda langsung dari sini, pilih Add View to Project.
Membuat kolom kustom saat menjelajah di SQL Runner
Jika memiliki akses ke fitur kolom kustom, Anda dapat menggunakan kolom kustom untuk memvisualisasikan kolom yang tidak sesuai model di SQL Runner. Seperti yang dijelaskan di bagian sebelumnya, pilih Jelajahi dari menu roda gigi. Kemudian, di pemilih kolom, ikuti langkah-langkah berikut:
- Pilih bagian Kolom Kustom untuk membukanya, lalu pilih Tambahkan untuk mulai membuat dimensi kustom, ukuran kustom, atau penghitungan tabel. (Jika tidak memiliki bagian Kolom Kustom, berarti Anda tidak memiliki akses untuk membuat kolom kustom.)
- Pilih menu Lainnya tiga titik untuk mengukur dan pilih Filter Ukuran untuk membuat ukuran kustom yang difilter dari ukuran yang ada.
- Pilih menu Lainnya tiga titik pada dimensi dan pilih jenis pengukuran (seperti jumlah atau jumlah) untuk membuat pengukuran kustom dari dimensi.
Menjelajahi tabel yang tercantum di SQL Runner
Gunakan opsi Jelajahi Tabel di tab Database untuk membuat bagian Jelajahi ad hoc untuk tabel apa pun dalam koneksi. Hal ini memungkinkan Anda menggunakan Looker pada tabel sebelum membuat modelnya, menjelajahi tabel seperti tampilan LookML.
Setelah membuka bagian Jelajahi untuk tabel, Anda dapat memutuskan apakah akan menambahkan tabel ke project Anda atau tidak. Anda juga dapat menggunakan tab SQL di Explore untuk melihat kueri SQL yang dikirim Looker ke database, lalu menggunakan tombol Open in SQL Runner untuk mengembalikan kueri tersebut ke SQL Runner.
- Pilih tab Database.
- Di SQL Runner, pilih roda gigi untuk tabel, lalu pilih Explore Table.
- Looker menghasilkan model sementara dengan tampilan untuk tabel, lalu menampilkan Jelajah.
- Looker menyediakan kolom dimensi untuk setiap kolom dalam tabel. (Ini adalah cara yang sama seperti Looker menghasilkan model di awal project.)
- Looker secara otomatis menyertakan jangka waktu untuk setiap kolom tanggal.
- Looker juga menyertakan ukuran jumlah.
Saat menggunakan opsi Explore Table, tidak ada file LookML yang terkait dengan Explore — file tersebut hanya merupakan tampilan ad hoc dari tabel.
Proses debug menggunakan SQL Runner
SQL Runner juga merupakan alat yang berguna untuk memeriksa kesalahan SQL dalam kueri.
Sorotan error SQL Runner
SQL Runner menandai lokasi error dalam perintah SQL dan menyertakan posisi error dalam pesan error:
Informasi posisi yang diberikan akan bervariasi tergantung pada dialek {i>database<i}. Misalnya, MySQL menyediakan nomor baris yang berisi error, sedangkan Redshift menyediakan posisi karakter error. Dialek {i>database<i} lain mungkin memiliki salah satu dari perilaku ini atau yang lain.
SQL Runner juga menandai lokasi error sintaksis first dalam perintah SQL dengan menggarisbawahinya dengan warna merah dan menandai baris dengan x. Arahkan kursor ke tanda x untuk melihat informasi selengkapnya tentang error tersebut. Setelah Anda memperbaiki masalah tersebut, pilih Run untuk melihat apakah ada error lain dalam kueri.
Menggunakan SQL Runner untuk memeriksa error di Eksplorasi
Jika mengalami error sintaksis SQL dalam Explore, Anda dapat menggunakan SQL Runner untuk menentukan lokasi error dan jenis error, seperti kesalahan ejaan atau perintah yang tidak ada.
- Dari Explore, pilih tab SQL di Data bar.
- Pilih Open in SQL Runner untuk membuka kueri di SQL Runner.
Tindakan ini akan menyalin SQL yang dibuat Explore ke SQL Runner. Seperti yang ditunjukkan di atas, SQL Runner menandai lokasi error dalam perintah SQL dan menyertakan posisi error dalam pesan error. Kemudian, Anda dapat membuat perubahan dan menjalankan kembali kueri di SQL Runner hingga errornya diperbaiki.
Menggunakan SQL Runner untuk memeriksa error dalam tabel turunan
Untuk mengetahui informasi tentang cara menggunakan SQL Runner untuk memeriksa error SQL di tabel turunan, lihat postingan Komunitas Looker Menggunakan SQL Runner untuk menguji tabel turunan.