Google BigQuery (veri analizi platformu)

Özet

Ürün	Açıklama
Sürüm 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ı) Müşteri İçgörüleri (Veri Akışları)
Desteklenen Kimlik Doğrulama Türleri	Kuruluş hesabı Hizmet hesabı

Uyarı

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

Important

Bu bağlayıcı ekli Simba Google BigQuery ODBC sürücüsünden BigQuery 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ş.

Google BigQuery bağlayıcı sürümleri

Power Query, Google BigQuery bağlayıcısının iki uygulamasını destekler:

• V1 (ODBC tabanlı) – ODBC tabanlı eski uygulama.
• V2 (ADBC tabanlı) – Apache Arrow Veritabanı Bağlantısı (ADBC) üzerinde oluşturulan ve büyük analitik iş yükleri için gelişmiş performans, güvenilirlik ve ölçeklenebilirlik sunmak üzere tasarlanmış yeni uygulama.

V2 bağlayıcısı, desteklenen deneyimlerdeki yeni iş yükleri için önerilen seçenektir. V2 bağlayıcısı özelliği hakkında daha fazla bilgi edinin.

Ö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

• Ithalat
• DirectQuery (Power BI anlamsal modeller)

Power Query Desktop'tan Google BigQuery verilerine bağlanma

Uyarı

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üncellemeniz gerekir.

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

1. Veri alma deneyiminde Google BigQuery 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 Where adresine giderek veri alın.

2. Eğer herhangi bir gelişmiş seçeneği kullanmak istiyorsanız, gelişmiş seçeneklerolan seçeneği seçin. Aksi takdirde devam etmek için Tamam seçin. Daha fazla bilgi için gelişmiş seçenekleri kullanarak 'a bağlanıngidin.

   

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ı kullanılır. Devam etmek için Oturum Aç'ı seçin.

   

   Google hizmet hesabı kullanarak da oturum açabilirsiniz. Bu durumda, hizmet hesabı oturum açma 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 bulunan veriler görüntülenir. Gezginde verilerinizi seçin. Ardından Transform Data öğesini seçerek verileri Power Query veya Load Power BI Desktop'a yükleyin.

   

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, Power Query Çevrimiçi veri alma deneyimine ulaşmak için farklı yöntemlere sahiptir. Uygulamanızda Power Query Online'dan veri alma deneyimi hakkında daha fazla bilgi için Veriyi nereden alabilirsiniz 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. Oturum açmak için bir kuruluş veya hizmet hesabı seçin. Ş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.

   Uyarı

   Oturum açma iletişim kutusunda, oturum açtıktan sonra Power BI Desktop'a devam edeceğiniz söyleniyor; ancak bunun yerine çevrimiçi uygulamanıza yönlendiriliyorsunuz.

   

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

5. Oturum açtıktan sonra devam etmek için Sonraki seçin.

   

6. Başarıyla bağlandıktan sonra bir Gezgin penceresi görüntülenir ve sunucuda bulunan veriler görüntülenir. Gezginde verilerinizi seçin. Ardından İleri seçerek verileri Power Query dönüştürün.

   Google BigQuery verilerini çevrimiçi uygulamaya yükleyen Power Query gezgininin ekran görüntüsü.

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
Hesap Fatura Proje Kimliği	Power Query'nin sorguları çalıştırdığı bir proje. İzinler ve faturalama bu projeye bağlıdır. Faturalama Proje 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 'inDepolama API'sinin kullanılmasını sağlayan 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 bağlantının tamamlanmasını ne kadar süreyle bekleyeceğ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 sorguyu tamamlayıp sonuçları döndürmesini ne kadar süreyle bekler? 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 ID	Yerel sorguları çalıştırmak istediğiniz proje.
SQL deyimi	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, Database.Schema.Tablebiçiminde tam tablo adları kullanmanı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 OK veya Power Query Online'da Next seçeneğini belirleyin.

Yeni Google BigQuery bağlayıcı uygulaması

Mayıs 2025'ten bu yana Google BigQuery ile tümleştirmeyi geliştirmek amacıyla Google BigQuery bağlayıcısı için yeni bir uygulama kullanıma sunuldu. Google BigQuery'ye bağlanmak ve bu verilerden veri almak için ODBC yerine Ok Veritabanı Bağlantısı (ADBC) kullanır ve bu da özellikle büyük sonuç kümelerinde performansı artırır. Bu bağlayıcıyı geliştirmeye ve yeni özellikler eklemeye devam ettikçe, denemek ve bize geri bildirim sağlamak için en son sürüme yükseltmenizi öneririz.

