Visual Studio Code için SQLTools için Databricks Sürücüsü

Önemli

Bu özellik Genel Önizlemededir.

SQLTools için Databricks Sürücüsü, SQL nesnelerine göz atmak ve uzak Azure Databricks çalışma alanlarında SQL sorguları çalıştırmak için Visual Studio Code için SQLTools uzantısını kullanmanıza olanak tanır.

Requirements

SQLTools için Databricks Sürücüsünü kullanabilmeniz için önce Azure Databricks çalışma alanınızın ve yerel geliştirme makinenizin aşağıdaki gereksinimleri karşılaması gerekir.

Çalışma alanı gereksinimleri

Kullanılabilir en az bir Azure Databricks çalışma alanınız olmalı ve çalışma alanı aşağıdaki gereksinimleri karşılamalıdır:

  • Çalışma alanı en az bir Databricks SQL warehouse içermelidir.

    Not:

    Azure Databricks kümeleri SQLTools için Databricks Sürücüsü tarafından desteklenmez.

  • Unity Catalog için etkinleştirilen çalışma alanları için, çalışma alanı en az bir katalog içermelidir ve bu katalog içinde en az bir şema (resmi olarak veritabanı olarak adlandırılır) olmalıdır.

  • Unity Kataloğu için etkinleştirilmemiş çalışma alanları için çalışma alanı en az bir şema (eski adıyla veritabanı) içermelidir.

Yerel geliştirme makinesi gereksinimleri

Yerel geliştirme makinenizde aşağıdakilere sahip olmanız gerekir:

SQLTools uzantısını yüklemek için SQLTools'a gidin ve ardından Yükle'ye tıklayın veya:

  1. Visual Studio Code'da, ana menüde Görünüm > Uzantılar'a tıklayın.

  2. Market'te Uzantıları Ara kutusuna SQLTools girin.

  3. Matheus Teixeira'nın SQLTools girdisine tıklayın.

    Not:

    Listede birden fazla SQLTools girdisi listelenmiş olabilir. Matheus Teixeira girişine tıkladığınızdan emin olun.

  4. Yükle düğmesine tıklayın.

Databricks Driver for SQLTools uzantısını yüklemek için Databricks Driver for SQLTools sayfasına gidin ve ardından Yükle'ye tıklayın veya:

  1. Visual Studio Code'da, ana menüde Görünüm > Uzantılar'a tıklayın.
  2. Market'te Uzantıları Ara kutusuna Databricks Driver for SQLTools yazın.
  3. SQLTools için Databricks Sürücüsü girdisine tıklayın.
  4. Yükle'ye tıklayın.

Kimlik Doğrulaması

SQLTools için Databricks Sürücüsü kimlik doğrulamasını aşağıdaki gibi ayarlamanız gerekir.

SQLTools için Databricks Sürücüsü aşağıdaki Azure Databricks kimlik doğrulama türlerini destekler:

Not:

SQLTools için Databricks Sürücüsü Microsoft Entra ID belirteçlerini desteklemez.

Azure Databricks kişisel erişim belirteci kimlik doğrulaması

SQLTools için Databricks Sürücüsünü Azure Databricks kişisel erişim belirteci kimlik doğrulamasıyla kullanmak için bir Azure Databricks kişisel erişim belirtecine sahip olmanız gerekir. Kişisel erişim belirteci oluşturmak için Çalışma alanı kullanıcıları için kişisel erişim belirteçleri oluşturma bölümünde yer alan adımları izleyin.

Azure Databricks OAuth makineden makineye (M2M) kimlik doğrulaması

Azure Databricks OAuth makineden makineye (M2M) kimlik doğrulamasını, aşağıdaki gibi SQLTools için Databricks Sürücüsü ile kimlik doğrulaması yapmak için kullanabilirsiniz:

Not:

