Altyapı tümleştirmesi

Visual Studio Code için MSSQL uzantısı, Microsoft Fabric'te SQL veritabanına bağlanmayı destekler. Bağlantı iletişim kutusu, Microsoft Entra ID kullanarak oturum açmak için kullanacağınız bir Fabric bağlantısı seçeneği içerir. Ağaç görünümünde Doku çalışma alanlarına göz atabilir, çalışma alanlarında arama yapabilir ve bağlantı dizelerini el ile yapılandırmadan SQL veritabanlarına veya uç noktalarına bağlanabilirsiniz. Uzantı, kalıcı oturum açmayı, kiracı değiştirmeyi ve Fabric uzantısından tümleşik MSSQL'de Aç akışını destekler.

Visual Studio Code'dan doğrudan Fabric'de yeni SQL veritabanları oluşturabilirsiniz. Kimlik doğrulaması yapın, çalışma alanı seçin veya oluşturun, veritabanı adı belirtin ve sağlama tamamlandıktan sonra bağlanın. Gösterge, ilerleme durumuyla ilgili güncel kalmanızı sağlar.

Doku bağlantısı (Gözat)

Doku portalından bağlantı dizelerini el ile kopyalamadan Doku veya SQL analiz uç noktalarındaki SQL veritabanınıza bağlanmak için MSSQL uzantısındaki Doku göz atma deneyimini kullanın.

Capabilities

  • Dedicated Fabric deneyimi: Fabric veritabanlarına bağlanmak için Bağlantı iletişim kutusunda Fabric'e özgü bir seçenek.

  • Tek oturum açma: Oturum açmak için Microsoft hesabınızı kullanır. Tüm Doku çalışma alanlarınıza ve veritabanlarınıza erişmek için bir kez kimlik doğrulaması yaparsınız.

  • Çalışma alanı tarama: Tüm Fabric çalışma alanlarını gerektikçe yüklenen kaynaklarla hiyerarşik bir ağaç görünümünde gösterir.

  • Arama ve bulma: Uzun listeleri kaydırmadan çalışma alanlarını veya veritabanlarını bulmak için gerçek zamanlı arama.

  • Uzantılar arası destek: Doku uzantısından veya portaldan MSSQL uzantısındaki Doku veritabanlarını açın.

Önkoşullar

  • Visual Studio Code için MSSQL uzantısının en son sürümünü yükleyin.
  • Active Fabric aboneliği ve çalışma alanı izinleri.
  • Fabric çalışma alanlarınıza ve kaynaklarınıza erişimi olan geçerli bir Microsoft hesabı.
  • Kimlik doğrulaması için Microsoft Entra Id. Oturum açtıktan sonra, uygun Doku çalışma alanları ve veritabanları kümesine göz atmak için hem hesabı hem de belirli kiracıyı seçebilirsiniz.

Uyarı

Bu Doku Bağlantısı (Gözat) deneyimi için bağlantı dizelerine veya kişisel erişim belirteçlerine ihtiyacınız yoktur.

