← All Power BI refresh errors

Connectivity

Oracle TNS error (ORA-12154 / ORA-12514 / ORA-12541)

Error code: oracle-tns

Power BI dataset refresh error — what it means and how to fix it.

What this means

Oracle TNS errors (ORA-12154/12514/12541/12170/12504): a bad connect identifier, or the listener/port is down or firewalled.

How to fix it

  1. Verify the tnsnames connect descriptor.
  2. Confirm the listener and port are reachable.
  3. Install the Oracle client on the gateway and test in Power BI Desktop.
View on Microsoft Learn

Related connectivity errors

Catch this automatically

RefreshRadar monitors every Power BI dataset refresh and alerts you the moment one fails — with the likely cause and the fix — so you never hear about a broken refresh from your stakeholders first.

Start free