Azure Databricks OAuth M2M kimlik doğrulaması, SQLTools 0.4.2 ve üzeri sürümleri için Databricks Sürücüsü'nde kullanılabilir.

  1. OAuth M2M kimlik doğrulaması için yapılandırma adımlarını tamamlayın. Bkz. OAuth makineden makineye (M2M) kimlik doğrulaması.
  2. OAuth M2M kimlik doğrulama yapılandırma ayarlarınız ile bir Azure Databricks yapılandırma profili oluşturun. OAuth makineden makineye (M2M) kimlik doğrulaması konusunun “Yapılandırma” bölümüne bakın.
  3. Yerel geliştirme makinenizde Visual Studio Code için Databricks uzantısını yükleyin ve açın.
  4. Databricks IDE uzantısında, Yapılandırma panelindeki Yapılandır düğmesine tıklayın. Yapılandır düğmesi görüntülenmiyorsa, bunun yerine dişli (Çalışma alanını yapılandır) simgesine tıklayın.
  5. Komut Paleti'nde, Databricks Ana Bilgisayarı için Azure Databricks çalışma alanı başına URL'nizi girin; örneğin ve ardından Enter'a basın.
  6. 2. adımda oluşturduğunuzla eşleşen yapılandırma profili girişini seçin.
  7. Azure Databricks hesabınızla kimlik doğrulamasını tamamlamak için web tarayıcınızda ekrandaki yönergeleri tamamlayın.

Azure Databricks OAuth kullanıcıdan makineye (U2M) kimlik doğrulaması

SQLTools için Databricks Sürücüsü ile kimlik doğrulaması yapmak için Azure Databricks OAuth kullanıcıdan makineye (U2M) kimlik doğrulamasını aşağıdaki gibi kullanabilirsiniz:

Not:

Azure Databricks OAuth U2M kimlik doğrulaması, SQLTools 0.4.2 ve üzeri sürümler için Databricks Sürücüsü'nde kullanılabilir.

  1. Yerel geliştirme makinenizde Visual Studio Code için Databricks uzantısını yükleyin ve açın.
  2. Databricks IDE uzantısında, Yapılandır düğmesine Yapılandırma panelinde tıklayın. Yapılandır düğmesi görüntülenmiyorsa, bunun yerine dişli (Çalışma alanını yapılandır) simgesine tıklayın.
  3. Komut Paleti'nde, Databricks Host için Azure Databricks çalışma alanı başına URL'nizi girin, örneğin https://adb-1234567890123456.7.azuredatabricks.net. Ardından Enter tuşuna basın.
  4. OAuth (kullanıcıdan makineye) öğesini seçin.
  5. Azure Databricks hesabınızla kimlik doğrulamasını tamamlamak için web tarayıcınızda ekrandaki yönergeleri tamamlayın. İstendiğinde all-apis erişimine izin verin.

Azure CLI kimlik doğrulaması

SQLTools için Databricks Sürücüsüyle Azure CLI'yı kullanarak aşağıdaki gibi kimlik doğrulaması yapabilirsiniz:

Not:

Azure CLI ile kimlik doğrulaması Deneysel özellik durumundadır. Bu özellik, SQLTools 0.4.2 ve üzeri sürümler için Databricks Sürücüsü'nde kullanılabilir.

  1. Henüz yapmadıysanız, yerel geliştirme makinenize Azure CLI'yı yükleyin.
  2. Yerel geliştirme makinenizde Visual Studio Code için Databricks uzantısını yükleyin ve açın.
  3. Databricks IDE uzantısında, Yapılandırma panelindeki Yapılandır düğmesine tıklayın. Yapılandır düğmesi görüntülenmiyorsa, bunun yerine dişli (Çalışma alanını yapılandır) simgesine tıklayın.
  4. Komut Paleti'nde, Databricks Ana Bilgisayarı için Azure Databricks çalışma alanına özgü URL'nizi girin, örneğin https://adb-1234567890123456.7.azuredatabricks.net. Ardından Enter tuşuna basın.
  5. Azure CLI'yi seçin.
  6. Azure CLI ile kimlik doğrulamasını tamamlamak için ekrandaki istemleri izleyin.

Bir şemaya bağlanın

  1. Visual Studio Code'da kenar çubuğunda SQLTools simgesine tıklayın.

  2. SQLTools görünümünde, SQLTools uzantısını ilk kez kullanıyorsanız, Bağlantılar bölmesinde Yeni Bağlantı Ekle'ye tıklayın. Aksi takdirde, bölmenin başlık çubuğundaki Yeni Bağlantı Ekle simgesine tıklayın.

  3. SQLTools Ayarları sekmesinde, Bir veritabanı sürücüsü seçin adımında Databricks simgesine tıklayın.

  4. Bağlantı Ayarları adımı için ambarınız, kataloğunuz ve şemanız hakkında aşağıdaki bilgileri girin:

    1. Bağlantı adı için bu bağlantı için benzersiz bir ad girin.
    2. (İsteğe bağlı) Bağlantı grubu için, var olan bir bağlantı grubunun adını girerek yeni bağlantıyı bu gruba ekleyin. Alternatif olarak, yeni bağlantıyla yeni bir bağlantı grubu oluşturmak için benzersiz bir ad da girin. Bağlantı grupları, uzantıdaki bağlantıları bulmayı kolaylaştırır.
    1. Kullanarak bağlan için aşağıdakilerden birini seçin:
      • Kimlik doğrulaması için bir Azure Databricks kişisel erişim belirteci kullanmak üzere Konak Adı ve Belirteç seçin.
      • SQLTools sürüm 0.4.2 ve üzeri için Databricks Sürücüsü için OAuth U2M veya M2M ya da Azure CLI kimlik doğrulaması kullanmak üzere VS Code uzantısı (beta) seçeneğini belirleyin.

    1. Kullanarak Bağlan için Konak Adı ve Belirteç'i seçtiyseniz, Konak için ambarın Sunucu ana bilgisayar adı ayarını girin. Bir ambarın Sunucu ana bilgisayar adı ayarını almak için bkz. Azure Databricks işlem kaynağının bağlantı ayrıntılarını alma.

    2. Yol için ambarın veya kümenin HTTP yolu ayarını girin. Bir ambarın HTTP yolu ayarını almak için bkz. Azure Databricks işlem kaynağında bağlantı ayrıntılarını alma.

    3. Bağlanma yöntemi için Ana Bilgisayar Adı ve Belirteç'i seçtiyseniz, Azure Databricks kişisel erişim belirteci değerinizi Belirteç alanına girin.

    4. Katalog için katalogunuzun adını girin.

      Not:

      Unity Catalog için etkin olmayan çalışma alanlarında, varsayılan hive_metastore değerini kullanmak için Catalog alanını boş bırakabilirsiniz.

    5. Şema için şemanızın adını girin.

    6. (İsteğe bağlı) Kayıt gösterme varsayılan sınırı için varsayılan değerini 50 olarak bırakın; böylece her sorgu için yalnızca ilk 50 satır gösterilir veya farklı bir sınır girin.

  5. Test Connection'a tıklayın.

  6. Bağlantı testi başarılı olursa, Bağlantıyı Kaydet'e tıklayın.

Bağlantı ayarlarını değiştirme

Bu yordamda en az bir ambara başarıyla bağlandığınız varsayılır.

  1. SQLTools görünümü görünmüyorsa Visual Studio Code'da kenar çubuğunda SQLTools simgesine tıklayın.
  2. Bağlantılar bölmesinde, hedef bağlantınız için varsa bağlantı grubunu genişletin.
  3. Bağlantıya sağ tıklayın ve Bağlantıyı Düzenle'ye tıklayın.
  4. Hedef ayarlarını değiştirin.
  5. Bağlantıyı Test Et düğmesine tıklayın.
  6. Bağlantı testi başarılı olursa, Bağlantıyı Kaydet'e tıklayın.

Şemanın nesnelerine göz atma

  1. Bağlantılar bölmesinde, hedef bağlantınız için varsa bağlantı grubunu genişletin.
  2. Ambarınız için hedef bağlantıyı çift tıklayın veya hedef bağlantıyı genişletin.
  3. Bağlantınız için varsa hedef veritabanını (şema) genişletin.
  4. Veritabanınız (şema) için bir veya daha fazla tablo veya görünüm varsa Tablolar veya Görünümler'i genişletin.
  5. Tablonun veya görünümün sütunlarını görüntülemek için herhangi bir hedef tabloyu veya görünümü genişletin.

Tablo veya görünümün satırlarını veya şemasını görüntüleyin

Bağlantılar bölmesinde Tablolar veya Görünümler genişletilmiş durumdayken aşağıdakilerden birini yapın:

  • Tablonun veya görünümün satırlarını göstermek için tabloya veya görünüme sağ tıklayın ve Tablo Kayıtlarını Göster veya Kayıtları Görüntüle'ye tıklayın.
  • Tablonun veya görünümün şemasını göstermek için tabloya veya görünüme sağ tıklayın ve Tabloyu Açıkla veya Görünümü Tanımla'ya tıklayın.

