Kar tanesi

Uyarı

Dağıtım zamanlamaları ve konağa özgü özellikler nedeniyle bazı özellikler tek bir üründe mevcut olabilir ancak diğerleri mevcut olmayabilir.

Özet

Öğe Açıklama
Yayın Durumu Genel Kullanılabilirlik
Ürünler Power BI (Anlam modelleri)
Power BI (Veri Akışları)
Fabric (Veri Akışı 2. Nesil)
Power Apps (Veri Akışları)
Desteklenen Kimlik Doğrulama Türleri Snowflake (Kullanıcı Adı/Parola), Microsoft hesabı (Microsoft Entra Id), Anahtar Çifti Kimlik Doğrulaması (ADBC), Hizmet Sorumlusu (SPN)
İşlev Başvurusu Belgeleri

Uyarı

Parola ifadesi giriş alanı, karşıya yüklenen sertifika türüne bağlı olarak gerekirse otomatik olarak görüntülenir. Kullanıcı bir sertifikayı karşıya yükledikten sonra sistem, sertifikanın şifrelenip şifrelenmediğini algılar ve parola iletişim kutusunu koşullu olarak görüntüler. Hem şifrelenmiş hem de şifrelenmemiş anahtarlar desteklenir.

Important

Bu bağlayıcı ekli Simba Snowflake ODBC sürücüsünden Snowflake ADBC sürücüsüne geçiş yapmakta. Geçiş kılavuzu, önemli tarihler ve yönetici denetimleri için bkz. Power BI ve Fabric'te ODBC sürücülerinden ADBC sürücülerine geçiş.

Desteklenen Özellikler

  • İthalat
  • DirectQuery (Power BI anlamsal modeller)
  • Gelişmiş seçenekler
    • Rol adı olarak kullanılacak bir metin değeri belirtin
    • İlişki sütunları
    • Bağlantı zaman aşımı süresi (saniyeler)
    • Komut zaman aşımı süresi saniye cinsinden
    • Veritabanı
    • Yerel SQL deyimi

Desteklenen kimlik doğrulama türleri

Uyarı

  • Kullanıcı adı/parola kimlik doğrulama modu kullanım dışı bırakılacak. Daha fazla bilgi için buraya bakın. Daha fazla bilgiyi, Connectivity altında, Fabric yol haritamızda bulabilirsiniz.

  • Anahtar Çifti Kimlik Doğrulaması, Veri Akışları 1. Nesil ve Power Apps (Veri Akışları) için desteklenmez.

Snowflake bağlayıcısı aşağıdaki kimlik doğrulama yöntemlerini destekler:

  • Microsoft Entra Id (önerilen): Kullanıcı adlarını veya parolaları depolamadan güçlü, kimlik tabanlı kimlik doğrulamasını etkinleştirir.

    • Microsoft Fabric'te bu kimlik doğrulama yöntemi desteklenen deneyimlerde (Veri Kümeleri ve Veri Akışları 2. Nesil gibi) çalışma alanı kimliği tarafından desteklenebilir ve Doku'nun çalışma alanının yönetilen kimliğini kullanarak Snowflake'te kimlik doğrulaması yapmalarına olanak tanır.
  • Çalışma Alanı Kimliği: Microsoft Fabric çalışma alanıyla ilişkilendirilmiş yönetilen kimlik. Microsoft Entra Kimliği ile kimlik doğrulaması yaptığınızda, desteklenen Doku deneyimleri (Veri Kümeleri ve Veri Akışları 2. Nesil gibi) Snowflake'de kimlik doğrulaması yapmak için çalışma alanı kimliğini kullanabilir. Bu yöntem, Fabric'in tek tek kullanıcı kimlik bilgileri yerine çalışma alanına bağlı bir kimlik kullanarak Snowflake'e erişmesini sağlar.

  • Anahtar çifti kimlik doğrulaması (ADBC):Desteklenen senaryolar için sertifika tabanlı kimlik doğrulaması.

  • Hizmet Sorumlusu (SPN): Hizmet sorumluları, kullanıcı olmayan, uygulama düzeyinde bir kimliğin gerekli olduğu senaryolar için Snowflake ile desteklenir. Destek, Snowflake yapılandırmasına ve kullanılan kimlik doğrulama yöntemine bağlıdır.