Uyarı

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

Power BI Desktop'ta bu özelliğe erişmek için Seçenekler ve ayarlar (File sekme) OptionsÖnerme özellikleri, ve ardından Yeni Google BigQuery bağlayıcı uygulamasını kullan seçeneğini etkinleştirmek için onay kutusunu seçin. Seçenek açık olduğunda, yeni oluşturulan tüm bağlantılar otomatik olarak yeni bağlayıcı uygulamasını kullanır.

Mevcut bağlantılarınız değişmeden kalır. Özelliği, sorgularınızda Implementation="2.0" bayrağını GoogleBigQuery.Database olarak aşağıdaki şekilde ekleyerek deneyebilirsiniz. Bu özellik, kullanmakta olduğunuz bağlayıcının sürümünü ayırt eder.

Dataflow 2. Nesil'deki bu özelliğe erişmek için, Google BigQuery'den veri almayı yapılandırdıktan sonra üst şeritteki Gelişmiş düzenleyici'ye gidin ve bu yeni bağlayıcıyı Implementation="2.0" kullanmak için sorgularınıza aşağıdaki bayrağı GoogleBigQuery.Database ekleyin.

Source = GoogleBigQuery.Database([Implementation = "2.0"])

Uyarı

Şirket içi veri ağ geçidini kullandığınızda desteklenen en düşük sürümün Mayıs 2025 olduğuna dikkat edin. Bu özelliği en güncel özelliklerle değerlendirmek için en son sürümü kullanmanız önerilir.

Olası sorunları tanılamaya yardımcı olmak için, Mashup günlüklerinizde Implementation olarak "2.0" ve DriverType olarak "ADBC" bulabilirsiniz.

Şu anda bu bağlayıcı aşağıdaki bilinen sınırlamalara sahiptir:

• İlişkiler desteklenmez.
• Proxy desteklenmez.

Sınırlamalar ve dikkat edilmesi gerekenler

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

Google BigQuery bağlayıcısını Power BI 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'den 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 Faturalama Projesi gelişmiş seçeneğine bir Faturalama Proje Kimliği girmeniz gerekebilir.

Ayrıca, ağ geçidi kullanarak Power BI hizmeti'da da 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 Project Kimliğini el ile eklemeniz gerekir. Örneğin:

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

Tek bulut bağlantısı desteği

Google BigQuery birden fazla bulut bağlantısını desteklemez çünkü birden fazla yapılandırmaya yönelik parametre alanı yoktur. Sonuç olarak, yalnızca tek bir bulut bağlantısı kullanılabilir.

İç 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 Transform Data öğesini seçip Power Query düzenleyicisindeki JSON ayrıştırma özelliklerini kullanarak verileri ayıklamalıdır.

1. Dönüşümler şerit sekmesindeki Metin Sütunu kategorisi altında Ayrıştır'ı ve ardından JSON'u 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 gidin.

Gezgin tüm projeleri veya veri kümelerini göstermiyor

Gezgin penceresi yalnızca kimliği doğrulanmış kullanıcının yeterli Google Cloud Platform (GCP) izinlerine sahip olduğu projeleri ve veri kümelerini görüntüler. Verilere yerel sorgular aracılığıyla erişebilirsiniz ancak bazı projeler veya veri kümeleri Gezgin'de görünmüyorsa aşağıdakileri denetleyin:

• Bağlantıyı kurarken veri projesine değil faturalama projenize bağlanın.
• Kullanıcının Gezgin'de listelenen projeleri görmek için proje düzeyinde Tarayıcı rolüne (veya eşdeğerine) ihtiyacı vardır. Bu rol olmadan, kullanıcı veri kümesi düzeyinde erişime sahip olsa bile sürücü projeyi numaralandıramaz.
• Veri projesini seçtikten sonra yalnızca kullanıcıya erişim verilmiş veri kümeleri görüntülenir.
• BigQuery Meta Veri Görüntüleyicisi rolünün yalnızca veri kümesi düzeyinde verilmesi, projelerin Gezgin'de görünmesi için yeterli değildir. Rol proje düzeyinde verilmelidir veya bunun yerine proje düzeyinde Tarayıcı rolü atanmalıdır.

