Skip to content

Revise Oracle driver settings and TNS_ADMIN instructions#611

Merged
v-regandowner merged 12 commits intoMicrosoftDocs:mainfrom
rufengli2:patch-2
Mar 19, 2026
Merged

Revise Oracle driver settings and TNS_ADMIN instructions#611
v-regandowner merged 12 commits intoMicrosoftDocs:mainfrom
rufengli2:patch-2

Conversation

@rufengli2
Copy link
Copy Markdown
Contributor

Updated references to the Oracle bundled driver settings in Power BI documentation to reflect new naming conventions and added instructions for specifying TNS_ADMIN.

Updated references to the Oracle bundled driver settings in Power BI documentation to reflect new naming conventions and added instructions for specifying TNS_ADMIN.
@prmerger-automator prmerger-automator Bot added the do-not-merge Don't merge this yet label Feb 26, 2026
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 6aedd26:

✅ Validation status: passed

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ✅Succeeded

For more details, please refer to the build report.

@ttorble
Copy link
Copy Markdown
Contributor

ttorble commented Feb 27, 2026

@rufengli2 Thank you for your contribution. Would you take a moment to sign the Contributor License Agreement (CLA)? After the CLA is signed, someone can review your pull request. Thanks!

label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@rufengli2
Copy link
Copy Markdown
Contributor Author

@microsoft-github-policy-service agree [company="{Microsoft}"]

@rufengli2
Copy link
Copy Markdown
Contributor Author

@microsoft-github-policy-service agree company="Microsoft"

@prmerger-automator
Copy link
Copy Markdown
Contributor

@rufengli2 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
rufengli2 and others added 4 commits March 11, 2026 14:41
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit f43e94e:

⚠️ Validation status: warnings

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ⚠️Warning Details

powerquery-docs/connectors/oracle-database.md

  • Line 228, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#configure-tns_admin-in-oadcconfig' in 'connectors/oracle-database.md'.
  • Line 229, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-an-environment-variable' in 'connectors/oracle-database.md'.
  • Line 230, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-settings-from-a-previously-installed-OADC' in 'connectors/oracle-database.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

rufengli2 and others added 2 commits March 11, 2026 14:42
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 7203363:

⚠️ Validation status: warnings

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ⚠️Warning Details

powerquery-docs/connectors/oracle-database.md

  • Line 228, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#configure-tns_admin-in-oadcconfig' in 'connectors/oracle-database.md', did you mean '#configure-tns_admin-in-odacconfig'?
  • Line 230, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-settings-from-a-previously-installed-OADC' in 'connectors/oracle-database.md', did you mean '#use-settings-from-a-previously-installed-odac'?

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

rufengli2 and others added 2 commits March 11, 2026 14:43
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
Co-authored-by: Whitney Henderson <13474870+whhender@users.noreply.github.com>
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 283e582:

⚠️ Validation status: warnings

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ⚠️Warning Details

powerquery-docs/connectors/oracle-database.md

  • Line 228, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#configure-tns_admin-in-oadcconfig' in 'connectors/oracle-database.md', did you mean '#configure-tns_admin-in-odacconfig'?
  • Line 230, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-settings-from-a-previously-installed-OADC' in 'connectors/oracle-database.md', did you mean '#use-settings-from-a-previously-installed-odac'?

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9f998c9:

⚠️ Validation status: warnings

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ⚠️Warning Details

powerquery-docs/connectors/oracle-database.md

  • Line 228, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#configure-tns_admin-in-oadcconfig' in 'connectors/oracle-database.md', did you mean '#configure-tns_admin-in-odacconfig'?
  • Line 230, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-settings-from-a-previously-installed-OADC' in 'connectors/oracle-database.md', did you mean '#use-settings-from-a-previously-installed-odac'?

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 7cc4b8c:

⚠️ Validation status: warnings

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ⚠️Warning Details

powerquery-docs/connectors/oracle-database.md

  • Line 230, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#use-settings-from-a-previously-installed-ODAC' in 'connectors/oracle-database.md', did you mean '#use-settings-from-a-previously-installed-odac'?

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 91d40a5:

✅ Validation status: passed

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ✅Succeeded

For more details, please refer to the build report.

@whhender
Copy link
Copy Markdown
Contributor

#sign-off

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Oracle connector documentation to reflect renamed bundled-driver settings and to document supported ways to specify TNS_ADMIN when using the built-in Oracle managed driver.

Changes:

  • Renames the Power BI Desktop preview feature text for the bundled Oracle managed ODP provider.
  • Updates the on-premises data gateway flight key from MashupFlight_EnableOracleBundledOdacProvider to ...V2 and refreshes the example snippet.
  • Adds new guidance describing supported TNS_ADMIN configuration options (ODAC.config, environment variable, and prior ODAC discovery) plus limitations.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread powerquery-docs/connectors/oracle-database.md
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
Comment thread powerquery-docs/connectors/oracle-database.md
Comment thread powerquery-docs/connectors/oracle-database.md
Comment thread powerquery-docs/connectors/oracle-database.md
Comment thread powerquery-docs/connectors/oracle-database.md Outdated
- [Use settings from a previously installed OADC](#use-settings-from-a-previously-installed-odac)

#### Configure TNS_ADMIN in ODAC.config
If you are using the Built-in Oracle Driver and have access to modify program files, you can specify TNS_ADMIN in configuration file ODAC.config used by Built-in Oracle Driver. The file is located in Power BI Desktop or On-Promise Gateway installed location under “ADO.NET Providers” subfolder. Following is an example of specifying TNS_ADMIN path that is "C:\network\admin".
Copy link

Copilot AI Mar 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence uses smart quotes around “ADO.NET Providers”. Most markdown/docs tooling expects straight quotes, and smart quotes can cause lint/build issues in some pipelines; replace them with straight quotes or format the folder name as code (for example, inline code).

Suggested change
If you are using the Built-in Oracle Driver and have access to modify program files, you can specify TNS_ADMIN in configuration file ODAC.config used by Built-in Oracle Driver. The file is located in Power BI Desktop or On-Promise Gateway installed location under ADO.NET Providers subfolder. Following is an example of specifying TNS_ADMIN path that is "C:\network\admin".
If you are using the Built-in Oracle Driver and have access to modify program files, you can specify TNS_ADMIN in configuration file ODAC.config used by Built-in Oracle Driver. The file is located in Power BI Desktop or On-Promise Gateway installed location under `ADO.NET Providers` subfolder. Following is an example of specifying TNS_ADMIN path that is "C:\network\admin".

Copilot uses AI. Check for mistakes.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@prmerger-automator prmerger-automator Bot added do-not-merge Don't merge this yet and removed ready-to-merge labels Mar 19, 2026
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 53dd62c:

✅ Validation status: passed

File Status Preview URL Details
powerquery-docs/connectors/oracle-database.md ✅Succeeded

For more details, please refer to the build report.

@v-regandowner v-regandowner merged commit c16ac17 into MicrosoftDocs:main Mar 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants