Google BigQuery

Özet

Öğe	Açıklama
Sürüm Durumu	Genel Kullanılabilirlik
Ürünler	Power BI (Anlam modelleri) Power BI (Veri Akışları) Doku (Veri Akışı 2. Nesil) Power Apps (Veri Akışları) Müşteri İçgörüleri (Veri Akışları)
Desteklenen Kimlik Doğrulama Türleri	Kurumsal hesap Servis firması

Not

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

Not

Temmuz 2021'den itibaren Google, eklenmiş tarayıcı çerçevelerinden Google hesaplarında oturum açma desteğini sona erdirdi. Bu değişiklik nedeniyle, Google'da oturum açmayı desteklemek için Power BI Desktop sürümünüzü Haziran 2021 veya sonraki bir sürüme güncelleştirmeniz gerekir.

Önkoşullar

Google BigQuery'de oturum açmak için bir Google hesabına veya Google hizmet hesabına ihtiyacınız vardır.

Desteklenen özellikler

• İçeri Aktar
• DirectQuery (Power BI anlam modelleri)

Power Query Desktop'tan Google BigQuery verilerine bağlanma

Power Query Desktop'tan Google BigQuery'ye bağlanmak için aşağıdaki adımları izleyin:

1. Veri alma deneyiminde Google BigQuery'yi seçin. Power Query Desktop'taki veri alma deneyimi uygulamalar arasında farklılık gösterir. Uygulamanız için Power Query Desktop veri alma deneyimi hakkında daha fazla bilgi için Veri alma yeri'ne gidin.

2. Herhangi bir gelişmiş seçeneği kullanmak istiyorsanız Gelişmiş seçenekler'i seçin. Aksi takdirde devam etmek için Tamam'ı seçin. Daha fazla bilgi: Gelişmiş seçenekleri kullanarak bağlanma

   

3. Google BigQuery bağlayıcısı, bir kuruluş hesabı veya hizmet hesabı oturum açma aracılığıyla bağlanmayı destekler. Bu örnekte, oturum açmak için kuruluş hesabını kullanın. Devam etmek için Oturum Aç'ı seçin.

   

   Google hizmet hesabı kullanarak da oturum açabilirsiniz. Bu durumda, Hizmet Hesabı Oturum Açma'yı seçin ve hizmet hesabı e-postanızı ve hizmet hesabınızın JSON anahtar dosyası içeriğini girin. Ardından Bağlan'ı seçin.

4. Google ile oturum aç iletişim kutusu görüntülenir. Google hesabınızı seçin ve Power BI Desktop'a bağlanmayı onaylayın.

   

5. Oturum açtıktan sonra devam etmek için Bağlan'ı seçin.

   

6. Başarıyla bağlandıktan sonra bir Gezgin penceresi görüntülenir ve sunucuda kullanılabilir olan veriler görüntülenir. Gezginde verilerinizi seçin. Ardından Power Query'deki verileri dönüştürmek için Verileri Dönüştür'ü veya Verileri Power BI Desktop'a yüklemek için Yükle'yi seçin.

   

Power Query Online'dan Google BigQuery verilerine bağlanma

Power Query Online'dan Google BigQuery'ye bağlanmak için aşağıdaki adımları izleyin:

1. Veri alma deneyiminde Google BigQuery seçeneğini belirleyin. Farklı uygulamaların Power Query Online veri alma deneyimine ulaşmak için farklı yolları vardır. Power Query Online'a uygulamanızdan veri alma deneyimine nasıl ulaşabileceğiniz hakkında daha fazla bilgi için Nereden veri alınacağı bölümüne gidin.

   

2. Google BigQuery Veritabanı iletişim kutusunda yeni bir bağlantı oluşturmanız veya var olan bir bağlantıyı seçmeniz gerekebilir. Şirket içi verileri kullanıyorsanız bir şirket içi veri ağ geçidi seçin. Ardından Oturum aç'ı seçin.

   

3. Google ile oturum aç iletişim kutusu görüntülenir. Google hesabınızı seçin ve bağlanmayı onaylayın.

   Not

   Oturum açma iletişim kutusunda oturum açtıktan sonra Power BI Desktop'a devam ettiğiniz belirtilse de, bunun yerine çevrimiçi uygulamanıza gönderilirsiniz.

   

4. Herhangi bir gelişmiş seçeneği kullanmak istiyorsanız Gelişmiş seçenekler'i seçin. Daha fazla bilgi: Gelişmiş seçenekleri kullanarak bağlanma

5. Oturum açtıktan sonra devam etmek için İleri'yi seçin.

   

6. Başarıyla bağlandıktan sonra bir Gezgin penceresi görüntülenir ve sunucuda kullanılabilir olan veriler görüntülenir. Gezginde verilerinizi seçin. Ardından Power Query'de verileri dönüştürmek için İleri'yi seçin.

   

Gelişmiş seçenekleri kullanarak bağlanma

Hem Power Query Desktop hem de Power Query Online, gerekirse sorgunuza ekleyebileceğiniz bir dizi gelişmiş seçenek sağlar.

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