Power Query Desktop'tan Snowflake veri ambarı'na bağlanma

Uyarı

Tüm yeni bağlantılar varsayılan olarak Snowflake bağlayıcısı uygulaması 2.0'i kullanır.

Mart 2025'e kadar oluşturulan tüm bağlantıları bu yeni uygulamayla güncelleştirmenizi öneririz.

Snowflake bilgi işlem ambarı ile bağlantı oluşturmak için aşağıdaki adımları izleyin:

  1. Power BI Desktop'taki Home şeridinden Get Data öğesini seçin. soldaki kategorilerden Database öğesini seçin, Snowflake'ı seçin ve ardından Connect öğesini seçin.

    Snowflake veritabanı seçimini gösteren Veri Al iletişim kutusunun ekran görüntüsü.

  2. Görüntülenen Snowflake penceresinde, Sunucu'da Snowflake sunucunuzun adını ve Warehouse'daki Snowflake bilgi işlem ambarınızın adını girin.

    Radyoyu içeri aktar düğmesinin seçili olduğunu gösteren Snowflake iletişim kutusunun ekran görüntüsü.

  3. İsteğe bağlı olarak, bağlantı sorgusunu değiştirmek için kullanmak istediğiniz herhangi bir gelişmiş seçenekte rol adı veya komut zaman aşımı olarak kullanılacak metin değeri gibi değerleri girin. Daha fazla bilgi için gelişmiş seçenekleri kullanarak 'a bağlanıngidin.

  4. Tamam'ı seçin.

  5. Snowflake bilgi işlem ambarında oturum açmak için kullanıcı adınızı ve parolanızı girin ve bağlan'ı seçin.

    Kullanıcı adı ve Parola alanlarını gösteren Snowflake kimlik bilgisi isteminin ekran görüntüsü.

    Uyarı

    Belirli bir Snowflake sunucusu için kullanıcı adınızı ve parolanızı girdiğinizde, Power BI Desktop sonraki bağlantı girişimlerinde aynı kimlik bilgilerini kullanır. Dosya > Seçenekleri ve ayarları Veri kaynağı ayarları'na >giderek bu kimlik bilgilerini değiştirebilirsiniz. Daha fazla bilgi için Kimlik doğrulama yöntemini değiştirme bölümüne gidin.

    Microsoft hesabı seçeneğini kullanmak istiyorsanız Snowflake Microsoft Entra ID tümleştirmesi Snowflake tarafında yapılandırılmalıdır. Daha fazla bilgi için Power BI SSO to Snowflake - Başlarken adresine gidin.

  6. Navigator içinde, Power BI Desktop'ta içeri aktarmak ve kullanmak üzere bir veya birden çok öğe seçin. Ardından tabloyu Power BI Desktop'ta yüklemek için Load veya Transform Data öğesini seçerek kullanmak istediğiniz veri kümesini filtreleyip geliştirebileceğiniz Power Query düzenleyicisini açın ve ardından bu geliştirilmiş veri kümesini Power BI Desktop'a yükleyin.

    Test şeması veritabanının açık olduğu ve DimProduct tablosunun seçili olduğu Gezgin'in ekran görüntüsü.

  7. Verileri doğrudan Power BI içeri aktarmak için Import öğesini seçin veya DirectQuery'ı ve ardından OK'yi seçin. Daha fazla bilgi için Power BI Desktop'da DirectQuery kullanma bölümüne gidin.

    Uyarı

    Microsoft Entra ID çoklu oturum açma (SSO) yalnızca DirectQuery'i destekler.

    İçeri Aktarma ve DirectQuery seçimlerini içeren Bağlantı ayarlarının ekran görüntüsü.

Power Query Online'dan Snowflake veritabanına bağlanma

