dfe-analytical-services / dfe-analytical-services/dfeR

[Other]: Analysts' Guide - Databricks token documentation

Open Beginner friendly
#143 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
R
Stars
14
Forks
4
Avg merge
4d 5h
Merged PRs (30d)
3

Description

### Description

When generating a new access token, the users are now prompted to select the API scope(s). It'd be good if guidance on this is added to the AG.

Image

### Why this is important?

For `write_df_to_delta()`, the following scopes are needed: `files`, `sql` and `unity-catalog`, otherwise the function errors out. For simplicity, my unit has been selecting `all-apis` when generating a new access token.

Contributor guide

Open the contributing guide

Research direction

Start with the Analysts' Guide section covering Databricks access-token generation and the guidance around write_df_to_delta(). Document that files, sql, and unity-catalog scopes are required, and mention the all-apis option; done when users can select the needed scopes and avoid the reported error.

Written by the indexing model from the issue text.

Assessment

Tech stack
r
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.