Instale a biblioteca Snowflake Python APIs.

É possível instalar a biblioteca Snowflake Python APIs para uso com o conda ou um ambiente virtual. Antes de começar, revise as versões compatíveis do Python.

Para definir a biblioteca Snowflake Python APIs, conclua as seguintes etapas:

  1. Ative um ambiente Python.

  2. Instale a biblioteca.

  3. Defina as opções para o cliente da API Python.

Ativação de um ambiente Python

Para configurar um ambiente no qual executar código Python, você precisa ativar um ambiente Python. Por exemplo, você pode usar conda ou um ambiente virtual.

Uso de conda

Nota

Essas etapas são mostradas apenas como exemplo e seguir o exemplo pode exigir direitos adicionais a dados, produtos ou serviços de terceiros que não pertencem ou são fornecidos pela Snowflake. Certifique-se de ter os direitos apropriados sobre dados, produtos ou serviços de terceiros antes de continuar.

Você pode usar conda para criar um ambiente para executar código Python. Se você não tiver o conda, poderá instalá-lo do site do conda.

Para obter informações sobre conda, consulte a documentação Conda. Para baixar e instalar o conda, consulte Instalação do conda.

  1. Crie um ambiente conda:

    conda create -n <env_name> python==3.10
    Copy

  2. Ative o ambiente:

    conda activate <env_name>
    Copy

Uso de um ambiente virtual

Você pode usar venv para criar um ambiente virtual para executar o código Python. Se você ainda não tiver o Python, você poderá baixar e instalar o Python e, depois, criar um ambiente virtual.

Para obter informações sobre venv, consulte venv — Criação de ambientes virtuais. Para baixar o Python, veja downloads do Python.

  1. Use venv para criar um ambiente virtual.

    cd <your Python project root folder>
python3 -m venv '.venv'
    Copy

  2. Ative o ambiente:

    source '.venv/bin/activate'
    Copy

Instale a biblioteca Snowflake Python APIs.

É possível instalar a biblioteca Snowflake Python APIs a partir do Python Package Index (PyPI).

  • No ambiente conda ou virtual que você criou, execute o comando pip a seguir para instalar a biblioteca:

    pip install snowflake -U
    Copy

A instalação do pacote snowflake instala automaticamente todos os seus subpacotes como dependências, incluindo o conector Snowflake Python, a biblioteca Snowpark Python e snowflake.core.

  • Para instalar também a biblioteca Snowpark ML como uma dependência de pacote extra, você pode executar o seguinte comando pip:

    pip install "snowflake[ml]" -U
    Copy

Depois de instalar a biblioteca, você deve criar uma conexão com o Snowflake antes de poder usar a API. Para obter mais informações sobre conexão, consulte Conexão ao Snowflake com o Snowflake Python APIs.

Definição das opções do cliente da API Python

É possível definir as seguintes variáveis de ambiente para controlar as opções do cliente para o Snowflake Python APIs:

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

Especifica se o rastreamento completo da pilha está habilitado em mensagens de erro exibidas.

Possíveis valores:

  • Habilitado: true, t, yes, y, on

  • Desabilitado: Qualquer outro valor ou indefinido

Padrão: Desabilitado

Quando esta opção está desabilitada, o cliente da API imprime rastreamentos de pilha reduzidos em vez de rastreamentos completos de pilha em mensagens de erro.

Para desabilitar esta opção para ambientes de notebook Python, também é necessário executar a seguinte linha em seu notebook. Após executar esta linha uma vez, a variável de ambiente controla o comportamento do rastreamento de pilha por si só:

%xmode minimal
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

Especifica se as tentativas automáticas são habilitadas em solicitações de consulta com códigos de status específicos.

Possíveis valores:

  • Habilitado: true, t, yes, y, on

  • Desabilitado: Qualquer outro valor ou indefinido

Padrão: Habilitado

Quando esta opção está habilitada, o cliente da API tenta novamente solicitações de consulta automaticamente quando elas têm os seguintes códigos de status:

  • 202

  • 429

  • 503

  • 504

Linguagem: Português