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. Opcional: Para usar a biblioteca em regiões governamentais, crie a biblioteca de criptografia Python no ambiente.

    Nota

    A biblioteca Snowflake Python APIs depende da biblioteca de criptografia Python para autenticação. Se você estiver usando um ambiente Python compatível com FIPS, você deve compilar a biblioteca de criptografia em relação ao OpenSSL compatível com FIPS do sistema.

  3. Instale a biblioteca.

  4. 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

Criação da biblioteca de criptografia Python para regiões governamentais

Para a autenticação, o Snowflake Python APIs use o Conector Snowflake para Python, que depende da biblioteca de criptografia Python. A biblioteca de criptografia depende da biblioteca C do OpenSSL para todas as operações criptográficas e envia pacotes wheel com uma dependência OpenSSL incluída e estaticamente vinculada.

Como tal, quando você instala cryptography usando o comando padrão pip install cryptography, a biblioteca usa sua própria versão do OpenSSL em vez da versão do sistema. Para obter mais informações, consulte Uso de OpenSSL.

Se você estiver usando a API Python para se conectar a contas Snowflake em regiões governamentais, precisará assegurar-se de que usa um ambiente Python compatível com FIPS. Para garantir a conformidade do FIPS, em vez de instalar a biblioteca de criptografia de um wheel PyPI, você mesmo deve compilá-lo para o OpenSSL compatível com FIPS do seu sistema.

  • Para obter instruções sobre como criar a biblioteca de criptografia em seu sistema operacional específico, consulte Instalação na documentação de cryptography.

Importante

Você deve criar a biblioteca de criptografia dessa maneira antes de executar pip install snowflake -U. Esta compilação define a dependência cryptography e garante que o pacote cryptography não seja extraído do PyPI.

A biblioteca de criptografia deve ser compilada usando uma versão que atenda aos requisitos de dependência definidos na biblioteca do conector Snowflake para Python.

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

    O pacote snowflake é o pacote pai do namespace PEP 420 para o Snowflake Python APIs. Ele inclui snowflake.core, que é o subpacote que fornece Python APIs para gerenciar objetos de recursos do Snowflake.

    A instalação do pacote snowflake instala automaticamente o snowflake.core juntamente com suas dependências necessárias, incluindo o snowflake-connector-python.

  • 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 ou undefined

  • Desabilitado: qualquer outro valor

Padrão: Habilitado

Quando essa opção está desabilitada, a API cliente define sys.tracebacklimit como 0 ao processar solicitações. Essa configuração faz com que o cliente suprima as informações de traceback de todos os tipos de exceções (não apenas as relacionadas à API cliente) e imprima apenas as mensagens de erro.

Para desativar essa opção para ambientes de notebook Python, execute a seguinte linha em seu notebook:

%env _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE=false
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