Einrichten Ihrer Java- und Scala-Umgebung für die Verwendung der Telemetrie-Klasse

Sie können Builds und Pakete für Handler-Code erstellen, der die Klasse com.snowflake.telemetry.Telemetry verwendet, und dann den Handler in einem Stagingbereich referenzieren. Die Telemetrie-Bibliothek ist über Maven und über eine Archivdatei verfügbar, die Sie von der Seite Treiber und Bibliotheken der Snowflake Developer-Website herunterladen können.

Wenn Sie Maven zum Entwickeln von Funktions- oder Prozedur-Handlern in Java oder Scala verwenden, können Sie eine JAR-Datei erstellen, die Ihren Code enthält:

  1. Fügen Sie der „pom.xml“-Datei Ihres Projekts eine Abhängigkeit für das Paket com.snowflake:telemetry hinzu:

    <dependency>
  <groupId>com.snowflake</groupId>
  <artifactId>telemetry</artifactId>
  <version>0.01</version>
</dependency>

  2. Schließen Sie das Paket telemetry aus der JAR-Datei aus, die Sie erstellen, da dieses Paket bereits in Snowflake enthalten ist.

    1. Erstellen Sie in dem Verzeichnis Ihres Projekts ein Unterverzeichnis mit dem Namen assembly/.

    2. Erstellen Sie in diesem Verzeichnis eine Assembly-Deskriptordatei, die angibt, dass Sie Abhängigkeiten zu Ihrer JAR-Datei hinzufügen möchten.

      Ein Beispiel dazu finden Sie unter jar-with-dependencies.

    3. Fügen Sie im Assembly-Deskriptor ein <dependencySet>-Element hinzu, das die Snowpark-Bibliothek von Ihrer JAR-Datei ausschließt. Beispiel:

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

      Weitere Informationen zu Elementen in einem Assembly-Deskriptor finden Sie unter Assembly-Deskriptor-Format.

  3. Fügen Sie Ihrer „pom.xml“-Datei unter <project> » <build> » <plugins> ein <plugin>-Element für das Maven Assembly Plugin hinzu.

    Fügen Sie außerdem unter <configuration> » <descriptors> einen <descriptor> hinzu, der auf die in den vorherigen Schritten erstellte Assembly-Deskriptordatei verweist.

    Beispiel:

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