Oracle Database

Özet

Ürün	Açıklama
Sürüm Durumu	Genel Kullanılabilirlik
Ürünler	Excel Power BI (Anlam modelleri) Power BI (Veri Akışları) Veri Yapısı (Veri Akışı Gen2) Power Apps (Veri Akışları) Dynamics 365 Müşteri İçgörüleri Analiz Servisleri
Desteklenen Kimlik Doğrulama Türleri	Windows (masaüstü/çevrimiçi) Veritabanı (masaüstü) Temel (çevrimiçi) Microsoft hesabı (masaüstü)
İşlev Başvurusu Belgeleri	Oracle.Database

Uyarı

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

Önkoşullar

Desteklenen Oracle sürümleri:

• Oracle Database Server 12c (12.1.0.2) ve üzeri
• Oracle Otonom Veritabanı - tüm sürümler

Power Query kullanarak bir Oracle veritabanına bağlanabilmeniz için önce Microsoft Araçları için Oracle İstemcisi'ni (OCMT) yüklemeniz gerekir. Şirket içi veri ağ geçidi ile bir Oracle veritabanına bağlanmak için ağ geçidini çalıştıran bilgisayara 64 bit OCMT yüklenmelidir. Daha fazla bilgi için Bkz. Veri kaynağınızı yönetme - Oracle.

Uyarı

Power BI Desktop'ın Nisan 2025 sürümünden ve şirket içi veri ağ geçidinin Mayıs 2025 sürümünden bu yana, şu anda önizleme aşamasında olan Oracle veritabanına bağlanmak için yerleşik Oracle yönetilen ODP.NET sürücüsünü kullanmaya yönelik yeni bir seçenek sunuyoruz. Özellik etkinleştirildiğinde, OCMT'yi el ile yüklemeniz gerekmez. Bu özellik hakkında daha fazla bilgi edinin.

Desteklenen Özellikler

• İthalat
• DirectQuery (Power BI anlam modelleri)
• Gelişmiş seçenekler
  • Dakika cinsinden komut zaman aşımı
  • SQL deyimi
  • İlişki sütunlarını ekle
  • Tam hiyerarşi kullanarak gezinme

Microsoft Araçları için Oracle İstemcisi'ni indirme ve yükleme

Microsoft Araçları için Oracle İstemcisi, Oracle Otonom Veritabanı (ADB) dahil olmak üzere Oracle şirket içi ve bulut veritabanlarıyla 32 bit ve 64 bit Microsoft araç bağlantılarını desteklemek üzere .NET (ODP.NET) için Oracle Veri Sağlayıcısı'nı yükler ve yapılandırr. OCMT, Oracle Veritabanı İstemcisi kurulum işlemini otomatik hale getiren bir grafik yükleyicidir. Power BI Desktop, Power BI hizmeti, Doku (Veri Akışı 2. Nesil), Excel, SQL Server Analysis Services, SQL Server Veri Araçları, SQL Server Integration Services, SQL Server Reporting Services ve BizTalk Server ile bağlanmayı destekler.

OCMT ücretsiz bir yazılımdır. Microsoft Araçları için Oracle İstemcisi sayfasından indirilebilir. 64 bit Power BI Desktop ve Power BI hizmeti için 64 bit OCMT kullanın. 32 bit Power BI Desktop için 32 bit OCMT kullanın.

Power BI istemcinizde zaten bir Oracle İstemcisi veya ODP.NET yüklü olsa bile, Power BI'ın Oracle veritabanıyla çalışması için gereken tüm yapılandırma adımlarını düzgün bir şekilde tamamlamak için OCMT yükleyicisini kullanmanızı kesinlikle öneririz.

• OCMT 64 bit ve 32 bit indirmeler
• OCMT yükleme ve kurulum yönergeleri

Power Query Desktop'tan şirket içi Oracle veritabanına bağlanma

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

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

2. Sunucu'ya bağlanmak için Oracle net hizmet adını/TNS diğer adını veya Easy Connect Plus bağlantı dizesini belirtin. Kolay Bağlantı, Sunucu değerini Oracle Veritabanı sunucunuzun Hostname/ServiceName değerine ayarlayarak en kolay şekilde kullanılabilir. Burada ServiceName , genel veritabanı adıdır. Aşağıdaki ekran görüntüsünde bir net hizmet adı kullanılmıştır.

   

3. Power BI Desktop'tan bağlanıyorsanız İçeri Aktarma veya DirectQuery veri bağlantısı modunu seçin. Bu örnek adımların geri kalanında Verileri içeri aktarma bağlantı modu kullanılır. DirectQuery hakkında daha fazla bilgi edinmek için Power BI Desktop'ta DirectQuery kullanma bölümüne gidin.

4. Bu Oracle veritabanına ilk kez bağlanıyorsanız, kullanmak istediğiniz kimlik doğrulama türünü seçin ve kimlik bilgilerinizi girin. Kullanılabilir kimlik doğrulama türleri şunlardır:

   • Windows (Windows kimlik doğrulaması)
   • Veritabanı (Kullanıcı adı ve parola)
   • Microsoft hesabı (Microsoft Entra Id)

   Kimlik doğrulaması hakkında daha fazla bilgi içinveri kaynağıyla Kimlik Doğrulaması bölümüne gidin.

   

5. Gezgin'de ihtiyacınız olan verileri seçin, ardından verileri yüklemek için Yükle'yi veya verileri dönüştürmek için Verileri Dönüştür'ü seçin.

Power Query Online'dan şirket içi Oracle veritabanına bağlanma

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

1. Şirket içi veri ağ geçidini yükleme ve ayarlama.

2. Power Query Online'da veri kaynakları seçiminde Oracle veritabanı seçeneğini belirleyin.

3. Görüntülenen Oracle veritabanı iletişim kutusunda Oracle net service name/TNS diğer adını, Easy Connect Plus bağlantı dizesini veya Sunucu'da bağlanılacak bağlantı tanımlayıcısını belirtin.

   

4. "testoracleserver" gibi bir Bağlantı adı sağlayın.

5. Şirket içi veri ağ geçidinizin adını seçin.

   Uyarı

   Oracle veritabanı yerel ağınızda veya bir web sitesinde olsun, bu bağlayıcı için bir şirket içi veri ağ geçidi seçmeniz gerekir.

6. Bu Oracle veritabanına ilk kez bağlanıyorsanız Kimlik doğrulama türünde bağlantı için kimlik bilgileri türünü seçin. Oracle kullanıcı adı ve parolası ile oturum açmayı planlıyorsanız Temel'i seçin. Windows işletim sistemi kimlik doğrulamasını kullanırken ve hem Oracle istemcisi hem de Windows üzerinde çalışan sunucu ile Windows'u seçin.

7. Kimlik bilgilerinizi girin.

8. Devam etmek için İleri'yi seçin.

9. Gezgin'de, ihtiyacınız olan verileri seçin ve ardından Power Query Düzenleyicisi'nde verileri dönüştürmek için Verileri dönüştür'ü seçin.

Oracle Otonom Veritabanına bağlanma

Uyarı

Şu anda bu bölümdeki yordamları kullanarak Excel, Power BI Desktop, Power BI hizmeti, Doku (Veri Akışı 2. Nesil), Power Apps, SQL Server Analysis Services ve BizTalk Server'dan Oracle Otonom Veritabanına bağlanabilirsiniz. Bu araçlar bağlanmak için yönetilmeyen ODP.NET kullanır. SQL Server Veri Araçları, SQL Server Integration Services ve SQL Server Reporting Services gibi diğer Microsoft araçları, büyük ölçüde benzer yordamlar kullanarak Oracle Otonom Veritabanı'na bağlanmak için yönetilen ODP.NET kullanır.

Power BI'ı oracle otonom veritabanına bağlamak için aşağıdaki hesaplara ve uygulamalara ihtiyacınız vardır:

