Oracle Database

Ringkasan

Barang	Deskripsi
Status Perilisan	Ketersediaan Umum
Produk	Excel Power BI (Model Semantik) Power BI (Dataflow) Fabric (Dataflow Gen2) Power Apps (Aliran Data) Dynamics 365 Customer Insights Analysis Services
Jenis Autentikasi Didukung	Windows (desktop/online) Database perangkat lunak desktop Dasar (online) Akun Microsoft (desktop)
Dokumentasi Referensi Fungsi	Oracle.Database

Nota

Beberapa kemampuan mungkin ada dalam satu produk tetapi tidak yang lain karena jadwal penyebaran dan kemampuan khusus host.

Prasyarat

Versi Oracle yang didukung:

• Oracle Database Server 12c (12.1.0.2) dan yang lebih baru
• Oracle Autonomous Database - semua versi

Sebelum Anda bisa menyambungkan ke database Oracle menggunakan Power Query, Anda perlu menginstal Klien Oracle untuk Microsoft Tools (OCMT). Untuk menyambungkan ke database Oracle dengan gateway data lokal, OCMT 64-bit harus diinstal pada komputer yang menjalankan gateway. Untuk informasi selengkapnya, buka Mengelola sumber data Anda - Oracle.

Nota

Sejak versi April 2025 dari Power BI Desktop dan versi Mei 2025 dari gateway data di lingkungan lokal, kami menyediakan opsi baru untuk menggunakan driver ODP.NET terkelola Oracle bawaan untuk menyambungkan ke database Oracle, yang saat ini tersedia dalam versi pratinjau. Dengan fitur diaktifkan, Anda tidak perlu menginstal OCMT secara manual. Pelajari lebih lanjut tentang fitur ini .

Kemampuan yang Didukung

• Mengimpor
• DirectQuery (model semantik Power BI)
• Opsi tingkat lanjut
  • Batas waktu perintah dalam menit
  • Perintah SQL
  • Sertakan kolom hubungan
  • Menavigasi menggunakan hierarki penuh

Mengunduh dan menginstal Klien Oracle untuk Microsoft Tools

Klien Oracle untuk Microsoft Tools menginstal dan mengonfigurasi Penyedia Data Oracle untuk .NET (ODP.NET) untuk mendukung koneksi alat Microsoft 32-bit dan 64-bit dengan database lokal dan cloud Oracle, termasuk Oracle Autonomous Database (ADB). OCMT adalah alat penginstal grafis yang mengotomatiskan proses penyiapan Klien Oracle Database. Ini mendukung koneksi dengan Power BI Desktop, layanan Power BI, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services, dan BizTalk Server.

OCMT adalah perangkat lunak gratis. Ini dapat diunduh dari halaman Klien Oracle untuk Microsoft Tools. Untuk layanan Power BI Desktop dan Power BI 64-bit, gunakan OCMT 64-bit. Untuk Power BI Desktop 32-bit, gunakan OCMT 32-bit.

Bahkan jika Anda sudah memiliki Klien Oracle atau ODP.NET yang terinstal pada klien Power BI Anda, kami sangat menyarankan Anda menggunakan penginstal OCMT untuk menyelesaikan semua langkah konfigurasi yang diperlukan Power BI dengan benar untuk bekerja dengan database Oracle.

• Unduhan OCMT 64-bit dan 32-bit
• Instruksi penginstalan dan penyiapan OCMT

Menyambungkan ke database Oracle lokal dari Power Query Desktop

Untuk membuat koneksi, lakukan langkah-langkah berikut:

1. Pilih opsi Database Oracle di pilihan konektor.

2. Tentukan nama layanan net Oracle/alias TNS atau string koneksi Easy Connect (Plus) untuk disambungkan di Server. Easy Connect adalah yang paling sederhana untuk digunakan dengan mengatur nilai Server ke server Oracle Database Hostname/ServiceName Anda, di mana ServiceName adalah nama database global. Cuplikan layar berikut menggunakan nama layanan jaringan.

   

3. Jika Anda menghubungkan dari Power BI Desktop, pilih mode konektivitas data Impor atau DirectQuery. Langkah-langkah contoh lainnya menggunakan mode Impor konektivitas data. Untuk mempelajari selengkapnya tentang DirectQuery, buka Gunakan DirectQuery di Power BI Desktop.

