PyPI · #1431 most downloaded on PyPI

cloud-sql-python-connector

1.22.07.1M downloads/moGoogleCloudPlatform/cloud-sql-python-connector ↗New releases in your daily digest, changelog included.

Google Cloud SQL Python Connector library

Last release 1 months ago
18 Aug 2026
Ships on a steady schedule
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
64 releases · first in 2021

Release timeline

64 releases since 2021

20212022

Releases

1.22.018 Aug 20263 sources agree
Add PSC DNS and Global Write Endpoint support to Python Connector
1.22.0 (2026-08-18)

Features

Add PSC DNS and Global Write Endpoint support to Python Connector (#1446) (62640f3)

add support for psycopg (#1452) (ba58f8f)

Bug Fixes

psycopg: add platform guard for platforms without AF_UNIX support (#1466) (2dfee66)

update deps to the latest (#1456) (a1bdfc7)

Documentation

update pg8000 link to new repository location (#1368) (2b20167)

One column per quarter.

1.21.024 Jul 20263 sources agree

Add PSC DNS and Global Write Endpoint support to Python Connector

1.21.0 (2026-07-23)

Features

Add PSC DNS and Global Write Endpoint support to Python Connector (#1424) (b34e9c6)

Bug Fixes

update python dependencies (#1443) (2adc515)

Open source →

1.20.426 Jun 20263 sources agree

1.20.4 (2026-06-26) Bug Fixes update dependencies to latest

1.20.4 (2026-06-26)

Bug Fixes

update dependencies to latest (#1438) (34be60c)

Open source →

1.20.327 May 20263 sources agree

Update dependencies to latest as of 2026-05-04

1.20.3 (2026-05-26)

Bug Fixes

update dependencies to latest (#1422) (6bb9b37)
Update dependencies to latest as of 2026-05-04 (#1406) (d1282d8)

Open source →

1.20.217 Apr 20263 sources agree

1.20.2 (2026-04-17) Bug Fixes update dependencies to latest

1.20.2 (2026-04-17)

Bug Fixes

update dependencies to latest (#1402) (4bbe1f8)

Open source →

1.20.116 Mar 20263 sources agree

1.20.1 (2026-03-16) Bug Fixes update dependencies to latest

1.20.1 (2026-03-16)

Bug Fixes

update dependencies to latest (#1379) (8f79f4e)

Open source →

1.20.013 Jan 20263 sources agree

Use configured DNS name to lookup instance IP address ( #1363 ) ( 18eddc4 ), closes #1362

1.20.0 (2026-01-13)

Features

Use configured DNS name to lookup instance IP address (#1363) (18eddc4), closes #1362

Dependencies

Update project dependencies to latest (#1369) (8cb6745)

Open source →

1.19.09 Dec 20253 sources agree

Add python 3.14 and remove python 3.9 support

1.19.0 (2025-12-09)

Features

Add python 3.14 and remove python 3.9 support (#1339) (a2e8c4d)

Documentation

Add sample Cloud Run example application (#1335) (adc25f6)
Update documentation to describe how to use Advanced DR write endpoint. (#1332) (2e1ed21)

Open source →

1.18.59 Oct 20253 sources agree

error on connect_async() event loop mismatch

1.18.5 (2025-10-09)

Bug Fixes

error on connect_async() event loop mismatch (#1113) (3030b82)

Open source →

1.18.412 Aug 20253 sources agree

1.18.4 (2025-08-12) Bug Fixes bump dependencies to latest

1.18.4 (2025-08-12)

Bug Fixes

bump dependencies to latest (#1317) (6ebfac6)

Open source →

1.18.311 Jul 20253 sources agree

suppress lint check for _scopes property

1.18.3 (2025-07-11)

Bug Fixes

suppress lint check for _scopes property (#1308) (821245c)

Open source →

1.18.220 May 20253 sources agree

## 1.18.2 (2025-05-20) ### Bug Fixes * bump dependencies to latest

1.18.2 (2025-05-20)

Bug Fixes

bump dependencies to latest (#1295) (dc907ef)

Open source →

1.18.116 Apr 20253 sources agree

## 1.18.1 (2025-04-16) ### Bug Fixes * bump dependencies to latest (#1283) (f29b639) ### Documentation * use lambda over getconn func

1.18.1 (2025-04-16)

Bug Fixes

bump dependencies to latest (#1283) (f29b639)

Documentation

use lambda over getconn func (#1251) (6ecf894)

Open source →

1.18.024 Mar 20253 sources agree

reset connection when the DNS record changes

1.18.0 (2025-03-21)

Features

add domain name validation (#1246) (15934bd)
reset connection when the DNS record changes (#1241) (1405f56)

Open source →

1.17.013 Feb 20253 sources agree

add support for GOOGLE_CLOUD_QUOTA_PROJECT env var

1.17.0 (2025-02-12)

Features

add support for GOOGLE_CLOUD_QUOTA_PROJECT env var (#1231) (5232055)

Bug Fixes

update create_async_connector args (#1232) (b4f8f52)

Open source →

1.17.0.dev013 Feb 2025pre-release

add support for GOOGLE_CLOUD_QUOTA_PROJECT env var

Features

add support for GOOGLE_CLOUD_QUOTA_PROJECT env var (#1231) (5232055)

Bug Fixes

update create_async_connector args (#1232) (b4f8f52)

Open source →

1.16.014 Jan 20253 sources agree

add support for GOOGLE_CLOUD_UNIVERSE_DOMAIN env var

1.16.0 (2025-01-13)

Features

add support for GOOGLE_CLOUD_UNIVERSE_DOMAIN env var (#1221) (ac77932)

Open source →

1.15.010 Dec 20243 sources agree

add support for DNS names with Connector

1.15.0 (2024-12-10)

Features

add support for DNS names with Connector (#1204) (1a8f274)
improve aiohttp client error messages (#1201) (11f9fe9)

Open source →

1.14.020 Nov 20243 sources agree

support native asyncpg connection pools

1.14.0 (2024-11-20)

Features

support native asyncpg connection pools (#1182) (eb95a9d)

Open source →

1.13.022 Oct 20243 sources agree

improve key for connector cache

1.13.0 (2024-10-22)

Features

add support for Python 3.13 (#1177) (6e6a1c8)
drop support for Python 3.8 (#1176) (10c9172)
improve key for connector cache (#1172) (066c14e)

Bug Fixes

remove ConnectorLoopError from connector.connect (#1170) (a348659)

Open source →

1.12.118 Sept 20243 sources agree

set PSC ip type based on pscEnabled

1.12.1 (2024-09-17)

Bug Fixes

set PSC ip type based on pscEnabled (#1158) (53e40c7)

Open source →

1.12.013 Aug 20243 sources agree

use non-blocking disk read/writes

1.12.0 (2024-08-13)

Features

use non-blocking disk read/writes (#1142) (d2fd465)

Dependencies

update python non-major dependencies (#1149) (2e27c05)

Open source →

1.11.010 Jul 20243 sources agree

invalidate cache on bad connection info and IP lookup

1.11.0 (2024-07-10)

Features

invalidate cache on bad connection info and IP lookup (#1118) (672dc4e)

Bug Fixes

let DNS resolve outside connector (#1120) (d321f79)
retry 50x errors with exponential backoff (#1125) (2da9128)

Open source →

1.10.011 Jun 20243 sources agree

add support for lazy refresh strategy

1.10.0 (2024-06-11)

Features

add support for lazy refresh strategy (#1093) (b9526bb)
validate driver with database engine (#1108) (a7c7861)

Open source →

1.9.214 May 20243 sources agree

update dependency cryptography to v42.0.7

1.9.2 (2024-05-14)

Dependencies

update dependency cryptography to v42.0.7 (#1076) (a4aec7e)

Open source →

1.9.117 Apr 20243 sources agree

add minimum version for google-auth dep

1.9.1 (2024-04-17)

Bug Fixes

add minimum version for google-auth dep (#1065) (b13d172)

Dependencies

update dependency aiohttp to v3.9.5 (#1063) (bd6c323)

Open source →

1.9.016 Apr 20243 sources agree

add universe domain support to Connector (TPC)

1.9.0 (2024-04-16)

Features

add universe domain support to Connector (TPC) (#1045) (b1e9dee)

Dependencies

update dependency aiohttp to v3.9.4 (#1060) (78b3671)
Update dependency google-auth to v2.29.0 (#1043) (2ac2fd1)
Update dependency pg8000 to v1.31.1 (#1053) (eaa371d)

Open source →

1.8.012 Mar 20243 sources agree

update create_async_connector args

1.8.0 (2024-03-12)

Features

support ip_type as str (#1029) (e087704)

Bug Fixes

update create_async_connector args (#1016) (c3f51a2)

Dependencies

Update dependency cryptography to v42.0.5 (#1015) (b47dfef)
Update dependency google-auth to v2.28.2 (#1034) (bf20bbc)
Update dependency pg8000 to v1.30.5 (#1026) (e66f4e3)

Open source →

1.7.013 Feb 20243 sources agree

add support for a custom user agent

1.7.0 (2024-02-13)

Features

add support for a custom user agent (#986) (82da410)
add support for Python 3.12 (#905) (7501d17)

Dependencies

Update dependency aiohttp to v3.9.3 (#993) (168b1f4)
Update dependency cryptography to v42.0.2 (#994) (6b762df)
Update dependency google-auth to v2.27.0 (#980) (def011a)

Open source →

1.6.017 Jan 20243 sources agree

add support for domain-scoped projects

1.6.0 (2024-01-17)

Features

add support for domain-scoped projects (#937) (3d1f36e)

Dependencies

Update dependency google-auth to v2.26.2 (#964) (43d7ad6)
update dependency pg8000 to v1.30.4 (#962) (8012c8f)

Open source →

1.5.012 Dec 20233 sources agree

introduce compatibility with native namespace packages

1.5.0 (2023-12-12)

Features

introduce compatibility with native namespace packages (#906) (083da11)

Dependencies

Update dependency aiohttp to v3.9.1 (#916) (b6f9485)
Update dependency cryptography to v41.0.7 (#917) (43e22e1)
Update dependency google-auth to v2.25.2 (#929) (24439a9)

Open source →

1.4.315 Nov 20233 sources agree

use IAM login creds in expiration logic

1.4.3 (2023-11-15)

Bug Fixes

use IAM login creds in expiration logic (#898) (7f8a3a4)
Use utcnow() in refresh calculation (#890) (469ed04)

Dependencies

Update dependency asyncpg to v0.29.0 (#887) (9c566ea)
Update dependency cryptography to v41.0.5 (#874) (9f9dd0d)
Update dependency pg8000 to v1.30.3 (#882) (13e9d31)

Open source →

1.4.211 Oct 2023

Update dependency aiohttp to v3.8.6

1.4.2 (2023-10-09)

Dependencies

Update dependency aiohttp to v3.8.6 (#864) (0d4cf17)
Update dependency cryptography to v41.0.4 (#851) (c700e9b)
Update dependency pg8000 to v1.30.2 (#848) (62079f7)

Open source →

Additional notes2 sources agree

Dependencies

Update actions/checkout action to v3.6.0 (#829) (f6c1fea)
Update actions/checkout action to v4 (#837) (0f570a6)
Update actions/checkout action to v4.1.0 (#855) (0566b15)
Update actions/setup-python action to v4.7.1 (#858) (1085306)
Update actions/upload-artifact action to v3.1.3 (#838) (3238c96)
Update dependencies for github (#863) (cad15e2)
Update dependency aiohttp to v3.8.6 (#864) (0d4cf17)
Update dependency black to v23.9.1 (#840) (89e90fd)
Update dependency cryptography to v41.0.4 (#851) (c700e9b)
Update dependency pg8000 to v1.30.2 (#848) (62079f7)
Update dependency pytest to v7.4.2 (#835) (3d05557)
Update dependency SQLAlchemy to v2.0.21 (#849) (f5e9c2f)
Update dependency types-mock to v5.1.0.2 (#836) (9a57a41)
Update github/codeql-action action to v2.21.5 (#832) (6c7c322)
Update github/codeql-action action to v2.21.6 (#841) (71b9347)
Update github/codeql-action action to v2.21.7 (#847) (53a19ad)
Update github/codeql-action action to v2.21.8 (#850) (2bd4f3a)
Update github/codeql-action action to v2.21.9 (#857) (28f07ae)

Open source →

1.4.118 Aug 20233 sources agree

re-use existing connections on force refresh

1.4.1 (2023-08-18)

Bug Fixes

re-use existing connections on force refresh (#828) (f98c1b6)

Open source →

1.4.08 Aug 20233 sources agree

configure pg8000 connection with SSLSocket

1.4.0 (2023-08-08)

Features

configure pg8000 connection with SSLSocket (#789) (a6433b9)

Dependencies

Update dependency aiohttp to v3.8.5 (#801) (7ed23d0)
Update dependency cryptography to v41.0.3 [SECURITY] (#810) (d11b3a5)
Update dependency pg8000 to v1.30.1 (#808) (c4cd9bc)
Update dependency python-tds to v1.13.0 (#818) (65cccf3)

Open source →

1.3.011 Jul 20233 sources agree

add support for PSC connections

1.3.0 (2023-07-11)

Features

add support for PSC connections (#766) (c238fe3)
remove support for Python 3.7 (#761) (5b8a172)

Documentation

update getconn in README samples (#773) (179c06e)

Dependencies

Update dependency asyncpg to v0.28.0 (#785) (036982e)
Update dependency cryptography to v41.0.2 (#790) (869fb49)
Update dependency google-auth to v2.21.0 (#781) (be4b492)
Update dependency pg8000 to v1.29.8 (#778) (46e8637)
Update dependency PyMySQL to v1.1.0 (#780) (dd3fa64)

Open source →

1.2.413 Jun 2023

Update dependency cryptography to v41.0.1

1.2.4 (2023-06-13)

Bug Fixes

improve timeout handling (#760) (723b6f1)

Dependencies

Update dependency cryptography to v41.0.1 (#749) (e89755c)
Update dependency google-auth to v2.19.1 (#751) (eee33ae)
Update dependency pg8000 to v1.29.6 (#746) (47d6d87)

Documentation

document SQLAlchemy async connection pooling (#758) (bb1c72a)

Open source →

Additional notes2 sources agree

Bug Fixes

improve timeout handling (#760) (723b6f1)

Dependencies

Update dependency cryptography to v41.0.1 (#749) (e89755c)
Update dependency google-auth to v2.19.1 (#751) (eee33ae)
Update dependency pg8000 to v1.29.6 (#746) (47d6d87)
Update dependency Requests to v2.31.0 (#733) (c18869d)

Documentation

document SQLAlchemy async connection pooling (#758) (bb1c72a)

Open source →

1.2.39 May 20233 sources agree

Update dependency cryptography to v40.0.2

1.2.3 (2023-05-08)

Dependencies

Update dependency cryptography to v40.0.2 (#705) (5544086)
Update dependency google-auth to v2.17.3 (#698) (37a5150)
Update dependency Requests to v2.30.0 (#717) (db4fbcb)

Open source →

1.2.213 Apr 20233 sources agree

Update dependency cryptography to v40

1.2.2 (2023-04-10)

Dependencies

Update dependency cryptography to v40 (#669) (e95fa98)
Update dependency google-auth to v2.17.2 (#690) (02bf543)
Update dependency PyMySQL to v1.0.3 (#677) (4bb8751)

Open source →

1.2.114 Mar 20233 sources agree

update dependencies to latest versions

1.2.1 (2023-03-14)

Bug Fixes

update dependencies to latest versions (#646) (d758987)

Open source →

1.2.015 Feb 20233 sources agree

improve reliability of certificate refresh

1.2.0 (2023-02-13)

Features

improve reliability of certificate refresh (#599) (e546efb)

Open source →

1.1.010 Jan 20233 sources agree

format user argument for automatic IAM authn

1.1.0 (2023-01-10)

Features

add support for Python 3.11 (#577) (b2669be)
format user argument for automatic IAM authn (#449) (88f5bcd)

Bug Fixes

update TLS protocol for python3.10 (#575) (bb4ab5d)

Open source →

1.0.06 Dec 20223 sources agree

add support for MySQL auto IAM AuthN

1.0.0 (2022-12-06)

Features

add support for MySQL auto IAM AuthN (#466) (80644d7)

Open source →

0.9.33 Nov 20223 sources agree

set minimum version constraint on cryptography

0.9.3 (2022-11-03)

Bug Fixes

set minimum version constraint on cryptography (#530) (d2dc58f)

Open source →

0.9.22 Nov 20223 sources agree

update cryptography to latest release

0.9.2 (2022-11-02)

Bug Fixes

update cryptography to latest release (#527) (d6276ec)

Open source →

0.9.11 Nov 20223 sources agree

update dependencies to latest versions

0.9.1 (2022-11-01)

Bug Fixes

update dependencies to latest versions (#522) (799f35f)

Open source →

0.9.018 Oct 20223 sources agree

add sqladmin_api_endpoint arg to specify Cloud SQL Admin API endpoint

0.9.0 (2022-10-18)

Features

add sqladmin_api_endpoint arg to specify Cloud SQL Admin API endpoint (#475) (bf1a909)
add quota_project arg to specify quota and billing project (#472) (528852a)
downscope token used for IAM DB AuthN (#488) (d461d75)

Bug Fixes

throw error if Auto IAM AuthN is unsupported (#476) (fef0cd7)

Open source →

0.8.17 Sept 20223 sources agree

add README code sample for Flask-SQLAlchemy and FastAPI

0.8.1 (2022-09-07)

Documentation

add README code sample for Flask-SQLAlchemy and FastAPI (#432) (fadc357)

Open source →

0.8.02 Aug 20223 sources agree

stop event loop on Connector.close

0.8.0 (2022-07-29)

Features

add support for asyncpg driver (#390) (3170b1f)

Bug Fixes

stop event loop on Connector.close (#410) (5cda924)

Open source →

0.7.012 Jul 2022Deprecated3 sources agree

remove deprecated global 'connector.connect' function

0.7.0 (2022-07-12)

⚠ BREAKING CHANGES

remove deprecated global 'connector.connect' function (#394)

Features

remove deprecated global 'connector.connect' function (#394) (50b81fb)

Open source →

0.6.27 Jun 2022

add Colab Notebook for Postgres, MySQL and SQL Server

0.6.2 (2022-06-07)

Documentation

add Colab Notebook for Postgres, MySQL and SQL Server (#372) (a16068f)

Open source →

Additional notes2 sources agree

Documentation

add Colab Notebook for Postgres, MySQL and SQL Server (#372) (a16068f)

0.6.1 (2022-05-03)

Bug Fixes

update dependencies to latest versions (#351) (009dfda)

Open source →

0.6.13 May 2022

update dependencies to latest versions

0.6.1 (2022-05-03)

Bug Fixes

update dependencies to latest versions (#351) (009dfda)

Open source →

0.6.05 Apr 2022Deprecated

deprecate default connect method

0.6.0 (2022-04-05)

⚠ BREAKING CHANGES

deprecate default connect method (#316)

Features

add asynchronous interface to Connector (#280) (9cef59e)
deprecate default connect method (#316) (4a543dc)
drop support for Python 3.6 (#299) (0d63f90)

Bug Fixes

resolve TimeoutError and add context manager to Connector (#309) (372e401)

Miscellaneous Chores

release 0.6.0 (#326) (9ea1b73)

Open source →

Additional notes2 sources agree

⚠ BREAKING CHANGES

deprecate default connect method (#316)

Features

add asynchronous interface to Connector (#280) (9cef59e)
deprecate default connect method (#316) (4a543dc)
drop support for Python 3.6 (#299) (0d63f90)

Bug Fixes

resolve TimeoutError and add context manager to Connector (#309) (372e401)

0.5.2 (2022-03-01)

⚠ BREAKING CHANGES

update error messages and doc strings (#276)

Bug Fixes

allow support for impersonated credentials via gcloud (#262) (8b7e5f7)
remove enable_iam_auth from downstream kwargs and catch error (#273) (f9576f3)
update error messages and doc strings (#276) (68f37b4)

0.5.1 (2022-02-01)

Bug Fixes

make asyncio.Lock() run in background thread (#252) (f52ba7e)
remove token padding strip (#245) (cb77021)

0.5.21 Mar 2022

update error messages and doc strings

0.5.2 (2022-03-01)

⚠ BREAKING CHANGES

update error messages and doc strings (#276)

Bug Fixes

allow support for impersonated credentials via gcloud (#262) (8b7e5f7)
remove enable_iam_auth from downstream kwargs and catch error (#273) (f9576f3)
update error messages and doc strings (#276) (68f37b4)

Miscellaneous Chores

release 0.5.2 (#286) (5deffcf)

Open source →

0.5.12 Feb 2022

make asyncio.Lock() run in background thread

0.5.1 (2022-02-01)

Bug Fixes

make asyncio.Lock() run in background thread (#252) (f52ba7e)
remove token padding strip (#245) (cb77021)

Documentation

update code samples with python designation (#256) (17994cc)

Open source →

0.5.04 Jan 2022

add arg for specifying credentials

Features

add arg for specifying credentials (#226) (85f5476)
add support for python 3.10 (#227) (8359f85)
expose Connector object to allow multiple connection configurations. (#210) (cef1ed1)

Bug Fixes

consolidate to 'ip_type' instead of 'ip_types' for connect args (#220) (5f9cf58)

Open source →

Additional notes2 sources agree

Features

add arg for specifying credentials (#226) (85f5476)
add support for python 3.10 (#227) (8359f85)
expose Connector object to allow multiple connection configurations. (#210) (cef1ed1)

Bug Fixes

consolidate to 'ip_type' instead of 'ip_types' for connect args (#220) (5f9cf58)

0.4.3 (2021-12-07)

Documentation

update README with connection pooling (#196) (af05cf5)

0.4.2 (2021-11-02)

Bug Fixes

update dependencies to latest versions (#192) (046838a)

0.4.1 (2021-10-05)

Bug Fixes

update dependencies to latest versions (#176) (03197ab)

Open source →

0.4.37 Dec 2021

update README with connection pooling

Documentation

update README with connection pooling (#196) (af05cf5)

Open source →

0.4.22 Nov 2021

update dependencies to latest versions

Bug Fixes

update dependencies to latest versions (#192) (046838a)

Open source →

0.4.15 Oct 2021

update dependencies to latest versions

Bug Fixes

update dependencies to latest versions (#176) (03197ab)

Open source →

0.4.07 Sept 20213 sources agree

add rate limiter and force refresh function

Features

add rate limiter and force refresh function (#146) (b390fac)
switch development status to beta (#149) (b415e03)

Documentation

Add Support policy to README (#151) (7dbc4b5)

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →

cloud-sql-python-connector

Release timeline

Releases

1.22.0 (2026-08-18)

Features

Bug Fixes

Documentation

1.21.0 (2026-07-23)

Features

Bug Fixes

1.20.4 (2026-06-26)

Bug Fixes

1.20.3 (2026-05-26)

Bug Fixes

1.20.2 (2026-04-17)

Bug Fixes

1.20.1 (2026-03-16)

Bug Fixes

1.20.0 (2026-01-13)

Features

Dependencies

1.19.0 (2025-12-09)

Features

Documentation

1.18.5 (2025-10-09)

Bug Fixes

1.18.4 (2025-08-12)

Bug Fixes

1.18.3 (2025-07-11)

Bug Fixes

1.18.2 (2025-05-20)

Bug Fixes

1.18.1 (2025-04-16)

Bug Fixes

Documentation

1.18.0 (2025-03-21)

Features

1.17.0 (2025-02-12)

Features

Bug Fixes

Features

Bug Fixes

1.16.0 (2025-01-13)

Features

1.15.0 (2024-12-10)

Features

1.14.0 (2024-11-20)

Features

1.13.0 (2024-10-22)

Features

Bug Fixes

1.12.1 (2024-09-17)

Bug Fixes

1.12.0 (2024-08-13)

Features

Dependencies

1.11.0 (2024-07-10)

Features

Bug Fixes

1.10.0 (2024-06-11)

Features

1.9.2 (2024-05-14)

Dependencies

1.9.1 (2024-04-17)

Bug Fixes

Dependencies

1.9.0 (2024-04-16)

Features

Dependencies

1.8.0 (2024-03-12)

Features

Bug Fixes

Dependencies

1.7.0 (2024-02-13)

Features

Dependencies

1.6.0 (2024-01-17)

Features

Dependencies

1.5.0 (2023-12-12)