Configurando seu ambiente Java e Scala para usar a classe de telemetria

Você pode criar e empacotar o código do manipulador que usa a classe com.snowflake.telemetry.Telemetry e, em seguida, fazer referência ao manipulador em um estágio. A biblioteca de telemetria está disponível por meio do Maven e de um arquivo que você pode baixar na página de Drivers e bibliotecas no site de desenvolvedor do Snowflake.

Se estiver usando o Maven para desenvolver manipuladores de funções ou procedimentos em Java ou Scala, você poderá criar um arquivo JAR contendo seu código:

  1. No arquivo pom.xml de seu projeto, adicione uma dependência ao pacote com.snowflake:telemetry:

    <dependency>
      <groupId>com.snowflake</groupId>
      <artifactId>telemetry</artifactId>
      <version>0.01</version>
    </dependency>
    
    Copy
  2. Exclua o pacote telemetry do arquivo JAR que você compila porque ele já está incluído no Snowflake.

    1. No diretório para seu projeto, crie um subdiretório chamado assembly/.

    2. Nesse diretório, crie um arquivo descritor de assembly que especifica que você deseja incluir dependências em seu arquivo JAR.

      Para obter um exemplo, consulte jar-with-dependencies.

    3. No descritor de assembly, adicione um elemento <dependencySet> que exclui a biblioteca do Snowpark de seu arquivo JAR. Por exemplo:

      <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

      Para obter mais informações sobre os elementos de um descritor de assembly, consulte Formato do descritor de assembly.

  3. Em seu arquivo pom.xml, em <project> » <build> » <plugins>, adicione um elemento <plugin> para o plugin Maven Assembly.

    Além disso, em <configuration> » <descriptors>, adicione um <descriptor> que aponte para o arquivo do descritor de assembly que você criou nas etapas anteriores.

    Por exemplo:

    <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