Add troubleshooting to failure computed assets#1119
Conversation
Greptile SummaryThis PR extends the Unloadable Container Error documentation to cover computed assets (Computed Tables, Computed Files, Computed Joins), which cannot be reset via a Sync operation and instead require a forced Edit → Validate → Save cycle.
Confidence Score: 4/5Safe to merge — all changes are documentation only with no code logic affected. Step 4 of the tables/views resolution path still tells users to 'run the scan operation again' even though the section intro now covers profiles and check validations too; a user who hit the error during a profile run could be momentarily confused. Everything else — link targets, anchor names, relative paths — checks out correctly across all five files. docs/operations/scan/scan.md — the tables/views resolution step 4 wording is slightly out of sync with the broadened section introduction. Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Container marked Unloadable\n3 consecutive failures] --> B{Container type?}
B -->|Table / View / File pattern| C[Run Sync Operation\non the datastore]
B -->|Computed asset\nComputed Table / File / Join| D[Open asset → click Edit]
C --> E{Sync successful?}
D --> F[Fix SQL if needed\nor re-save as-is]
F --> G[Click Validate]
G --> H{Validation passes?}
H -->|Yes| I[Click Save →\nUnloadable status cleared]
H -->|No| J[Fix root cause\ne.g. renamed column, dropped table]
J --> G
E -->|Yes| K[Re-run scan / profile /\ncheck validation]
E -->|No| L[Investigate root cause\npermissions, schema, network]
I --> K
K --> M[Container processes normally]
Reviews (1): Last reviewed commit: "Add troubleshooting to failure computed ..." | Re-trigger Greptile |
| 1. Navigate to your source datastore. | ||
| 2. Run a [Sync Operation](../sync/sync.md) on the datastore. | ||
| 3. Once the sync operation completes successfully, the container status is reset. | ||
| 4. Run the scan operation again. The previously unloadable container should now be processed normally. |
There was a problem hiding this comment.
Step 4 still only says "Run the scan operation again", but the section intro was broadened to cover profiles and quality-check validations as well. A user who first hit this error during a profile run would find the instruction misleading.
| 4. Run the scan operation again. The previously unloadable container should now be processed normally. | |
| 4. Re-run the operation that surfaced the error (scan, profile, or check validation). The previously unloadable container should now be processed normally. |
No description provided.