Get started

  1. Bağlantı iletişim kutusunu açın ve Fabric'e Gözat'ı seçin.

    Visual Studio Code için MSSQL uzantısında Doku bağlantısının ekran görüntüsü.

  2. Microsoft Entra Id ile oturum açın.

    İlk kez kimlik doğrulaması

    • Kimlik doğrulama türü varsayılan olarak Microsoft Entra ID - MFA desteğiyle Evrensel olarak kullanılır.
    • Oturum açmadıysanız Hesap açılan listesini açın ve Hesap ekle'yi seçin.
    • Hesabınızı seçin ve açılan tarayıcı penceresinde oturum açma işlemini tamamlayın.
    • İşlem başarıyla tamamlandıktan sonra Visual Studio Code'a dönün.

    Geri dönen kullanıcı kimlik doğrulaması

    • Sık sık oturum açarsanız hesap bilgileriniz önceden doldurulmuş olarak görünür.
    • Doğru hesabın seçili olduğunu doğrulayın ve devam edin.
  3. (İsteğe bağlı) Bir kiracı seçin.

    • Kuruluşunuzun kiracısını seçmek için Kiracı Kimliği açılan listesini kullanın.
    • Bu seçim, birden çok kiracı ortamına erişiminiz varsa ve farklı bir kiracıdaki kaynaklara göz atmanız gerekiyorsa kullanışlıdır.
  4. Çalışma alanı ağacında Fabric çalışma alanlarını gözden geçirin.

  5. Bir çalışma alanını veya veritabanını hızla bulmak için ağacın üst kısmındaki arama çubuğunu kullanın.

  6. Listeden istediğiniz veritabanı veya analiz uç noktasını seçin.

  7. İstenirse seçili kaynak için kimlik doğrulamasını onaylayın.

    Fabric göz atma deneyiminden Fabric'e bağlanma işleminin ekran görüntüsü.

  8. Seçili veritabanını Bağlantılar listenize eklemek için Bağlan'ı seçin.

  9. Yeni bağlantı Bağlantılar'da görünür ve kullanıma hazır bir sorgu penceresi açılır.

    Nesne Gezgini'ndeki yeni Doku bağlantısının ekran görüntüsü.

Tip

Bir çalışma alanını veya veritabanını hızla bulmak için ağacın üst kısmındaki Ara'yı kullanın. Sonuçlar en yakın eşleşmelerin ve son kullanılan öğelerin önceliğini belirler.

Hatalar ve uç durumlar

Bir sorun olursa kullanıcı arabiriminde net bir ileti ve önerilen eylemler gösterilir:

Türü Message Önerilen eylem
Çalışma alanına erişim yok You do not have permission to view this workspace. Erişim isteme veya hesap değiştirme.
Hizmet kullanılamıyor veya kısıtlandı Fabric service is temporarily unavailable. Hizmet durumunu yeniden deneyin veya denetleyin.
Süresi dolan oturum Your session has expired. Microsoft Entra Kimliği ile yeniden kimlik doğrulaması yapın.
Ağ kısıtlamaları Connection blocked by network policy. Şirket, VPN veya güvenlik duvarı ayarlarını doğrulayın.

Önemli

Ağacın yanıt vermemeye devam etmesi için büyük kiracılara göz atmak isteğe bağlı olarak alt öğeleri yükleyebilir. Birçok öğe içeren düğümleri genişletirken kısa yükleme göstergeleri görebilirsiniz.

Bilinen sınırlamalar

  • Yalnızca SQL veritabanları ve SQL analiz uç noktaları desteklenir. MSSQL uzantısından diğer Fabric öğesi türlerini açamazsınız.
  • Kiracılar arasında geçiş yaparak kiracılara göz atabilirsiniz, ancak her veritabanı bağlantısını ayrı ayrı oluşturmanız gerekir. Tek bir tenantlar arası veya çoklu veritabanı bağlantısı yoktur.
  • Çevrimdışı oturum açma ve cihaz kodu kimlik doğrulama akışları desteklenmez.

Fabric'da SQL veritabanı sağlama

SQL veritabanı sağlama deneyimi, MSSQL uzantısının Dağıtımlar sayfasıyla tümleşiktir. Visual Studio Code'dan çıkmadan yeni Fabric SQL veritabanları oluşturabilir ve bu veritabanlarına bağlanabilirsiniz.

Capabilities

  • Destekli iş akışı: Dağıtımlar sayfasında kimlik doğrulaması, çalışma alanı seçimi veya oluşturma, veritabanı adlandırma ve sağlama adımlarında size yol gösterir.

  • Anında bağlantı: Yeni sağlanan veritabanını otomatik olarak bağlantı listenize ekler.

  • Tutarlı deneyim: Yerel SQL Server kapsayıcıları gibi desteklenen diğer backend'lerle aynı provisioning akışını izler.

  • Kapasite farkındalığı: Kapasite kısıtlamaları çalışma alanlarını devre dışı bıraktığında, bu durumun nedenini açıklayan araç ipuçları ile gösterilir.

