Clearer documentation for Snowflake connection using URIs (from Python)

[jhzab]

What feature or improvement would you like to see?

Hey,
I'm writing this as a suggestion to improve upon the documentation.

On the snowflake documentation page it is mentioned how one can use a URI to connect to snowflake. But it isn't clearly mentioned which parameters are actually valid.

Only the parameters for the adbc_driver_snowflake.dbapi.connect are explicitly mentioned, which I haven't tried yet. The gosnowflake documentation is linked, but it's not clear when it is important (the URI parameters apparently).

This distinction is at least important for the authentication type. The URI requires the parameter key authenticator and for instance externalbrowser as value, which are quite different from "adbc.snowflake.sql.auth_type": "auth_ext_browser".

I assume the URI parameters required are all directly parsed by the Snowflake Go driver? A few sentences in that regard would help a fair bit.

I could create a small diff to make this clearer under URI Format?

[lidavidm]

That would be appreciated, yes. It doesn't look like there's a clear reference for the Snowflake URI format. We should probably link to https://docs.snowflake.com/en/user-guide/gen-conn-config and say that we are considered the Go client as far as connection strings are concerned.

[jhzab]

take