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

일반적인 변경 사항¶

• SnowSQL 도구를 새로운 Snowflake CLI 도구로 교체

• Java 종속성 업데이트

동작 변경 사항¶

• com.snowflake.connectors.common.object:

  • toString 에서 반환되는 값을 클래스의 getValue 에서와 동일하게 변경했습니다.

    • Identifier

    • ObjectName

    • Reference

    • SchemaName

• com.snowflake.connectors.application.scheduler.SchedulerCreator:

  • 클래스 이름을 SchedulerManager 로 변경했습니다.

• com.snowflake.connectors.taskreactor.commands.queue.CommandsQueueRepository:

  • 클래스 이름을 CommandsQueue 로 변경했습니다.

• com.snowflake.connectors.application.integration.SchedulerTaskReactorOnIngestionScheduled:

  • 클래스 이름을 TaskReactorOnIngestionScheduledCallback 으로 변경했습니다.

  • 이제 클래스는 ResourceIngestionDefinition 및 일반 매개 변수를 사용합니다.

• com.snowflake.connectors.taskreactor.config.ConfigRepository:

  • 이제 구성 값은 항상 베리언트가 아닌 문자열로 취급됩니다.

새로운 기능¶

• 구성 마법사 상태를 재설정할 수 있는 새로운 PUBLIC.RESET_CONFIGURATION() 프로시저를 추가했습니다. 또한 프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 콜백이 추가되었습니다. 구성 재설정 섹션을 참조하십시오.

• 커넥터 상태를 재설정할 수 있는 새로운 PUBLIC.RECOVER_CONNECTOR_STATE(STRING) 프로시저. 커넥터 상태 복구 섹션을 참조하십시오.

• 작업 리액터 인스턴스를 제거할 수 있는 새로운 TASK_REACTOR.REMOVE_INSTANCE(STRING) 프로시저. 인스턴스 제거 섹션을 참조하십시오.

• com.snowflake.connectors.application.configuration.connector.ConnectorConfigurationKey:

  • 새 CORTEX_WAREHOUSE 키를 추가했습니다.

  • 새 CORTEX_USER_ROLE 키를 추가했습니다.

• com.snowflake.connectors.util.time:

  • LocalDate 및 ZoneId 의 JSON 직렬화를 위한 새로운 클래스를 추가했습니다.

• com.snowflake.connectors.common.task.TaskRepository:

  • 선행 작업이 지정된 경우 작업 생성 중 AFTER 매개 변수에 대한 지원을 추가했습니다.

  • USER_TASK_TIMEOUT_MS 매개 변수에 대한 지원을 추가했습니다.

• com.snowflake.connectors.common.task.TaskProperties:

  • 선행 작업에 대한 지원을 추가했습니다.

  • USER_TASK_TIMEOUT_MS 속성에 대한 지원을 추가했습니다.

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

• callProcedureRaw(Session, String, String...) 메서드를 추가했습니다.

• callProcedureRaw(Session, String, String, String...) 메서드를 추가했습니다.

• 수집 워크로드에 사용할 수 있는 간단한 워커 구현인 com.snowflake.connectors.taskreactor.worker.ingestion.SimpleIngestionWorker 클래스를 새로 추가했습니다.

• IngestionWorker 에서 사용할 수 있는 간단한 수집 표현인 com.snowflake.connectors.taskreactor.worker.ingestion.SimpleIngestion 클래스를 새로 추가했습니다.

• 수집 작업을 위한 간단한 작업 항목 구현인 com.snowflake.connectors.taskreactor.worker.ingestion.SimpleIngestionWorkItem 클래스를 새로 추가했습니다.

버그 수정 사항¶

• com.snowflake.connectors.common.task.TaskRepository:

  • create(TaskDefinition, boolean, boolean) 에서 성공적인 작업 생성 조건 확인을 수정했습니다.

• com.snowflake.connectors.util.variant.VarianMapper:

  • 베리언트에서 타임스탬프 처리를 수정했습니다.

• 커넥터 구성 프로세스에 대한 처리기의 기본 입력 검증기를 수정했습니다.

• 대부분의 SELECT 쿼리에서 DataFrame#first 를 제거하여 작업에서 일부 프로시저를 사용할 때 발생하는 문제를 수정했습니다.

• STATE 스키마에서 USAGE 를 앱 역할 ADMIN 에 부여하는 기능을 제거했습니다.

• 작업 리액터 구성 테이블에 누락된 UPDATED_AT 열을 추가했습니다.

동작 변경 사항¶

• 새로운 식별자 접근법.

  중요

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

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