Mengimpor dan mengkueri data menggunakan Add-in Azure Databricks Excel

Penting

Fitur ini ada di Pratinjau Umum.

Nota

Add-in Azure Databricks Excel tidak tersedia di wilayah Azure Government atau Azure Tiongkok.

Add-in Azure Databricks Excel menghubungkan ruang kerja Azure Databricks Anda ke Microsoft Excel, membawa data Lakehouse yang diatur langsung ke spreadsheet Anda.

Halaman ini menjelaskan cara menggunakan Add-in Azure Databricks Excel untuk mengimpor dan menganalisis data dari Azure Databricks di Excel. Anda dapat menelusuri dan mengimpor tabel Azure Databricks melalui antarmuka intuitif di mana tidak ada pengetahuan SQL yang diperlukan. Meskipun add-in menawarkan fleksibilitas untuk menjalankan kueri SQL kustom, add-in tersebut bersifat opsional.

Prasyarat

• Sebelum Anda menggunakan Add-in Excel, verifikasi bahwa Anda memilikinya siapkan.
• Anda memiliki akses SQL Azure Databricks dan setidaknya dapat menggunakan izin pada gudang SQL.

Pilih gudang SQL

Pilih gudang SQL mana yang akan digunakan:

1. Di kanan atas panel Add-in Azure Databricks di Excel, klik menu drop-down.
2. Pilih gudang SQL mana yang ingin Anda gunakan.

Mengimpor data dari Azure Databricks

Impor data dari Azure Databricks di Excel dengan memilih tabel, menulis kueri SQL, atau mengimpor tabel pivot.

Nota

Anda dapat mengimpor tampilan metrik Katalog Unity menggunakan tabel pivot, kueri SQL, dan fungsi kustom.

Membuat tabel pivot

Untuk membuat tabel pivot dari tabel dan tampilan Unity Catalog di Excel:

1. Di panel Add-in Azure Databricks Excel, di bawah tab Impor baru, pilih Pilih data sebagai metode Impor.

2. Di bawah Katalog, pilih tabel yang ingin Anda buat tabel pivotnya dan klik Pilih.

3. Pilih kotak centang Pivot Data .

4. Konfigurasikan Baris, Kolom, dan Nilai dengan menyeret setiap bidang ke area yang benar.

5. (Opsional) Tambahkan Filter. Untuk informasi selengkapnya tentang filter, lihat Memfilter data yang diimpor.

6. (Opsional) Untuk melihat sampel impor, klik Pratinjau.

7. (Opsional) Atur batas baris untuk impor Anda.

8. Impor hasil Anda. Pilih salah satu metode berikut:

   • Klik Simpan dan impor untuk menyimpan kueri untuk digunakan kembali dalam buku kerja Excel dan impor hasilnya.
   • Klik panah bawah, lalu klik Impor hasil untuk mengimpor hasil tanpa menyimpan kueri. Gunakan opsi ini saat Anda ingin terus mengedit impor.

   Nota

   Tabel pivot hanya dapat diimpor ke lembar baru.

Saat bekerja dengan metrik Katalog Unity dalam tabel pivot, Anda mungkin melihat Sum(measure) ditampilkan dalam hasilnya. Ini adalah perilaku yang diharapkan dan tidak ada agregasi tambahan yang terjadi. Excel mengharuskan nilai memiliki fungsi agregasi, tetapi karena data berisi nilai unik, tidak ada agregasi yang terjadi.

Pilih tabel

Data diimpor sebagai objek tabel Excel. Anda dapat memindahkan tabel atau mengganti nama lembar, dan add-in Excel me-refresh data di lokasi baru.

Untuk mengimpor data dari tabel Azure Databricks, lakukan hal berikut:

