Mise en place de IntelliJ IDEA CE pour Snowpark Scala¶

Cette rubrique explique comment configurer IntelliJ IDEA CE pour Snowpark.

Dans ce chapitre :

Configurer IntelliJ IDEA CE pour le développement Scala¶

Pour utiliser Scala dans IntelliJ IDEA CE, vous devez installer le plugin Scala. Voir la section Installation du tutoriel Démarrer avec Scala dans IntelliJ IDEA.

Création d’un nouveau projet Scala dans IntelliJ IDEA¶

Ensuite, créez un nouveau projet Scala pour Snowpark.

Choisissez File » New » Project.
1. Dans la liste de gauche, sélectionnez Scala.
2. Dans la liste de droite, sélectionnez sbt.
3. Cliquez sur Next.
Remplissez les détails de votre nouveau projet.

Pour les JDK et SDK Scala, sélectionnez les JDK et versions de Scala prises en charge pour une utilisation avec des Snowpark.
Cliquez sur Finish pour créer le nouveau projet.

Configuration du projet IntelliJ IDEA pour Snowpark¶

Ensuite, configurez le projet pour Snowpark.

Dans la fenêtre d’outil Project sur la gauche, double-cliquez sur le fichier build.sbt de votre projet.

Dans le fichier build.sbt de votre projet, apportez les modifications suivantes :
1. Si le paramètre scalaVersion ne correspond pas à la version que vous prévoyez d’utiliser, mettez-le à jour. Par exemple :
  scalaVersion := "2.12.13"
  Copy
  Notez que vous devez utiliser une version de Scala qui est prise en charge pour l’utilisation de la bibliothèque Snowpark.
2. Ajoutez la bibliothèque Snowpark à la liste des dépendances. Par exemple :
```
libraryDependencies += "com.snowflake" % "snowpark" % "1.10.0"
```
Enregistrez les modifications dans le fichier build.sbt.
Mettez à jour vos répertoires Maven.

Voir Mettre à jour les répertoires Maven.
Rechargez le projet SBT :
1. Choisissez View » Tool Windows » sbt pour afficher la fenêtre sbt Tool.
2. Cliquez à droite sur le nom du projet, et choisissez Reload sbt Project.
Cela permet à IntelliJ IDEA CE de télécharger la bibliothèque Snowpark et rend les API disponibles pour être utilisées dans votre code.

Vérification de la configuration de votre projet IntelliJ IDEA¶

Pour vérifier que vous avez configuré votre projet pour utiliser Snowpark, exécutez un exemple simple de code Snowpark.

Dans la fenêtre d’outils Project, sur la gauche, développez votre projet, développez les dossiers src/main et sélectionnez le dossier scala.
Cliquez à droite sur le dossier, et choisissez New » Scala class.
Dans la boîte de dialogue Create New Scala Class , entrez le nom « Main », sélectionnez Object et appuyez sur la touche Entrée.
Dans le fichier Main.scala , remplacez le contenu par le code ci-dessous :
```
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
Remarques :
- Remplacez les <espaces réservés> par les valeurs que vous utilisez pour vous connecter à Snowflake.
- Pour <identificateur_de_compte>, indiquez votre identificateur de compte.
- Si vous préférez utiliser l’authentification par paire de clés :
  - Remplacez PASSWORD par PRIVATE_KEY_FILE et indiquez le chemin d’accès à votre fichier de clé privée.
  - Si la clé privée est chiffrée, vous devez définir PRIVATE_KEY_FILE_PWD comme étant la phrase secrète pour le déchiffrage de la clé privée.
  Au lieu de définir PRIVATE_KEY_FILE et PRIVATE_KEY_FILE_PWD, vous pouvez définir la propriété PRIVATEKEY sur la valeur de chaîne de la clé privée non chiffrée du fichier de clé privée.
  - Par exemple, si votre fichier de clé privée n’est pas chiffré, définissez cette propriété sur la valeur de la clé dans le fichier (sans les en-têtes et pieds de page -----BEGIN PRIVATE KEY----- et -----END PRIVATE KEY----- et sans les fins de ligne).
  - Notez que si la clé privée est chiffrée, vous devez déchiffrer la clé avant de la définir comme valeur de la propriété PRIVATEKEY.
- Si vous prévoyez de créer des UDFs :
  - Ne configurez pas votre object pour étendre App Trait. Pour plus de détails, voir Mise en garde concernant la création d’UDFs dans un objet avec l’App Trait.
  - Ne configurez pas votre object pour étendre une classe ou un trait qui n’est pas sérialisable.
Cliquez sur la flèche verte à côté de la ligne Object, et choisissez Run Main pour exécuter l’exemple.