Como configurar o Visual Studio Code para o Snowpark Scala

Este tópico explica como configurar o Visual Studio Code para o Snowpark.

Neste tópico:

Como configurar o Visual Studio Code para desenvolvimento em Scala

Para conveniência ao escrever código em Scala no Visual Studio Code, instale a extensão Metals. A extensão Metals fornece conclusão de código, dicas de parâmetros e informações sobre tipos e métodos.

Para instalar a extensão Metals:

  1. Na Activity Bar no lado esquerdo da janela, clique no ícone Extensions.

    Ícone de extensões na barra de atividades no Visual Studio Code

    (Se o Activity Bar não for exibido, certifique-se de que View » Appearance » Show Activity Bar esteja marcado).

    Isso exibe a exibição Extensions, que permite navegar e instalar extensões a partir do Mercado de Extensões.

  2. Na caixa de busca para Search Extensions in Marketplace, procure o termo:

    metals
    
    Copy
  3. Nos resultados da busca, encontre a extensão Scala (Metals) e clique em Install.

Para obter mais informações sobre a extensão Scala (Metals), consulte Visual Studio Code na documentação do Metals.

Como criar um novo projeto de Scala no Visual Studio Code

Em seguida, crie um novo projeto de Scala para o Snowpark.

  1. Crie um diretório de espaço de trabalho para seus projetos. Por exemplo:

    mkdir snowpark_projects
    
    Copy

    Esse diretório conterá subdiretórios para os projetos que você criar.

  2. No Visual Studio Code, escolha File » Open, selecione o diretório que você criou e clique em Open.

  3. No ícone Activity Bar à esquerda, clique no ícone Metals.

    Ícone de extensão Metals na barra de atividades no Visual Studio Code
  4. Abaixo de Packages no botão Side Bar (à direita do Activity Bar), clique no botão New Scala Project.

    Botão para criar um novo projeto Scala Visual Studio Code
  5. Selecione um modelo a ser utilizado para o novo projeto (por exemplo, scala/hello-world.g8).

  6. Selecione o diretório do espaço de trabalho que você criou anteriormente (snowpark_projects) e clique em Ok.

  7. Digite um nome para o novo projeto (por exemplo, hello_snowpark).

  8. Quando solicitado pela caixa de diálogo no canto inferior direito da janela, clique em Yes para abrir o novo projeto em uma nova janela.

    Caixa de diálogo solicitando que você abra o novo projeto em uma nova janela
  9. Quando solicitado pela caixa de diálogo no canto inferior direito da janela, clique em Import build para importar a compilação.

    Caixa de diálogo solicitando que você importe a compilação para o novo projeto

Como configurar o projeto do Visual Studio Code para o Snowpark

Em seguida, configure o projeto para o Snowpark.

  1. Na Activity Bar no lado esquerdo da janela, certifique-se de que o ícone Explorer (o primeiro ícone na parte superior) esteja selecionado.

    Ícone do Explorer selecionado na barra de atividades no Visual Studio Code
  2. Abaixo de Explorer na Side Bar (à direita da Activity Bar), abaixo de seu projeto, selecione o arquivo build.sbt para edição.

    Seleção do arquivo build.sbt para edição

    No arquivo build.sbt de seu projeto, faça as seguintes mudanças:

    1. Se a configuração scalaVersion não corresponder à versão que você planeja usar, atualize a configuração. Por exemplo:

      scalaVersion := "2.12.13"
      
      Copy

      Note que você deve usar uma versão de Scala que tenha suporte para uso com a biblioteca do Snowpark.

    2. Adicione a biblioteca do Snowpark à lista de dependências. Por exemplo:

      libraryDependencies += "com.snowflake" % "snowpark" % "1.10.0"
  3. Após fazer essas mudanças, escolha File » Save para salvar suas mudanças.

  4. Quando solicitado pela caixa de diálogo no canto inferior direito da janela, clique em Import changes para importar novamente o arquivo.

    Caixa de diálogo solicitando que você importe novamente o arquivo build.sbt

Como verificar a configuração de seu projeto no Visual Studio Code

Para verificar se você configurou seu projeto para utilizar o Snowpark, execute um exemplo simples do código do Snowpark.

  1. Na Activity Bar no lado esquerdo da janela, certifique-se de que o ícone Explorer (o primeiro ícone na parte superior) esteja selecionado.

    Ícone do Explorer selecionado na barra de atividades no Visual Studio Code
  2. Abaixo de Explorer na Side Bar, abaixo de seu projeto, expanda a pasta src/main/scala e selecione e abra o arquivo Main.scala.

  3. No arquivo Main.scala, substitua o conteúdo com o código abaixo:

    import com.snowflake.snowpark._
    import com.snowflake.snowpark.functions._
    
    object Main {
      def main(args: Array[String]): Unit = {
        // Replace the <placeholders> below.
        val configs = Map (
          "URL" -> "https://<account_identifier>.snowflakecomputing.com:443",
          "USER" -> "<user name>",
          "PASSWORD" -> "<password>",
          "ROLE" -> "<role name>",
          "WAREHOUSE" -> "<warehouse name>",
          "DB" -> "<database name>",
          "SCHEMA" -> "<schema name>"
        )
        val session = Session.builder.configs(configs).create
        session.sql("show tables").show()
      }
    }
    
    Copy

    Observe o seguinte:

    • Substitua os <placeholders> por valores que você usa para se conectar ao Snowflake.

    • Como <account_identifier>, especifique seu identificador da conta.

    • Se você preferir usar a autenticação de par de chaves:

      • Substitua PASSWORD por PRIVATE_KEY_FILE, e defina-o como o caminho do seu arquivo de chave privada.

      • Se a chave privada estiver criptografada, você deve definir PRIVATE_KEY_FILE_PWD como a senha de descriptografia da chave privada.

      Como alternativa a definir PRIVATE_KEY_FILE e PRIVATE_KEY_FILE_PWD, você pode definir a propriedade PRIVATEKEY como o valor da cadeia de caracteres da chave privada não criptografada do arquivo de chave privada.

      • Por exemplo, se seu arquivo de chave privada não estiver criptografado, defina a propriedade como o valor da chave no arquivo (sem os cabeçalhos e rodapés -----BEGIN PRIVATE KEY----- e -----END PRIVATE KEY----- e sem as terminações de linha).

      • Observe que se a chave privada estiver criptografada, você deverá descriptografar a chave antes de defini-la como o valor da propriedade PRIVATEKEY.

  4. Clique em run acima da linha Object para executar o exemplo.

Se aparecer a seguinte mensagem de erro:

Run session not started
Copy

verifique a aba Problems na parte inferior da janela. Se essa aba não aparecer na parte inferior da janela, selecione o item View > Problems no menu.