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-wheelscript - 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
11 maintainers
Metadata
11 maintainers
Release files for snowflake-connector-python 5.0.0rc1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| snowflake_connector_python-5.0.0rc1.tar.gz | 1.5 MB | Details |
Built distributions (wheels)
Total release size: 335.7 MB
Release files / snowflake_connector_python-5.0.0rc1.tar.gz
| Download URL | snowflake_connector_python-5.0.0rc1.tar.gz |
|---|---|
| Size | 1.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3c3fffe03ccc8dc027737977e7f41188a525d79469ae06b4c1504729d8e59f75
|
|
BLAKE2b-256 checksum How to use checksums |
13570bd310a337b96cd2587d0e7b148ec1aa9ecd2efb9397bc60b202034850d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp314-cp314-win_amd64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 14.8 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
871a6e7d55f6b3c14307138e5b1345940e46429c252e6f0d82dd89981f140e8f
|
|
BLAKE2b-256 checksum How to use checksums |
4fb5abf76eade991ed2d69b5a20a30f9e4b62cdf9d102c7e573aa8357273f8ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 21.1 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
440cb38d5bbeb398bd5338ee5d3ef117bd4815e01139cee9ecf101db73577e29
|
|
BLAKE2b-256 checksum How to use checksums |
12cbd76b41a71e8570d91209c3b8bb760fbaee5d22bbd538cc45317018b9af3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_aarch64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp314-cp314-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 20.3 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
cbea2af21bc4324b94dc57b75766b1bf60ae0ad5dc94b1a86d46c620bcd8340e
|
|
BLAKE2b-256 checksum How to use checksums |
76f6118ffa7d6a510849d2acbd4f5bb477264108e7cbaabd84ee4736c6d63707
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c3aec5a8cb9ce558c26af338f47a0425f6476c268dbf6cb954ad0b751db270d3
|
|
BLAKE2b-256 checksum How to use checksums |
8af5d9e7b90a0f2b399c5be6082c4c101e2a113a97fe67b254908a616abadb39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_10_15_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp314-cp314-macosx_10_15_x86_64.whl |
|---|---|
| Size | 13.6 MB |
| Tags | CPython 3.14 macOS 10.15+ x86-64 |
|
SHA-256 checksum How to use checksums |
7d3ec2a048904481c8678e4b2155150fbe0c5d59ad8f211fdee2cce0c3537f18
|
|
BLAKE2b-256 checksum How to use checksums |
c91bbef29476e6f4753469b556dcd6feaa816c06455d38ca42488e2c762f3f62
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp313-cp313-win_amd64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 14.2 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a284fc8a05a5203e220a1ba9cb582ca66ae134716f11fdef44b981b22e41ef18
|
|
BLAKE2b-256 checksum How to use checksums |
5341612109c4436c1a327aebc6c8816cf4601a5deb936cf7343309f8fa0f6260
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 19.3 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
674013a130bb8d0bd0a2ee5ef25f892b9a789739fc5f57e8839bbc616bdf441c
|
|
BLAKE2b-256 checksum How to use checksums |
29d2009ea6a7e4ce18f8903d2ba1da4080d66e3cd39a7f3f508422ab4ad362c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_aarch64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp313-cp313-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 18.5 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
cfbab49993f193beb0a618c9f278573de4d6652292c79eb9594fb909ce628a8b
|
|
BLAKE2b-256 checksum How to use checksums |
0d51592909066d9632baa260164e2b355de9ba9c21a7c319469a99b504681402
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 13.1 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a708505cacf7af44fc2183d2918c0bb25d0e635f0be8ade3740829a71484ad99
|
|
BLAKE2b-256 checksum How to use checksums |
c3b16995e89151e4aba405c81c1a60cb30677f7367cc820f82f0c733ce594045
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_10_14_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp313-cp313-macosx_10_14_x86_64.whl |
|---|---|
| Size | 13.4 MB |
| Tags | CPython 3.13 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
057bb5fc56d84ea4db6a4b9d1282a0e8c1921f3341034880aef9fdad04c0ec22
|
|
BLAKE2b-256 checksum How to use checksums |
3114a7a6426a65a6f8af44b19d586cfdd4e4395cbf74e6d9cc4da8a22c70afb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-win_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-win_arm64.whl |
|---|---|
| Size | 13.8 MB |
| Tags | CPython 3.12 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
bafe1b465eef001856b7035a3939b9f9ec37bf961b31f4b83d045973e1e25a8c
|
|
BLAKE2b-256 checksum How to use checksums |
7266140d87955644717858682682e113750103b63595f2bda411716fc523b0a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-win_amd64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 14.1 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3f602a78cec5c81792c0b89292e9d1d04eeb2a5ca183485a72db488fdb43ccfa
|
|
BLAKE2b-256 checksum How to use checksums |
b06e7df7f9ead2b87bfba9709123b2040786a02924621204a36cc89a558f85e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 17.5 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
a2b16ab241e52053084d9b2a7258f3507d9067597380f049a24acc044b5f36f7
|
|
BLAKE2b-256 checksum How to use checksums |
fbc75ca755a051d661db17bc1708fa463cfc1bc45edea3cfb484c6dcbaaa4831
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_aarch64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 16.8 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
0f3a08ba0db57867fd2e572cdda8cf275e000f256a864a3ba1984e19b0892697
|
|
BLAKE2b-256 checksum How to use checksums |
baef55aa41175dbca79e3122fa6fe64e948ca6f420f2699fcb372efb78ee366c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.9 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
44df3894cab200daeb4112d04920606b989ee026ed4b76e2397b98a69afce4d5
|
|
BLAKE2b-256 checksum How to use checksums |
f73e0fd88fc756341a10cb5c719c852d944fad20cd10f97ba3d91260cf05faaa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_10_14_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp312-cp312-macosx_10_14_x86_64.whl |
|---|---|
| Size | 13.3 MB |
| Tags | CPython 3.12 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
05b4cfada5898983ef0fdcc647cf1298dd1dcaf9e9f05388e60aaaac816a2aff
|
|
BLAKE2b-256 checksum How to use checksums |
6b3fc47218307c0b1941263f6e644af1b92080cc82acb2c50a32511f0dfd71a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-win_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-win_arm64.whl |
|---|---|
| Size | 13.8 MB |
| Tags | CPython 3.11 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
3be85c965ba739a130e291f7dfc1205ebbc59904bc469ba0320c9a7e519ba6a8
|
|
BLAKE2b-256 checksum How to use checksums |
aa06c060659494a2a95bdeb601bc91bfca00951dfe9337c24aa15ea5d68f1f55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-win_amd64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 14.0 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8744614f8c901070b6940a380150f908233bc9e1141b92fad63df427d018d597
|
|
BLAKE2b-256 checksum How to use checksums |
a2a7ef026df59b31b96ab8ed34be2ee5c5c2ac312a5d57056db88dbbb6a66c5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.7 MB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f38d8fdc93bad3f6a7f8e4cadb3de745df37bc7864e170821156a583c12f8732
|
|
BLAKE2b-256 checksum How to use checksums |
d752d1e312925a4dad61a8494be7bce5868d30bdba115506f92fb3ea5e29dc79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_aarch64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 15.0 MB |
| Tags | CPython 3.11 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
578a68a7166fbe97e0f2cbac7d5bbec9d95bea0207323c147eaa6b2076a5a094
|
|
BLAKE2b-256 checksum How to use checksums |
957cd7769ba3966f752bf217d0f369e82e9aed41dc88cb68b08885fa8fce2efe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.8 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
44a537f95e27026d50f031253dacde0da5bb3c8c2a912c56fcaab71aca81c224
|
|
BLAKE2b-256 checksum How to use checksums |
9fdcce50b1a39ec05d4e88b445e83b18c58f655f77419ba0557e8da83b195fe9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_10_14_x86_64.whl
| Download URL | snowflake_connector_python-5.0.0rc1-cp311-cp311-macosx_10_14_x86_64.whl |
|---|---|
| Size | 13.1 MB |
| Tags | CPython 3.11 macOS 10.14+ x86-64 |
|
SHA-256 checksum How to use checksums |
bfa044fa15d6a88c902692c5bb931e6f5c534afbeec8dc6fdd336d0ddeeb6b0a
|
|
BLAKE2b-256 checksum How to use checksums |
bc295594fed6e37ad0a02b5443e36df717c727ff4234f5d7d579c45ebed88eed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
