Skip to content

Scan Troubleshooting

This page documents known scan-related errors and the steps to resolve them. Each section describes the error, its cause, and a step-by-step resolution.

Unloadable Container Error

When running a scan, a profile, or a quality check validation, you may encounter the following error for specific containers:

Container '<CONTAINER_NAME>' is marked as Unloadable. No attempt was made to load the container due to multiple consecutive failures in prior operations.

Cause: This error occurs when a container has failed in 3 consecutive scan or profile operations. The count combines scans and profiles chronologically. To prevent repeated failed attempts and optimize performance, Qualytics marks the container as "Unloadable" and skips it in subsequent operations. Any later attempt to use the container (running another scan or profile, or validating a quality check against it) surfaces the same error until the status is cleared.

Resolution: The steps to clear the Unloadable status depend on the container type.

Tables, views, and file patterns

These containers are discovered from the datastore catalog, so a successful Sync operation resets their status.

  1. Navigate to your source datastore.
  2. Run a Sync Operation on the datastore.
  3. Once the sync operation completes successfully, the container status is reset.
  4. Re-run the operation that surfaced the error (scan, profile, or check validation). The previously unloadable container should now process normally.

Computed assets (Computed Tables, Computed Files, Computed Joins)

Computed assets are defined inside Qualytics, not discovered from the datastore catalog, so a Sync operation does not reset their status. Instead, you need to force an edit on the asset and re-save its definition. Re-saving runs the validation against the datastore again and clears the Unloadable status.

  1. Navigate to the source datastore where the computed asset lives.
  2. Open the computed asset and click Edit to force the asset into edit mode.
  3. Review the SQL query or transformation and apply any change needed to make it work again (for example, after a renamed source column, a removed table, or a schema change in an upstream container). If the definition still looks correct, you can re-save it as-is to force Qualytics to re-evaluate it.
  4. Click Validate to confirm the query runs successfully against the datastore.
  5. Click Save. Saving a successfully validated definition clears the Unloadable status, and the asset becomes available again for scans, profiles, and check validations.

For details on editing computed assets, see Computed Tables, Computed Files, and Computed Joins.

Tip

If the container continues to fail in scans, profiles, or check validations after a Sync (tables, views, or file patterns) or after Validate + Save (computed assets), investigate the underlying cause of the failures. Common causes include:

  • Permission issues accessing the container.
  • Schema changes that invalidate existing configurations.
  • Network connectivity problems to the data source.
  • Resource constraints or timeouts during data loading.
  • For computed assets: SQL referencing a renamed, dropped, or relocated upstream object.