Gelişmiş seçenek	Açıklama
Faturalama Proje Kimliği	Power Query'nin sorgu çalıştıracağı bir proje. İzinler ve faturalama bu projeye bağlıdır. Faturalama Projesi Kimliği sağlanmazsa, varsayılan olarak Google API'leri tarafından döndürülen ilk kullanılabilir proje kullanılır.
Depolama Api'si kullanma	Google BigQuery'nin Depolama API'sini kullanmayı sağlayan bir bayrak. Bu seçenek varsayılan olarak doğrudur. Bu seçenek, Depolama API'sini kullanmamak ve REST API'lerini kullanmak için false olarak ayarlanabilir.
Bağlantı zaman aşımı süresi	Power Query'nin bağlantının tamamlanmasını ne kadar süre beklediğini denetleen standart bağlantı ayarı (saniye cinsinden). Bağlantınız 15 saniyeden (varsayılan değer) önce tamamlanmazsa bu değeri değiştirebilirsiniz.
Komut zaman aşımı süresi	Power Query'nin sorguyu tamamlayıp sonuçları döndürmesini beklediği süre. Varsayılan, sürücü varsayılan ayarına bağlıdır. Bağlantıyı daha uzun süre açık tutmak için dakikalar içinde başka bir değer girebilirsiniz.
Proje kodu	Yerel sorguları çalıştırmak istediğiniz proje. Bu seçenek yalnızca Power Query Desktop'ta kullanılabilir.
SQL statement	Bilgi için Yerel veritabanı sorgusu kullanarak veritabanından veri içeri aktarma bölümüne gidin. Yerel veritabanı sorgusu işlevinin bu sürümünde, biçiminde tam tablo adları Database.Schema.Tablekullanmanız gerekir, örneğin SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Bu seçenek yalnızca Power Query Desktop'ta kullanılabilir.

İstediğiniz gelişmiş seçenekleri belirlediğinizde, Google BigQuery verilerinize bağlanmak için Power Query Desktop'ta Tamam'ı veya Power Query Online'da İleri'yi seçin.

Sınırlamalar ve önemli noktalar

Bu bölümde, Google BigQuery bağlayıcısının sınırlamaları veya dikkat edilmesi gerekenler açıklanmaktadır.

Power BI Desktop'ta Google BigQuery'ye bağlanma

Power BI ile Google BigQuery bağlayıcısını kullanırken dikkat edilmesi gereken birkaç sınır ve önemli nokta vardır.

Bağlayıcı kullanılabilirliği

Google BigQuery bağlayıcısı Power BI Desktop'ta ve Power BI hizmeti kullanılabilir. Power BI hizmeti bağlayıcıya Power BI'dan Google BigQuery'ye buluttan buluta bağlantı kullanılarak erişilebilir.

"Erişim Reddedildi" hatası

Power BI Desktop'tan Google BigQuery'ye bağlanmaya çalıştığınızda aşağıdaki hata iletisini alabilirsiniz:

Datasource.Error: ODBC: ERROR [HY000][Microsoft][BigQuery] (100) Error interacting with REST API: Access Denied: Project <project name>: The user <user name> bigquery.jobs.create permissions in project <project name>.

Bu durumda, Power Query Bağlantısı ayarlarındaki Faturalama Projesi gelişmiş seçeneğine Faturalama Projesi Kimliği girmeniz gerekebilir.

Ayrıca, ağ geçidi kullanarak Power BI hizmeti'de de rapor oluşturursanız bu hatayı almaya devam edebilirsiniz. Bu durumda, Power Query düzenleyicisini veya Power Query formül çubuğunu kullanarak bağlantının M koduna Faturalama Projesi Kimliğini el ile eklemeniz gerekir. Örneğin:

Source = GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"])

İç içe alanlar

Performansla ilgili dikkat edilmesi gereken noktaları iyileştirmek için Google BigQuery normalleştirilmiş, düzleştirilmiş ve iç içe yerleştirilmiş büyük veri kümelerinde iyi bir performans sergiler.

Google BigQuery bağlayıcısı, JSON biçiminde metin sütunları olarak yüklenen iç içe alanları destekler.

Kullanıcılar Verileri Dönüştür'ü seçip verileri ayıklamak için Power Query Düzenleyicisi JSON ayrıştırma özelliklerini kullanmalıdır.

1. Dönüşümler şerit sekmesinin Metin Sütunu kategorisi altında Ayrıştır'ı ve ardından JSON'ı seçin.
2. Sütunu Genişlet seçeneğini kullanarak JSON kayıt alanlarını ayıklayın.

Google hizmet hesabı ayarlama

Google hizmet hesaplarını ayarlama veya kullanma hakkında daha fazla bilgi için Google belgelerinde hizmet hesabı anahtarlarını oluşturma ve yönetme bölümüne gidin.

Google hizmet hesabı üzerinden kimlik doğrulaması

Power BI Desktop'ta bir Google hizmet hesabı üzerinden kimlik doğrulaması yaptığınızda, bağlayıcının gerektirdiği belirli bir kimlik bilgisi biçimi vardır.

