Skip to content

MOLT Oracle documentation; refactor MOLT tutorials #19918

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: main
Choose a base branch
from
Open

Conversation

taroface
Copy link
Contributor

@taroface taroface commented Jul 11, 2025

DOC-14130
DOC-14259
DOC-13941
DOC-13035

  • Document Oracle support for MOLT (in public preview)
  • Refactor MOLT tutorials to center on user journeys
    • Make guidance clearer and more explicit, including PKs requirement
  • Document Azure Blob Storage support

Please review:

Page preview Review link
Bulk Load https://github.com/cockroachdb/docs/pull/19918/files#diff-8b869a1172f94c4b14010f730ab39d51cdeee342497ee1aeb0ed8605c72e5e60
Load and Replicate https://github.com/cockroachdb/docs/pull/19918/files#diff-e33d9d713e7b66e47c4c9e6b1c4d696760ba4a6a56c91388371fcfb07d1b8702
Load and Replicate Separately https://github.com/cockroachdb/docs/pull/19918/files#diff-240a82fe78b31e2105a4a0882479b665d1c36a0553bbfea56dc7dba7cad1aba4
Resume Replication https://github.com/cockroachdb/docs/pull/19918/files#diff-7e788b5f71dd9e3d14bce14858a23ba0cf95efa88299496559d89ba54cab7dfb
Failback https://github.com/cockroachdb/docs/pull/19918/files#diff-15e68aea37ca1e37ede383feed074bf6973b939daadb0357f7997b97f919e9ac
MOLT Fetch https://github.com/cockroachdb/docs/pull/19918/files#diff-d33cc35311a672af48897ed330cc8692163816714829a86f5b667a7ebbda15f3
Migration Overview (new Migration Flows section) https://github.com/cockroachdb/docs/pull/19918/files#diff-39a1ebe415b90ca952a0d16cec1c23b6ec13ecce34d780cb27505e82c2a7e06b

The above pages use content from the _includes folder. Please review those documents as well.

Note that the PG and MySQL flows were updated as well. This is technically outside the scope of this PR, but I'd like to request a review of the SQL user creation steps for each dialect and for CRDB, as this hasn't previously been documented and I was making an educated guess in some places.

Copy link

netlify bot commented Jul 11, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 55c916c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/68796c147b6f3e0008338f74

Copy link

netlify bot commented Jul 11, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 55c916c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/68796c14b60e5200082cbdde

Copy link

github-actions bot commented Jul 11, 2025

Files changed:

Copy link

netlify bot commented Jul 11, 2025

Deploy Preview for cockroachdb-docs failed. Why did it fail? →

Name Link
🔨 Latest commit 21fb832
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/6870a0d7ada63e000859a849

Copy link

netlify bot commented Jul 11, 2025

Netlify Preview

Name Link
🔨 Latest commit 55c916c
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/68796c14f37f40000843a282
😎 Deploy Preview https://deploy-preview-19918--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Jeremyyang920
Copy link

image I saw this on the preview, but seems like a markdown reference isint resolved properly.

Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

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

Excellent work @taroface and @noelcrl . I can give this a more thorough look Monday, but left some high level comments for now

Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

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

Reviewed the rest just now. Looks good, just nits and clarifications. Agreed with Jeremy's comments. Can review after those are all addressed. I also want to ensure rest of the team can take a look here. @taroface it would be helpful if you could also link the exact docs preview section link so folks can see how it presents on the website

@taroface
Copy link
Contributor Author

Addressed all comments. PTAL!

The docs preview links are in the PR description.

Copy link

@ryanluu12345 ryanluu12345 left a comment

Choose a reason for hiding this comment

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

Changes lgtm!

Copy link

@Jeremyyang920 Jeremyyang920 left a comment

Choose a reason for hiding this comment

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

LGTM! Will let Noel sign off on the Oracle stuff

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

Suggestions for Bulk Load. I will give my suggestions per page.

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

Suggestions for Load and Replicate.

Copy link

@noelcrl noelcrl left a comment

Choose a reason for hiding this comment

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

Great work so far, I will take another review at the Oracle-specific portion next and the rest of the changes

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

Reviewed Resume Replication and Failback.

a few questions.

Copy link

@noelcrl noelcrl left a comment

Choose a reason for hiding this comment

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

Reviewed the rest including Oracle, please let me know when it is ready for a final review 👍

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

Reviewed MOLT Fetch and Migration Overview (new Migration Flows section).

some nits. Great job @taroface, very comprehensive!

@taroface
Copy link
Contributor Author

@noelcrl @florence-crl TFTRs!!! I think I addressed all comments. Could you please have another look?

Copy link
Contributor

@florence-crl florence-crl left a comment

Choose a reason for hiding this comment

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

lgtm!

Copy link

@noelcrl noelcrl left a comment

Choose a reason for hiding this comment

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

LGTM! Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants