Java UDF 처리기 생성하기¶

Java로 UDF 처리기 작성하기¶

Java UDF 처리기를 작성할 때 다음 요구 사항과 지침을 사용하십시오.

• 클래스를 public으로 정의하십시오.

• 클래스 내에서 UDF 처리기로 사용할 공용 메서드를 하나 이상 선언합니다.

  인라인 UDF의 경우 처리기 메서드를 하나만 선언합니다. 대신 클래스를 스테이징된 처리기로 JAR에 패키징하려는 경우 여러 개의 처리기 메서드를 선언한 이후에 각각을 CREATE FUNCTION 문의 HANDLER 절을 사용하여 처리기로 지정할 수 있습니다.

  인라인 처리기와 스테이징된 처리기의 차이점에 대한 자세한 내용은 처리기 코드를 인라인 또는 스테이지에 유지하기 섹션을 참조하십시오.

  필요한 경우 처리기 메서드로 호출할 다른 메서드를 선언할 수 있습니다.

  각 처리기 메서드에 대해 다음 요구 사항과 지침을 사용합니다.

  • 정적이든 비정적이든, 처리기 메서드를 공용으로 선언합니다.

    메서드가 비정적인 경우 클래스는 또한 인자가 없는 생성자를 선언하거나 생성자를 전혀 선언하지 않아야 합니다.

    Snowflake는 클래스를 인스턴스화할 때 생성자에 어떤 인자도 전달하지 않습니다. 생성자에서 오류가 발생하는 경우, 이 오류는 예외 메시지와 함께 사용자 오류로서 발생합니다.

  • 적절한 반환 형식을 지정하십시오.

    반환 형식은 SQL-Java 형식 매핑 테이블 의 Java Data Type 열에 지정된 데이터 타입 중 하나여야 합니다. 반환 형식은 CREATE FUNCTION 문의 RETURNS 절에 지정된 SQL 데이터 타입과 호환되어야 합니다.

  • 각 처리기 메서드 인자(있는 경우)가 SQL-Java Type Mappings 테이블 의 Java Data Type 열에 지정된 데이터 타입인지 확인합니다.

    Java 변수의 데이터 타입을 선택할 때 Snowflake에서 전송(및 반환)될 수 있는 데이터의 가능한 최댓값 및 최솟값을 고려하십시오.

  • 주어진 Java 클래스에서 메서드를 오버로드하는 경우 Snowflake는 메서드 인자의 유형 이 아닌 개수 만 사용하여 클래스 내에서 처리기 메서드를 구별한다는 점을 명심하십시오. 데이터 타입을 기반으로 확인하는 것은 비실용적입니다. 일부 SQL 데이터 타입은 둘 이상의 Java 데이터 타입에 맵핑될 수 있고 따라서 잠재적으로 둘 이상의 처리기 메서드 서명에 맵핑될 수 있기 때문입니다.

    예를 들어 어떤 클래스에서 두 Java 메서드가 동일 이름과 동일 수의 인자를 갖고 데이터 타입은 다른 경우, 이러한 메서드 중 하나를 처리기로 사용하는 UDF를 호출하면 다음과 유사한 오류가 생성됩니다.

    Cannot determine which implementation of handler "handler name" to invoke since there are multiple
    definitions with <number of args> arguments in function <user defined function name> with
    handler <class name>.<handler name>
    

    웨어하우스를 사용할 수 있는 경우, UDF가 만들어질 때 오류가 감지됩니다. 그렇지 않은 경우, UDF가 호출될 때 오류가 발생합니다.

  • 각 처리기 메서드와 각 메서드가 호출하는 메서드에서 Java UDF에 대해 Snowflake가 적용한 제약 조건을 준수합니다. 이러한 제약 조건에 대한 자세한 내용은 Snowflake에서 적용한 제약 조건 내에서 유지되는 처리기 설계하기 섹션을 참조하십시오.

클래스 경로에 종속 항목 추가하기¶

처리기 코드에 외부 JAR 파일에 패키징된 클래스가 필요할 때는 처리기에서 사용할 수 있는 Snowflake 관리 클래스 경로에 이러한 종속 항목을 추가할 수 있습니다. 다음은 Java UDF 처리기에서 볼 수 있는 클래스 경로에 JAR 파일을 추가하는 방법을 설명합니다. 자세한 내용은 코드에 종속성을 사용할 수 있도록 만들기 섹션을 참조하십시오.

파일 정리¶

Java 코드를 컴파일하여 JAR 파일을 직접 만들 계획이라면 아래와 같이 파일을 구성할 수 있습니다. 이 예에서는 Java의 패키지 메커니즘을 사용할 계획이라고 가정합니다.

• developmentDirectory

  • packageDirectory

    • class_file1.java

    • class_file2.java

  • classDirectory

    • class_file1.class

    • class_file2.class

  • manifest_file.manifest(선택 사항)

  • jar_file.jar

  • put_command.sql

developmentDirectory

이 디렉터리에는 Java UDF를 만드는 데 필요한 프로젝트별 파일이 포함되어 있습니다.

packageDirectory

이 디렉터리에는 패키지에 컴파일하고 포함할 .java 파일이 포함되어 있습니다.

class_file#.java

이 파일에는 UDF의 Java 소스 코드가 포함되어 있습니다.

class_file#.class

이들은 .java 파일을 컴파일하여 만들어진 .class 파일입니다.

manifest_file.manifest

.class 파일(및 필요에 따라 종속성 JAR 파일)을 JAR 파일에 결합할 때 사용되는 선택적 매니페스트 파일입니다.

jar_file.jar

UDF 코드가 포함된 JAR 파일입니다.

put_command.sql

이 파일에는 JAR 파일을 Snowflake 스테이지 에 복사하는 SQL PUT 명령이 포함되어 있습니다.