Native SDK for Connectors Java - 릴리스 정보¶

동작 변경 사항¶

• 새로운 식별자 접근법.

  중요

  이 새로운 접근법은 커넥터에서 식별자가 사용되는 방식을 변경할 수 있으므로 새로운 변경 사항을 철저히 테스트하시기 바랍니다!

  • 이제 SDK는 모든 식별자가 사용자가 제공한 대로 전송되기를 기대하며, SDK는 따옴표 처리된 식별자인지 여부를 자체적으로 판단하여 추후 올바르게 처리합니다.

  • 식별자 자동 따옴표 처리는 Snowflake 쿼리에서 반환된 값을 사용할 때만 수행됩니다.

  • UI에서 새로운 접근법을 사용하려면 커넥터가 PUBLIC.APP_PROPERTIES 뷰에서 UI_ADD_QUOTES_TO_EXISTING_QUOTED_IDENTIFIERS 키와 TRUE 값을 사용하여 새 속성을 반환해야 합니다.

  • com.snowflake.connectors.common.object.Identifier 클래스 변경됨:

    • fromWithAutoQuoting() 및 getName() 메서드가 제거되었습니다.

    • 빈 식별자 개념 제거됨. empty(), isNullOrEmpty(), validateNullOrEmpty(), isEmpty() 메서드 제거됨.

    • 식별자 인스턴스 생성 시 자동 따옴표 처리를 활성화할 수 있는 새로운 from() 메서드를 추가했습니다. 제공된 문자열이 따옴표로 묶이지 않은 완전한 대문자 식별자인 경우 자동 따옴표 처리가 적용되지 않습니다.

    • validate() 메서드가 isValid() 로 변경되었습니다.

    • toSqlString() 메서드가 getValue() 로 변경되었습니다.

    • getUnquotedValue(), getQuotedValue(), getVariantValue() 및 isUnquoted() 메서드를 추가했습니다.

• com.snowflake.connectors.common.object.ObjectName 클래스 변경됨:

  • 데이터베이스 및 스키마 속성을 Optional 로 설정했습니다.

  • getDatabase() 및 getSchema() 의 반환 유형이 Optional 로 변경되었습니다.

  • validate() 메서드가 isValid() 로 변경되었습니다.

  • validateDoubleDot() 메서드가 isDoubleDot() 로 변경되었습니다.

  • getEscapedName() 메서드가 getValue() 로 변경되었습니다.

  • getVariantValue() 및 getSchemaName() 메서드를 추가했습니다.

• com.snowflake.connectors.common.object.Reference 클래스 변경됨:

  • 빈 식별자 개념 제거됨. empty() 및 isEmpty() 메서드 제거됨.

  • validate() 메서드가 isValid() 로 변경되었습니다.

  • referenceName() 메서드가 getName() 으로 변경되었습니다.

  • value() 메서드가 getValue() 로 변경되었습니다.

  • 스키마를 표현하는 새로운 com.snowflake.connectors.common.object.ObjectName 클래스 추가됨. com.snowflake.connectors.common.object.SchemaName 클래스와 유사하게 동작함.

  • 새로운 com.snowflake.connectors.common.object.InvalidSchemaNameException 클래스가 추가되었습니다.

새로운 기능¶

• 리소스 관리 프로시저:

  • 프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 새로운 콜백을 PUBLIC.CREATE_RESOURCE() 프로시저에 도입했습니다. 리소스 만들기 섹션도 참조하십시오.

  • 비활성화된 리소스를 활성화할 수 있는 새로운 PUBLIC.ENABLE_RESOURCE() 프로시저. 또한 프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 콜백이 추가되었습니다. 리소스 활성화 섹션도 참조하십시오.

  • 활성화된 리소스를 비활성화할 수 있는 새로운 PUBLIC.DISABLE_RESOURCE() 프로시저. 또한 프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 콜백이 추가되었습니다. 리소스 비활성화 섹션도 참조하십시오.

  • 특정 리소스의 수집 구성을 업데이트할 수 있는 새로운 PUBLIC.UPDATE_RESOURCE() 프로시저. 또한 프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 콜백이 추가되었습니다. 리소스 업데이트 섹션도 참조하십시오.

• com.snowflake.connectors.util.sql.SqlTools:

  • varcharArgument() 메서드를 대체할 것으로 예상되는 asVarchar() 메서드를 추가했습니다.

  • variantArgument() 메서드를 대체할 것으로 예상되는 asVariant() 메서드를 추가했습니다.

  • varcharArgument() 및 variantArgument() 메서드를 더 이상 사용되지 않는 것으로 표시하고 향후 제거하도록 설정되었습니다.

• 기타 추가 사항:

  • com.snowflake.connectors.application.ingestion.process.IngestionProcessStatuses 클래스에서 수집 프로세스 상태를 상수로 정의했습니다.

  • isNotOk() 메서드가 com.snowflake.connectors.common.response.ConnectorResponse 클래스에 추가되었습니다.

  • 트랜잭션 내에서 withTransaction() 메서드를 사용하여 SQL 문을 실행할 수 있는 com.snowflake.connectors.util.snowflake.DefaultTransactionManager 클래스를 추가했습니다.

  • 태스크 리액터의 로깅이 개선되었습니다.

버그 수정 사항¶

• CREATE_INSTANCE_OBJECTS() 프로시저 중 예기치 않은 오류가 발생하면 작업 리액터 인스턴스 스키마가 제거되던 버그가 수정되었습니다.