Apa itu titik akhir analitik SQL untuk lakehouse?

Titik akhir analitik SQL memberikan antarmuka kueri T-SQL hanya-baca atas tabel Delta di lakehouse Anda. Setiap lakehouse yang dibuat menyediakan titik akhir analitik SQL secara otomatis — tidak ada hal tambahan yang perlu disiapkan. Di balik layar, titik akhir analitik SQL berjalan pada mesin yang sama dengan Fabric Data Warehouse, sehingga Anda mendapatkan kueri SQL berkinerja tinggi dan latensi rendah tanpa mengelola infrastruktur.

Titik akhir analitik SQL tidak unik untuk lakehouse. Item Fabric lainnya — termasuk gudang data, database mirror, database SQL, dan Azure Cosmos DB — juga secara otomatis menyediakan titik akhir analitik SQL. Pengalaman dan batasannya sama di semuanya.

Screenshot dari titik akhir analitik SQL untuk lakehouse yang memperlihatkan query editor dan daftar tabel.

Apa yang dapat Anda lakukan

Titik akhir analitik SQL beroperasi dalam mode baca-saja melalui tabel Delta — Anda tidak dapat menyisipkan, memperbarui, atau menghapus data melaluinya. Untuk memodifikasi data, beralihlah ke lakehouse dan gunakan Apache Spark.

Dalam batas baca-saja tersebut, Anda dapat:

  • Kueri Tabel Delta dengan T-SQL — Jalankan pernyataan SELECT terhadap tabel Delta apa pun di lakehouse Anda, termasuk tabel yang diekspos melalui shortcuts ke Azure Data Lake Storage eksternal atau Amazon S3.
  • Buat tampilan, fungsi, dan prosedur tersimpan — Merangkum logika bisnis dan pola kueri yang dapat digunakan kembali di objek T-SQL yang bertahan di titik akhir analitik SQL.
  • Terapkan keamanan tingkat baris dan tingkat objek — Gunakan izin terperinci SQL untuk mengontrol pengguna mana yang dapat melihat tabel, kolom, atau baris mana.
  • Buat laporan Power BI — Model semantik Power BI dapat tersambung ke titik akhir analitik SQL melalui titik akhir Aliran Data Tabular (TDS), sehingga Anda dapat membuat laporan melalui data lakehouse Anda.
  • Kueri di seluruh ruang kerja — Gunakan pintasan OneLake untuk mereferensikan tabel Delta di lakehouse atau gudang lain, lalu gabungkan dalam satu kueri. Untuk skenario lintas ruang kerja lainnya, lihat Kasus penggunaan titik akhir analitik Lakehouse SQL.

Nota

Tabel Delta eksternal yang dibuat dengan kode Spark tidak terlihat oleh titik akhir analitik SQL. Gunakan pintasan di bagian Tabel untuk membuat tabel Delta eksternal terlihat. Untuk mempelajari caranya, lihat Membuat pintasan.

Akses titik akhir analitik SQL

Anda dapat membuka titik akhir analitik SQL dengan dua cara:

  • Dari ruang kerja — Di daftar item ruang kerja Anda, temukan item endpoint analitik SQL (yang memiliki nama yang sama dengan lakehouse Anda) dan pilih.
  • Dari penjelajah Lakehouse — Di area kanan atas toolbar, gunakan menu dropdown untuk beralih ke tampilan endpoint analitik SQL.

Bagaimanapun, query editor terbuka di mana Anda dapat menulis dan menjalankan kueri T-SQL terhadap tabel Delta Anda.

Keamanan

Aturan keamanan SQL yang ditetapkan pada titik akhir analitik SQL hanya berlaku saat data diakses melalui titik akhir. Mereka tidak berlaku saat data yang sama diakses melalui Spark atau alat lainnya.

Untuk mengamankan data Anda:

  • Atur izin terperinci SQL pada titik akhir analitik SQL untuk mengontrol access ke tabel, kolom, atau baris tertentu.
  • Atur peran dan izin workspace untuk mengontrol siapa yang dapat mengakses lakehouse dan datanya melalui jalur lain.

Untuk informasi selengkapnya tentang model keamanan, lihat Keamanan OneLake untuk titik akhir analitik SQL.

Sinkronisasi metadata

Saat Anda membuat atau memperbarui tabel Delta di lakehouse Anda, titik akhir analitik SQL secara otomatis mendeteksi perubahan dan memperbarui metadata SQL-nya — definisi tabel, jenis kolom, dan statistik. Tidak ada langkah impor dan tidak diperlukan sinkronisasi manual. Anda memiliki beberapa opsi untuk memulai refresh metadata titik akhir analitik SQL secara manual.

Untuk informasi selengkapnya, lihat Sinkronisasi metadata titik akhir analitik SQL.

Penyediaan ulang

Jika endpoint analitik SQL gagal menyediakan saat Anda membuat lakehouse, Anda dapat mencoba ulang langsung dari halaman utama lakehouse tanpa membuat ulang lakehouse.

Cuplikan layar memperlihatkan opsi untuk mencoba kembali provisi titik akhir analitik SQL di lakehouse.

