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 및 JavaScript UDF의 경우 Snowflake는 유형 이 아닌 메서드 인자의 개수 만으로 처리기 메서드를 구분한다는 점에 유의하십시오. 데이터 타입을 기반으로 확인하는 것은 비실용적입니다. 일부 SQL 데이터 타입은 둘 이상의 Java 데이터 타입에 맵핑될 수 있고 따라서 잠재적으로 둘 이상의 처리기 메서드 서명에 맵핑될 수 있기 때문입니다.

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

    호출할 핸들러 《handler name》의 구현을 확인할 수 없습니다. <class name>.<handler name> 핸들러가 있는 <user defined function name> 함수에 <number of args> 인자가 있는 여러 정의가 있기 때문입니다.

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

    SQL UDF의 경우 Snowflake는 인자의 수와 해당 데이터 타입을 모두 사용하여 오버로드된 함수를 구분합니다.

  • 각 처리기 메서드와 각 메서드가 호출하는 메서드에서 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 명령이 포함되어 있습니다.