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 o conda ou um ambiente virtual (venv).

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 o conda para criar um ambiente para executar o 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

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