Azure Databricks Excel Eklentisini kullanarak verileri içeri aktarma ve sorgulama

Önemli

Bu özellik Genel Önizleme aşamasındadır.

Uyarı

Azure Databricks Excel Eklentisi Azure Kamu veya Azure Çin bölgelerinde kullanılamaz.

Azure Databricks Excel Eklentisi, Azure Databricks çalışma alanınızı Microsoft Excel bağlar ve verilerden kararlara daha hızlı geçmenize yardımcı olmak için yönetilen Lakehouse verilerini doğrudan elektronik tablolarınıza getirir.

Bu sayfada, Excel'da Azure Databricks verileri içeri aktarmak ve analiz etmek için Azure Databricks Excel Eklentisi'nin nasıl kullanılacağı açıklanır. SQL bilgisi gerektirmeden sezgisel bir arabirim aracılığıyla Azure Databricks tablolara göz atabilir ve bunları içeri aktarabilirsiniz. Eklenti özel SQL sorguları yürütme esnekliği sunsa da isteğe bağlıdır.

Önkoşullar

SQL ambarı seçme

Hangi SQL ambarını kullanacağınızı seçin:

  1. Excel'daki Azure Databricks Eklentisi bölmesinin sağ üst kısmında açılan menüye tıklayın.
  2. Kullanmak istediğiniz SQL ambarını seçin.

Azure Databricks'dan veri içeri aktarma

Bir tablo seçerek, SQL sorgusu yazarak veya özet tabloyu içeri aktararak Excel Azure Databricks verilerini içeri aktarabilirsiniz.

Uyarı

Özet tabloları, SQL sorgularını ve özel işlevleri kullanarak Unity Kataloğu ölçüm görünümlerini içeri aktarabilirsiniz.

Özet tablo oluşturma

Unity Kataloğu'ndaki tablolar ve görünümlerden Excel'de bir özet tablo oluşturmak için:

  1. Azure Databricks Excel Eklentisi bölmesindeki Yeni içeri aktarma sekmesinin altında Select data öğesini Import yöntemi olarak seçin.

  2. Katalog altında, pivot tablosu oluşturmak istediğiniz tabloyu seçin ve Seç'e tıklayın.

  3. Pivot Data onay kutusunu seçin.

  4. Her alanı doğru alana sürükleyerek Satır, Sütun ve Değer'i yapılandırın.

  5. (İsteğe bağlı) Filtre Ekle'yi seçin. Filtreler hakkında daha fazla bilgi için bkz . İçeri aktarılan verileri filtreleme.

  6. (İsteğe bağlı) İçeri aktarma işleminin bir örneğini görmek için Önizleme'ye tıklayın.

  7. (İsteğe bağlı) İçeri aktarmanız için bir satır sınırı ayarlayın.

  8. Sonuçlarınızı içeri aktar. Aşağıdakilerden birini seçin:

    • Kaydet ve içeri aktar öğesine tıklayarak sorguyu Excel çalışma kitabında yeniden kullanmak üzere kaydedin ve sonuçları içeri aktarın.
    • Aşağı oka tıklayın ve ardından Sonuçları içeri aktar'a tıklayarak sorguyu kaydetmeden sonuçları içeri aktarın. İçeri aktarmayı düzenlemeye devam etmek istediğinizde bu seçeneği kullanın.

    Uyarı

    Özet tablolar yalnızca yeni bir sayfaya aktarılabilir.

Özet tablolarda Unity Kataloğu ölçümleriyle çalışırken, sonuçlarda Sum(measure) görüntülenmiş olarak görebilirsiniz. Bu beklenen bir davranıştır ve ek toplama gerçekleşmez. Excel, değerlerin bir toplama işlevine sahip olmasını gerektirir, ancak veriler benzersiz değerler içerdiğinden toplama gerçekleşmez.

Tabloları seçme

Veriler bir Excel table nesnesi olarak içeri aktarılır. Tabloyu taşıyabilir veya sayfayı yeniden adlandırabilirsiniz ve Excel Eklenti yeni konumdaki verileri yeniler.

