Configuration de votre environnement Java et Scala pour l’utilisation de la classe de télémétrie

Vous pouvez créer et empaqueter un code de gestionnaire qui utilise la classe com.snowflake.telemetry.Telemetry, puis référencer le gestionnaire sur une zone de préparation. La bibliothèque de télémétrie est disponible via Maven et via un fichier d’archive que vous pouvez télécharger depuis la page Pilotes et bibliothèques du site Développeur Snowflake.

Si vous utilisez Maven pour développer des gestionnaires de fonctions ou de procédures en Java ou Scala, vous pouvez créer un fichier JAR contenant votre code :

  1. Dans le fichier pom.xml de votre projet, ajoutez une dépendance sur le paquet com.snowflake:telemetry :

    <dependency>
      <groupId>com.snowflake</groupId>
      <artifactId>telemetry</artifactId>
      <version>0.01</version>
    </dependency>
    
    Copy
  2. Excluez le paquet telemetry du fichier JAR que vous construisez car il est déjà inclus dans Snowflake.

    1. Dans le répertoire de votre projet, créez un sous-répertoire nommé assembly/.

    2. Dans ce répertoire, créez un fichier descripteur d’assemblage qui spécifie que vous voulez inclure les dépendances dans votre fichier JAR.

      Pour un exemple, voir jar-with-dependencies.

    3. Dans le descripteur d’assemblage, ajoutez un élément <dependencySet> qui exclut la bibliothèque Snowpark de votre fichier JAR. Par exemple :

      <assembly xmlns="http://maven.apache.org/ASSEMBLY/2.1.0"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.1.0 http://maven.apache.org/xsd/assembly-2.1.0.xsd">
        <id>jar-with-dependencies</id>
        <formats>
            <format>jar</format>
        </formats>
        <includeBaseDirectory>false</includeBaseDirectory>
        <dependencySets>
          <dependencySet>
            <outputDirectory>/</outputDirectory>
            <useProjectArtifact>true</useProjectArtifact>
            <unpack>true</unpack>
            <scope>runtime</scope>
            <excludes>
              <exclude>com.snowflake:telemetry</exclude>
            </excludes>
          </dependencySet>
        </dependencySets>
      </assembly>
      
      Copy

      Pour plus d’informations sur les éléments d’un descripteur d’assemblage, voir Format du descripteur d’assemblage.

  3. Dans votre fichier pom.xml, sous <project> » <build> » <plugins>, ajoutez un élément <plugin> pour le plugin Maven Assembly.

    En outre, sous <configuration> » <descriptors>, ajoutez un <descriptor> qui pointe vers le fichier de descripteur d’assemblage que vous avez créé aux étapes précédentes.

    Par exemple :

    <project>
      [...]
      <build>
        [...]
        <plugins>
          <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
              <descriptors>
                <descriptor>src/assembly/jar-with-dependencies.xml</descriptor>
              </descriptors>
            </configuration>
            [...]
          </plugin>
          [...]
        </plugins>
        [...]
      </build>
      [...]
    </project>
    
    Copy