Bagikan melalui


Membuat pintasan OneLake dalam database KQL

OneLake adalah data lake logis tunggal, terpadu untuk Microsoft Fabric untuk menyimpan lakehouse, gudang, database KQL, dan item lainnya. Pintasan adalah referensi yang disematkan dalam OneLake yang menunjuk ke lokasi penyimpanan file lain tanpa memindahkan data asli. Referensi yang disematkan membuatnya tampak seolah-olah file dan folder disimpan secara lokal tetapi pada kenyataannya; mereka ada di lokasi penyimpanan lain. Pintasan dapat diperbarui atau dihapus dari item Anda, tetapi perubahan ini tidak memengaruhi data asli dan sumbernya.

Dalam artikel ini, Anda mempelajari cara membuat pintasan OneLake dalam database KQL yang menunjuk ke Fabric internal atau sumber eksternal. Pintasan semacam ini kemudian diakses untuk kueri dalam set kueri KQL dengan menggunakan external_table() fungsi . Pintasan yang dibuat dalam database KQL tidak dapat diganti namanya, dan hanya satu pintasan yang dapat dibuat pada satu waktu.

Selain membuat pintasan dari database KQL, pintasan juga dapat dibuat dari item Fabric lainnya. Pintasan ini juga menunjuk ke data yang disimpan di Fabric internal atau sumber eksternal, tetapi memiliki batasan yang berbeda dan diakses secara berbeda. Untuk informasi selengkapnya, lihat Pintasan OneLake.

Catatan

Gunakan pintasan OneLake saat Anda jarang menjalankan kueri pada data historis tanpa mempartisi atau mengindeks data. Jika Anda ingin sering menjalankan kueri dan mempercepat performa, impor data langsung ke database KQL Anda.

Pilih tab yang sesuai dengan pintasan yang ingin Anda buat:

Prasyarat

Untuk mengakses data dalam database KQL Anda di pengalaman Microsoft Fabric lainnya, lihat Satu salinan logis.

Buat pintasan

Catatan

Alur berikut menunjukkan cara membuat pintasan yang menunjuk ke data di Lakehouse di Fabric. Demikian pula, Anda dapat membuat pintasan yang menunjuk ke Gudang Data atau database KQL lainnya.

  1. Telusuri ke database KQL yang sudah ada.

  2. Pilih Pintasan OneLake Baru>.

    Cuplikan layar tab Beranda memperlihatkan menu dropdown tombol Baru. Opsi berjudul Pintasan OneLake disorot.

Pilih sumber

  1. Di bawah Sumber internal, pilih Microsoft OneLake.

    Cuplikan layar jendela Pintasan baru memperlihatkan dua metode untuk membuat pintasan. Opsi berjudul OneLake disorot.

  2. Pilih sumber data yang ingin Anda sambungkan, lalu pilih Berikutnya.

    Cuplikan layar jendela Pilih jenis sumber data memperlihatkan sumber data yang tersedia untuk digunakan dengan pintasan. Tombol Berikutnya disorot.

  3. Perluas Tabel, dan pilih tabel tertentu untuk disambungkan.

    Cuplikan layar jendela Pintasan baru memperlihatkan data di LakeHouse. Subfolder berjudul StrmSC dan tombol Buat disorot.

  4. Pilih Buat.

Catatan

Anda hanya dapat menyambungkan ke satu subfolder atau tabel per pintasan. Untuk menyambungkan ke lebih banyak data, ulangi langkah-langkah ini dan buat pintasan tambahan.

Database di-refresh secara otomatis. Pintasan muncul di bawah Pintasan di panel Explorer .

Cuplikan layar panel Explorer memperlihatkan pintasan baru.

Pintasan OneLake telah dibuat. Sekarang Anda bisa mengkueri data ini.

Mengkueri data

Untuk mengkueri data dari pintasan OneLake, gunakan external_table() fungsi .

  1. Di sisi paling kanan database Anda, pilih Jelajahi data Anda. Jendela terbuka dengan beberapa contoh kueri yang bisa Anda jalankan untuk mendapatkan tampilan awal data Anda.
  2. Ganti tempat penampung nama tabel dengan external_table('Nama') pintasan.
  3. Pilih Jalankan atau tekan Shift + Enter untuk menjalankan kueri yang dipilih.

Cuplikan layar jendela Jelajahi data Anda memperlihatkan hasil kueri contoh.

Pemetaan jenis data

Pemetaan jenis data Delta parquet ke Eventhouse

Jenis data primitif Delta dipetakan ke jenis data skalar Eventhouse menggunakan aturan berikut. Untuk informasi selengkapnya tentang jenis data Eventhouse, lihat Jenis data skalar.

Jenis Delta Jenis Data Skalar Eventhouse
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (tanpa zona waktu) datetime
struct dynamic
array dynamic
map dynamic