Önkoşullar

  • Geçerli bir Microsoft Fabric aboneliği.
  • Yeni SQL veritabanları sağlamak için hedef çalışma alanında yeterli kapasite.
  • Gerekli çalışma alanı izinlerine (Yönetici veya Üye) sahip Microsoft Entra Id hesabı.
  • MSSQL uzantısının yüklü olduğu Visual Studio Code.

Get started

  1. Dağıtımlar sayfasını açın ve Fabric'deki SQL veritabanını seçin.
  2. Microsoft Entra Kimliği ile kimlik doğrulaması yapın.
  3. Fabric çalışma alanını seçin veya oluşturun.
  4. Bir veritabanı adı girin ve Oluştur'u seçin.
  5. Sağlama tamamlandığında, veritabanı otomatik olarak bağlanır ve Bağlantılar'ın altında bir başarı onayıyla görüntülenir.

Tip

Uçtan uca akış genellikle bir dakikadan kısa sürede tamamlar.

Aşağıdaki animasyon, Yapı sağlama iş akışındaki SQL veritabanının çalıştığını gösterir:

Fabric sağlama akışındaki uçtan uca SQL veritabanını gösteren animasyonun ekran görüntüsü.

Kapasite farkındalığı ayrıntıları

  • Hazırlık akışı, veritabanının başarıyla oluşturulmasını sağlamak adına Fabric hesabını ve çalışma alanı kapasitesini doğrular.
  • Çalışma alanı açılan listesi, kullanılabilir kapasitesi olmayan çalışma alanlarını devre dışı olarak gösterir ve nedenini açıklamak için bir araç ipucu sağlar.

Kapasite kısıtlamaları nedeniyle devre dışı bırakılan çalışma alanlarını gösteren çalışma alanı açılır menü listesinin ekran görüntüsü.

Sağlama sonrası davranışı

  • Yeni bağlantı, hızlı görsel tanımlama için seçtiğiniz Bağlantı Grubunu (isteğe bağlı) benimser.
  • Bu deneyimi Doku göz atma özelliğiyle eşleştirerek yeni oluşturulan veritabanını başka bir Visual Studio Code ortamından bulabilir ve bu veritabanına bağlanabilirsiniz.

Sorun giderme

  • Ad zaten var: Seçili çalışma alanında benzersiz bir veritabanı adı seçin.
  • Yetersiz izinler: Veritabanları oluşturmak için Çalışma Alanı Yöneticisi/Üye haklarına sahip olduğunuzdan emin olun.
  • Ağ veya kiracı hataları: Hesap menüsünden oturum açmış hesabı yeniden doğrulayın veya değiştirin.
  • Sağlama zaman aşımı veya hata: Sihirbaz tamamlanmazsa işlemi yeniden deneyin veya Fabric hizmeti durumunu denetleyin.

Bilinen sınırlamalar

  • SQL veritabanlarını yalnızca Fabric'de sağlayabilirsiniz. Fabric'in diğer öğe türleri desteklenmez.
  • Kimlik doğrulaması sırasında açıkça farklı bir kiracı seçtiğinizde, kiracılar arasında yapılandırma gerçekleştirebilirsiniz. Ancak Visual Studio Code henüz birden çok eşzamanlı kiracı veya otomatik kiracılar arası iş akışları içeren senaryoları desteklemez.
  • Kapasite tam olarak tüketildiğinde sağlama işlemini sıraya ekleyemezsiniz.

Geri bildirim ve destek

Fikirleriniz, geri bildirimleriniz varsa veya toplulukla etkileşim kurmak istiyorsanız adresinden https://aka.ms/vscode-mssql-discussionstartışmaya katılın. Bir hatayı bildirmek için https://aka.ms/vscode-mssql-bug adresini ziyaret edin. Yeni bir özellik istemek için adresine https://aka.ms/vscode-mssql-feature-requestgidin.