Konektivitas gudang

Berlaku untuk:✅ Titik akhir analitik SQL dan Gudang di Microsoft Fabric

Di Microsoft Fabric, pengguna mengakses titik akhir analitik SQL atau Gudang melalui titik akhir Aliran Data Tabular (TDS). Aplikasi web modern berinteraksi dengan endpoint TDS SQL Server. Dalam pengaturan Microsoft Fabric, titik akhir ini diberi label sebagai string koneksi SQL.

Petunjuk / Saran

Untuk tutorial tentang menyambungkan dengan alat umum, lihat Menyambungkan ke Fabric Data Warehouse.

Autentikasi ke gudang di Fabric

Di Microsoft Fabric, string koneksi SQL mendukung dua jenis pengguna terautentikasi:

  • Prinsipal pengguna ID Microsoft Entra, atau identitas pengguna
  • Prinsipal layanan Microsoft Entra ID

Untuk informasi selengkapnya, lihat Autentikasi Microsoft Entra sebagai alternatif untuk autentikasi SQL di Microsoft Fabric.

String koneksi SQL mengharuskan port TCP 1433 agar terbuka. TCP 1433 adalah nomor port SQL Server standar. String koneksi SQL juga mematuhi model keamanan endpoint analitik Warehouse atau Lakehouse SQL untuk akses data. Pengguna dapat mengakses data untuk semua objek yang mereka miliki izinnya.

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

Praktik terbaik

Tambahkan percobaan ulang ke aplikasi dan pekerjaan ETL Anda untuk membuatnya lebih tangguh. Untuk informasi selengkapnya, lihat dokumentasi berikut:

Mengizinkan tag layanan Azure melalui firewall

Untuk mengaktifkan konektivitas melalui firewall, Anda perlu mengizinkan tag layanan Power BI dan tag layanan SQL. Untuk informasi selengkapnya, lihat Tag Layanan Power BI dan Tag layanan.

Anda tidak dapat menggunakan Nama Domain Berkualifikasi Penuh (FQDN) dari TDS Endpoint secara mandiri.

Pertimbangan dan batasan

  • Autentikasi SQL tidak didukung.
  • Beberapa Set Hasil Aktif (MARS) tidak didukung untuk Microsoft Fabric Warehouse. MARS dinonaktifkan secara default. Jika MultipleActiveResultSets disertakan dalam string koneksi, hapus atau atur ke false.
  • Jika Anda menerima kode kesalahan 24804 dengan pesan "Tidak dapat menyelesaikan operasi karena pembaruan sistem. Tutup koneksi ini, masuk lagi, dan coba lagi operasi" atau kode kesalahan 6005 dengan pesan "SHUTDOWN sedang berlangsung. Eksekusi gagal pada server SQL. Silakan hubungi tim SQL Server jika Anda memerlukan dukungan lebih lanjut.", itu karena kehilangan koneksi sementara, kemungkinan karena penyebaran sistem atau konfigurasi ulang. Untuk mengatasi masalah ini, masuk lagi dan coba lagi. Untuk mempelajari cara membangun ketahanan dan percobaan ulang di aplikasi Anda, lihat Praktik Terbaik.
  • Jika Anda menerima kode kesalahan 6008 dengan pesan "Ruang kerja sementara tidak tersedia. Ini mungkin karena pemeliharaan sistem atau operasi internal. Silakan membangun kembali koneksi Anda." Kesalahan ini menunjukkan gangguan koneksi sementara. Untuk mengatasi masalah ini, membangun kembali koneksi Anda, masuk lagi, dan mencoba kembali operasi. Kondisi ini bersifat sementara dan tidak menunjukkan kegagalan dalam kueri atau aplikasi Anda.
  • Koneksi server tertaut dari SQL Server tidak didukung.

Perilaku koneksi untuk InitialCatalog

Pada bulan Mei 2026, Microsoft memperbarui perilaku koneksi untuk Fabric Data Warehouse dan endpoint analitik SQL sehingga properti InitialCatalog string koneksi menjadi opsional. Saat ini, pengguna tersambung ke basis data sistem master saat properti InitialCatalog tidak diberikan. Dalam Fabric Data Warehouse, Anda hanya bisa menyambungkan ke database master, Anda tidak dapat mengubah database master, dan Anda tidak dapat membuat, mengubah, atau menghilangkan objek pengguna di database master.

Anda dapat menggunakan sintaks USE Transact-SQL untuk mengubah konteks warehouse koneksi setelah terhubung ke master, dan fungsi DB_NAME() untuk menentukan warehouse Anda saat ini. Contohnya:

SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO

Tabel berikut menguraikan perilaku koneksi yang diperbarui untuk titik akhir analitik Fabric Data Warehouse dan SQL saat Anda menentukan atau menghilangkan properti InitialCatalog dalam string koneksi.

Skenario Masukan Sebelum Mei 2026 Perilaku saat ini
Nama gudang yang ada disediakan Menyambungkan ke gudang yang ditentukan Tidak ada perubahan - terhubung ke gudang yang ditentukan
ID gudang yang ada disediakan Menyambungkan ke gudang yang ditentukan Tidak ada perubahan - terhubung ke gudang yang ditentukan
InitialCatalog properti tidak disediakan Menyambungkan ke gudang yang tidak menentukan di ruang kerja Terhubung ke master
InitialCatalog = master Menyambungkan ke gudang yang tidak menentukan di ruang kerja Terhubung ke master
Gudang di properti InitialCatalog tidak ditemukan Menyambungkan ke gudang yang tidak menentukan di ruang kerja Menampilkan kesalahan yang menunjukkan bahwa tidak ada gudang

Penanganan kesalahan

Jika tidak ada warehouse di ruang kerja dan upaya koneksi dilakukan tanpa menentukan warehouse yang valid, pengguna akan melihat pesan kesalahan berikut: "Login gagal untuk pengguna '<prinsipal yang diidentifikasi oleh token>'." Alasan: Autentikasi berhasil, tetapi database tidak ditemukan, atau Anda tidak memiliki cukup izin untuk menyambungkannya."

Cuplikan layar berikut menunjukkan kesalahan seperti yang muncul di SSMS ketika nama gudang yang tidak valid disediakan sebagai InitialCatalog:

Cuplikan layar pesan kesalahan SSMS saat katalog awal yang valid tidak disediakan.

Langkah selanjutnya

Menyambungkan ke Fabric Data Warehouse

Konten terkait

  • Last updated on