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

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