Bağlantı oluşturmak için aşağıdaki adımları izleyin:

  1. Bağlayıcı seçiminde Snowflake seçeneğini belirleyin.

  2. Görüntülenen Snowflake iletişim kutusunda sunucunun ve ambarın adını girin.

    Power Query Online'deki Snowflake bağlantı oluşturucusunun ekran görüntüsü.

  3. Kullanmak istediğiniz gelişmiş seçeneklere herhangi bir değer girin. Kullanıcı arabiriminde temsil edilmeyen gelişmiş seçenekler varsa, bunları daha sonraki Power Query Gelişmiş Düzenleyici içinde düzenleyebilirsiniz.

  4. Yeni bağlantı seçme veya oluşturma, kullanmak istediğiniz ağ geçidi ve kullanıcı adı ve parola gibi bağlantı kimlik bilgilerinizi girin.

  5. Veritabanına bağlanmak için İleri'yi seçin.

  6. Navigator içinde, istediğiniz verileri seçin ve ardından Transform data seçerek verileri Power Query Düzenleyicisi dönüştürün.

    Test şeması veritabanı açık ve DimProduct tablosu seçili olduğu çevrimiçi gezginin ekran görüntüsü.

Gelişmiş seçenekleri kullanarak bağlanma

Power Query, gerekirse sorgunuza ekleyebileceğiniz bir dizi gelişmiş seçenek sağlar.

Aşağıdaki tabloda, Power Query'de ayarlayabileceğiniz tüm gelişmiş seçenekler listelenmiştir.

Gelişmiş seçenek Açıklama
Rol adı Raporun sürücü aracılığıyla kullandığı rolü belirtir. Bu rol kullanıcının kullanımına açık olmalıdır. Aksi takdirde hiçbir rol ayarlanmaz.
İlişki sütunlarını ekle İşaretlenirse, diğer tablolarla ilişkileri olabilecek sütunları içerir. Bu kutu temizlenmişse, bu sütunları görmezsiniz.
Bağlantı zaman aşımı süresi (saniyeler) Bir hata döndürmeden önce Snowflake hizmetiyle etkileşim kurarken yanıt beklemenin ne kadar süreceğini belirtir. Varsayılan değer 0'dır (zaman aşımı yoktur).
Komut zaman aşımı süresi saniye cinsinden Sorgunun tamamlanması için ne kadar süre bekleneceğini, yoksa hata döndürüleceğini belirtir. Varsayılan değer 0'dır (zaman aşımı yoktur).
Veritabanı Ambardaki belirli bir veritabanını belirtir. Bu seçenek yalnızca Power Query Desktop'ta kullanılabilir.
SQL Deyimi Bilgi için Yerel veritabanı sorgusu kullanarak veritabanından veri içeri aktarma bölümüne gidin. Bu seçenek yalnızca Power Query Desktop'ta kullanılabilir.

Gerektirdiğiniz gelişmiş seçenekleri belirlediğinizde, Snowflake veritabanınıza bağlanmak için Power Query Desktop'ta OK'yi veya Power Query Online'da İleri'yi seçin.

Snowflake bağlayıcısı uygulaması 2.0

Ocak 2025'te Snowflake ile tümleştirmeyi geliştirmek için Snowflake bağlayıcısı için yeni bir uygulama kullanıma sunmuştuk. Bu bağlayıcı Temmuz 2025'ten bu yana genel kullanıma sunulmuştur. En güncel özelliklerden yararlanmak için Power BI Desktop'ı ve şirket içi veri ağ geçidini en son sürüme yükseltmenizi öneririz. Bağlayıcıyı geliştirmeye devam etmemize yardımcı olmak için bize geri bildirim sağlayın.

Snowflake bağlayıcısı uygulaması 2.0, açık kaynak Ok Veritabanı Bağlantısı (ADBC) sürücüsü kullanılarak oluşturulur. ADBC, Ok verileriyle etkileşim kurmak için bir dizi standart arabirim sağlar. Bu, en düşük ek yük ve serileştirme veya kopyalama olmadan büyük veri kümelerini getirme konusunda özellikle etkilidir. ADBC sürücüsü ayrıca bellek güvenliği ve çöp toplama gibi güvenlik geliştirmelerini de içerir. Buna ek olarak, açık kaynak topluluğuyla işbirliği, modern araçları ve güvenli geliştirme yaşam döngüsü (SDL) süreçlerini kullanarak daha hızlı güncelleştirmeler sağlar.

