Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Snowflake Connector for Python

[!CAUTION] This version of the driver is in public preview and is not ready for use with production data and may be unstable.

This package includes the Snowflake Connector for Python, which conforms to the Python DB API 2.0 specification.

The Snowflake Connector for Python provides an interface for developing Python applications that can connect to Snowflake and perform all standard operations. It provides a programming alternative to developing applications in Java or C/C++ using the Snowflake JDBC or ODBC drivers.

The connector has no dependencies on JDBC or ODBC. It can be installed using pip on Linux, Mac OSX, and Windows platforms where Python 3.10.0 (or higher) is installed.

Development

Prerequisites

  • Python 3.10+
  • uv package manager
  • Hatch build tool
  • Rust toolchain (for building core library)
  • Credentials: ../parameters.json (see main README.md for setup instructions)

Setup

Install uv and Hatch:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install Hatch
uv tool install hatch

Note: The Rust core library is built automatically during the build process via a custom Hatch build hook. You don't need to build it manually.

Environment Variables

IMPORTANT: Set up required environment variables before running tests:

export PARAMETER_PATH="$(pwd)/../parameters.json"

Hatch Environments

This project uses Hatch to manage development environments. There are two primary environments for running tests, each designed for a different use case:

dev Environment (for local development)

The dev environment is designed for human developers during active development. It installs the package from sources in editable mode, meaning any code changes are immediately reflected without reinstallation.

Key characteristics:

  • Installs from sources (skip-install = false)
  • Editable mode enabled (dev-mode = true)
  • Changes to source code are immediately available
  • Supports Python matrix: 3.10, 3.11, 3.12, 3.13, 3.14

Usage:

# Run all tests with the dev environment
hatch run dev:all

# Run specific test types
hatch run dev:unit              # Unit tests only
hatch run dev:integ             # Integration tests only
hatch run dev:e2e               # End-to-end tests only

# Run with coverage
hatch run dev:all-cov

# Run with specific Python version
hatch run dev.py3.12:all

# Pass additional pytest arguments
hatch run dev:all -k test_connection --maxfail=1

test Environment (for CI/CD pipelines)

The test environment is designed for CI systems to test the end-to-end software development lifecycle (SDLC). It does not install from sources - instead, it expects a pre-built wheel to be installed, simulating how end users would install and use the package.

Key characteristics:

  • Skips source installation (skip-install = true)
  • No editable mode (dev-mode = false)
  • Requires explicit wheel installation via install-wheel script
  • Tests the actual built artifact, not source code

Usage:

# First, build the wheel
hatch build

# Then install and test with the test environment
hatch run test:install-wheel
hatch run test:all

# Or with specific Python version
hatch run test.py3.12:install-wheel
hatch run test.py3.12:all

Environment Comparison

Aspect dev test
Purpose Local development CI/CD pipelines
Installs from Source (editable) Pre-built wheel
Code changes Immediately reflected Requires rebuild
Tests Source code Built artifact
Use case Developer workflow E2E SDLC validation

Other Environments

# Code quality checks
hatch run precommit:check        # Run all checks (format, lint, type)
hatch run precommit:fix          # Auto-fix formatting and linting issues

# Reference connector tests (for compatibility testing, installs latest v4.x)
hatch run reference:test
# Pin a specific version if needed:
PYTHON_REFERENCE_DRIVER_VERSION='==4.3.0' hatch run reference:test

References

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