1. Di panel Add-in Azure Databricks Excel, di bawah tab Impor baru, pilih Pilih data sebagai metode Impor.
2. Pilih tabel untuk diimpor dari penjelajah Katalog. Anda dapat memfilter katalog menurut pemilik, status sertifikasi, dan properti lainnya menggunakan
3. Klik Pilih.
4. Di bawah Kolom, klik panah bawah dan batal pilih kolom yang tidak ingin Anda impor, atau biarkan semua kolom dipilih untuk mengimpor seluruh tabel.
5. (Opsional) Tambahkan Filter. Untuk informasi selengkapnya tentang filter, lihat Memfilter data yang diimpor.
6. (Opsional) Untuk melihat sampel impor, klik Pratinjau.
7. (Opsional) Atur batas baris untuk membatasi jumlah baris yang diimpor.
8. (Opsional) Untuk mengidentifikasi data yang Anda impor, masukkan Nama impor.
9. Di bawah Tujuan Output, pilih untuk mengimpor data ke lembar baru atau lembar saat ini. Jika Anda mengimpor ke lembar saat ini, data dimulai dari referensi sel yang Anda masukkan (secara default A1).
10. Impor hasil Anda. Pilih salah satu hal berikut ini:
    • Klik Simpan dan impor untuk menyimpan kueri untuk digunakan kembali dalam buku kerja Excel dan impor hasilnya.
    • Klik panah bawah, lalu klik Impor hasil untuk mengimpor hasil tanpa menyimpan kueri. Gunakan opsi ini saat Anda ingin terus mengedit impor.

Menulis kueri SQL

Metode impor Write SQL mendukung fungsi SQL dan prosedur tersimpan.

Untuk menjalankan kueri SQL kustom terhadap ruang kerja Azure Databricks Anda, lakukan hal berikut:

1. Di panel Add-in Azure Databricks Excel, di bawah tab Impor, pilih Write SQL sebagai metode Import.

2. Masukkan nama untuk kueri Anda untuk mengidentifikasinya nanti.

3. Tulis kueri baru atau gunakan kueri yang sudah ada dari ruang kerja Azure Databricks Anda.

   • Tulis kueri SQL Anda di editor. Anda bisa mengkueri tabel apa pun di Unity Catalog yang memiliki izin untuk diakses.

     • Klik Penjelajah katalog untuk melihat skema dan tabel Anda.

   • Untuk menggunakan kueri dari ruang kerja Azure Databricks atau kueri yang sudah ada di Excel, klik folder. Jika Anda menggunakan kueri yang sudah ada dari ruang kerja Azure Databricks Anda, pengeditan yang dibuat di Excel tidak tercermin pada Azure Databricks.

     Nota

     Kueri harus disimpan secara eksplisit di Azure Databricks menggunakan tombol Simpan di sudut kanan atas editor kueri sebelum muncul di Excel.

4. (Opsional) Untuk menambahkan parameter kueri, klik +Tambahkan di samping Parameter. Klik parameter dan masukkan Nama Parameter dan Nilai Parameter.

   • Untuk nilai parameter, Anda dapat memasukkan nilai tertentu atau mengklik tombol kotak dan panah untuk menentukan referensi sel. Pilih sel atau rentang sel dan klik panah untuk mengisi nilai parameter secara otomatis.

5. Di bawah Tujuan Output, pilih untuk mengimpor data ke lembar baru atau lembar saat ini. Jika Anda mengimpor ke lembar saat ini, data dimulai dari referensi sel yang Anda masukkan (secara default A1).

6. Untuk mempratinjau hasil kueri Anda, klik Jalankan.

7. Impor hasil Anda. Pilih salah satu metode berikut:

   • Klik Simpan dan impor untuk menyimpan kueri untuk digunakan kembali dalam buku kerja Excel dan impor hasilnya.
   • Klik panah bawah, lalu klik Impor hasil untuk mengimpor hasil tanpa menyimpan kueri. Gunakan opsi ini saat Anda ingin terus mengedit impor.

Anda juga bisa menggunakan fungsi kustom untuk menambahkan parameter kueri. Lihat Menulis SQL.

Memfilter data yang diimpor

Saat Anda mengimpor data dengan memilih tabel atau membuat tabel pivot, Anda bisa menerapkan filter untuk mempersempit hasilnya.

Filter string tidak membedakan huruf besar dan kecil serta berjenjang. Ketika Anda menerapkan lebih dari satu filter, nilai yang tersedia untuk setiap filter bergantung pada pilihan di filter sebelumnya. Misalnya, jika Anda memfilter berdasarkan negara lalu menambahkan filter pada kota, filter kota hanya menawarkan kota dalam negara yang dipilih.

Untuk mengatur filter, klik + di samping Filter, pilih kolom yang ingin Anda terapkan filternya, lalu masukkan kondisi filter Anda. Untuk filter yang memerlukan nilai, Anda bisa melakukan salah satu hal berikut ini:

