Konektivitas ke pergudangan data di Microsoft Fabric

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

Di Microsoft Fabric, titik akhir analitik atau Gudang Lakehouse SQL dapat diakses melalui Aliran Data Tabular, atau titik akhir TDS, yang akrab dengan semua aplikasi web modern yang berinteraksi dengan titik akhir TDS SQL Server. Ini disebut sebagai String Koneksi SQL dalam antarmuka pengguna Microsoft Fabric.

Artikel ini menyediakan cara menyambungkan ke titik akhir analitik SQL atau Gudang Anda.

Untuk memulai, Anda harus menyelesaikan prasyarat berikut:

• Anda memerlukan akses ke titik akhir analitik SQL atau Gudang dalam ruang kerja kapasitas Premium dengan izin kontributor atau yang lebih tinggi.

Autentikasi ke gudang di Fabric

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

• Prinsipal pengguna Microsoft Entra ID (sebelumnya Azure Active Directory), atau identitas pengguna
• Perwakilan layanan MICROSOFT Entra ID (sebelumnya Azure Active Directory)

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

SQL string koneksi mengharuskan port TCP 1433 terbuka. TCP 1433 adalah nomor port SQL Server standar. SQL string koneksi juga menghormati model keamanan titik akhir analitik Warehouse atau Lakehouse SQL untuk akses data. Data dapat diperoleh untuk semua objek yang dapat diakses pengguna.

Izinkan tag layanan Power BI melalui firewall

Untuk memastikan akses yang tepat, Anda perlu mengizinkan tag layanan Power BI untuk akses firewall. Untuk informasi selengkapnya, lihat Tag Layanan Power BI. Anda tidak dapat menggunakan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) dari Titik Akhir TDS saja. Mengizinkan tag layanan Power BI diperlukan untuk konektivitas melalui firewall.

Mengambil string koneksi SQL

Untuk mengambil string koneksi, ikuti langkah-langkah berikut:

1. Navigasi ke ruang kerja Anda, pilih Gudang.
2. Pilih tombol Salin dalam kotak string koneksi SQL untuk menyalin string koneksi ke clipboard Anda.

Atau, di OneLake Data Hub:

1. Pilih Gudang, dan pilih elipsis ... untuk Opsi lainnya.
2. Pilih Salin string koneksi SQL untuk menyalin string koneksi ke clipboard Anda.

Mulai menggunakan SQL Server Management Studio (SSMS)

Langkah-langkah berikut merinci cara memulai di ruang kerja Microsoft Fabric dan menghubungkan gudang ke SQL Server Management Studio (SSMS).

1. Saat Anda membuka SQL Server Management Studio, jendela Sambungkan ke Server akan muncul. Jika sudah terbuka, Anda bisa tersambung secara manual dengan memilih Object Explorer>Connect>Database Engine.

   

2. Setelah jendela Koneksi ke Server terbuka, tempelkan string koneksi yang disalin dari bagian sebelumnya dari artikel ini ke dalam kotak Nama server. Pilih Sambungkan dan lanjutkan dengan kredensial yang sesuai untuk proses autentikasi. Ingat bahwa hanya autentikasi multifaktor Microsoft Entra (MFA) yang didukung, melalui opsi Microsoft Entra MFA.

   

3. Setelah koneksi dibuat, Object Explorer menampilkan gudang yang terhubung dari ruang kerja dan tabel dan tampilan masing-masing, yang semuanya siap untuk dikueri.

   

Saat menyambungkan melalui SSMS (atau ADS), Anda melihat titik akhir analitik SQL dan Gudang yang terdaftar sebagai gudang, dan sulit untuk membedakan antara dua jenis item dan fungsionalitasnya. Untuk alasan ini, kami sangat mendorong Anda untuk mengadopsi konvensi penamaan yang memungkinkan Anda dengan mudah membedakan antara dua jenis item saat Anda bekerja di alat di luar pengalaman portal Microsoft Fabric. Hanya SSMS 19 atau yang lebih tinggi yang didukung.

Menyambungkan menggunakan Power BI

Titik akhir analitik Warehouse atau Lakehouse SQL adalah sumber data asli dan didukung sepenuhnya dalam Power BI, dan tidak perlu menggunakan string Koneksi SQL. Panel Data mengekspos semua gudang yang dapat Anda akses secara langsung. Ini memungkinkan Anda untuk dengan mudah menemukan gudang Anda berdasarkan ruang kerja, dan:

1. Pilih Gudang.
2. Pilih entitas.
3. Muat Data - pilih mode konektivitas data: impor atau DirectQuery.

Untuk informasi selengkapnya, lihat Membuat laporan di Microsoft Fabric.

Menyambungkan menggunakan OLE DB

Kami mendukung konektivitas ke titik akhir analitik Gudang atau SQL menggunakan OLE DB. Pastikan Anda menjalankan Driver Microsoft OLE DB terbaru untuk SQL Server.

Menyambungkan menggunakan ODBC

Microsoft Fabric mendukung konektivitas ke titik akhir analitik Warehouse atau SQL menggunakan ODBC. Pastikan Anda menjalankan Driver ODBC terbaru untuk SQL Server. Gunakan autentikasi MICROSOFT Entra ID (sebelumnya Azure Active Directory). Hanya ODBC 18 atau versi yang lebih tinggi yang didukung.

Menyambungkan menggunakan JDBC

Microsoft Fabric juga mendukung konektivitas ke titik akhir analitik Warehouse atau SQL menggunakan driver konektivitas database Java (JDBC).

Saat membangun konektivitas melalui JDBC, periksa dependensi berikut:

1. Tambahkan artefak. Pilih Tambahkan Artefak dan tambahkan empat dependensi berikut, lalu pilih Unduh/Perbarui untuk memuat semua dependensi. Contohnya:

   

