임포트 세트 속성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분

    • 여러 속성이 임포트 세트 동작을 제어합니다.

    임포트 세트 속성

    glide.import_set.보존.선도.공간
    가져오기 프로세스에서 Excel 데이터 셀의 선행 공백을 유지할지 여부를 지정합니다. false인 경우 가져오기 프로세스는 Excel 데이터 셀에서 줄 바꿈하지 않는 선행 공백을 제거합니다. true인 경우 임포트 프로세스는 줄 바꿈하지 않는 선행 공백을 유지합니다.
    주:
    가져오기 프로세스는 항상 Excel 데이터 셀에서 후행 공백을 제거합니다.
    glide.import_set_row.dynamically_add_fields
    임포트 세트가 스테이징 테이블에 새 열을 추가할 수 있는지(예) 또는 추가할 수 없는지(아니오)를 지정합니다. 임포트 세트가 많이 포함된 인스턴스는 스테이징 테이블의 모든 행을 변경해야 하기 때문에 임포트에서 열을 추가할 때 때때로 응답하지 않을 수 있습니다. 경우에 따라 데이터베이스 테이블 변경 조치로 인해 가동 중단이 발생합니다. 이 속성을 false로 설정하면 임포트 세트에서 스테이징 테이블에 열을 추가할 수 없으며 로그 메시지가 생성됩니다. 임시 해결책으로 관리자는 새 딕셔너리 항목을 생성한 다음 임포트 세트를 다시 임포트하여 스테이징 테이블에 열을 수동으로 추가할 수 있습니다.
    com.glide.loader.verify_target_field_size
    임포트 세트 필드의 동적 크기 조정을 사용합니다. 기본 설정 false를 사용하면 임포트 세트 필드 길이를 결정하기 위해 소스 데이터의 최대 20개 기록이 샘플링됩니다. 샘플링된 모든 기록에서 필드가 비어 있으면 기본 길이인 40이 사용됩니다. 로드된 데이터 중 임포트 세트 테이블 필드 길이를 초과하는 데이터는 잘립니다. 모든 임포트 세트 필드에서 데이터 길이와 일치하도록 열 크기를 100씩 늘릴 수 있도록 하려면 이 속성을 예 로 설정합니다. 예를 들어 수신 소스 데이터의 길이가 60인 경우 시스템은 열의 길이를 160으로 설정합니다. 이는 데이터 소스에만 관련이 있습니다.
    glide.ds.file.http.variable_replacement
    HTTP 또는 HTTPS를 사용하여 검색되는 파일 형식 데이터 소스에 대해 시스템 속성 확장을 활성화합니다.
    glide.scheduled_import.stop_on_error
    예약된 상위 임포트에서 오류가 발생할 때 임포트 프로세스를 중지하려면 true 로 설정합니다. 이 동작은 한 임포트 세트가 다른 임포트 세트의 결과에 종속되는 경우에 유용할 수 있습니다.
    glide.impex.transformer.empty_value_nil
    임포트 세트 스테이징 테이블에서 변환하는 동안 빈 문자열 값이 처리되는 방식을 통제합니다. 빈 문자열을 유지하려면 이 속성을 true 로 설정합니다. 빈 문자열을 문자열 NULL로 변환하려면 이 속성을 false로 설정합니다.
    주:
    빈 문자열은 이 속성 값에 관계없이 데이터베이스에 항상 null 값으로 저장됩니다.
    변환 중에 onBefore 스크립트를 실행할 때 이 속성을 사용할 수 있습니다. 이 속성을 true 로 설정하면 hasValue() 또는 nil() 함수를 사용하여 null 값을 확인할 수 있습니다.
    com.glide.loader.max_scan_rows
    데이터를 임포트할 때 스테이징 테이블 필드를 자동으로 생성하기 위해 샘플링되는 소스 데이터의 행 수를 제어합니다. 이 속성은 JDBC, XLS, CSV 및 XML 임포트에 적용되지만 JSON 및 XSLX 임포트에는 적용되지 않습니다.

    동시 임포트 세트 속성

    glide.scheduled_import.max.concurrent.import_sets
    동시 임포트 하나에 대한 최대 임포트 세트 수입니다.
    com.glide.concurrent_import_set_insert_mutex_spin_wait
    잠금을 획득하면 뮤텍스가 소비하는 대기 시간(밀리초)입니다.
    com.glide.concurrent_import_set_insert_mutex_expiration
    뮤텍스 만료 시간(밀리초)입니다.
    com.glide.concurrent_import_set_mutex_fast_lock
    빠른 잠금(true) 또는 SQL 기반 느린 잠금(false)을 사용할지 여부를 지정합니다.

    웹 서비스 임포트 세트 속성

    com.glide.ws_import_set.column_resize
    예일 경우 임포트 시 동적 열 크기 조정을 활성화합니다. 웹 서비스 임포트 세트에 대한 준비 테이블입니다.
    com.glide.ws_import_set.column_resize.max_row_count
    웹 서비스 임포트 세트를 사용하여 동적 열 크기를 조정할 때 임포트 준비 테이블에 포함될 수 있는 최대 행 수입니다.

    이 행보다 많은 임포트 준비 테이블은 true인 경우에도 com.glide.ws_import_set.column_resize 웹 서비스 임포트 세트에서 동적 크기 조정을 사용하지 않습니다.

    이 속성의 최댓값은 500,000입니다.

    CSV 속성

    com.glide.csv.loader.ignore_non_parseable_lines
    인스턴스에서 CSV 임포트에 잘못된 데이터가 포함된 하나 이상의 행(행)(예: 데이터 열이 누락된 행)을 무시할 수 있도록 허용합니다. 기본적으로 가져오기는 CSV 파일의 잘못된 데이터를 무시할 수 없으며 첫 번째 오류에서 실패합니다.
    com.glide.csv.loader.max_오류_허용됨
    임포트가 실패하기 전에 무시할 수 있는 최대 줄(행) 수를 지정합니다. 임포트에 성공하면 임포트는 오류로 인해 임포트에서 무시한 행 수를 나열합니다.
    glide.import.csv.charset
    임포트할 CSV 파일의 문자 세트입니다. 유효한 값은 UTF-8 및 WINDOWS-1252입니다. 특수 문자를 임포트할 때 UTF-8 형식을 사용해야 할 수도 있습니다.

    Excel 임포트 속성

    glide.excel.multiplier
    Excel 임포트에 할당할 최대 인스턴스 메모리 양입니다. 이 속성은 .XLS 파일만 임포트할 때만 적용됩니다.

    이 속성의 값을 Excel 파일의 파일 크기에 곱하여 총 메모리 할당을 결정합니다. 사용된 메모리는 속성에 지정된 glide.excel.max_memory_percent 제한을 초과할 수 없습니다.

    예를 들어, 기본값이 8이고 Excel 파일이 10MB인 경우 인스턴스는 임포트에 최대 80MB의 메모리를 사용합니다.

    glide.xlsx.승수
    Excel 임포트에 할당할 최대 인스턴스 메모리 양입니다. 이 속성은 임포트할 때 적용됩니다. XLSX 파일에만 해당됩니다.

    이 속성의 값을 Excel 파일의 파일 크기에 곱하여 총 메모리 할당을 결정합니다. 사용된 메모리는 속성에 지정된 glide.excel.max_memory_percent 제한을 초과할 수 없습니다.

    예를 들어, 기본값이 10이고 Excel 파일이 10MB인 경우 인스턴스는 임포트에 최대 100MB의 메모리를 사용합니다.

    주:
    이 속성의 값은 수정하지 마십시오. 최적의 성능을 위해 기본값이 선택되었습니다.
    glide.excel.max_메모리_백분율
    Excel 임포트에 허용되는 최대 메모리 양으로, 총 인스턴스 메모리의 백분율입니다.
    glide.excel.use_disk_backed_strings_table
    XLSX 임포트 중에 인스턴스가 디스크 스토리지를 사용하여 큰 파일 데이터를 유지관리하는지 여부를 제어합니다. XLSX 파일 데이터를 메모리에만 저장하려면 이 속성을 false로 설정하십시오. 이 속성을 false로 설정하면 XLSX 임포트 중에 사용되는 메모리가 증가합니다.
    glide.excel.in_memory_strings_table_size_mb
    glide.excel.use_disk_backed_strings_table true일 경우 디스크 스토리지에 기록하기 전에 XLSX 파일 데이터를 저장하는 데 사용할 수 있는 최대 메모리 양(MB)입니다. 이 속성 값을 낮게 설정하면 XLSX 임포트 중에 사용되는 메모리가 줄어들지만 임포트 속도가 느려질 수 있습니다.
    glide.xlsx.import.debug
    XLSX 임포트에 디버그 로깅을 사용합니다.
    glide.import.excel.enhanced_number_conversions
    true인 경우 1,000만보다 큰 숫자 값이 임포트 스테이징 테이블에 보존됩니다. false인 경우 1,000만 개를 초과하는 가져온 값은 원래 가져온 값과 일치하지 않을 수 있는 과학적 표기법으로 변환됩니다. 대부분의 데이터 종류를 임포트하려면 이 속성을 true로 설정해야 합니다.
    glide.transform.boolean.casesensitive
    true인 경우 (TRUE/FALSE)의 대문자 부울 값은 항상 false로 변환됩니다. false인 경우 대문자 부울 값(TRUE/FALSE)이 올바르게 변환됩니다.

    JDBC 연결 속성

    glide.jdbcprobeloader.retry
    JDBC 프로브 로더가 JDBC 데이터 소스에서 반환되는 데이터를 처리하려고 시도하는 횟수입니다. 재시도 사이에 정의된 glide.jdbcprobeloader.retry_millis 값에 대해 일시 중지됩니다.
    glide.jdbcprobeloader.retry_millis
    JDBC 데이터 소스의 데이터를 처리하려는 재시도 사이에 JDBC 프로브 로더가 대기하는 시간(밀리초)입니다.

    로깅 및 디버그 속성

    com.glide.import_set.importlog_level
    임포트 세트가 로그에 추가하는 정보의 양을 지정합니다. 가능한 값은 INFO, WARNING 및 ERROR입니다. 개발 환경에서 이를 INFO로 설정하고 프로덕션에서 WARNING 또는 ERROR로 변경하여 데이터베이스에 대한 로깅 노이즈 트래픽의 양을 줄일 수 있습니다.
    주:
    이 속성은 준비 테이블 정리와 관련된 로깅에 영향을 주지 않습니다.
    glide.import.debug
    모든 임포트 프로세스에 디버그 로깅을 사용합니다.
    • 유형: true | false
    • 기본값: false
    • 위치: 시스템 속성 추가시스템 속성 [sys_properties] 테이블에 추가
    glide.importlog.log_to_table
    정보 레벨 로그 메시지를 import_log 테이블에 쓸지 여부를 지정합니다. true인 경우 정보 수준 로그 메시지가 기록됩니다.
    주:
    통합 허브 ETL에 대한 정보 수준 로그는 이 속성 설정에 관계 없이 importlog.log 테이블에 기록됩니다. 추가 예외를 추가하려면 에 문의하십시오 Now Support.
    glide.import.sftp.debug
    SFTP 임포트에 대한 추가 디버그 로깅을 사용하도록 설정합니다. 이 속성을 활성화하면 SSH 세션 동안 인스턴스가 모든 발신 및 수신 메시지를 로깅합니다.
    glide.import.scp.debug
    SCP 임포트에 대한 추가 디버그 로깅을 활성화합니다. 이 속성을 활성화하면 SSH 세션 동안 인스턴스가 모든 발신 및 수신 메시지를 로깅합니다.