• Masukkan nilai.
• Untuk menghasilkan daftar hingga 5.000 nilai filter yang berbeda, Anda dapat menggunakan:
  1. Klik Nilai, lalu Dapatkan nilai filter.
  2. Klik panah bawah dan pilih satu atau beberapa nilai dari daftar.
• Untuk menggunakan referensi sel:
  1. Klik Sel.
  2. Pilih sel atau rentang sel.
  3. Klik kursor .

Tabel berikut ini menjelaskan setiap filter yang tersedia dan input yang diharapkan.

Filter	Input yang diharapkan	Deskripsi
IS NULL	Tidak	Menemukan baris di mana nilai kolom null.
IS NOT NULL	Tidak	Menemukan baris di mana nilai kolom tidak null.
EQUALS	Satu angka atau string teks	Menemukan baris di mana nilai kolom sama persis dengan nilai yang ditentukan.
NOT EQUALS	Satu angka atau string teks	Menemukan baris di mana nilai kolom tidak cocok dengan nilai yang ditentukan.
STARTS WITH	Satu string teks	Menemukan baris di mana nilai kolom dimulai dengan teks yang ditentukan.
ENDS WITH	Satu string teks	Menemukan baris di mana nilai kolom berakhir dengan teks yang ditentukan.
CONTAINS	Satu string teks	Menemukan baris di mana nilai kolom berisi teks yang ditentukan di mana saja dalam string.

Bidang terhitung

Bidang kalkulasi adalah kolom yang diturunkan dari data yang ada, seperti profit yang dihitung dari revenue dan cost. Add-in Excel tidak mendukung pembuatan bidang terhitung menggunakan metode Select data import. Untuk menambahkan bidang terhitung, gunakan salah satu metode berikut:

• Tulis SQL: Gunakan metode impor Tulis SQL untuk menghitung kolom terhitung dengan ekspresi SQL apa pun. Lihat Tulis kueri SQL.
• Genie One: Minta Genie One mengembalikan data Anda dengan kolom yang dihitung yang Anda butuhkan, lalu impor hasilnya. Lihat Gunakan Genie One di Microsoft Excel.

Databricks merekomendasikan penggunaan Genie One untuk kolom terhitung.

Menggunakan fungsi kustom Azure Databricks di Excel

Add-in Excel menyediakan fungsi kustom yang bisa Anda gunakan dalam rumus Excel untuk mengimpor data dari Azure Databricks.

Pilih tabel

Fungsi DATABRICKS.Table mengimpor data dari tabel Unity Catalog.

Sintaks:

=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])

Parameter:

• catalog_name.schema_name.table_name (wajib): Nama tabel yang sepenuhnya memenuhi kriteria.
• columns (opsional): Array nama kolom yang akan diimpor. Hilangkan parameter ini untuk mengimpor semua kolom.
• limit (opsional): Jumlah maksimum baris yang akan diimpor. Hilangkan parameter ini untuk mengimpor semua baris, hingga batas 10 MB.

Example:

=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)

Rumus ini mengimpor customer_id kolom dan customer_name dari main.default.customers tabel, dibatasi hingga 100 baris.

Tulis SQL

Fungsi DATABRICKS.SQL menjalankan kueri SQL yang menggunakan parameter kueri dan mengembalikan hasilnya.

Sintaks:

Tentukan parameter menggunakan nilai.

=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})

Tentukan parameter menggunakan rentang sel. Tentukan parameter nama dan nilai dalam sel yang berada di baris yang sama.

=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})

Parameter:

• query_text (wajib): Kueri SQL yang akan dijalankan.
• parameters (wajib): Pemetaan nilai parameter yang akan dimasukkan ke dalam kueri.

Example:

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)

Rumus ini menjalankan kueri yang memfilter data penjualan menurut longitude dan latitude, menggunakan nilai parameter yang disediakan.

Mengelola permintaan

Kelola impor yang sudah ada dari halaman Impor.

Mengedit impor yang sudah ada

Untuk mengedit impor yang sudah ada:

1. Di panel Add-in Azure Databricks di Excel, klik tab Impor.
2. Temukan impor yang ingin Anda edit.
3. Klik menu tiga titik di samping impor.
4. Klik Edit untuk mengedit impor Anda.

Perbarui data