Azure Databricks tablosundan verileri içeri aktarmak için aşağıdakileri yapın:

  1. Azure Databricks Excel Eklentisi bölmesindeki Yeni içeri aktarma sekmesinin altında Select data öğesini Import yöntemi olarak seçin.
  2. Katalog gezgininden içeri aktaracak bir tablo seçin. Kaydırıcılar simgesini kullanarak kataloğu sahibine, sertifika durumuna ve diğer özelliklere göre filtreleyebilirsiniz.
  3. Seç'e tıklayın.
  4. Sütunlar'ın altında aşağı oka tıklayın ve içeri aktarmak istemediğiniz sütunların seçimini kaldırın veya tablonun tamamını içeri aktarmak için tüm sütunları seçili bırakın.
  5. (İsteğe bağlı) Filtre Ekle'yi seçin. Filtreler hakkında daha fazla bilgi için bkz . İçeri aktarılan verileri filtreleme.
  6. (İsteğe bağlı) İçeri aktarma işleminin bir örneğini görmek için Önizleme'ye tıklayın.
  7. (İsteğe bağlı) İçeri aktarılan satır sayısını kısıtlamak için bir satır sınırı ayarlayın.
  8. (İsteğe bağlı) İçeri aktarılan verilerinizi tanımlamak için bir İçeri aktarma adı girin.
  9. Çıkış Hedefi'nin altında, verileri yeni bir sayfaya veya geçerli sayfaya içeri aktarmayı seçin. Geçerli sayfaya aktarırsanız, veriler girdiğiniz hücre referansından başlar (varsayılan olarak A1).
  10. Sonuçlarınızı içeri aktar. Aşağıdakilerden birini seçin:
    • Kaydet ve içeri aktar öğesine tıklayarak sorguyu Excel çalışma kitabında yeniden kullanmak üzere kaydedin ve sonuçları içeri aktarın.
    • Aşağı oka tıklayın ve ardından Sonuçları içeri aktar'a tıklayarak sorguyu kaydetmeden sonuçları içeri aktarın. İçeri aktarmayı düzenlemeye devam etmek istediğinizde bu seçeneği kullanın.

SQL sorguları yazma

Write SQL içeri aktarma yöntemi, SQL işlevlerini ve saklı yordamları destekler.

Azure Databricks çalışma alanınızda özel SQL sorguları çalıştırmak için aşağıdakileri yapın:

  1. Azure Databricks Excel Eklentisi bölmesinde, Yeni içeri aktarma sekmesinin altında Write SQLImport yöntemi olarak seçin.

  2. Sorgunuzu daha sonra tanımlamak için bir ad girin.

  3. Yeni bir sorgu yazın veya Azure Databricks çalışma alanınızdan var olan bir sorguyu kullanın.

    • SQL sorgunuzu düzenleyiciye yazın. Unity Kataloğu'nda erişim izniniz olan herhangi bir tabloyu sorgulayabilirsiniz.

      • Veri simgesine tıklayın. Şemalarınızı ve tablolarınızı görüntülemek için katalog gezgini.
    • Azure Databricks çalışma alanınızdan veya Excel'da var olan bir sorguyu kullanmak için klasöre Folder icon. tıklayın. Azure Databricks çalışma alanınızdaki mevcut bir sorguyu kullanıyorsanız, Excel'de yapılan düzenlemeler Azure Databricks'e yansıtılmazlar.

      Uyarı

      Sorguların Excel görünmeden önce sorgu düzenleyicisinin sağ üst köşesindeki Save düğmesi kullanılarak Azure Databricks'a açıkça kaydedilmesi gerekir.

  4. (İsteğe bağlı) Sorgu parametreleri eklemek için Parametreler'in yanındaki +Ekle'ye tıklayın. parametresine tıklayın ve Parametre Adı ve Parametre Değeri girin.

    • Parametre değeri için belirli bir değer girebilir veya hücre referansı belirtmek için kutu ve ok simgesine tıklayabilirsiniz. Bir hücreyi veya hücre aralığını seçin ve parametre değerini otomatik olarak doldurmak için oka tıklayın.
  5. Çıkış Hedefi'nin altında, verileri yeni bir sayfaya veya geçerli sayfaya içeri aktarmayı seçin. Geçerli sayfaya aktarırsanız, veriler girdiğiniz hücre referansından başlar (varsayılan olarak A1).

  6. Sorgu sonuçlarınızı önizlemek için Çalıştır'a tıklayın.

  7. Sonuçlarınızı içeri aktar. Aşağıdakilerden birini seçin:

    • Kaydet ve içeri aktar öğesine tıklayarak sorguyu Excel çalışma kitabında yeniden kullanmak üzere kaydedin ve sonuçları içeri aktarın.
    • Aşağı oka tıklayın ve ardından Sonuçları içeri aktar'a tıklayarak sorguyu kaydetmeden sonuçları içeri aktarın. İçeri aktarmayı düzenlemeye devam etmek istediğinizde bu seçeneği kullanın.

