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. Warehouse menggunakan protokol Microsoft SQL Server Tabular Data Stream (TDS) melalui port TCP 1433. Di lingkungan yang menggunakan firewall yang mengenali protokol atau inspeksi tingkat aplikasi, konfigurasikan dan periksa lalu lintas SQL sebagai lalu lintas Microsoft SQL Server (MSSQL/TDS), bukan sebagai lalu lintas HTTPS.

Beberapa firewall membedakan antara akses port TCP dan inspeksi protokol aplikasi. Dalam lingkungan ini, hanya mengizinkan port TCP 1433 mungkin tidak cukup jika firewall dikonfigurasi untuk mengharapkan lalu lintas HTTPS pada port tersebut.

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.

Important

Jika organisasi Anda menggunakan aturan aplikasi Azure Firewall atau firewall serupa yang sadar protokol, konfigurasikan lalu lintas Warehouse sebagai lalu lintas MSSQL/TDS. Mengonfigurasi lalu lintas SQL sebagai lalu lintas HTTPS pada port 1433 dapat mencegah konektivitas yang berhasil meskipun akses jaringan ke port diizinkan.

Pertimbangan inspeksi firewall dan lapisan aplikasi

Beberapa solusi firewall perusahaan melakukan inspeksi lapisan aplikasi selain penyaringan IP dan port tradisional.

Saat Anda mengonfigurasi kebijakan firewall untuk Warehouse:

  • Izinkan konektivitas TCP keluar pada port 1433.
  • Pastikan lalu lintas SQL diperlakukan sebagai lalu lintas Microsoft SQL Server (MSSQL/TDS).
  • Jangan konfigurasikan koneksi SQL ke Warehouse sebagai lalu lintas HTTPS pada port 1433.
  • Validasi konektivitas setelah perubahan kebijakan firewall diterapkan.

Catatan

Pelanggan yang menggunakan aturan aplikasi Azure Firewall harus mengonfigurasi pemfilteran yang mengenali SQL untuk lalu lintas SQL. Azure Firewall mendukung penanganan protokol MSSQL dan penyaringan SQL FQDN untuk beban kerja SQL.

Penyaringan firewall berbasis FQDN

Organisasi yang membatasi akses keluar menggunakan nama domain lengkap (FQDN) dapat menggunakan aturan firewall yang hanya mengizinkan tujuan SQL yang disetujui.

Untuk lingkungan yang menggunakan Azure Firewall:

  • Penyaringan FQDN yang sadar SQL didukung melalui aturan aplikasi MSSQL.
  • Penyaringan FQDN dapat digunakan bersama dengan pembatasan port 1433 untuk membatasi konektivitas SQL keluar.
  • Pastikan semua endpoint Warehouse yang didokumentasikan dalam artikel ini termasuk dalam daftar izin firewall.

Untuk detail implementasi, lihat Konfigurasikan aturan aplikasi Azure Firewall dengan SQL FQDN.

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

  • Terakhir diperbarui pada