apunkt/ktx
1
0
Fork 0
mirror of https://github.com/Kaelio/ktx.git synced 2026-06-19 08:28:06 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: document query history readiness probes

Browse source
This commit is contained in:
Andrey Avtomonov 2026-05-24 01:29:13 +02:00
parent 3677b1fb0c
commit 6afca20b2a
2 changed files with 12 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs-site/content/docs/cli-reference/ktx-setup.mdx
View file

@ -134,6 +134,16 @@ window flag applies to BigQuery and Snowflake; Postgres reads the current
Enabling query history makes deep ingest readiness matter for later
`ktx ingest` runs.
When query history is enabled for PostgreSQL, Snowflake, or BigQuery,
`ktx setup` runs a non-blocking readiness probe after the connection test
passes. A failed probe still writes setup changes, prints the warehouse-specific
grant or extension remediation, and leaves query-history ingest disabled until
you fix the prerequisite.
For BigQuery, the remediation tells you to grant `roles/bigquery.resourceViewer`
on the BigQuery project, or grant a custom role that contains
`bigquery.jobs.listAll`.
### Context Sources
| Flag | Description |