metricsign
Start free
Medium severityexecutionSnowflake

Power BI Refresh Error:
253003

What does this error mean?

The Python connector's PUT command failed to upload a local file to a Snowflake stage. The upload was initiated but could not be completed, leaving the stage file in an incomplete or missing state.

Common causes

  • 1Insufficient privileges on the stage — the user role lacks WRITE access
  • 2The local source file does not exist or cannot be read (path error or file lock)
  • 3Cloud storage credentials used by an external stage have expired
  • 4Network timeout or interruption during multipart upload
  • 5Snowflake's internal stage storage quota has been reached (uncommon)

How to fix it

  1. 1Verify the user has WRITE privileges on the stage.
  2. 2Confirm the local file path is correct and the file exists: os.path.exists(local_path).
  3. 3For external stages, validate cloud storage credentials: check the STORAGE INTEGRATION expiry.
  4. 4Retry the PUT command — uploads support automatic retry for transient network errors.
  5. 5Check available stage storage (for internal stages) in SHOW STAGES.

Frequently asked questions

Does PUT overwrite an existing file on the stage?

Yes — by default PUT overwrites files with the same name. Use OVERWRITE=FALSE to skip files that already exist on the stage.

Should I delete stage files after a successful COPY INTO?

Yes, when using internal stages — use PURGE=TRUE in the COPY INTO statement or run REMOVE @stage/file after loading to free up storage.

Official documentation: https://github.com/snowflakedb/snowflake-connector-python/blob/main/src/snowflake/connector/errorcode.py

Other execution errors