Add-in Excel tidak menyegarkan data secara otomatis. Cara Anda merefresh data bergantung pada cara Anda mengimpornya. Data yang diimpor menggunakan metode impor (pilih tabel, tulis kueri SQL, atau buat tabel pivot) refresh dari tab Impor . Data yang diimpor menggunakan fungsi kustom harus dihitung ulang.

Perbarui impor dengan nilai terbaru dari Azure Databricks. Add-in menjalankan kueri asli atau pilihan tabel lagi dan memperbarui lembar kerja Anda dengan data baru:

• Untuk memuat ulang satu impor:
  1. Di panel Add-in Azure Databricks di Excel, klik tab Impor.
  2. Klik di samping impor yang ingin Anda perbarui.
• Untuk memuat ulang semua import:
  1. Klik Refresh All di panel Add-in Azure Databricks.

Penting

Saat merefresh data, Add-in Excel menghapus semua data yang ada dalam tabel yang ditentukan dan memuat ulang data terbaru dari Azure Databricks. Kolom kustom apa pun yang Anda tambahkan ke tabel dihapus selama proses refresh.

Data yang diimpor dari fungsi kustom, seperti DATABRICKS.Table dan DATABRICKS.SQL, tidak di-refresh saat Anda membuka kembali buku kerja. Untuk menyegarkan data yang diimpor dari fungsi kustom, masuk ke Add-in Azure Databricks, lalu hitung ulang buku kerja atau ubah nilai referensi fungsi kustom.

Implikasi berbagi

Saat Anda berbagi buku kerja Excel yang berisi data Azure Databricks, pertimbangkan implikasi akses data dan keamanan berikut:

Visibilitas ke data yang diimpor

Saat penerima me-refresh impor, Add-in menggunakan izin Unity Catalog penerima. Jika mereka tidak memiliki akses ke data yang mendasar, refresh gagal.

Untuk buku kerja yang menjadi perhatian privasi data, Anda bisa menggunakan solusi berikut:

1. Buat buku kerja dengan semua rumus dan pengimporan yang diperlukan.
2. Hapus data yang diimpor dari lembar.
3. Bagikan buku kerja dengan penerima.
4. Minta penerima menyegarkan data.

Penerima hanya melihat data yang dapat mereka akses berdasarkan izin Katalog Unity mereka.

Akses ke ruang kerja dan aset data

• Pengguna tanpa akses ke objek Katalog Unity yang direferensikan dalam buku kerja tidak dapat me-refresh data. Untuk merefresh data, pengguna harus memiliki izin baca pada tabel dan view yang mendasarinya di Unity Catalog.
• Pengguna harus memiliki akses ke tabel yang mendasar di Azure Databricks untuk mengedit impor yang ada.

Tingkat kejelasan kueri

Pengguna dengan akses edit ke buku kerja bisa menampilkan kueri yang digunakan untuk menghasilkan data melalui Add-in Azure Databricks, meskipun mereka tidak memiliki akses ke data yang mendasarinya di Katalog Unity.

Alternatif untuk menyimpan sebagai templat

Add-in Azure Databricks Excel tidak mendukung penyimpanan buku kerja sebagai templat, tetapi Anda bisa berbagi buku kerja sehingga pengguna lain bisa melihat kueri yang diimpor. Lihat Implikasi berbagi untuk akses data dan pertimbangan keamanan.

Sebagai solusi untuk berbagi buku kerja sebagai templat, lakukan salah satu hal berikut ini:

• Bagikan file lokal dengan pengguna lain. Penerima dapat mengganti nama file dan melihat kueri yang disimpan.
• Pada SharePoint, bagikan buku kerja dengan pengguna lain. Ketika pengguna lain mengunduh file, impor yang disimpan dipertahankan.

Keterbatasan

• Fungsi kustom: Untuk fungsi kustom, hasil kueri dibatasi hingga 25 MiB karena keterbatasan API eksekusi SQL.
• Pemuatan data: Pemuatan data mungkin gagal jika ada sel dalam buku kerja dalam mode edit.
• Excel Batas baris desktop: Excel Desktop mendukung maksimum 1.048.576 baris per lembar.
• Excel untuk web batas ukuran file: Excel untuk web mendukung ukuran file buku kerja maksimum sekitar 25 MB untuk menampilkan dan mengedit.