Integrasi Fabric

Ekstensi MSSQL untuk Visual Studio Code mendukung menyambungkan ke database SQL di Microsoft Fabric. Dialog Koneksi menyertakan opsi konektivitas Fabric yang Anda gunakan untuk masuk menggunakan ID Microsoft Entra. Anda dapat menelusuri ruang kerja Fabric dalam tampilan pohon, mencari di seluruh ruang kerja, dan menyambungkan ke database atau titik akhir SQL tanpa mengonfigurasi string koneksi secara manual. Ekstensi ini mendukung masuk persisten, pengalihan penyewa, dan alur Open in MSSQL terintegrasi dari ekstensi Fabric.

Anda dapat membuat database SQL baru di Fabric langsung dari Visual Studio Code. Lakukan autentikasi, pilih atau buat ruang kerja, tentukan nama database, dan sambungkan setelah penyediaan selesai. Indikator membuat Anda selalu mendapatkan informasi terbaru tentang kemajuan.

Konektivitas Fabric (Jelajahi)

Gunakan pengalaman penelusuran Fabric di ekstensi MSSQL untuk menyambungkan ke database SQL Anda di titik akhir analitik Fabric atau SQL tanpa menyalin string koneksi secara manual dari portal Fabric.

Capabilities

  • Pengalaman Dedicated Fabric: Opsi khusus Fabric dalam dialog Koneksi untuk menyambungkan ke database Fabric.

  • Single sign-on: Menggunakan akun Microsoft Anda untuk masuk. Anda mengautentikasi sekali untuk mengakses semua ruang kerja dan database Fabric Anda.

  • Penjelajahan ruang kerja: Menampilkan semua ruang kerja Fabric dalam tampilan pohon hierarkis dengan sumber daya yang dimuat sesuai permintaan.

  • Pencarian dan penemuan: Pencarian real time untuk menemukan ruang kerja atau database tanpa menggulir daftar panjang.

  • Dukungan lintas ekstensi: Database Open Fabric di ekstensi MSSQL dari ekstensi Fabric atau portal.

Prasyarat

  • Instal versi terbaru ekstensi MSSQL untuk Visual Studio Code.
  • Langganan Active Fabric dan izin akses ruang kerja.
  • Akun Microsoft yang valid dengan akses ke ruang kerja dan sumber daya Fabric Anda.
  • ID Microsoft Entra untuk autentikasi. Setelah masuk, Anda dapat memilih akun dan penyewa tertentu untuk menelusuri kumpulan ruang kerja dan database Fabric yang benar.

Nota

Untuk pengalaman (Telusuri) Konektivitas Fabric ini, Anda tidak memerlukan string koneksi atau token akses pribadi.

Get started

  1. Buka dialog Koneksi dan pilih Telusuri Fabric.

    Cuplikan layar konektivitas Fabric di ekstensi MSSQL untuk Visual Studio Code.

  2. Masuk dengan ID Microsoft Entra.

    Autentikasi pertama kali

    • Jenis autentikasi default ke MICROSOFT Entra ID - Universal dengan dukungan MFA.
    • Jika Anda tidak masuk, buka daftar dropdown Akun dan pilih Tambahkan akun.
    • Pilih akun Anda dan selesaikan proses masuk di jendela browser yang terbuka.
    • Kembali ke Visual Studio Code setelah proses berhasil diselesaikan.

    Mengembalikan autentikasi pengguna

    • Jika Anda sering masuk, informasi akun Anda akan terisi otomatis.
    • Verifikasi bahwa akun yang benar dipilih dan lanjutkan.
  3. (Opsional) Pilih penyewa.

    • Gunakan daftar dropdown ID Penyewa untuk memilih penyewa organisasi Anda.
    • Pilihan ini berguna jika Anda memiliki akses ke beberapa lingkungan penyewa dan perlu menelusuri sumber daya di penyewa yang berbeda.
  4. Telusuri ruang kerja Fabric di pohon ruang kerja.

  5. Gunakan bilah pencarian di bagian atas pohon untuk menemukan ruang kerja atau database dengan cepat.

  6. Pilih database atau titik akhir analitik yang diinginkan dari daftar.

  7. Konfirmasi autentikasi untuk sumber daya yang dipilih jika diminta.

    Tangkapan layar saat menghubungkan ke Fabric melalui pengalaman menjelajah Fabric.

  8. Pilih Sambungkan untuk menambahkan database yang dipilih ke daftar Koneksi Anda.

  9. Koneksi baru muncul di Koneksi, dan jendela kueri terbuka siap digunakan.

    Cuplikan layar koneksi Fabric baru di Object Explorer.

Petunjuk / Saran

Gunakan Cari di bagian atas pohon untuk menemukan ruang kerja atau database dengan cepat. Hasil memprioritaskan kecocokan terdekat dan item yang baru digunakan.

Kesalahan dan kasus tepi

Jika terjadi kesalahan, UI menunjukkan pesan yang jelas dan tindakan yang direkomendasikan:

Tipe Message Tindakan yang direkomendasikan
Tidak ada akses ke ruang kerja You do not have permission to view this workspace. Meminta akses atau beralih akun.
Layanan tidak tersedia atau dibatasi Fabric service is temporarily unavailable. Coba lagi atau periksa kesehatan layanan.
Sesi kedaluwarsa Your session has expired. Aatentikasi ulang dengan ID Microsoft Entra.
Pembatasan jaringan Connection blocked by network policy. Verifikasi pengaturan perusahaan, VPN, atau firewall.