Temmuz 2025'den itibaren bu performans ve güvenlik geliştirmelerinden yararlanmanızı sağlamak için, Masaüstü'nde yeni oluşturulan tüm bağlantılar otomatik olarak 2.0 uygulamasını kullanır. Ayrıca, mevcut sorgularınızı güncelleştirerek ve bayrağını Implementation="2.0"Snowflake.Databases aşağıdaki gibi ekleyerek 2.0 uygulamasını test edebilirsiniz.

Source = Snowflake.Databases("contoso.snowflakecomputing.com", "CONTOSO_WH", [Implementation="2.0"])

Olası sorunları tanımlamaya yardımcı olmak için Implementation ve DriverType ayrıntılarını aşağıdaki örnekte olduğu gibi Mashup günlüklerinde bulabilirsiniz. Geçiş sırasında herhangi bir sorunla karşılaşırsanız desteğe başvurun. Bu arada, sorunu kendiniz hafifletmek için, sorun çözülene kadar iş kesintisini önlemek amacıyla ODBC bağlayıcısını kullanmaya devam etmek istiyorsanız, Implementation="2.0" öğesini kaldırabilirsiniz. Ancak Anahtar Çifti kimlik doğrulamasını kullanıyorsanız, adbc sürücüsü bu ayardan bağımsız olarak her zaman kullanılır.

{
   "Start":"2024-11-02T00:14:02.7968686Z",
   "Action":"Engine/Module/Snowflake/IO/Snowflake/Implementation",
   "ResourceKind":"Snowflake",
   "ResourcePath":"powerbi.snowflakecomputing.com ;DEMO_WH",
   "HostProcessId":"29200",
   "Implementation":"2.0",
   "DriverType":"ADBC",
   "ProductVersion":"2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99",
   "ActivityId":"106f16b6-cfbb-4853-9f20-ed45486486d2",
   "Process":"Microsoft.Mashup.Container.NetFX45",
   "Pid":38560,
   "Tid":1,
   "Duration":"00:00:00.0000291"
}

Temmuz 2025 sürümünden bu yana aşağıdaki seçenekler kullanılabilir:

  • UseHighPrecision: Snowflake NUMBER(38,0) alanlarının nasıl işleneceğinin kesinliğini kontrol eder. Değer belirtilmezse bağlayıcı, SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' sorgusunu kullanarak Snowflake'i sorgular. Değer ayarlanmadıysa bağlayıcı sütun tarafından belirtilen ölçeği kullanır. Bir true değer, SAYI(38,0) değerini Ondalık tür olarak değerlendirir. değer false NUMBER(38,0) değerini Int64 türü olarak değerlendirir. Ölçek 0'dan büyükse, sütun Çift türü olarak kabul edilir.
  • DateTimePrecision: Snowflake Zaman Damgası değerlerinin hassasiyetini nasıl ele aldığını kontrol eder. Snowflake genellikle zaman damgası değerlerini nanosaniye duyarlıkla depolar. Snowflake gereğince, ADBC'de bu hassasiyet, 1677'den önceki veya 2262'den sonraki tarihler için taşma özel durumu oluşturabilir. Bu seçenek için geçerli değerler null, nanosecondsveya microsecondsşeklindedir. `Null değer, varsayılan olarak microseconds kullanır.` 1677 veya 2262 öncesi tarihlere ihtiyacı olan kullanıcıların bu ayarı kullanmasını microseconds öneririz. 1677'den önce veya 2262'den sonra on milyonuncu basamağa kadar hassasiyeti korumanız gerekiyorsa, ODBC sürücüsünü kullanmaya devam etmenizi öneririz.

Snowflake'e bağlanmak için ara sunucu kullanmanız gerekiyorsa ara sunucu ayarı yönergesine bakın. Sürücü, ara sunucu ayarları için ortam değişkenlerini kullanır.

Aşağıdaki tabloda, önceki sürümlerde yayımlanan bağlayıcı geliştirmelerinin özeti yer alır:

