Skip to content
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

Updated databricks destination documentation #1984

Merged
merged 3 commits into from
Oct 24, 2024

Conversation

dat-a-man
Copy link
Collaborator

Description

The Databricks documentation suggests that staging is optional for the destination. However, it's important to clarify that Databricks requires a staging destination.

Related Issues

@dat-a-man dat-a-man added the documentation Improvements or additions to documentation label Oct 24, 2024
@dat-a-man dat-a-man requested a review from sh-rp October 24, 2024 06:06
@dat-a-man dat-a-man self-assigned this Oct 24, 2024
@dat-a-man dat-a-man linked an issue Oct 24, 2024 that may be closed by this pull request
Copy link

netlify bot commented Oct 24, 2024

Deploy Preview for dlt-hub-docs ready!

Name Link
🔨 Latest commit d288acd
🔍 Latest deploy log https://app.netlify.com/sites/dlt-hub-docs/deploys/671a1c850560520009a130c4
😎 Deploy Preview https://deploy-preview-1984--dlt-hub-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 site configuration.

Copy link
Collaborator

@burnash burnash left a comment

Choose a reason for hiding this comment

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

Please see the comments

* [JSONL](../file-formats/jsonl.md) supported when staging is enabled (see limitations below).
* [Parquet](../file-formats/parquet.md) supported when staging is enabled.

* [parquet](../file-formats/parquet.md) supported when staging is enabled.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* [parquet](../file-formats/parquet.md) supported when staging is enabled.
* [Parquet](../file-formats/parquet.md) supported when staging is enabled.

Parquet should be capitalized in the sentence because it is the name of a specific file format. Proper nouns, such as the names of file formats, should be capitalized.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

yes, updated. Thanks!

* [Parquet](../file-formats/parquet.md) supported when staging is enabled.

* [parquet](../file-formats/parquet.md) supported when staging is enabled.
* [jsonl](../file-formats/jsonl.md) supported when staging is enabled (see limitations below).
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* [jsonl](../file-formats/jsonl.md) supported when staging is enabled (see limitations below).
* [jsonl](../file-formats/jsonl.md) supported when staging is enabled (see limitations below).

Same as Parquet, "JSONL" should also be capitalized, as it is an acronym for "JSON Lines."

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Updated

@@ -128,15 +128,17 @@ See [staging support](#staging-support) for authentication options when `dlt` co
All write dispositions are supported.

## Data loading
Data is loaded using `INSERT VALUES` statements by default.
To load data into Databricks, you must set up a staging filesystem by configuring an Amazon S3 or Azure Blob Storage bucket. `parquet` is the default file format used for data uploads. As an alternative to `parquet`, you can switch to using `JSONL`.
Copy link
Collaborator

Choose a reason for hiding this comment

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

There's no need to mark Parquet and JSONL as code here as you're referring to file formats.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

updated

Copy link
Collaborator

@burnash burnash left a comment

Choose a reason for hiding this comment

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

Thank you!

@burnash burnash merged commit 774ad5c into devel Oct 24, 2024
51 checks passed
@burnash burnash deleted the docs/1953-update-databricks-destination-documentation branch October 24, 2024 12:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update Databricks destination documentation
2 participants