4. Jika Anda menyambungkan ke database Oracle ini untuk pertama kalinya, pilih jenis autentikasi yang ingin Anda gunakan, lalu masukkan kredensial Anda. Jenis autentikasi yang tersedia adalah:

   • Windows (autentikasi Windows)
   • Database (Nama pengguna dan kata sandi)
   • Akun Microsoft (ID Microsoft Entra)

   Untuk informasi selengkapnya tentang autentikasi, buka Autentikasi dengan sumber data.

   

5. Di Navigator, pilih data yang Anda butuhkan, lalu pilih Muat untuk memuat data atau Mengubah Data untuk mengubah data.

Menyambungkan ke database Oracle lokal dari Power Query Online

Untuk membuat koneksi, lakukan langkah-langkah berikut:

1. Instal dan siapkan gateway data lokal.

2. Dari Power Query Online, pilih opsi Database Oracle di pilihan sumber data.

3. Dalam dialog database Oracle yang muncul, tentukan nama layanan net Oracle/alias TNS, string koneksi Easy Connect Plus, atau deskriptor sambungkan untuk disambungkan di Server.

   

4. Berikan Nama koneksi, seperti "testoracleserver".

5. Pilih nama gateway data lokal Anda.

   Nota

   Anda harus memilih gateway data lokal untuk konektor ini, baik database Oracle berada di jaringan lokal Anda atau di situs web.

6. Jika Anda menyambungkan ke database Oracle ini untuk pertama kalinya, pilih jenis kredensial untuk koneksi dalam jenis Autentikasi. Pilih Dasar jika Anda berencana untuk masuk dengan nama pengguna dan kata sandi Oracle. Pilih Windows saat menggunakan autentikasi sistem operasi Windows dan dengan klien Oracle dan server yang berjalan di Windows.

7. Masukkan kredensial Anda.

8. Untuk melanjutkan, klik Berikutnya.

9. Di Navigator, pilih data yang Anda butuhkan, lalu pilih Ubah data untuk mengubah data di Editor Power Query.

Menyambungkan ke Oracle Autonomous Database

Nota

Saat ini, Anda dapat menyambungkan ke Oracle Autonomous Database dari Excel, Power BI Desktop, layanan Power BI, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services, dan BizTalk Server menggunakan prosedur di bagian ini. Alat-alat ini menggunakan ODP.NET yang tidak dikelola untuk menyambungkan. Alat Microsoft lainnya, termasuk SQL Server Data Tools, SQL Server Integration Services, dan SQL Server Reporting Services, menggunakan ODP.NET terkelola untuk menyambungkan ke Oracle Autonomous Database menggunakan prosedur yang sebagian besar serupa.

Untuk menyambungkan Power BI ke Oracle Autonomous Database, Anda memerlukan akun dan aplikasi berikut:

• Akun Oracle.com (Pendaftaran Akun Oracle.com)
• Akun Oracle Cloud (Pendaftaran Akun Cloud Oracle)
• Database Otonom Oracle (Dapatkan Database Otonom Yang Selalu Gratis)
• Power BI Desktop (Dapatkan Power BI Desktop) atau akun layanan Power BI (Lisensi layanan Power BI untuk pengguna di organisasi Anda)
• Gateway data lokal jika menggunakan layanan Power BI (Unduh dan instal gateway standar)

Mengunduh kredensial klien Anda

Langkah pertama dalam menyiapkan koneksi ke database Oracle Autonomous adalah mengunduh kredensial klien Anda.

Untuk mengunduh kredensial klien Anda:

1. Di halaman detail database Oracle Autonomous Anda, pilih Koneksi DB.

   

2. Dari halaman Koneksi Database , pilih Unduh Dompet.

   

3. Masukkan kata sandi yang ingin Anda gunakan dengan dompet ini, konfirmasi kata sandi, lalu pilih Unduh.

   

Mengonfigurasi informasi kredensial Oracle ADB

1. Di komputer Windows Anda, buka folder tempat Anda mengunduh kredensial Oracle ADB dari Unduh kredensial klien Anda.

2. Unzip kredensial ke dalam direktori yang Anda tentukan di OCMT sebagai Direktori File Konfigurasi Oracle. Dalam contoh ini, kredensial diekstrak ke c:\data\wallet\wallet_contosomart.

   

   Nota

   File tnsnames.ora menentukan alamat Oracle Autonomous Database dan informasi koneksi Anda.

3. Buka sqlnet.ora di editor, seperti Notepad.

4. Di bawah WALLET_LOCATION, ubah jalur ke folder dompet Anda di bawah opsi Direktori. Dalam contoh ini:

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

5. Simpan dan tutup file sqlnet.ora.

Buka file tnsnames.ora di folder wallets. File ini berisi daftar nama layanan jaringan ADB yang dapat Anda sambungkan. Dalam contoh ini, nama-namanya contosomart_high, contosomart_low, dan contosomart_medium. Nama layanan net ADB Anda berbeda.

Menyambungkan Power BI Desktop ke Oracle ADB

1. Buka Power BI Desktop.

2. Pilih Dapatkan Data.

3. Dari Dapatkan Data, pilih Database>Oracle database.

4. Masukkan nama layanan jaringan dari server Oracle Autonomous Database yang ingin Anda hubungkan. Dalam contoh ini, Server adalah contosomart_high. Kemudian pilih OK.

   

5. Jika Anda masuk ke server ini dari Power BI Desktop untuk pertama kalinya, Anda diminta untuk memasukkan kredensial Anda. Pilih Database, lalu masukkan nama pengguna dan kata sandi untuk database Oracle. Kredensial yang Anda masukkan di sini adalah nama pengguna dan kata sandi untuk Database Otonom Oracle tertentu yang ingin Anda sambungkan. Dalam contoh ini, nama pengguna dan kata sandi administrator awal database digunakan. Kemudian pilih Sambungkan.

   

   Nota

   Anda dapat menggunakan autentikasi ID Microsoft Entra untuk masuk ke Oracle Autonomous Database melalui opsi akun Microsoft .

Pada titik ini, Navigator muncul dan menampilkan data koneksi.

Anda mungkin juga menemukan salah satu dari beberapa kesalahan karena konfigurasi tidak disiapkan dengan benar. Kesalahan ini dibahas dalam Pemecahan Masalah.

Satu kesalahan yang mungkin terjadi dalam pengujian awal ini terjadi di Navigator, di mana database tampaknya terhubung, tetapi tidak berisi data. Sebagai gantinya, Oracle: ORA-28759: kesalahan kegagalan membuka file muncul sebagai pengganti data tersebut.

Jika kesalahan ini terjadi, pastikan bahwa jalur folder dompet yang Anda berikan di sqlnet.ora adalah jalur lengkap dan benar ke folder dompet.

Konfigurasi gateway

1. Instal dan siapkan gateway data lokal.

2. Di layanan Power BI, pilih ikon roda gigi di sisi kanan atas, lalu pilih Kelola gateway.

   

3. Di Tambahkan Sumber Data, pilih Tambahkan sumber data untuk menggunakan gateway.

   

4. Di Nama Sumber Data, masukkan nama yang ingin Anda gunakan sebagai pengaturan sumber data.

5. Di Jenis Sumber Data, pilih Oracle.

6. Di Server, masukkan nama layanan jaringan server Oracle Autonomous Database untuk terhubung.

7. Di Metode Autentikasi, pilih Dasar.

8. Masukkan nama pengguna dan kata sandi untuk Oracle Autonomous Database. Dalam contoh ini, nama pengguna dan kata sandi administrator database default (ADMIN) digunakan.

9. Pilih Tambahkan.

   

Jika semuanya diinstal dan dikonfigurasi dengan benar, pesan Koneksi Berhasil muncul. Sekarang Anda bisa menyambungkan ke Oracle Autonomous Database menggunakan langkah yang sama yang dijelaskan dalam Menyambungkan ke database Oracle lokal dari Power Query Online.

Menyambungkan menggunakan opsi tingkat lanjut

Power Query Desktop dan Power Query Online menyediakan sekumpulan opsi tingkat lanjut yang bisa Anda tambahkan ke kueri Anda jika diperlukan.

Tabel berikut ini mencantumkan semua opsi tingkat lanjut yang bisa Anda atur di Power Query Desktop dan Power Query Online.

Opsi tingkat lanjut	Deskripsi
Batas waktu perintah dalam menit	Jika koneksi Anda berlangsung lebih dari 10 menit (batas waktu default), Anda dapat memasukkan nilai lain dalam hitungan menit untuk menjaga koneksi tetap terbuka lebih lama. Opsi ini hanya tersedia di Power Query Desktop.
Perintah SQL	Untuk informasi, buka Mengimpor data dari database menggunakan kueri database asli.
Sertakan kolom hubungan	Jika dicentang, sertakan kolom yang mungkin memiliki hubungan dengan tabel lain. Jika kotak ini dikosongkan, kolom ini tidak muncul.
Menavigasi menggunakan hierarki penuh	Jika dicentang, navigator menampilkan hierarki lengkap tabel dalam database yang sedang Anda sambungkan. Jika dibersihkan, navigator hanya menampilkan tabel yang kolom dan barisnya berisi data.

Setelah Anda memilih opsi tingkat lanjut yang Anda perlukan, pilih OK di Power Query Desktop atau Berikutnya di Power Query Online untuk menyambungkan ke database Oracle Anda.

Gunakan driver Oracle bawaan (Pratinjau)

Sejak versi Power BI Desktop April 2025 dan gateway data lokal versi Mei 2025, konektor Oracle menyertakan driver ODP.NET terkelola Oracle bawaan untuk konektivitas. Fitur ini menghapus kebutuhan pengguna untuk menginstal dan mengelola driver. Anda dapat mengaktifkan fitur ini dengan menggunakan instruksi berikut.

Untuk menggunakan driver bawaan ini di Power BI Desktop, navigasikan ke Opsi dan pengaturan (di bawah tab File) >Fitur Pratinjau>, lalu pilih kotak centang untuk mengaktifkan opsi Aktifkan menggunakan Penyedia ODP Terkelola Oracle yang dibundel.

Untuk menggunakan driver bawaan ini di gerbang data lokal, ubah konfigurasi gerbang untuk memperbarui setelan MashupFlight_EnableOracleBundledOdacProvider dengan menggunakan langkah-langkah berikut:

1. Pada komputer lokal tempat gateway data lokal diinstal, navigasikan ke C:\Program Files\Gateway data lokal.
2. Buat cadangan file konfigurasi bernama Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Buka file konfigurasi Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config asli dan temukan entri MashupFlight_EnableOracleBundledOdacProvider.
4. MashupFlight_EnableOracleBundledOdacProvider Perbarui nilai sebagai True.
5. Mulai ulang gateway Anda.

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

Konfigurasi yang tersisa untuk menyambungkan ke database Oracle dari Power Query Desktop sama seperti yang dijelaskan di bagian sebelumnya.

Masalah dan batasan yang diketahui

Sesi Power BI masih bisa aktif di database Oracle Anda selama sekitar 30 menit setelah refresh model semantik ke database Oracle tersebut. Hanya setelah sekitar 30 menit, sesi tersebut menjadi tidak aktif/dihapus pada database Oracle. Perilaku ini dirancang.

Penyelesaian Masalah

Anda mungkin menemukan salah satu dari beberapa kesalahan dari Oracle ketika sintaks penamaan salah atau tidak dikonfigurasi dengan benar:

• 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.

Kesalahan ini mungkin terjadi jika deskriptor koneksi database Oracle tnsnames.ora salah dikonfigurasi, nama layanan jaringan yang disediakan salah eja, atau pendengar database Oracle tidak berjalan atau tidak dapat dijangkau, misalnya firewall memblokir pendengar atau port database. Pastikan Anda memenuhi prasyarat penginstalan minimum. Informasi selengkapnya: Prasyarat

Kunjungi Portal Bantuan Kesalahan Oracle Database untuk meninjau penyebab umum dan resolusi untuk kesalahan Oracle tertentu yang Anda temui. Masukkan kesalahan Oracle Anda di bilah pencarian portal.

Jika Anda mengunduh Power BI Desktop dari Microsoft Store, Anda mungkin tidak dapat menyambungkan ke database Oracle karena masalah driver Oracle. Jika Anda menemukan masalah ini, pesan kesalahan yang dikembalikan adalah: Referensi objek tidak diatur. Untuk mengatasi masalah ini, unduh Power BI Desktop dari Pusat Unduhan alih-alih Microsoft Store.

Jika pesan kesalahan referensi Objek tidak diatur terjadi di Power BI saat Anda menyambungkan ke database Oracle melalui gateway data lokal, ikuti instruksi di Mengelola sumber data Anda - Oracle.

Jika Anda menggunakan Server Laporan Power BI, lihat panduan di artikel Jenis Koneksi Oracle .

Konten terkait

Optimalkan Power Query saat memperluas kolom tabel