Sorgu parametreleri eklemek için özel işlevler de kullanabilirsiniz. Bkz SQL Yaz.

İçeri aktarılan verileri filtreleme

Tablo seçerek veya özet tablo oluşturarak verileri içeri aktardığınızda, sonuçları daraltmak için filtreler uygulayabilirsiniz.

Filtreleri ayarlamak için + yanındaki öğesine tıklayın, filtre uygulamak istediğiniz sütunu seçin ve filtre koşulunuzu girin. Değer gerektiren filtreler için aşağıdakilerden birini yapabilirsiniz:

  • Değeri girin.
  • En fazla 1.000 ayrı filtre değerinin listesini oluşturmak için şunları kullanabilirsiniz:
    1. Değerler'e ve ardından Filtre değerlerini al'a tıklayın.
    2. Aşağı oka tıklayın ve listeden bir veya daha fazla değer seçin.
  • Hücre başvurusu kullanmak için:
    1. Cells öğesine tıklayın.
    2. Bir hücreyi veya hücre aralığını seçin.
    3. İmleci tıklatın İmleç simgesine tıklayın. .

Aşağıdaki tabloda kullanılabilir her filtre ve beklenen giriş açıklanmaktadır.

Filtre Beklenen giriş Açıklama
IS NULL Hiçbiri Sütun değerinin null olduğu satırları bulur.
IS NOT NULL Hiçbiri Sütun değerinin null olmadığı satırları bulur.
EQUALS Bir sayı veya metin dizesi Sütun değerinin belirtilen değerle tam olarak eşleştiği satırları bulur.
NOT EQUALS Bir sayı veya metin dizesi Sütun değerinin belirtilen değerle eşleşmediği satırları bulur.
IN Virgülle ayrılmış bir veya daha fazla sayı veya metin dizesi Sütun değerinin belirtilen değerlerden herhangi biri ile eşleştiği satırları bulur.
NOT IN Virgülle ayrılmış bir veya daha fazla sayı veya metin dizesi Sütun değerinin belirtilen değerlerle eşleşmediği satırları bulur.
LIKE % (herhangi bir karakter) ve _ (tek karakter) joker karakterler olarak kullanılan bir desen.
%smith "smith" ile biten herhangi bir değerle eşleşir.
t_p "tap", "tip" veya "top" gibi değerleri eşleştirir.
Sütun değerinin desenle eşleştiği satırları bulur. Büyük/küçük harfe duyarlı.
NOT LIKE % (herhangi bir karakter) ve _ (tek karakter) joker karakterler olarak kullanılan bir desen.
%test% "test" içeren değerleri dışlar.
_at "bat", "cat" veya "hat" gibi değerleri dışlar.
Sütun değerinin desenle eşleşmediği satırları bulur. Büyük/küçük harfe duyarlı.
ILIKE % (herhangi bir karakter) ve _ (tek karakter) joker karakterler olarak kullanılan bir desen.
%Smith "smith", "Smith" veya "SMITH" gibi değerlerle eşleşir.
_ob "Bob", "rob" veya "Rob" ile eşleşir.
Sütun değerinin desenle eşleştiği satırları bulur. Büyük/küçük harfe duyarlı değildir.
STARTS WITH Bir metin dizesi Sütun değerinin belirtilen metinle başladığı satırları bulur.
ENDS WITH Bir metin dizesi Sütun değerinin belirtilen metinle sona erdiği satırları bulur.
CONTAINS Bir metin dizesi Sütun değerinin dizenin herhangi bir yerinde belirtilen metni içerdiği satırları bulur.

