Document remote authentication for SQL stored procedures#59
Conversation
zachmu
left a comment
There was a problem hiding this comment.
LGTM
Content is good, but maybe this deserves its own doc?
Per @zachmu's review on #59: the "Authenticating to remotes" content is better as a standalone page than a section buried in the procedures reference. - New page reference/sql/version-control/remote-authentication.md ("Authenticating to Remotes"), covering --user / DOLT_REMOTE_PASSWORD, where to set the env var, the credentials per backend, and an example. - dolt-sql-procedures.md: the four `--user` option entries now link to the new page instead of carrying the full explanation inline. - nav.ts: added under Version Control Features, after "Using Remotes". Rebased onto current dev (the branch was 43 commits behind and predated the catch-all routing + frontmatter-title work), so the page needs no .astro wrapper and its H1 is injected from the frontmatter title. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
e744bd9 to
3d826f8
Compare
|
Done — pulled the "Authenticating to remotes" content out into its own page ( Heads-up: the branch was 43 commits behind dev and predated the catch-all routing + frontmatter-title refactors, so I rebased it onto current dev and force-pushed. That means the new page needs no |
Closes #46.
The four remote-touching procedures (
DOLT_CLONE,DOLT_FETCH,DOLT_PULL,DOLT_PUSH) each named--userandDOLT_REMOTE_PASSWORDin their option lists but didn't explain the actual SQL-server flow: that the env var lives on the server process (not the SQL session), what user/password to use for each backend (DoltHub / DoltLab / Hosted / another sql-server's remotesapi), or that all--usercalls in a server process share one password.Adds a new `### Authenticating to remotes` subsection at the top of `dolt-sql-procedures.md` covering all of the above, with an end-to-end example and the verbatim "must set DOLT_REMOTE_PASSWORD" error string. Each procedure's
--userOptions entry now cross-links into the new section.Source: env var is read at call time on the server process per
grpc_dial_provider.go:158.🤖 Generated with Claude Code