Konektivitas ke pergudangan data di Microsoft Fabric

Artikel
05/23/2023

Berlaku untuk: Titik Akhir dan Gudang SQL di Microsoft Fabric

Di Microsoft Fabric, Titik Akhir 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 SQL Server. Ini disebut sebagai String Koneksi SQL dalam antarmuka pengguna Microsoft Fabric.

Artikel ini menyediakan cara menyambungkan ke Titik Akhir atau Gudang SQL Anda.

Penting

Microsoft Fabric saat ini dalam PRATINJAU. Informasi ini berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis. Microsoft tidak memberikan jaminan, dinyatakan atau tersirat, sehubungan dengan informasi yang diberikan di sini.

Untuk memulai, Anda harus menyelesaikan prasyarat berikut:

Anda memerlukan akses ke Titik Akhir SQL atau Gudang dalam ruang kerja kapasitas Premium dengan izin kontributor atau di atasnya.

Autentikasi ke gudang di Fabric

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

Prinsipal pengguna Azure Active Directory (Azure AD), atau identitas pengguna
Perwakilan layanan Azure Active Directory (Azure AD)

String koneksi SQL mengharuskan port TCP 1433 terbuka. TCP 1433 adalah nomor port SQL Server standar. String koneksi SQL juga menghormati model keamanan Titik Akhir SQL Gudang atau Lakehouse untuk akses data. Data dapat diperoleh untuk semua objek yang dapat diakses pengguna.

Mengambil string koneksi SQL

Untuk mengambil string koneksi, ikuti langkah-langkah berikut:

Navigasi ke ruang kerja Anda, pilih Gudang, dan pilih Opsi lainnya.
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).

Saat Anda membuka SQL Server Management Studio, jendela Sambungkan ke Server muncul. Jika sudah terbuka, Anda dapat tersambung secara manual dengan memilih Object Explorer>Koneksi>Mesin Database.
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 Azure Active Directory - MFA yang didukung.
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 SQL Server Management Studio (atau ADS), Anda melihat Titik Akhir 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 untuk dengan mudah membedakan antara dua jenis item saat Anda bekerja dalam alat di luar pengalaman portal Microsoft Fabric.

Menyambungkan menggunakan Power BI

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

Pilih Gudang
Pilih entitas
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 Gudang atau Titik Akhir SQL menggunakan OLE DB. Pastikan Anda menjalankan Driver Microsoft OLE DB terbaru untuk SQL Server.

Menyambungkan menggunakan ODBC

Microsoft Fabric mendukung konektivitas ke Gudang atau Titik Akhir SQL menggunakan ODBC. Pastikan Anda menjalankan Driver ODBC terbaru untuk SQL Server. Gunakan autentikasi Azure Active Directory (Azure AD).

Menyambungkan menggunakan JDBC

Microsoft Fabric juga mendukung konektivitas ke Gudang atau Titik Akhir SQL menggunakan driver konektivitas database Java (JDBC).

Saat membuat konektivitas melalui JDBC, periksa dependensi berikut:

Tambahkan artefak, pilih Tambahkan Artefak dan tambahkan empat dependensi berikut di jendela seperti ini, lalu pilih Unduh/Perbarui untuk memuat semua dependensi.

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

Pengguna biasanya menggunakan adaptor DBT untuk menghubungkan proyek DBT ke datastore target. Adaptor DBT dibuat khusus untuk setiap sumber data. Pengguna yang ingin terhubung ke Gudang Data Synapse di Microsoft Fabric dari proyek DBT harus menggunakan dbt-synapsevnext adaptor DBT. Demikian pula, sumber data kumpulan SQL khusus Azure Synapse Analytics memiliki adaptornya sendiri, dbt-synapse.

Adaptor DBT Fabric DW menggunakan pyodbc pustaka untuk membangun konektivitas dengan Gudang. Pustaka pyodbc adalah implementasi ODBC dalam bahasa Python yang menggunakan Spesifikasi Python Database API 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).

Adaptor DBT Fabric DW mendukung autentikasi Azure Active Directory (Azure AD) dan memungkinkan pengembang menggunakan az cli authentication adaptor dbt-synapsevnext. Autentikasi SQL tidak didukung.

Konektivitas dengan cara lain

Alat pihak ketiga apa pun dapat menggunakan string Koneksi SQL melalui driver ODBC atau OLE DB untuk terhubung ke Microsoft Fabric Warehouse atau SQL Endpoint, menggunakan autentikasi Azure AD.

Aplikasi kustom

Di Microsoft Fabric, Gudang dan Titik Akhir SQL Lakehouse menyediakan string koneksi SQL. Data dapat diakses dari ekosistem peralatan SQL yang luas, asalkan mereka dapat mengautentikasi menggunakan Azure AD. Untuk informasi selengkapnya, lihat Pustaka koneksi untuk Microsoft SQL Database.

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.
Pada koneksi ke gudang, Anda mungkin menerima kesalahan bahwa "Ukuran token melebihi ukuran payload maksimum yang diizinkan". Ini mungkin karena memiliki sejumlah besar gudang di dalam ruang kerja atau menjadi anggota sejumlah besar grup Azure AD. Untuk sebagian besar pengguna, kesalahan biasanya tidak akan terjadi sampai mendekati di luar 80 gudang di ruang kerja. Jika terjadi kesalahan ini, bekerja samalah dengan admin Ruang Kerja untuk membersihkan Gudang yang tidak digunakan dan mencoba kembali koneksi, atau hubungi dukungan jika masalah berlanjut.