FAQ / Troubleshooting

Why are my assets not creating relationships automatically? Make sure the column header exactly matches the target CSV filename. If you want a different relation type or target, use the explicit [[retype_relation]] directive in a model.

Why is an automatic relationship forming when I don’t want it to? Auto-linking runs if a property name matches a known resource type. If you want to prevent this, prefix the property name with an underscore (_) in your CSV header or model property.

My data generator fails in CI but works locally. Why? CI environments run non-interactively. If a module is untrusted, Rescile blocks execution. You must pass --trust-modules "url" or --trust-all-modules to allow the generator to execute headlessly.

My numeric values are acting like floats instead of strings. Rescile auto-converts values like “true” to booleans and “1.0” to floats. If you need them to stay strings (like a version number), prefix the CSV column header or the model property name with a tilde (~).

How do I view orphaned resources? Run the rescile-ce binary without --remove-orphaned-assets. Orphans will appear in the graph, usually resulting from CSV rows that were never linked by models.

Why is my match_on condition failing for complex JSON? Ensure you are using the expression operator with the jmespath filter. Simple value checks do not deeply parse JSON objects.

I updated my asset but the graph didn’t update in the UI. By default, rescile-ce serve watches local files and hot-reloads. If you modify a remote module’s git repo, you must restart or pull the latest changes.