Excel'da Azure Databricks özel işlevleri kullanma

Excel Eklentisi, Azure Databricks verileri içeri aktarmak için Excel formüllerde kullanabileceğiniz özel işlevler sağlar.

Tablo seçme

İşlev, DATABRICKS.Table Unity Kataloğu tablosundan verileri içeri aktarır.

Syntax:

=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])

Parametreler:

  • catalog_name.schema_name.table_name (gerekli): Tam nitelikli tablo adı.
  • columns (isteğe bağlı): İçeri aktarılacağınız sütun adları dizisi. Tüm sütunları içeri aktarmak için bu parametreyi atla.
  • limit (isteğe bağlı): İçeri aktarılacağınız satır sayısı üst sınırıdır. 10 MB sınırına kadar tüm satırları içeri aktarmak için bu parametreyi atlayın.

Example:

=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)

Bu formül, customer_id tablosundan customer_name ve main.default.customers sütunlarını, 100 satırla sınırlı olacak şekilde içeri aktarır.

SQL yazma

İşlev, DATABRICKS.SQL sorgu parametrelerini kullanan ve sonuçları döndüren bir SQL sorgusu çalıştırır.

Syntax:

Değerleri kullanarak parametreleri belirtin.

=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})

Bir hücre aralığı kullanarak parametreleri belirtin. Aynı satırdaki hücrelerde ad ve değer parametrelerini tanımlayın.

=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})

Parametreler:

  • query_text (gerekli): Çalıştırılacak SQL sorgusu.
  • parameters (gerekli): Sorgunun yerine geçecek parametre değerlerinin eşlemesi.

Example:

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)

Bu formül, sağlanan parametre değerlerini kullanarak satış verilerini longitude ve latitude ölçütlerine göre filtreleyen bir sorguyu çalıştırır.

Sorguları yönetme

İçeri Aktarmalar sayfasından var olan içeri aktarmalarınızı yönetin.

Var olan içeri aktarmayı düzenleme

Mevcut bir içe aktarmayı düzenlemek için:

  1. Excel Azure Databricks Eklentisi bölmesinde Imports sekmesine tıklayın.
  2. Düzenlemek istediğiniz import'u bulun.
  3. İçeri aktarma işleminin yanındaki üç noktalı menüye tıklayın.
  4. İçeri aktarma işleminizi düzenlemek için Düzenle'ye tıklayın.

Verileri yenileme

Excel Eklentisi verileri otomatik olarak yenilemez. Verileri nasıl yenilediğiniz, verileri nasıl içeri aktardığınıza bağlıdır. İçeri aktarma yöntemi kullanılarak içeri aktarılan veriler (tablo seçin, SQL sorgusu yazın veya özet tablo oluşturun) İçeri Aktarmalar sekmesinden yenilenir. Özel işlev kullanılarak içeri aktarılan veriler yeniden hesaplanmalıdır.

İçe aktarmaları Azure Databricks’teki en son değerlerle güncelleştirin. Eklenti özgün sorguyu veya tablo seçimini yeniden çalıştırır ve çalışma sayfanızı yeni verilerle güncelleştirir:

  • Tek bir içe aktarmayı yenilemek için:
    1. Excel Azure Databricks Eklentisi bölmesinde Imports sekmesine tıklayın.
    2. Yenile simgesine tıklayın. Yenilemek istediğiniz içeri aktarma işleminin yanındaki yenile'yi seçin.
  • Tüm içe aktarmaları yenilemek için:
    1. Azure Databricks Eklentisi bölmesinde Refresh All öğesine tıklayın.

Önemli

Excel Eklentisi, verileri yenilerken belirtilen tablodaki tüm mevcut verileri temizler ve Azure Databricks en yeni verileri yeniden yükler. Tabloya eklediğiniz tüm özel sütunlar yenileme işlemi sırasında silinir.

ve DATABRICKS.Tablegibi DATABRICKS.SQL özel işlevlerden içeri aktarılan veriler, çalışma kitabını yeniden açtığınızda yenilenmez. Özel işlevlerden içeri aktarılan verileri yenilemek için, Azure Databricks Eklentisi'nde oturum açın, ardından çalışma kitabını yeniden hesaplayın veya özel işlevin başvurdüğü bir değeri değiştirin.

Paylaşım etkileri

Azure Databricks verileri içeren bir Excel çalışma kitabını paylaşırken aşağıdaki veri erişimini ve güvenlik etkilerini göz önünde bulundurun:

İçeri aktarılan verilere görünürlük

Alıcı bir içeri aktarmayı yenilediğinde, Eklenti alıcının Unity Kataloğu izinlerini kullanır. Temel alınan verilere erişimi yoksa yenileme başarısız olur.

Veri gizliliğinin önemli olduğu çalışma kitapları için aşağıdaki geçici çözümü kullanabilirsiniz:

  1. Tüm gerekli formülleri ve içeri aktarmaları içeren bir çalışma kitabı oluşturun.
  2. İçeri aktarılan verileri sayfadan silin.
  3. Çalışma kitabını alıcıyla paylaşın.
  4. Alıcının verileri yenilemesini sağlayın.

Alıcı yalnızca Unity Kataloğu izinlerine göre erişimi olan verileri görür.

Çalışma alanlarına ve veri varlıklarına erişim

  • Çalışma kitabında başvuruda bulunan Unity Kataloğu nesnelerine erişimi olmayan kullanıcılar verileri yenileyemez. Verileri yenilemek için, kullanıcıların Unity Kataloğu'ndaki temel tablolar ve görünümler üzerinde okuma izinlerine sahip olması gerekir.
  • Kullanıcıların var olan içeri aktarmaları düzenlemek için Azure Databricks'daki temel tabloya erişimi olmalıdır.

Sorgu görünürlüğü

Çalışma kitabına düzenleme erişimi olan kullanıcılar, Unity Kataloğu'nda temel alınan verilere erişimi olmasa bile Azure Databricks Eklentisi aracılığıyla verileri oluşturmak için kullanılan sorguları görüntüleyebilir.

Şablon olarak kaydetmeye alternatif

Azure Databricks Excel Eklentisi çalışma kitabını şablon olarak kaydetmeyi desteklemez, ancak diğer kullanıcıların içeri aktarılan sorguları görebilmesi için çalışma kitabını paylaşabilirsiniz. Bkz. Veri erişimi ve güvenlik konuları için paylaşım etkileri .

Çalışma kitabını şablon olarak paylaşmaya ilişkin geçici bir çözüm olarak aşağıdakilerden birini yapın:

  • Yerel dosyayı başka bir kullanıcıyla paylaşın. Alıcı dosyayı yeniden adlandırabilir ve kaydedilen sorguları görebilir.
  • SharePoint çalışma kitabını başka bir kullanıcıyla paylaşın. Başka bir kullanıcı dosyayı indirdiğinde, kaydedilen içeri aktarmalar korunur.

Sınırlamalar

  • Özel işlevler: Sql yürütme API'sinin sınırlamaları nedeniyle özel işlevler için sorgu sonuçları 25 MiB ile sınırlıdır.
  • Veri yükleme: Çalışma kitabındaki herhangi bir hücre düzenleme modundaysa veri yükleme başarısız olabilir.
  • Excel Desktop satır sınırı: Excel Desktop, sayfa başına en fazla 1.048.576 satırı destekler.
  • Web için Excel dosya boyutu sınırı: Web için Excel görüntüleme ve düzenleme için yaklaşık 25 MB çalışma kitabı dosya boyutu üst sınırını destekler.