Google hizmet hesabı üzerinden kimlik doğrulaması

Power BI Desktop'ta bir Google hizmet hesabı aracılığıyla 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, UseStorageApiadlı 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 okuma oturumundaki verileri okur.
• bigquery.readsessions.update: BigQuery Depolama API'sini kullanarak okuma oturumunu güncelleştirir.

Bu izinler genellikle BigQuery.User rolünde sağlanır. Daha fazla bilgi için Google BigQuery Önceden Tanımlanmış roller ve izinlersayfasına gidin.

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 Invalid query hatasına veya görsel hataya neden olur.

Tablo adıyla aynı isme sahip sütunu sorgulamaya yönelik 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 kolon adıyla çakışmayan bir görünümle sarmak—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

Gerçekleştirilmiş görünümler Power BI Masaüstü gezgininde desteklenmez

Bilinen bir sorun, Google BigQuery bağlayıcısının şu anda Power BI Masaüstü 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ı)

• Müşteri hesabı genelinde, Google'a yapılan project.lists API çağrılarının kullanımı kotayı aşmaktadı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 Fatura Projesi Kimliği - GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"]) içerecek şekilde güncelleyin.
• GoogleBigQuery.Database çağrıları, hatadan kaçınmak için şema ve tablo seçimiyle aynı sorguda olmalıdır.

ADBC kullanılırken ExecuteQueryInternalAsync hatası

Bazı kullanıcılar yolu kullanarak Implementation="2.0" BigQuery'ye bağlanırken sorunlarla karşılaşabilir ve hatasını Cannot execute <ExecuteQueryInternalAsync>b__2 after 5 triesalabilir. Bu sorun birkaç faktörden kaynaklanıyor olabilir:

• Aşağıdaki bölümde ele alınan izin sorunu.
• Geçirilirse LargeResultDataset , sürücü sağlanan adla çıkış veri kümesini oluşturmayı dener. Bu oluşturma işlemi için doğru izinler gerekir.
• Veri kümesi oluşturma sırasında açıkça hiçbir bölge belirtilmediğinde BigQuery API'sinin varsayılan olarak ABD çoklu bölgesi olur. Bu davranış, bağlayıcı veya istemci yapılandırması tarafından değil API tarafından yönlendirilir.

Geçici Çözüm Seçenekleri

El ile Veri Kümesi Oluşturma

Beklenmeyen bölge varsayılanlarını önlemek için BigQuery Konsolu'nu kullanarak veri kümesini istediğiniz bölgede el ile oluşturun.

Masaüstü Bağlayıcı yapılandırması

Power BI Desktop kullanıyorsanız ve tablolarda gezinirken hatalarla karşılaşıyorsanız:

1. Dosya>Seçenekleri ve ayarları>Seçenekleri'ne gidin
2. Önizleme özellikleri'nin altında Yeni Google BigQuery bağlayıcısı uygulamasını kullan seçeneğinin işaretini kaldırın.

Bu mesajı ve Last exception: ... arızanın ek ayrıntılarını içeren ... ile alırsanız, daha fazla araştırma için bir vaka oluşturun.

ADBC'ye bağlanma izin sorunları

Bazı ortamlar /ADBC kullanarak Implementation="2.0"bağlanmak için ek izinler gerektirebilir. Bunun nedeni, ADBC yolunun verileri sorgulamak ve yüklemek için ODBC'den farklı BigQuery API'leri kullanmasıdır. Gerekli izinler sürücünün GitHub deposunda özetlenmiştir.

Bölümlenmiş modeller ADBC ile yenilenemiyor

Google BigQuery bağlayıcısında bilinen bir sorun, bölümlenmiş anlamsal modellerin doğru şekilde yenilenemeyebilir olmasıdır. Bu genellikle Cannot execute <ReadChunkWithRetries>b__0 after 5 tries hatasıyla kendini gösterir. Bu sorun için yeni bir düzeltme yayımlandı ve Ekim 2025'te dağıtılmalıdır. Bu mesajı ve Last exception: ... arızanın ek ayrıntılarını içeren ... ile alırsanız, daha fazla araştırma için bir vaka oluşturun.