snowflake_connector_python-5.0.0rc1.tar.gz (1.5 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

snowflake_connector_python-5.0.0rc1-cp314-cp314-win_amd64.whl (14.8 MB view details)

Uploaded CPython 3.14Windows x86-64

snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_x86_64.whl (21.1 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ x86-64

snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_aarch64.whl (20.3 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ ARM64

snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_11_0_arm64.whl (13.2 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_10_15_x86_64.whl (13.6 MB view details)

Uploaded CPython 3.14macOS 10.15+ x86-64

snowflake_connector_python-5.0.0rc1-cp313-cp313-win_amd64.whl (14.2 MB view details)

Uploaded CPython 3.13Windows x86-64

snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_x86_64.whl (19.3 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_aarch64.whl (18.5 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_11_0_arm64.whl (13.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_10_14_x86_64.whl (13.4 MB view details)

Uploaded CPython 3.13macOS 10.14+ x86-64

snowflake_connector_python-5.0.0rc1-cp312-cp312-win_arm64.whl (13.8 MB view details)

Uploaded CPython 3.12Windows ARM64

snowflake_connector_python-5.0.0rc1-cp312-cp312-win_amd64.whl (14.1 MB view details)

Uploaded CPython 3.12Windows x86-64

snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_x86_64.whl (17.5 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_aarch64.whl (16.8 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_11_0_arm64.whl (12.9 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_10_14_x86_64.whl (13.3 MB view details)

Uploaded CPython 3.12macOS 10.14+ x86-64

snowflake_connector_python-5.0.0rc1-cp311-cp311-win_arm64.whl (13.8 MB view details)

Uploaded CPython 3.11Windows ARM64

snowflake_connector_python-5.0.0rc1-cp311-cp311-win_amd64.whl (14.0 MB view details)

Uploaded CPython 3.11Windows x86-64

snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_x86_64.whl (15.7 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_aarch64.whl (15.0 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_11_0_arm64.whl (12.8 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_10_14_x86_64.whl (13.1 MB view details)

Uploaded CPython 3.11macOS 10.14+ x86-64

File details

Details for the file snowflake_connector_python-5.0.0rc1.tar.gz.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1.tar.gz
Algorithm Hash digest
SHA256 3c3fffe03ccc8dc027737977e7f41188a525d79469ae06b4c1504729d8e59f75
MD5 268fcdd9877bd9158ed86c4cff093e31
BLAKE2b-256 13570bd310a337b96cd2587d0e7b148ec1aa9ecd2efb9397bc60b202034850d4

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp314-cp314-win_amd64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 871a6e7d55f6b3c14307138e5b1345940e46429c252e6f0d82dd89981f140e8f
MD5 eb80053fe81796d703d2b9ece2a6254f
BLAKE2b-256 4fb5abf76eade991ed2d69b5a20a30f9e4b62cdf9d102c7e573aa8357273f8ea

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 440cb38d5bbeb398bd5338ee5d3ef117bd4815e01139cee9ecf101db73577e29
MD5 c9bebbb0040087dae6ac73044b2cae17
BLAKE2b-256 12cbd76b41a71e8570d91209c3b8bb760fbaee5d22bbd538cc45317018b9af3f

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 cbea2af21bc4324b94dc57b75766b1bf60ae0ad5dc94b1a86d46c620bcd8340e
MD5 9994647b99da62597dc869ede3725ebf
BLAKE2b-256 76f6118ffa7d6a510849d2acbd4f5bb477264108e7cbaabd84ee4736c6d63707

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c3aec5a8cb9ce558c26af338f47a0425f6476c268dbf6cb954ad0b751db270d3
MD5 d3540879e698c091911d7bfd526cf559
BLAKE2b-256 8af5d9e7b90a0f2b399c5be6082c4c101e2a113a97fe67b254908a616abadb39

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 7d3ec2a048904481c8678e4b2155150fbe0c5d59ad8f211fdee2cce0c3537f18
MD5 c9fbe885cba46f02d6907695ed6ca985
BLAKE2b-256 c91bbef29476e6f4753469b556dcd6feaa816c06455d38ca42488e2c762f3f62

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 a284fc8a05a5203e220a1ba9cb582ca66ae134716f11fdef44b981b22e41ef18
MD5 372530bb1a63cf6a031f304ce2cb45fc
BLAKE2b-256 5341612109c4436c1a327aebc6c8816cf4601a5deb936cf7343309f8fa0f6260

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 674013a130bb8d0bd0a2ee5ef25f892b9a789739fc5f57e8839bbc616bdf441c
MD5 f7c91f320947da07ae2023fef0d60b24
BLAKE2b-256 29d2009ea6a7e4ce18f8903d2ba1da4080d66e3cd39a7f3f508422ab4ad362c1

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 cfbab49993f193beb0a618c9f278573de4d6652292c79eb9594fb909ce628a8b
MD5 0f7b98292ede56bd14e2b5611dad1b15
BLAKE2b-256 0d51592909066d9632baa260164e2b355de9ba9c21a7c319469a99b504681402

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a708505cacf7af44fc2183d2918c0bb25d0e635f0be8ade3740829a71484ad99
MD5 8a9a06b2bde22fea9cf92e9411841b50
BLAKE2b-256 c3b16995e89151e4aba405c81c1a60cb30677f7367cc820f82f0c733ce594045

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 057bb5fc56d84ea4db6a4b9d1282a0e8c1921f3341034880aef9fdad04c0ec22
MD5 aa2897d8d4dfe472ceba9a93eb24e221
BLAKE2b-256 3114a7a6426a65a6f8af44b19d586cfdd4e4395cbf74e6d9cc4da8a22c70afb3

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-win_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-win_arm64.whl
Algorithm Hash digest
SHA256 bafe1b465eef001856b7035a3939b9f9ec37bf961b31f4b83d045973e1e25a8c
MD5 46a3584d7c920d9c1a5af3afc1204854
BLAKE2b-256 7266140d87955644717858682682e113750103b63595f2bda411716fc523b0a1

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 3f602a78cec5c81792c0b89292e9d1d04eeb2a5ca183485a72db488fdb43ccfa
MD5 aefd3a40ae6300d840ee8dfd28d53507
BLAKE2b-256 b06e7df7f9ead2b87bfba9709123b2040786a02924621204a36cc89a558f85e7

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a2b16ab241e52053084d9b2a7258f3507d9067597380f049a24acc044b5f36f7
MD5 fc9e8c0938a899c57b9d14a4242eb269
BLAKE2b-256 fbc75ca755a051d661db17bc1708fa463cfc1bc45edea3cfb484c6dcbaaa4831

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 0f3a08ba0db57867fd2e572cdda8cf275e000f256a864a3ba1984e19b0892697
MD5 a22431d27a2dd272d1ab529b20865fce
BLAKE2b-256 baef55aa41175dbca79e3122fa6fe64e948ca6f420f2699fcb372efb78ee366c

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 44df3894cab200daeb4112d04920606b989ee026ed4b76e2397b98a69afce4d5
MD5 3d121deb9ef3bf989a2acb62fed20e8a
BLAKE2b-256 f73e0fd88fc756341a10cb5c719c852d944fad20cd10f97ba3d91260cf05faaa

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 05b4cfada5898983ef0fdcc647cf1298dd1dcaf9e9f05388e60aaaac816a2aff
MD5 e2fe0dca81a8d2aa6ca776bbd4e14d67
BLAKE2b-256 6b3fc47218307c0b1941263f6e644af1b92080cc82acb2c50a32511f0dfd71a3

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-win_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-win_arm64.whl
Algorithm Hash digest
SHA256 3be85c965ba739a130e291f7dfc1205ebbc59904bc469ba0320c9a7e519ba6a8
MD5 a53cd8e13d9eddd76fdd6d1d2a35488c
BLAKE2b-256 aa06c060659494a2a95bdeb601bc91bfca00951dfe9337c24aa15ea5d68f1f55

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 8744614f8c901070b6940a380150f908233bc9e1141b92fad63df427d018d597
MD5 7f990283d569a312758ab37c3edcb72c
BLAKE2b-256 a2a7ef026df59b31b96ab8ed34be2ee5c5c2ac312a5d57056db88dbbb6a66c5d

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f38d8fdc93bad3f6a7f8e4cadb3de745df37bc7864e170821156a583c12f8732
MD5 c8618adc972db325e551370c311b93dc
BLAKE2b-256 d752d1e312925a4dad61a8494be7bce5868d30bdba115506f92fb3ea5e29dc79

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 578a68a7166fbe97e0f2cbac7d5bbec9d95bea0207323c147eaa6b2076a5a094
MD5 ab8e1a8e63bf9a27993795d63540e516
BLAKE2b-256 957cd7769ba3966f752bf217d0f369e82e9aed41dc88cb68b08885fa8fce2efe

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 44a537f95e27026d50f031253dacde0da5bb3c8c2a912c56fcaab71aca81c224
MD5 954e52320b04a52ed1b5c5f0e56ef160
BLAKE2b-256 9fdcce50b1a39ec05d4e88b445e83b18c58f655f77419ba0557e8da83b195fe9

See more details on using hashes here.

File details

Details for the file snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 bfa044fa15d6a88c902692c5bb931e6f5c534afbeec8dc6fdd336d0ddeeb6b0a
MD5 0b9889d1bbdbc0fbfba30e193fb90f06
BLAKE2b-256 bc295594fed6e37ad0a02b5443e36df717c727ff4234f5d7d579c45ebed88eed

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page