Snowflake guide

[neelasha23]

Describe your changes

Snowflake integration guide

Issue number

Closes #384

Checklist before requesting a review

• Performed a self-review of my code
• Formatted my code with pkgmt format
• Added tests (when necessary).
• Added docstring documentation and update the changelog (when needed)

---

📚 Documentation preview 📚: https://jupysql--591.org.readthedocs.build/en/591/

[neelasha23]

I have added the guide, but the build is failing because of the dummy credentials. Initially I run the entire notebook, and after all the cell outputs were generated, I changed the connection parameters to dummy values:

engine = create_engine(
    URL(
        drivername="driver",
        user="user",
        password="password",
        account="account",
        database="database",
        role="role",
        schema="schema",
        warehouse="warehouse",
    )
)

However, the cells still try to execute and fails at %sql engine.

Is there any other approach? Should we save these values as readthedocs public env variables and try to read those in the notebook? It would be read like ${env_variable_name}, but this is specific to readthedocs and wont work on notebooks.

@edublancas

[edublancas]

we can do the same that we've done for other tutorials: we run them locally, upload them as ipynb and then configure readthedocs to skip its execution - we should not store snowflake credentials on readthedocs

[edublancas]

check comment above

[edublancas]

btw, hide the connection string. instructions here: https://jupysql.ploomber.io/en/latest/howto.html#hide-connection-string