Bir tablo için ekleme sorgusu oluştur

  1. İmlecinizi, ekleme sorgusunu eklemek istediğiniz konumdaki mevcut bir düzenleyiciye yerleştirin.
  2. Tablolar, Bağlantılar bölmesinde genişletilmişken tabloya sağ tıklayın ve Ekleme Sorgusu Oluştur seçeneğine tıklayın. Ekleme sorgusunun tanımı imlecin ekleme noktasına eklenir.

Sorgu oluşturun ve çalıştırın

Bu yordamda en az bir ambara başarıyla bağlandığınız varsayılır.

  1. Bağlantılar bölmesinde, hedef bağlantınız için varsa bağlantı grubunu genişletin.
  2. Ambarınızın hedef bağlantısını çift tıklayın veya genişletin.
  3. Bağlantı seçili durumdayken, Bağlantılar bölmesinin başlık çubuğunda Yeni SQL Dosyası'na tıklayın. Yeni bir düzenleyici sekmesi görüntülenir.
  4. SQL sorgunuzu yeni düzenleyiciye girin.
  5. SQL sorgusunu çalıştırmak için düzenleyicide Etkin bağlantıda çalıştır'a tıklayın. Sorgunun sonuçları yeni bir düzenleyici sekmesinde görüntülenir.

Var olan bir sorguyu çalıştırın

Bu yordamda en az bir ambara başarıyla bağlandığınız varsayılır.

  1. Bağlantılar bölmesinde, hedef bağlantınız için varsa bağlantı grubunu genişletin.
  2. Ambarınız için hedef bağlantı düğümünü çift tıklayın veya genişletin.
  3. Bağlantı seçiliyken, dosya uzantısına .sql sahip herhangi bir dosyayı açın veya daha önce açılmış olan herhangi bir düzenleyicide ardışık SQL deyimleri grubunu seçin.
  4. SQL sorgusunu açık .sql bir dosyadan çalıştırmak için, dosyanızın .sql içeriği düzenleyicide görüntülenirken düzenleyicide Etkin bağlantıda çalıştır'a tıklayın. Sorgunun sonuçları yeni bir düzenleyici sekmesinde görüntülenir.
  5. Daha önce açılmış bir düzenleyicide seçili SQL deyimleri grubunu çalıştırmak için seçiminize sağ tıklayın ve ardından Seçili Sorguyu Çalıştır'a tıklayın. Sorgunun sonuçları yeni bir düzenleyici sekmesinde görüntülenir.

Kullanım günlüklerini Databricks'e gönder

SQLTools için Databricks Sürücüsünü kullanırken sorunlarla karşılaşırsanız, aşağıdakileri yaparak kullanım günlüklerini ve ilgili bilgileri Databricks Desteği'ne gönderebilirsiniz:

  1. Visual Studio Code için Databricks uzantısını yükleyin yerel geliştirme makinenize.
  2. Logs: Enabled ayarını işaretleyerek veya Databricks IDE uzantısı için Ayarlar bölümünde açıklandığı gibi databricks.logs.enabled öğesini true olarak ayarlayarak günlüğe kaydetmeyi açın. Günlüğe kaydetmeyi açtıktan sonra Visual Studio Code'u yeniden başlattığınızdan emin olun.
  3. Sorununuzu yeniden oluşturmaya çalışın.
  4. Komut Paleti'nden (ana menüden Görünüm > Komut Paleti), Databricks: Tam günlükleri aç komutunu çalıştırın.
  5. Databricks Desteği'ne görünen Databricks Logs.log, databricks-cli-logs.json ve sdk-and-extension-logs.json dosyalarını gönderin.
  6. Ayrıca, sorunun bağlamında Terminal (Görünüm > Terminal) içeriğini kopyalayın ve bu içeriği Databricks Desteği'ne gönderin.

Çıkış görünümü (Görünüm > Çıkış, Databricks Günlükleri), Günlükler: Etkin işaretliyse veya databricks.logs.enabled olarak ayarlanmışsa kesilmiş bilgiler gösterir. Daha fazla bilgi göstermek için, Databricks IDE uzantısı için Ayarlar'da açıklandığı gibi aşağıdaki ayarları değiştirin:

  • Günlükler: En Fazla Dizi Uzunluğu veya databricks.logs.maxArrayLength
  • Günlükler: En Fazla Alan Uzunluğu veya databricks.logs.maxFieldLength
  • Günlükler: Kesme Derinliği veya databricks.logs.truncationDepth

Ek kaynaklar

  • Son güncelleştirme: