Skip to content

Clarify documentation of the Oracle connection-url string#11656

Merged
hashhar merged 1 commit intotrinodb:masterfrom
jhlodin:jl/oracle-jdbc
Mar 26, 2022
Merged

Clarify documentation of the Oracle connection-url string#11656
hashhar merged 1 commit intotrinodb:masterfrom
jhlodin:jl/oracle-jdbc

Conversation

@jhlodin
Copy link
Copy Markdown
Contributor

@jhlodin jhlodin commented Mar 24, 2022

Description

The current example URL used for the Oracle connector config is used to connect to a service name, which appears to be less common in practice than connecting to a single Oracle SID. Since the syntax is completely different between the two, it makes the most sense to use the more common example in our docs.

This also updates the outgoing Oracle docs link to use the most recent version of the Oracle docs, rather than version 11 which we don't even support.

Is this change a fix, improvement, new feature, refactoring, or other?

Improvement

Is this a change to the core query engine, a connector, client library, or the SPI interfaces? (be specific)

Documentation

How would you describe this change to a non-technical end user or system administrator?

Improve the Oracle connector documentation to be more useful to the average Oracle user.

Related issues, pull requests, and links

Documentation

( ) No documentation is needed.
(x) Sufficient documentation is included in this PR.
( ) Documentation PR is available with #prnumber.
( ) Documentation issue #issuenumber is filed, and can be handled later.

Release notes

(x) No release notes entries required.
( ) Release notes entries required with the following suggested text:

# Section
* Fix some things. ({issue}`issuenumber`)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Reword to ensure misunderstanding .. you can NOT change the JDBC driver being used easily

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm conflicted on this. I see how this may imply that you can change drivers which is not advisable, but when navigating the Oracle docs for more information you probably need to know that we use the Thin driver.

@hashhar hashhar merged commit 9014ce9 into trinodb:master Mar 26, 2022
@github-actions github-actions bot added this to the 375 milestone Mar 26, 2022
v-jizhang added a commit to v-jizhang/presto that referenced this pull request Apr 25, 2022
Cherry-pick of trinodb/trino#9044
and
Cherry-pick of trinodb/trino#11656

Co-authored-by: Joe Lodin <joe.lodin@starburstdata.com>
highker pushed a commit to prestodb/presto that referenced this pull request Apr 25, 2022
Cherry-pick of trinodb/trino#9044
and
Cherry-pick of trinodb/trino#11656

Co-authored-by: Joe Lodin <joe.lodin@starburstdata.com>
@jhlodin jhlodin deleted the jl/oracle-jdbc branch September 2, 2022 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

3 participants