Penting

Untuk menjaga pohon tetap responsif, menelusuri penyewa besar mungkin memuat anak sesuai permintaan. Anda mungkin melihat penanda pemuatan singkat saat memperluas simpul dengan banyak elemen.

Batasan yang diketahui

  • Hanya database SQL dan titik akhir analitik SQL yang didukung. Anda tidak dapat membuka jenis item Fabric lainnya dari ekstensi MSSQL.
  • Anda dapat menelusuri seluruh penyewa dengan beralih penyewa, tetapi Anda harus membuat setiap koneksi database secara terpisah. Tidak ada koneksi lintas tenan atau multi-database yang terpadu.
  • Alur masuk offline dan autentikasi kode perangkat tidak didukung.

Menyediakan database SQL di Fabric

Pengalaman provisi database SQL diintegrasikan ke dalam halaman Penyebaran ekstensi MSSQL. Anda dapat membuat dan menyambungkan ke database Fabric SQL baru tanpa meninggalkan Visual Studio Code.

Capabilities

  • Alur kerja terpandu: Memandu Anda melalui autentikasi, pemilihan atau pembuatan ruang kerja, penamaan database, dan provisi dari halaman Penyebaran .

  • Koneksi langsung: Secara otomatis menambahkan database yang baru disediakan ke daftar koneksi Anda.

  • Pengalaman yang konsisten: Mengikuti alur provisi yang sama dengan backend lain yang didukung, seperti kontainer SQL Server lokal.

  • Kesadaran kapasitas: Menunjukkan kapan batasan kapasitas membuat ruang kerja tidak aktif, dengan tooltip yang menjelaskan alasannya.

Prasyarat

  • Langganan Microsoft Fabric yang valid.
  • Kapasitas yang memadai di ruang kerja target untuk menyediakan database SQL baru.
  • Akun ID Microsoft Entra dengan izin ruang kerja yang diperlukan (Admin atau Anggota).
  • Visual Studio Code dengan ekstensi MSSQL terinstal.

Get started

  1. Buka halaman Penyebaran dan pilih database SQL di Fabric.
  2. Autentikasi dengan ID Microsoft Entra.
  3. Pilih atau buat ruang kerja Fabric.
  4. Masukkan nama database, lalu pilih Buat.
  5. Saat provisi selesai, database tersambung secara otomatis dan muncul di bawah Koneksi, dengan konfirmasi keberhasilan.

Petunjuk / Saran

Aliran end-to-end biasanya selesai dalam waktu kurang dari satu menit.

Animasi berikut menunjukkan database SQL dalam alur kerja provisioning Fabric sedang berjalan:

Cuplikan layar animasi memperlihatkan database SQL end-to-end dalam alur provisi Fabric.

Rincian informasi kapasitas

  • Alur provisi memvalidasi akun Fabric dan kapasitas ruang kerja untuk memastikan database dapat berhasil dibuat.
  • Daftar dropdown ruang kerja menunjukkan ruang kerja yang tidak memiliki kapasitas tersedia sebagai dinonaktifkan, dengan tooltip yang menjelaskan alasannya.

Tangkapan layar daftar tarik-turun ruang kerja yang menunjukkan ruang kerja yang dinonaktifkan karena keterbatasan kapasitas.

Perilaku pascaprovisi

  • Koneksi baru mengadopsi Grup Koneksi yang Anda pilih (opsional) untuk identifikasi visual cepat.
  • Anda dapat memasangkan pengalaman ini dengan fitur penelusuran Fabric untuk menemukan dan menyambungkan ke database yang baru dibuat dari lingkungan Visual Studio Code lainnya.

Troubleshooting

  • Nama sudah ada: Pilih nama database unik dalam ruang kerja yang dipilih.
  • Izin tidak mencukup: Pastikan Anda memiliki hak Admin Ruang Kerja/Anggota untuk membuat database.
  • Kesalahan jaringan atau penyewa (tenant): Lakukan autentikasi ulang atau ganti akun yang masuk melalui menu akun.
  • Waktu habis atau kegagalan penyediaan: Jika wizard tidak selesai, coba ulang operasi atau periksa kesehatan layanan Fabric.

Batasan yang diketahui

  • Anda hanya dapat menyediakan database SQL di Fabric. Jenis item Fabric lainnya tidak didukung.
  • Anda dapat mengonfigurasi antarpenyewa saat Anda secara eksplisit memilih penyewa yang berbeda selama proses autentikasi. Namun, Visual Studio Code belum mendukung skenario yang melibatkan beberapa penyewa simultan atau alur kerja lintas penyewa otomatis.
  • Anda tidak dapat mengantre provisi saat kapasitas sepenuhnya digunakan.

Tanggapan dan dukungan

Jika Anda memiliki ide, umpan balik, atau ingin terlibat dengan komunitas, bergabunglah dengan diskusi di https://aka.ms/vscode-mssql-discussions. Untuk melaporkan bug, kunjungi https://aka.ms/vscode-mssql-bug. Untuk meminta fitur baru, buka https://aka.ms/vscode-mssql-feature-request.