Nota

Provisi ulang masih dapat gagal, sama seperti provisi awal. Jika upaya berulang gagal, hubungi dukungan.

Keterbatasan

Endpoint analitik SQL berbagi engine-nya dengan warehouse di Fabric, dan keduanya memiliki keterbatasan yang sama.

Batasan berikut berlaku untuk pembuatan skema otomatis dan penemuan metadata titik akhir analitik SQL.

  • Data harus dalam format Delta Parquet untuk dicari secara otomatis di titik akhir analitik SQL. Delta Lake adalah kerangka penyimpanan sumber terbuka yang memungkinkan pembangunan arsitektur lakehouse.

  • Pemetaan kolom Delta berdasarkan nama didukung, tetapi pemetaan kolom Delta menurut ID tidak didukung. Untuk informasi selengkapnya, lihat fitur Delta Lake dan pengalaman Fabric.

  • Tabel Delta yang dibuat di luar /tables folder tidak tersedia di titik akhir analitik SQL.

    Jika Anda tidak melihat tabel lakehouse di endpoint SQL analytics, periksa lokasi tabel tersebut. Hanya tabel yang mereferensikan data di folder /tables yang tersedia di titik akhir analitik SQL. Tabel yang mereferensikan data di folder /files dalam danau tidak diekspos di titik akhir analitik SQL. Sebagai solusinya, pindahkan data Anda ke /tables folder .

  • Beberapa kolom yang ada dalam tabel Spark Delta mungkin tidak tersedia dalam tabel di titik akhir analitik SQL. Untuk setiap tabel Delta di Lakehouse Anda, titik akhir analitik SQL secara otomatis menghasilkan tabel dengan jenis data T-SQL. Mesin titik akhir analitik SQL didasarkan pada mesin Fabric Data Warehouse, dan berbagi jenis data. Untuk daftar lengkap jenis data yang didukung, lihat Jenis data di Fabric Data Warehouse.

  • Jika Anda menambahkan batasan kunci asing di antara tabel di titik akhir analitik SQL, Anda tidak akan dapat membuat perubahan skema lebih lanjut (misalnya, menambahkan kolom baru). Jika Anda tidak melihat kolom Delta Lake dengan jenis yang harus didukung di titik akhir analitik SQL, periksa apakah ada batasan kunci asing yang mungkin mencegah pembaruan pada tabel.

  • Untuk informasi dan rekomendasi tentang performa titik akhir analitik SQL, lihat Pertimbangan performa titik akhir analitik SQL.

  • UDF skalar didukung jika dapat dijalankan sebaris. Untuk informasi selengkapnya, lihat CREATE FUNCTION dan Scalar UDF inlining.

  • Tipe data varchar(max) hanya didukung di endpoint analitik SQL dari item yang dicerminkan dan database Fabric, dan tidak untuk lakehouse. Tabel yang dibuat setelah 10 November 2025 akan secara otomatis dipetakan dengan varchar(maks). Tabel yang dibuat sebelum 10 November 2025 perlu dibuat ulang untuk mengadopsi jenis data baru, atau akan secara otomatis ditingkatkan ke varchar(max) selama perubahan skema berikutnya.

Pemotongan data menjadi 8 KB masih berlaku pada tabel di endpoint analitik SQL lakehouse, termasuk pintasan ke item yang dicerminkan.

Karena tidak semua tabel mendukung penggabungan varchar(max) pada kolom ini, mungkin tidak berfungsi sebagaimana mestinya jika salah satu tabel masih memiliki truncasi data. Misalnya, jika Anda melakukan CTAS pada tabel dari item cermin yang baru dibuat ke dalam tabel lakehouse menggunakan Spark, lalu menggabungkannya menggunakan kolom dengan varchar(max), hasil kueri akan berbeda dibandingkan dengan tipe data varchar(8000). Jika Anda ingin terus memiliki perilaku sebelumnya, Anda dapat melemparkan kolom ke varchar(8000) dalam kueri.

Anda dapat mengonfirmasi apakah tabel memiliki kolom varchar(max) dari metadata skema menggunakan kueri T-SQL berikut. max_length Nilai -1 mewakili varchar(max):

SELECT o.name, c.name, type_name(user_type_id) AS [type], max_length
FROM sys.columns AS c
INNER JOIN sys.objects AS o
ON c.object_id = o.object_id
WHERE max_length = -1 
AND type_name(user_type_id) IN ('varchar', 'varbinary');

  • Skema dengan nama yang bertentangan dengan skema sistem (seperti sys atau information_schema) dan prinsip keamanan database (seperti db_owner, db_datareader) tidak didukung di titik akhir analitik SQL. Tabel di bawah skema ini akan gagal disinkronkan ke titik akhir analitik SQL.

  • Ruang kerja mendukung hingga 150 item titik akhir analitik gudang dan SQL yang digabungkan. Membuat item tambahan di luar batas ini tidak didukung. Hapus item yang sudah ada sebelum membuat item baru.

Konten terkait

  • Last updated on