• Hizmet Hesabı E-postası: e-posta biçiminde olmalıdır
• Hizmet Hesabı JSON anahtarı dosya içeriği: Bu JSON anahtarı indirildikten sonra, içeriğin tek satırda olması için tüm yeni satırların dosyadan kaldırılması gerekir. JSON dosyası bu biçimde olduğunda, içerik bu alana yapıştırılabilir.

Power BI hizmeti veya Power Query Online'da bir Google hizmet hesabı üzerinden kimlik doğrulaması yaptığınızda, kullanıcıların "Temel" kimlik doğrulamasını kullanması gerekir. Kullanıcı adı alanı Hizmet Hesabı E-posta alanıyla, Parola alanı ise Hizmet Hesabı JSON anahtar dosyası içeriği alanıyla eşler. Her kimlik bilgisi için biçim gereksinimleri hem Power BI Desktop, Power BI hizmeti hem de Power Query Online'da aynı kalır.

Google BigQuery Depolama API'siyle kimlik doğrulaması yapılamıyor

Google BigQuery bağlayıcısı varsayılan olarak Google BigQuery Depolama API'sini kullanır. Bu özellik UseStorageApi adlı gelişmiş seçenek tarafından denetlenir. Ayrıntılı izinler kullanıyorsanız bu özellikle ilgili sorunlarla karşılaşabilirsiniz. Bu senaryoda, aşağıdaki hata iletisini görebilir veya sorgunuzdan veri alaamayabilirsiniz:

ERROR [HY000] [Microsoft][BigQuery] (131) Unable to authenticate with Google BigQuery Storage API. Check your account permissions

BigQuery Depolama API'sinin kullanıcı izinlerini doğru ayarlayarak bu sorunu çözebilirsiniz. BigQueryStorage API'siyle verilere doğru şekilde erişmek için bu depolama API'si izinleri gereklidir:

• bigquery.readsessions.create: BigQuery Depolama API'sini kullanarak yeni bir okuma oturumu oluşturur.
• bigquery.readsessions.getData: BigQuery Depolama API'sini kullanarak bir okuma oturumundan verileri okur.
• bigquery.readsessions.update: BigQuery Depolama API'sini kullanarak okuma oturumunu güncelleştirir.

Bu izinler genellikle rolde BigQuery.User sağlanır. Daha fazla bilgi, Google BigQuery Önceden Tanımlanmış roller ve izinler

Yukarıdaki adımlar sorunu çözmezse BigQuery Depolama API'sini devre dışı bırakabilirsiniz.

DateTime türü verileri Doğrudan Sorgu modunda kullanılamıyor

DateTime türünün Direct Query aracılığıyla desteklenmediği bilinen bir sorun vardır. DateTime türüne sahip bir sütunun seçilmesi "Geçersiz sorgu" hatasına veya görsel hataya neden olur.

Tablo adıyla aynı ada sahip sütunu sorgulamayla ilgili sınırlamalar

Tablo adıyla aynı ada sahip bir sütunu sorgularken, BigQuery sütunu belirtilen sütun yerine tablodaki tüm sütunları içeren bir struct olarak yorumlar. Örneğin, SELECT debug FROM dataset.debug belirtilen hata ayıklama sütunu yerine hata ayıklama tablosundaki tüm sütunları içeren bir struct döndürür. Bu davranış sezgisel değildir ve bir düzeltme araştırılmaktadır. Üç geçici çözüm vardır:

• Geçici çözüm 1: Tabloyu sütun adıyla çakışmayan bir görünümle sarmalama—CREATE VIEW dataset.new_view AS SELECT * FROM dataset.debug
• Geçici çözüm 2: Tablo adıyla çakışmaları önlemek için sütunu yeniden adlandırın—ALTER TABLE dataset.debug RENAME COLUMN debug to new_debug
• Geçici çözüm 3: Çakışma sütununa başvurmak için SELECT sorgusunu table.column kullanacak şekilde değiştirin—SELECT debug.debug FROM dataset.debug

Power BI Desktop gezgininde gerçekleştirilmiş görünümler desteklenmez

Bilinen bir sorun, Google BigQuery bağlayıcısının şu anda Power BI Desktop gezgininde gerçekleştirilmiş görünümleri desteklememesidir.

• Geçici çözüm: Google BigQuery'den gerçekleştirilmiş görünümleri getirmek için yerel sorgu SQL deyimlerini kullanın.

HTTP Hatası 403: quotaExceeded (Kota aşıldı: Kullanıcınız eşzamanlı project.lists istekleri için kotayı aştı)

• Project.lists API'sinin Google'a çağrılarının müşteri hesabı kullanımı genelinde kota aşılır. Aynı anda birden çok rapor yenilendiğinde, farklı sorgularda veya raporlarda hata tetiklenebilir. Hatayı önlemek için, rapor yenilemelerini aşamalı aralıklarla zamanlayın.
• Sorguyu Faturalama Proje Kimliği GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"])- içerecek şekilde güncelleştirin.
• Hatadan kaçınmak için çağrısının GoogleBigQuery.Database şema ve tablo seçimiyle aynı sorguda olması gerekir.