Salıverme Bağlayıcı iyileştirmesi
Temmuz 2025 • Boole sütunları Boole türleri döndürerek Boole sütunlarının boş bir kayıt kümesi şemasında (meta veriler dahil) Dize türleri olarak ele alındığı sorunu düzeltmektedir.
• Maksimum zaman damgası duyarlık değerini mikrosaniye olarak ayarlamak için yeni ayar.
• Geliştirilmiş Süre desteği.
• ADBC'ye gezinti özellikleri desteği eklendi.
• ADBC sürücüsünde geliştirilmiş izleme, burada "ActivityId" artık sürücü katmanı üzerinden izlenebilir.
Nisan 2025 • Snowflake sorgu etiketi desteği eklendi. Örnek olarak: {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"}
Mart 2025 • Snowflake'ten veri alınırken gelişmiş performans.
• Yeni oluşturulan bağlantıların otomatik olarak yeni bağlayıcı uygulamasını kullanması için Power BI Desktop'ta varsayılan olarak etkinleştirilir.
• En son Mart sürümünden bu yana görünümlerin görünmemesi sorunu düzeltildi.
Şubat 2025 • Meta veri çağrılarının sayısını azaltarak gelişmiş performans.
• Büyük sonuç kümeleri için yinelenen değerler sorunu çözüldü.

Uyarı

Şirket içi veri ağ geçidini kullandığınızda desteklenen en düşük sürümün Ocak 2025 olduğuna dikkat edin. En güncel özelliklere sahip en son sürümü kullanmanızı öneririz.

Uyarı

Bu özellik, Power BI Desktop'ın 64 bit sürümünde desteklenir ve 32 bit sürümünde çalışmaz.

Sorun giderme

Hata: SQL derleme hatası: Nesne yok veya işlem gerçekleştirilemiyor

Hata, sistem belirtilen nesneyi bulamadığında oluşur. Bu hata genellikle kullanıcının varsayılan veritabanı olarak geçersiz bir veritabanı adına sahip olmasından kaynaklanır.

özellik DEFAULT_NAMESPACE için geçerli bir varsayılan veritabanı adı kullanıldığından emin olun: DESC USERusername

Varsayılan veritabanı adını güncelleştirmek için: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. Daha fazla bilgi için Snowflake belgelerine gidin.

Sınırlamalar ve Dikkat Edilecek Hususlar

Snowflake bağlayıcısı uygulaması 2.0'daki bilinen sorunlar

Şu anda Snowflake bağlayıcısı uygulaması 2.0'da aşağıdaki bilinen sorunlar vardır. Bir düzeltme için devam eden çalışmalar vardır ve bir düzeltme yayınlandığında belgeler güncelleştirilecektir.

  • Mantık içeren count distinct snowflake sorgusu yanlış sonuç döndürür.
  • Daha fazla bellek kullanımı. genel yükleme süresi genellikle Implementation="2.0" kullanılarak daha hızlıdır, ancak bellek tüketimi de daha yüksek olabilir, bazı durumlarda Resource Governing: This operation was canceled because there wasn't enough memory to finish running it. Either reduce the memory footprint of your dataset by doing things such as limiting the amount of imported data, or if using Power BI Premium, increase the memory of the Premium capacity where this dataset is hosted. gibi sorunlara neden olabilir

Çözülen sorunlar

Veritabanı adlarında kısa çizgiler

Bir veritabanı adında kısa çizgi varsa, bir ODBC: ERROR[42000] SQL compilation errorile karşılaşabilirsiniz. Bu sorun Eylül 2024 sürümünde giderilmektedir.

Boole veri türü için dilimleyici görseli

Boole veri türü için dilimleyici görseli Haziran 2024 sürümünde beklendiği gibi çalışmıyor. Bu işlevsizlik bilinen bir sorundur. Geçici bir çözüm olarak, kullanıcılar şu sayfaya giderek raporlarındaki Boole veri türünü metne dönüştürebilir: Aktarım -> Veri Türü -> Metin. Ekim 2024 sürümünde bir düzeltme sağlanmıştır.

Görünümler Implementation="2.0" ile görünmüyor

Power BI Desktop'ın Mart 2025 sürümünün bir sürümünde, Snowflake bağlayıcı uygulaması 2.0 (Implementation="2.0") kullanılırken görünümlerin görünmeme sorunuyla karşılaşabilirsiniz. Bu sorun, Power BI Desktop'ın en son Mart 2025 sürümünden bu yana düzeltildi. Yeniden denemek için yüklemenizi yükseltin.