SQL Runner menyediakan cara untuk mengakses database secara langsung dan memanfaatkan akses tersebut dengan berbagai cara. Dengan SQL Runner, Anda dapat dengan mudah menavigasi tabel dalam skema, menggunakan Eksplorasi ad hoc dari kueri SQL, menjalankan kueri deskriptif yang telah ditulis sebelumnya pada data, melihat histori SQL Runner, 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 Eksplorasi ad hoc, dan cara menggunakan SQL Runner untuk men-debug kueri. Lihat halaman dokumentasi lainnya ini untuk mengetahui informasi tentang:
- Dasar-dasar SQL Runner
- 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 Eksplorasi untuk membuat kueri, atau menjalankan kueri terhadap model LookML. Anda juga dapat menggunakan histori untuk menjalankan kembali kueri sebelumnya.
Menulis kueri SQL dari awal
Anda dapat menggunakan SQL Runner untuk menulis dan menjalankan kueri SQL Anda sendiri terhadap database Anda. Looker meneruskan kueri Anda ke database Anda seperti yang Anda tulis, jadi pastikan sintaksis kueri SQL Anda 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 kolom di bawah panel Query.
- Secara opsional, pilih nama tabel atau kolom dari daftar kolom untuk menyertakannya dalam kueri Anda di lokasi kursor.
- Pilih Run untuk menjalankan kueri terhadap database Anda.
- Lihat hasilnya di area Results. SQL Runner akan memuat hingga 5.000 baris kumpulan hasil kueri. Untuk dialek SQL yang mendukung streaming, Anda dapat mendownload hasilnya untuk melihat seluruh kumpulan hasil.
Setelah menjalankan kueri, Anda dapat menambahkan kueri ke project, mendapatkan LookML untuk tabel turunan, atau membagikan kueri.
Anda juga dapat menggunakan SQL Runner untuk mencoba kueri baru atau menguji kueri yang ada. Penyorotan error SQL Runner membantu menguji dan men-debug kueri.
Menggunakan Eksplorasi untuk membuat kueri SQL
Anda juga dapat menggunakan Eksplorasi untuk membuat kueri, lalu mendapatkan perintah SQL untuk kueri tersebut yang akan digunakan di SQL Runner:
- Dari Eksplorasi, pilih tab SQL dari panel Data.
- Kueri SQL akan muncul di bagian panel Data.
- Pilih Open in SQL Runner atau Explain in SQL Runner untuk membuka kueri di SQL Runner.
Setelah kueri ditambahkan ke kolom di bawah panel Query, Anda dapat memilih Run untuk mengkueri database. Atau, Anda dapat mengedit kueri, lalu menjalankan kueri baru.
Membuat visualisasi dengan SQL Runner
Jika admin Looker Anda telah mengaktifkan fitur Labs SQL Runner Vis, Anda dapat membuat visualisasi langsung di SQL Runner.
Dengan SQL Runner Vis diaktifkan, panel SQL Runner akan 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 Visualization untuk melihat visualisasi dan memilih jenis visualisasi, seperti yang Anda lakukan di halaman Eksplorasi.
- Anda dapat mengedit visualisasi menggunakan menu Settings.
- Anda dapat membagikan visualisasi yang dibuat dengan SQL Runner dengan membagikan URL. Penyesuaian apa pun yang Anda buat menggunakan menu Settings visualisasi akan disimpan dan link tidak akan berubah.
Ada beberapa hal yang perlu diingat tentang cara kerja visualisasi SQL Runner:
- Tabel hasil dan visualisasi menafsirkan kolom numerik apa pun sebagai ukuran.
- Nama kolom lengkap selalu digunakan dalam tabel hasil dan visualisasi. Oleh karena itu, opsi Show Full Field Name di menu Settings tidak aktif.
- Untuk menggunakan kolom kustom, kalkulasi tabel, pivot, total kolom, dan subtotal, lakukan eksplorasi dari kueri SQL Runner Anda.
- Visualisasi peta statis (region) 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 melakukan pivot berdasarkan satu atau beberapa dimensi dalam visualisasi SQL Runner. Untuk melakukan pivot kolom:
- Pilih menu roda gigi kolom di area Results untuk menampilkan opsi kolom.
- Pilih Pivot Column.
Hasil pivot ditampilkan dalam visualisasi SQL Runner.
Untuk membatalkan pivot hasil, pilih menu roda gigi kolom pivot, lalu pilih Unpivot Column.
Mengubah jenis kolom
Saat menampilkan hasil dan visualisasi kueri, SQL Runner otomatis menafsirkan kolom numerik apa pun sebagai ukuran dan kolom non-numerik apa pun 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 Results untuk menampilkan opsi kolom.
- Pilih Convert to Dimension atau Convert to Measure 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 langsung terhadap database Anda. Saat membuat kueri terhadap model, Anda dapat menggunakan operator penggantian LookML, seperti ${view_name.field_name} atau ${view_name.SQL_TABLE_NAME}. Hal ini dapat menghemat waktu saat membuat kueri untuk memecahkan masalah tabel turunan, misalnya.
Looker menyelesaikan penggantian LookML, lalu meneruskan kueri Anda ke database Anda, sehingga kueri harus dalam 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.
- Di kotak teks di bawah panel Data, masukkan kueri SQL Anda menggunakan kolom LookML.
- Secara opsional, pilih tampilan dalam daftar tampilan untuk menyertakan tampilan dalam kueri Anda di lokasi kursor.
- Untuk melihat daftar kolom dalam tampilan, pilih tampilan di bagian Views. Secara opsional, Anda dapat memilih kolom dalam daftar kolom untuk menyertakannya dalam kueri Anda di lokasi kursor.
- Di area Prepared SQL Query, Anda dapat melihat kueri SQL yang dihasilkan yang dibuat setelah penggantian LookML diterjemahkan ke SQL.
- Pilih Run untuk menjalankan kueri terhadap model Anda.
- Lihat hasilnya di area Results. SQL Runner memuat hingga 5.000 baris kumpulan hasil kueri. Untuk dialek SQL yang mendukung streaming, Anda dapat mendownload hasilnya untuk melihat seluruh kumpulan hasil.
Anda dapat menggunakan SQL Runner untuk mencoba kueri baru, menguji kueri yang ada, atau membuka Eksplorasi baru dari hasil. Penyorotan error SQL Runner membantu menguji dan men-debug kueri.
Jika Anda memiliki kueri yang Anda sukai, Anda dapat membagikan kueri tersebut dan bahkan menambahkannya ke project LookML.
Melihat LookML kolom dari SQL Runner
Dari daftar kolom di tab Model, Anda juga dapat melihat LookML untuk kolom. Arahkan kursor ke kolom dalam daftar kolom, lalu pilih ikon Looker di sebelah kanan nama kolom.
Looker akan membuka IDE LookML, dan memuat file tempat kolom ditentukan.
Histori SQL Runner
Anda juga dapat melihat histori terbaru dari semua kueri yang telah Anda jalankan di SQL Runner.
Untuk melihat histori, pilih tab History di bagian atas panel navigasi. SQL Runner menampilkan semua kueri yang dijalankan pada koneksi database. Warna merah menunjukkan kueri yang tidak dijalankan karena terjadi error.
Pilih kueri dalam histori untuk mengisi kueri tersebut ke SQL Runner, lalu pilih Run untuk menjalankan kembali kueri.
Mengurutkan kueri
Urutan pengurutan tabel ditunjukkan oleh panah ke atas atau ke bawah di samping nama kolom yang diurutkan, bergantung pada apakah hasilnya dalam urutan menaik atau menurun. Anda dapat mengurutkan berdasarkan beberapa kolom dengan menahan tombol Shift, lalu memilih header kolom dalam urutan yang Anda inginkan. Urutan pengurutan kolom juga ditunjukkan oleh angka yang membedakan urutan pengurutan berdasarkan kolom tersebut dibandingkan dengan kolom lain, dengan 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 informasi dan contoh selengkapnya, lihat bagian Mengurutkan data di halaman dokumentasi Menjelajahi data di Looker.
Membagikan kueri
Anda dapat membagikan kueri di SQL Runner kepada pengguna lain yang memiliki akses SQL Runner. Untuk membagikan kueri, salin URL di kolom URL browser Anda.
Mendownload hasil
Setelah menjalankan kueri SQL, Anda dapat mendownload hasilnya dalam berbagai format.
- Tulis kueri di kotak SQL Query. (Anda tidak perlu menjalankan kueri di SQL Runner pada tahap ini.)
- Pilih Download dari menu roda gigi di kanan atas.
- Pilih format file download (file teks, CSV, JSON, dll.).
Pilih Open in Browser untuk melihat hasilnya di jendela browser baru, atau pilih Download untuk mendownload hasilnya ke file di komputer Anda.
Untuk dialek SQL yang mendukung streaming, opsi Download SQL Runner 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 kolom untuk menyalin nilai ke papan klip Anda. Dari sana, Anda dapat menempelkan nilai kolom ke file teks, spreadsheet Excel, atau lokasi lain.
Jika admin Looker Anda telah mengaktifkan fitur Labs SQL Runner Vis, Anda juga memiliki opsi lain di menu roda gigi kolom:
Anda juga dapat memindahkan, menyematkan, dan mengubah ukuran kolom secara manual di tabel hasil.
Estimasi biaya untuk kueri SQL Runner
Untuk koneksi BigQuery, MySQL, Amazon RDS untuk MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL untuk PostgreSQL, dan Microsoft Azure PostgreSQL, SQL Runner memberikan estimasi biaya kueri. Setelah Anda memasukkan kueri SQL, SQL Runner akan menghitung jumlah data yang akan 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 Cost Estimate saat Anda membuat koneksi. Untuk koneksi yang ada, Anda dapat mengedit koneksi dari halaman Connections di bagian Database pada panel Admin Looker.
Membuat Eksplorasi ad hoc
Dari SQL Runner, Anda dapat memperoleh insight cepat tentang data dengan membuat Eksplorasi ad hoc untuk kueri SQL atau tabel database. Anda dapat menggunakan Eksplorasi Looker untuk memilih kolom, menambahkan filter, memvisualisasikan hasil, dan membuat kueri SQL.
Ada dua cara untuk membuka Eksplorasi ad hoc dari SQL Runner:
- Eksplorasi dari hasil kueri SQL Runner
- Eksplorasi dari daftar tabel SQL Runner
Melakukan eksplorasi dari hasil kueri SQL Runner
SQL Runner memungkinkan Anda membuka Eksplorasi dari kueri SQL. Tindakan ini akan membuat Eksplorasi sementara dari kueri yang ditulis di SQL Runner. Hal ini memungkinkan Anda menguji apa yang ditampilkan oleh kueri, serta memvisualisasikan hasilnya. Hal ini dapat digunakan untuk kueri apa pun, tetapi sangat berguna untuk menguji kueri yang Anda rencanakan untuk digunakan pada tabel turunan.
- Gunakan SQL Runner untuk membuat kueri SQL yang ingin Anda gunakan.
- Pilih Explore dari menu roda gigi di kanan atas. Tindakan ini akan membawa Anda ke Eksplorasi baru, tempat Anda dapat menjelajahi kueri SQL seolah-olah kueri tersebut adalah tabel tersimpan dalam model Anda.
- Anda dapat menyalin URL ke Eksplorasi 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 melakukan eksplorasi di SQL Runner
Jika memiliki akses ke fitur kolom kustom, Anda dapat menggunakan kolom kustom untuk memvisualisasikan kolom yang tidak dimodelkan di SQL Runner. Seperti yang dijelaskan di bagian sebelumnya, pilih Explore dari menu roda gigi. Kemudian, di pemilih kolom, ikuti langkah-langkah berikut:
- Pilih bagian Custom Fields untuk membukanya, lalu pilih Add untuk mulai membuat dimensi kustom, ukuran kustom, atau kalkulasi tabel. (Jika Anda tidak memiliki bagian Custom Fields, Anda tidak memiliki akses untuk membuat kolom kustom.)
- Pilih menu tiga titik More ukuran, lalu pilih Filter Measure untuk membuat ukuran kustom yang difilter dari ukuran yang ada.
- Pilih menu tiga titik More dimensi, lalu pilih jenis ukuran (seperti jumlah atau hitungan) untuk membuat ukuran kustom dari dimensi.
Menjelajahi tabel yang tercantum di SQL Runner
Gunakan opsi Explore Table di tab Database untuk membuat Eksplorasi ad hoc untuk tabel apa pun dalam koneksi. Hal ini memungkinkan Anda menggunakan Looker di tabel sebelum Anda memodelkannya, menjelajahi tabel seperti tampilan LookML.
Setelah membuka Eksplorasi untuk tabel, Anda dapat memutuskan apakah akan menambahkan tabel ke project Anda. Anda juga dapat menggunakan tab SQL Eksplorasi untuk melihat kueri SQL yang dikirim Looker ke database, lalu menggunakan tombol Open in SQL Runner untuk membawa kueri kembali ke SQL Runner.
- Pilih tab Database.
- Di SQL Runner, pilih roda gigi untuk tabel, lalu pilih Explore Table.
- Looker membuat model sementara dengan tampilan untuk tabel, lalu menampilkan Eksplorasi.
- Looker menyediakan kolom dimensi untuk setiap kolom dalam tabel. (Ini adalah cara yang sama dengan Looker membuat model di awal project.)
- Looker otomatis menyertakan jangka waktu untuk kolom tanggal apa pun.
- Looker juga menyertakan ukuran hitungan.
Men-debug menggunakan SQL Runner
SQL Runner juga merupakan alat yang berguna untuk memeriksa error SQL dalam kueri.
Penyorotan error SQL Runner
SQL Runner menyoroti lokasi error dalam perintah SQL dan menyertakan posisi error dalam pesan error:
Informasi posisi yang diberikan akan bervariasi bergantung pada dialek database. Misalnya, MySQL memberikan nomor baris yang berisi error, sedangkan Redshift memberikan posisi karakter error. Dialek database lainnya mungkin memiliki salah satu atau perilaku lainnya.
SQL Runner juga menyoroti lokasi error sintaksis pertama dalam perintah SQL dengan menggarisbawahinya dengan warna merah dan menandai baris dengan x. Arahkan kursor ke x untuk melihat informasi selengkapnya tentang error. Setelah Anda memperbaiki masalah tersebut, pilih Run untuk melihat apakah ada error lain dalam kueri.
Menggunakan SQL Runner untuk memeriksa error di Eksplorasi
Jika Anda mengalami error sintaksis SQL di Eksplorasi, Anda dapat menggunakan SQL Runner untuk menentukan lokasi error dan jenis error, seperti kesalahan ejaan atau perintah yang tidak ada.
- Dari Eksplorasi, pilih tab SQL panel Data.
- Pilih Open in SQL Runner untuk membuka kueri di SQL Runner.
Tindakan ini akan menyalin SQL yang dihasilkan Eksplorasi ke SQL Runner. Seperti yang ditunjukkan di bagian Penyorotan error SQL Runner, SQL Runner menyoroti 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 Anda memperbaiki error.
Menggunakan SQL Runner untuk memeriksa error di 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.