Native SDK for Connectors Java - 릴리스 정보¶
Native SDK for Connectors Java 라이브러리에 대한 릴리스 정보입니다.
버전 2.2.0(2024년 7월 10일)¶
일반적인 변경 사항¶
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
열을 추가했습니다.
버전 2.1.0(2024년 7월 8일)¶
동작 변경 사항¶
새로운 식별자 접근법.
중요
이 새로운 접근법은 커넥터에서 식별자가 사용되는 방식을 변경할 수 있으므로 새로운 변경 사항을 철저히 테스트하시기 바랍니다!
이제 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
클래스가 추가되었습니다.
기타 추가 사항 및 변경 사항¶
초기화된 작업 리액터 인스턴스에서만 작업을 실행하도록
com.snowflake.connectors.taskreactor.TaskReactorInstanceActionExecutor
의applyToAllInitializedTaskReactorInstances()
메서드가 변경되었습니다. 이전 동작: 모든 등록된 태스크 리액터 인스턴스에서 작업이 실행되었습니다.
새로운 기능¶
리소스 관리 프로시저:
프로시저 흐름 중에 사용자 지정 작업을 수행할 수 있는 새로운 콜백을
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()
프로시저 중 예기치 않은 오류가 발생하면 작업 리액터 인스턴스 스키마가 제거되던 버그가 수정되었습니다.
버전 2.0.0(2024년 5월 24일)¶
초기 릴리스입니다.