Aracılığıyla paylaş

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

  • Makale

Ö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.

Başlamadan önce

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 ambarı içermelidir.

    Not

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

  • Unity Kataloğu 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 Yükle'ye tıklayın veya:

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

  2. Market'te Uzantıları Ara kutusuna yazınSQLTools.

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

    Not

    Listede birden çok SQLTools girdisi olabilir. Matheus Teixeira'daki girdiye tıklamış olmanız gerekir.

  4. Yükle'ye tıklayın.

SQLTools için Databricks Sürücüsü uzantısını yüklemek için SQLTools için Databricks Sürücüsü'ne gidin ve Yükle'ye tıklayın veya:

  1. Visual Studio Code'da, ana menüde Uzantıları Görüntüle'ye > tıklayın.
  2. Market'te Uzantıları Ara kutusuna yazınDatabricks Driver for SQLTools.
  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 Azure Databricks kişisel erişim belirteçleri'ndeki adımları izleyin.

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

SQLTools için Databricks Sürücüsü ile kimlik doğrulaması yapmak için Azure Databricks OAuth makineden makineye (M2M) kimlik doğrulamasını aşağıdaki gibi 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ının "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. Visual Studio Code için Databricks uzantısında Yapılandırma bölmesinde 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 Konağı için çalışma alanı başına Azure Databricks URL'nizi girin( örneğinhttps://adb-1234567890123456.7.azuredatabricks.net, ) ve enter tuşuna 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. Visual Studio Code için Databricks uzantısında Yapılandırma bölmesinde 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.
  3. Komut Paleti'nde Databricks Konağı için çalışma alanı başına Azure Databricks 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. İstenirse erişime izin verin all-apis .

Azure CLI kimlik doğrulaması

Azure CLI'yı kullanarak SQLTools için Databricks Sürücüsü ile 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 Azure CLI'yı yerel geliştirme makinenize yükleyin.
  2. Yerel geliştirme makinenizde Visual Studio Code için Databricks uzantısını yükleyin ve açın.
  3. Visual Studio Code için Databricks uzantısında Yapılandırma bölmesinde 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 Konağı için çalışma alanı başına Azure Databricks 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.

Şemaya bağlanma

  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, Veritabanı sürücüsü seçin adımı için 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.

    3. Kullanarak bağlan için aşağıdakilerden birini seçin:

      • Kimlik doğrulaması için Azure Databricks kişisel erişim belirteci kullanmak için Konak Adı ve Belirteç'i 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 için VS Code uzantısı (beta) seçeneğini belirleyin.

    4. 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.

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

    6. Kullanarak bağlan için Ana Bilgisayar Adı ve Belirteç'i seçtiyseniz Belirteç alanına Azure Databricks kişisel erişim belirteci değerinizi girin.

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

      Not

      Unity Kataloğu için etkinleştirilmemiş çalışma alanları için, varsayılan değerini kullanmak için Katalog'unhive_metastore.

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

    9. (İsteğe bağlı) Kayıtları göster varsayılan sınırı için varsayılan değerini her sorgu için yalnızca ilk 50 satırı gösterecek şekilde bırakın 50 veya farklı bir sınır girin.

  5. Bağlantıyı Sına’ya 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ı Sına’ya 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ıya çift tıklayın veya 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 için satırları veya şemayı görüntüleme

Bağlantılar bölmesinde genişletilmiş Tablolar veya Görünümler ile 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.

Tablo için ekleme sorgusu oluşturma

  1. İmlecinizi, ekleme sorgusunun eklenmesini istediğiniz konuma var olan bir düzenleyiciye getirin.
  2. Bağlantılar bölmesinde tablolar genişletildiyse, tabloya sağ tıklayın ve Sorgu Ekle Oluştur'a tıklayın. Ekleme sorgusunun tanımı imlecin ekleme noktasına eklenir.

Sorgu oluşturma ve çalıştırma

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ıya ç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ırma

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ıya çift tıklayın veya genişletin.
  3. Bağlantı seçiliyken, dosya uzantısına .sqlsahip herhangi bir dosyayı açın veya daha önce açılmış olan herhangi bir düzenleyicide sürekli 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 bir sürekli 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önderme

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. Yerel geliştirme makinenize Visual Studio Code için Databricks uzantısını yükleyin.
  2. Günlükler: Etkin ayarını veya databricks.logs.enabled Ayarını Visual Studio Codetrueaçıklandığı gibi denetleyerek günlüğü açın Günlüğü açtıktan sonra Visual Studio Code'u yeniden başlattığınızdan emin olun.
  3. Sorununuzu yeniden oluşturmaya çalışma.
  4. Komut Paleti'nden (ana menüden Komut Paletini Görüntüle) Databricks: Tam günlükleri>.
  5. Databricks Desteği'ne Databricks Logs.loggörünen , databricks-cli-logs.jsonve sdk-and-extension-logs.json dosyalarını gönderin.
  6. Ayrıca sorun bağlamında Terminalin (> Görüntüle) içeriğini kopyalayın ve bu içeriği Databricks Desteği'ne gönderin.

Çıkış görünümü (Çıktıyı Görüntüle>, Databricks Günlükleri), Günlükler: Etkindatabricks.logs.enabledkesilmiş bilgileri gösterir. Daha fazla bilgi göstermek için, Visual Studio Code için Databricks uzantısı ayarları bölümünde 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