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 aşağıdakileri yapın:

  1. Azure Databricks çalışma alanınızda üst çubukta Azure Databricks kullanıcı adınıza tıklayın ve açılan listeden Ayarlar'ı seçin.
  2. Geliştirici'ye tıklayın.
  3. Erişim belirteçleri'nin yanındaki Yönet'e tıklayın.
  4. Yeni belirteç oluştur'a tıklayın.
  5. (İsteğe bağlı) Gelecekte bu belirteci tanımlamanıza yardımcı olacak bir açıklama girin ve belirtecin varsayılan 90 günlük ömrünü değiştirin. Yaşam süresi olmayan bir belirteç oluşturmak için (önerilmez), Yaşam Süresi (gün) kutusunu boş (boş) bırakın.
  6. Generate (Oluştur) düğmesine tıklayın.
  7. Görüntülenen belirteci güvenli bir konuma kopyalayın ve bitti'ye tıklayın.

Not

Kopyalanan belirteci güvenli bir konuma kaydettiğinizden emin olun. Kopyalanan belirtecinizi başkalarıyla paylaşmayın. Kopyalanan belirteci kaybederseniz, tam olarak aynı belirteci yeniden oluşturamazsınız. Bunun yerine, yeni bir belirteç oluşturmak için bu yordamı yinelemeniz gerekir. Kopyalanan belirteci kaybederseniz veya belirtecin gizliliğinin ihlal edildiğini düşünüyorsanız Databricks, Erişim belirteçleri sayfasındaki belirtecin yanındaki çöp kutusu (İptal Et) simgesine tıklayarak bu belirteci çalışma alanınızdan hemen silmenizi kesinlikle önerir.

Çalışma alanınızda belirteç oluşturamıyor veya kullanamıyorsanız, bunun nedeni çalışma alanı yöneticinizin belirteçleri devre dışı bırakmış olması veya size belirteç oluşturma veya kullanma izni vermemiş olması olabilir. Çalışma alanı yöneticinize veya aşağıdaki konulara bakın:

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ğinhttps://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ğinhttps://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 hive_metastorekullanmak için Katalog'un boş bırakabilirsiniz.

    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 truedatabricks.logs.enabled Ayarını Visual Studio Code için Databricks uzantısı ayarları bölümünde açı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 aç komutunu çalıştırın.
  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 (Terminali 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: Etkin işaretliyse veya databricks.logs.enabled olarak ayarlandıysa truekesilmiş 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