Demonstrações da API do Snowflake Python¶

Instalação da biblioteca Snowflake Demos¶

Você pode instalar a biblioteca Snowflake Demos para uso com o conda ou com um ambiente virtual. Para configurar a biblioteca, siga estas etapas:

1. Ative um ambiente Python.

2. Para instalar a biblioteca, execute o seguinte comando pip install:

   pip install snowflake.demos
   

   Copy

Configuração de uma conexão padrão do Snowflake¶

A Snowflake Demos API usa a conexão padrão para o Snowflake Python Connector. Para configurar essa conexão, siga as instruções em Configuração de uma conexão padrão.

Por exemplo, para especificar uma conexão nomeada como a conexão padrão no arquivo config.toml do Snowflake, adicione o nome da conexão padrão ao arquivo config.toml da seguinte forma:

default_connection_name = '<connection_name>'

Para obter informações sobre como especificar definições de conexão em um arquivo de configuração TOML, consulte Conexão usando o arquivo connections.toml.

Importação de snowflake.demos¶

Para usar a biblioteca em seu terminal, você pode abrir um shell interativo, como o REPL Python padrão.

1. Execute o seguinte comando (que pode variar dependendo do seu ambiente Python):

   python3
   

   Copy

2. Na sessão REPL, para importar a biblioteca e as funções relevantes, execute o seguinte código:

   from snowflake.demos import help, load_demo, teardown
   

   Copy

Lista atual de demonstrações disponíveis¶

A Snowflake Demos API funciona atualmente com a seguinte lista de demonstrações:

Como carregar e explorar uma demonstração¶

• Para carregar uma demonstração específica e configurar os recursos associados no Snowflake, chame load_demo() com um argumento que especifique demo_name de qualquer demonstração compatível, conforme encontrado na saída help().

  Por exemplo:

  load_demo('get-started-snowflake-ml')
  

  Copy

Esta função faz o seguinte:

• Cria uma conexão com o Snowflake se for a primeira vez que você estiver carregando uma demonstração.

• Cria os notebooks necessários.

• Exibe o URL do notebook para a primeira etapa da demonstração (etapa 1), se você não estiver atribuindo load_demo() a uma variável.

  • Se você atribuir load_demo() a uma variável, precisará chamar demo.show() para obter o primeiro URL do notebook.

A saída deve ser semelhante ao seguinte:

Connecting to Snowflake...✅
Using ACCOUNTADMIN role...✅
Creating Database SNOWFLAKE_DEMO_DB...✅
Creating Schema SNOWFLAKE_DEMO_SCHEMA...✅
Creating Warehouse SNOWFLAKE_DEMO_WH...✅
Creating Stage SNOWFLAKE_DEMO_STAGE...✅
Uploading files to stage SNOWFLAKE_DEMO_STAGE/get-started-snowflake-ml and creating notebooks...
Creating notebook get_started_snowflake_ml_start_here...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_feature_transformations...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowflake_ml_model_training_inference...✅
Creating notebook get_started_snowflake_ml_sf_nb_snowpark_ml_adv_mlops...✅
Running setup for this demo...✅

Visualização do URL da demonstração¶

Você pode usar a função show() para visualizar o URL em uma etapa específica da demonstração.

• Para visualizar o URL da etapa atual, primeiro atribua o resultado de load_demo() a uma variável, como demo, e depois chame show() sem argumentos:

  demo.show()
  

  Copy

  A saída deve ser semelhante a esta:

  Showing step 1.
  Please copy and paste this url in your web browser to open the notebook:
  https://app.snowflake.com/myorg/myaccount/#/notebooks/SNOWFLAKE_DEMO_DB.SNOWFLAKE_DEMO_SCHEMA.GET_STARTED_SNOWFLAKE_ML_START_HERE
  

• Para obter o URL do notebook para uma etapa específica da demonstração, passe o argumento step com um número de etapa especificado para show():

  demo.show(step=1)
  

  Copy

• Para obter o URL do notebook para a próxima etapa em uma demonstração de várias etapas, use a função show_next():

  demo.show_next()
  

  Copy

Exclusão de uma demonstração e seus recursos¶

Quando terminar de explorar as demonstrações que configurou, talvez queira limpar todos os recursos, conjuntos de dados e notebooks criados.

• Para excluir uma única demonstração e seus recursos associados, primeiro atribua o resultado de load_demo() a uma variável como demo, e, em seguida, chame teardown() nela:

  demo.teardown()
  

  Copy

• Para excluir todas as demonstrações e quaisquer recursos associados que tenham sido configurados, chame teardown() como uma função de nível superior.

  teardown()
  

  Copy