• Oracle.com hesabı (Oracle.com Hesap Kaydı)
• Oracle Cloud hesabı (Oracle Cloud Account Signup)
• Oracle Otonom Veritabanı (Her Zaman Ücretsiz Otonom Veritabanı Alın)
• Power BI Desktop (Power BI Desktop'ı edinin) veya Power BI hizmet hesabı (Kuruluşunuzdaki kullanıcılar için Power BI hizmetini lisanslama)
• Power BI hizmeti kullanılıyorsa şirket içi veri ağ geçidi (Standart ağ geçidini indirme ve yükleme)

İstemci kimlik bilgilerinizi indirme

Oracle Otonom veritabanına bağlantı kurmanın ilk adımı, istemci kimlik bilgilerinizi indirmektir.

İstemci kimlik bilgilerinizi indirmek için:

1. Oracle Otonom veritabanı ayrıntıları sayfanızda DB Bağlantısı'nı seçin.

   

2. Veritabanı Bağlantısı sayfasında Cüzdan İndir'i seçin.

   

3. Bu cüzdanla kullanmak istediğiniz parolayı girin, parolayı onaylayın ve ardından İndir'i seçin.

   

Oracle ADB kimlik bilgilerini yapılandırma

1. Windows makinenizde, İstemci kimlik bilgilerinizi indirme sayfasından Oracle ADB kimlik bilgilerinizi indirdiğiniz klasöre gidin.

2. Kimlik bilgilerini OCMT'de Oracle Yapılandırma Dosyası Dizini olarak belirttiğiniz dizine çıkarın. Bu örnekte kimlik bilgileri c:\data\wallet\wallet_contosomart olarak ayıklanır.

   

   Uyarı

   tnsnames.ora dosyası Oracle Otonom Veritabanı adresinizi ve bağlantı bilgilerinizi tanımlar.

3. sqlnet.ora dosyasını Not Defteri gibi bir düzenleyicide açın.

4. WALLET_LOCATION altında Dizin seçeneğinin altındaki cüzdan klasörünüz yolunu değiştirin. Bu örnekte:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

5. sqlnet.ora dosyasını kaydedin ve kapatın.

Wallets klasöründeki tnsnames.ora dosyasını açın. Dosya, bağlanabileceğiniz ADB net hizmet adlarının listesini içerir. Bu örnekte adlar contosomart_high, contosomart_low ve contosomart_medium. ADB net hizmetinizin adları farklıdır.

Power BI Desktop'ı Oracle ADB'ye bağlama

1. Power BI Desktop'i açın.

2. Veri Al'ı seçin.

3. Veri Al'danVeritabanı>Oracle veritabanı'yı seçin.

4. Bağlanmak istediğiniz Oracle Otonom Veritabanı sunucusunun net hizmet adını girin. Bu örnekte Sunucu contosomart_high. Ardından Tamam'ı seçin.

   

5. Power BI Desktop'tan bu sunucuda ilk kez oturum açıyorsanız kimlik bilgilerinizi girmeniz istenir. Veritabanı'nı seçin, ardından Oracle veritabanının kullanıcı adını ve parolasını girin. Buraya girdiğiniz kimlik bilgileri, bağlanmak istediğiniz oracle otonom veritabanı için kullanıcı adı ve paroladır. Bu örnekte veritabanının ilk yönetici kullanıcı adı ve parolası kullanılır. Ardından Bağlan'ı seçin.

   

   Uyarı

   Microsoft Hesabı seçeneği aracılığıyla Oracle Otonom Veritabanı'nda oturum açmak için Microsoft Entra Id kimlik doğrulamasını kullanabilirsiniz.

Bu noktada Gezgin görüntülenir ve bağlantı verilerini görüntüler.

Yapılandırma düzgün ayarlanmadığı için birkaç hatadan biriyle de karşılaşabilirsiniz. Bu hatalar Sorun Giderme bölümünde ele alınıyor.

Bu ilk testte oluşabilecek bir hata, veritabanının bağlı gibi göründüğü ancak veri içermediği Gezgin'de gerçekleşir. Bunun yerine, verilerin yerine bir Oracle: ORA-28759: dosya açılamıyor hatası görüntülenir.

Bu hata oluşursa, sqlnet.ora dosyasında sağladığınız cüzdan klasör yolunun cüzdan klasörünün tam ve doğru yolu olduğundan emin olun.

Ağ geçidini yapılandırma

1. Şirket içi veri ağ geçidini yükleme ve ayarlama.

2. Power BI hizmetinde sağ üst taraftaki dişli simgesini ve ardından Ağ geçitlerini yönet'i seçin.

   

3. Veri Kaynağı Ekle bölümünde Veri kaynağı ekle'yi seçerek ağ geçidini kullanın.

   

4. Veri Kaynağı Adı'nda, veri kaynağı ayarı olarak kullanmak istediğiniz adı girin.

5. Veri Kaynağı Türü'ndeOracle'ı seçin.

6. Sunucu'da, bağlanacak Oracle Otonom Veritabanı sunucusunun net hizmet adını girin.

7. Kimlik Doğrulama Yöntemi'ndeTemel'i seçin.

8. Oracle Otonom Veritabanı için kullanıcı adını ve parolayı girin. Bu örnekte, varsayılan veritabanı yöneticisi kullanıcı adı (ADMIN) ve parola kullanılır.

9. Ekle'yi seçin.

   

Her şey doğru yüklenmiş ve yapılandırılmışsa, Bağlantı Başarılı iletisi görüntülenir. Artık Power Query Online'dan şirket içi Oracle veritabanına bağlanma bölümünde açıklanan adımları kullanarak Oracle Otonom Veritabanı'na bağlanabilirsiniz.

Gelişmiş seçenekleri kullanarak bağlanma

Power Query Desktop ve 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
Dakika cinsinden komut zaman aşımı	Bağlantınız 10 dakikadan uzun sürüyorsa (varsayılan zaman aşımı), bağlantıyı daha uzun süre açık tutmak için dakika cinsinden başka bir değer girebilirsiniz. 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.
İ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örünmez.
Tam hiyerarşi kullanarak gezinme	İşaretlenirse gezgin, bağlandığınız veritabanındaki tabloların tam hiyerarşisini görüntüler. Eğer temizlenirse, gezinici yalnızca sütunları ve satırları veri içeren tabloları görüntüler.

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

Yerleşik Oracle sürücüsünü kullanma (Önizleme)

Power BI Desktop'ın Nisan 2025 sürümünden ve şirket içi veri ağ geçidinin Mayıs 2025 sürümünden bu yana Oracle bağlayıcısı, bağlantı için yerleşik bir Oracle yönetilen ODP.NET sürücüsü içerir. Bu özellik, kullanıcıların sürücüyü yükleme ve yönetme gereksinimini ortadan kaldırır. Aşağıdaki yönergeleri kullanarak bu özelliği etkinleştirebilirsiniz.

Bu yerleşik sürücüyü Power BI Desktop'ta kullanmak için Seçenekler ve ayarlar ( Dosya sekmesinin altında) >Seçenekler>Önizleme özellikleri'ne gidin ve ardından İçeri Aktarma Modu için Paketlenmiş Oracle Yönetilen ODP Sağlayıcısını kullanarak etkinleştir seçeneğini etkinleştirmek için onay kutusunu seçin.

Bu yerleşik sürücüyü şirket içi veri ağ geçidinde kullanmak için ağ geçidi yapılandırmalarını değiştirerek aşağıdaki adımları kullanarak ayarı güncelleştirin MashupFlight_EnableOracleBundledOdacProviderV2 :

1. Şirket içi veri ağ geçidinin yüklü olduğu yerel makinede C:\Program Files\Şirket içi veri ağ geçidiadresine gidin.
2. Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configadlı yapılandırma dosyasını yedekleyin.
3. Özgün Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config yapılandırma dosyasını açın ve MashupFlight_EnableOracleBundledOdacProviderV2 girdisini bulun.
4. MashupFlight_EnableOracleBundledOdacProviderV2 değerini True olarak güncelleyin.
5. Ağ geçidinizi yeniden başlatın.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_EnableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Yerleşik Oracle sürücüsüyle TNS_ADMIN belirtmenin desteklenen yolları (Mart 2026 sürümü ve üzeri)

TNS_ADMIN belirtmek için üç seçenek vardır:

• OADC.config'de TNS_ADMIN yapılandırma
• Ortam değişkeni kullanma
• Önceden yüklenmiş bir OADC'den ayarları kullanma

ODAC.config'de TNS_ADMIN yapılandırma

Yerleşik Oracle Sürücüsü kullanıyorsanız ve program dosyalarını değiştirmeye erişiminiz varsa, Yerleşik Oracle Driver tarafından kullanılan ODAC.config yapılandırma dosyasında TNS_ADMIN belirtebilirsiniz. Dosya, "ADO.NET Sağlayıcıları" alt klasörünün altında Power BI Desktop'ta veya şirket içi veri ağ geçidi yüklü konumunda bulunur. Aşağıda , "C:\network\admin" olan TNS_ADMIN yolu belirtme örneği verilmiştir.

Bu yapılandırma değeri diğer seçeneklerden önceliklidir.

Örnek yapılandırma

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

ODAC.config içinde yapılandırılan TNS_ADMIN, ortamda tanımlanan bir TNS_ADMIN ayarını geçersiz kılar.

Ortam değişkeni kullanma

Kullanıcı ODAC.config dosyasını değiştirme erişimine sahip değilse, TNS_ADMIN çevresel değişkeni ekleyerek TNS_ADMIN'i belirtebilir. Ortam değişkeni, Power BI Desktop veya Şirket İçi Veri Ağ Geçidi çalıştıran kullanıcı için bir sistem ortam değişkeni veya kullanıcı ortam değişkeni olabilir. örneğin, TNS_ADMIN değerini "C:\network\admin" olarak ayarlayın.

Ortamda (özellikle sistem düzeyinde) TNS_ADMIN ayarlanması, bu makinede çalışan diğer uygulamaların ağ yapılandırma dosyalarını (tnsnames.ora gibi) TNS_ADMIN işaret ettiği konumdan almasına neden olabilir.

Önceden yüklenmiş bir ODAC'deki ayarları kullanma

ODAC önceden yüklenmişse ve TNS_ADMIN yapılandırılmışsa Power BI otomatik olarak TNS_ADMIN bulur.

Power Query Desktop'tan bir Oracle veritabanına bağlanmak için kalan yapılandırmalar, önceki bölümlerde açıklanan yapılandırmalarla aynıdır.

Uyarı

Önemli sınırlamalar

• Anlam modeli DirectQuery, bağlantı için yerleşik Oracle yönetilen ODP.NET sürücüsünü kullanamaz. MashupFlight_EnableOracleBundledOdacProviderV2 , DirectQuery anlam modeli üzerinde geçerli değildir.
• Dosya ODAC.config düzenlemek için yönetici hakları gerekebilir ve Power BI Mağazası uygulaması bu dosyanın değiştirilmesine izin vermez.
• Şirket İçi Veri Ağ Geçidi'nin düzgün çalışması için, ağ geçidi hizmetinin çalıştığı kullanıcının TNS_ADMIN tarafından işaret edilen klasöre erişimi olduğundan emin olun.
• Yapılandırma değişikliklerini uyguladıktan sonra Power BI Desktop veya Şirket İçi Veri Ağ Geçidi hizmetini yeniden başlatın.

Sınırlamalar ve Dikkat Edilecek Hususlar

Power BI oturumları, Oracle veritabanınızda anlamsal model yenilemesi sonrasında yaklaşık 30 dakika boyunca oracle veritabanınızda etkin olmaya devam edebilir. Yalnızca yaklaşık 30 dakika sonra bu oturumlar Oracle veritabanında devre dışı kalır/kaldırılır. Bu davranış tasarım gereğidir.

Sorun giderme

Adlandırma söz dizimi yanlış olduğunda veya düzgün yapılandırılmadığında Oracle'dan gelen çeşitli hatalardan biriyle karşılaşabilirsiniz:

• ORA-12154: TNS: could not resolve the connect identifier specified.
• ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
• ORA-12541: TNS: no listener.
• ORA-12170: TNS: connect timeout occurred.
• ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

Oracle tnsnames.ora veritabanı bağlantı tanımlayıcısı yanlış yapılandırılmışsa, sağlanan net hizmet adı yanlış yazılmışsa veya Oracle veritabanı dinleyicisi çalışmıyorsa veya erişilemiyorsa (örneğin, dinleyiciyi veya veritabanı bağlantı noktasını engelleyen bir güvenlik duvarı gibi) bu hatalar oluşabilir. En düşük yükleme önkoşullarını karşıladığınızdan emin olun. Daha fazla bilgi: Önkoşullar

Karşılaştığınız belirli Oracle hatasının yaygın nedenlerini ve çözümlerini gözden geçirmek için Oracle Veritabanı Hata Yardım Portalı'nı ziyaret edin. Portal arama çubuğuna Oracle hatanızı girin.

Power BI Desktop'ı Microsoft Store'dan indirdiyseniz Oracle sürücü sorunu nedeniyle Oracle veritabanlarına bağlanamayabilirsiniz. Bu sorunla karşılaşırsanız döndürülen hata iletisi: Nesne başvurusu ayarlanmadı. Sorunu gidermek için Microsoft Store yerine İndirme Merkezi'nden Power BI Desktop'ı indirin.

Şirket içi veri ağ geçidini kullanarak bir Oracle veritabanına bağlandığınızda Power BI'da Nesne başvurusu ayarlanmadı hata iletisi oluşuyorsa Veri kaynağınızı yönetme - Oracle başlığındaki yönergeleri izleyin.

Power BI Rapor Sunucusu kullanıyorsanız Oracle Bağlantı Türü makalesindeki kılavuza başvurun.

İlgili içerik

Tablo sütunlarını genişletirken Power Query'yi iyileştirme