Como criar uma sessão para o Snowpark Python

Para utilizar o Snowpark em seu aplicativo, você precisa criar uma sessão. Para conveniência em código escrito, você também pode importar os nomes dos pacotes e objetos.

Neste tópico:

Como criar uma sessão

O primeiro passo para usar a biblioteca é estabelecer uma sessão com o banco de dados do Snowflake.

Importe a classe da sessão.

>>> from snowflake.snowpark import Session
Copy

Para autenticar, você pode usar os mesmos mecanismos que aqueles suportados pelo conector Snowflake para Python.

Estabeleça uma sessão com um banco de dados do Snowflake usando os mesmos parâmetros (por exemplo, o nome da conta, nome de usuário etc.) usados na função connect no conector Snowflake para Python. Para obter mais informações, consulte os parâmetros para a função connect na documentação da API do conector de Python.

Construa um dicionário (dict) contendo os nomes e valores desses parâmetros (por exemplo, account, user, role, warehouse, database, schema etc.).

Para criar a sessão:

  1. Crie um dicionário Python (dict) contendo os nomes e valores dos parâmetros para a conexão ao Snowflake.

  2. Passe este dicionário para o método Session.builder.configs para retornar um objeto construtor com esses parâmetros de conexão.

  3. Chame o método create do builder para estabelecer a sessão.

O exemplo a seguir usa um dict contendo parâmetros de conexão para criar uma nova sessão:

>>> connection_parameters = {
...    "account": "<your snowflake account>",
...    "user": "<your snowflake user>",
...    "password": "<your snowflake password>",
...    "role": "<your snowflake role>",  # optional
...    "warehouse": "<your snowflake warehouse>",  # optional
...    "database": "<your snowflake database>",  # optional
...    "schema": "<your snowflake schema>",  # optional
...  }  

>>> new_session = Session.builder.configs(connection_parameters).create()
Copy

Para o parâmetro account, use seu identificador da conta. Observe que o identificador da conta não inclui o sufixo snowflakecomputing.com.

Nota

Este exemplo mostra uma forma de criar uma sessão, mas há muitas outras formas de conexão, incluindo: o autenticador padrão, login único (SSO), autenticação multifator (MFA), autenticação de par de chaves, usando um servidor proxy e OAuth. Para obter mais informações, consulte Uso do conector Python.

Como encerrar uma sessão

Se você não precisar mais usar uma sessão para executar consultas e quiser cancelar qualquer consulta que esteja em execução no momento, chame o método close do objeto Session. Por exemplo:

>>> new_session.close()
Copy
Linguagem: Português