2. Pilih Uji koneksi, dan Selesai.

   

   <dependency>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>msal4j</artifactId>
      <version>1.13.3</version>
   
   </dependency>
   
   <dependency>
      <groupId>com.microsoft.sqlserver</groupId>
      <artifactId>mssql-jdbc_auth</artifactId>
      <version>11.2.1.x86</version>
   </dependency>
   
    <dependency>
      <groupId>com.microsoft.sqlserver</groupId>
      <artifactId>mssql-jdbc</artifactId>
      <version>12.1.0.jre11-preview</version>
   </dependency>
   
    <dependency>
      <groupId>com.microsoft.aad</groupId>
      <artifactId>adal</artifactId>
      <version>4.2.2</version>
   </dependency>
   

Menyambungkan menggunakan dbt

dbt Adaptor adalah kerangka kerja transformasi data yang menggunakan praktik terbaik rekayasa perangkat lunak seperti pengujian dan kontrol versi untuk mengurangi kode, mengotomatiskan manajemen dependensi, dan mengirimkan data yang lebih andal—semuanya dengan SQL.

Plugin dbt adaptor khusus platform data memungkinkan pengguna untuk terhubung ke penyimpanan data pilihan. Untuk menyambungkan ke Synapse Data Warehouse di Microsoft Fabric dari dbt adaptor penggunaan dbt-fabric . Demikian pula, sumber data kumpulan SQL khusus Azure Synapse Analytics memiliki adaptornya sendiri, dbt-synapse.

Kedua adaptor mendukung autentikasi ID Microsoft Entra (sebelumnya Azure Active Directory) dan memungkinkan pengembang untuk menggunakan az cli authentication. Namun, autentikasi SQL tidak didukung untuk dbt-fabric

Adaptor DBT Fabric DW menggunakan pyodbc pustaka untuk membangun konektivitas dengan Gudang. Pustaka pyodbc adalah implementasi ODBC dalam bahasa Python yang menggunakan Spesifikasi API Database Python v2.0. pyodbc Pustaka secara langsung meneruskan string koneksi ke driver database melalui SQLDriverConnect dalam msodbc struktur koneksi ke Microsoft Fabric menggunakan layanan proksi TDS (Tabular Data Streaming).

Untuk informasi selengkapnya, lihat penyiapan adaptor dbt Gudang Data Microsoft Fabric Synapse dan konfigurasi adaptor dbt Gudang Data Microsoft Fabric Synapse.

Konektivitas dengan cara lain

Alat non-Microsoft apa pun juga dapat menggunakan string koneksi SQL melalui driver ODBC atau OLE DB untuk terhubung ke titik akhir analitik Microsoft Fabric Warehouse atau SQL, menggunakan autentikasi Microsoft Entra ID (sebelumnya Azure Active Directory). Untuk informasi selengkapnya dan contoh string koneksi, lihat Autentikasi Microsoft Entra sebagai alternatif untuk autentikasi SQL.

Aplikasi kustom

Di Microsoft Fabric, gudang dan titik akhir analitik Lakehouse SQL menyediakan string koneksi SQL. Data dapat diakses dari ekosistem alat SQL yang luas, asalkan mereka dapat mengautentikasi menggunakan ID Microsoft Entra (sebelumnya Azure Active Directory). Untuk informasi selengkapnya, lihat Pustaka koneksi untuk Microsoft SQL Database. Untuk informasi selengkapnya dan contoh string koneksi, lihat Autentikasi Microsoft Entra sebagai alternatif untuk autentikasi SQL.

Praktik terbaik

Sebaiknya tambahkan percobaan ulang dalam aplikasi/pekerjaan ETL Anda untuk membangun ketahanan. Untuk informasi selengkapnya, lihat dokumen berikut ini:

• Pola coba lagi - Azure Architecture Center
• Bekerja dengan kesalahan sementara - Azure SQL Database
• Langkah 4: Sambungkan dengan tangguh ke SQL dengan ADO.NET - Penyedia ADO.NET untuk SQL Server
• Langkah 4: Sambungkan dengan tangguh ke SQL dengan PHP - driver PHP untuk SQL Server

Pertimbangan dan batasan

• Autentikasi SQL tidak didukung.
• Beberapa Set Hasil Aktif (MARS) tidak didukung untuk Microsoft Fabric Warehouse. MARS dinonaktifkan secara default, namun jika MultipleActiveResultSets disertakan dalam string koneksi, MARS harus dihapus atau diatur ke false.
• Jika Anda menerima kesalahan ini "Tidak dapat menyelesaikan operasi karena kami mencapai batas sistem", itu karena ukuran token sistem mencapai batasnya. Masalah ini dapat disebabkan jika ruang kerja memiliki terlalu banyak titik akhir analitik gudang/SQL, jika pengguna adalah bagian dari terlalu banyak grup Microsoft Entra, atau kombinasi keduanya. Sebaiknya anda memiliki 40 atau lebih sedikit gudang dan titik akhir analitik SQL per ruang kerja untuk mencegah kesalahan ini. Jika masalah berlanjut, hubungi dukungan.
• 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 terhadap 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 18456: "Eksekusi gagal terhadap server SQL, silakan hubungi tim server SQL jika Anda memerlukan dukungan lebih lanjut.", lihat Masalah yang diketahui - Koneksi gudang data atau eksekusi kueri gagal.
• Koneksi server tertaut dari SQL Server tidak didukung.

Konten terkait

• Keamanan untuk pergudangan data di Microsoft Fabric
• Autentikasi Microsoft Entra sebagai alternatif untuk autentikasi SQL di Microsoft Fabric
• Menambahkan URL Fabric ke daftar izin Anda
• Rentang IP Azure dan tag layanan untuk cloud publik