데이터 소스 필드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기10분
  • 공통 필드 외에도 유형 필드의 값에 따라 데이터 소스 양식에 다른 필드가 나타납니다.

    공통 데이터 소스 필드

    이러한 필드는 모든 데이터 원본에 공통적으로 적용됩니다.

    필드 설명
    이름 이 데이터 소스의 고유한 이름입니다.
    임포트 세트 테이블 레이블 사용할 임포트 세트 스테이징 테이블의 레이블입니다.
    임포트 세트 테이블 이름 Now Platform 입력한 레이블을 사용하여 고유한 테이블 이름을 구성합니다. 이렇게 하면 네임스페이스가 이미 존재하는 테이블과 충돌하는 것을 방지할 수 있습니다.
    유형 임포트하려는 데이터 유형:
    • 원격 파일에서
    • JDBC 데이터베이스에서
    • LDAP 사용
    • OIDC 사용
    • REST를 사용하여 다음을 통해 데이터 임포트Integration Hub
    • 데이터 스트림 작업에서Integration Hub
    • 사용자 지정 스크립트 사용
    일괄 임포트 사용 이 옵션을 선택하면 데이터 로드 또는 20개 기록 로드 테스트를 클릭할 때 데이터 로드가 일괄 처리되도록 지정합니다.
    배치 크기 배치의 크기를 지정합니다. 일괄 임포트 사용 필드를 선택한 경우에만 나타납니다.
    glide.import_set_load_usebatch and glide.import_set_load_batch_size 속성은 이러한 필드에 영향을 줍니다. 속성과 필드의 우선순위는 다음과 같습니다. 속성이 설정된 경우 속성 값을 사용합니다. 그렇지 않은 경우 필드 값을 사용합니다. 두 속성이 모두 설정되지 않은 경우 기본 일괄 처리 크기인 1000을 사용합니다.
    • 예를 들어 = trueglide.import_set_load_batch_size = 200이면 glide.import_set_load_usebatch 필드 값에 관계없이 배치 크기로 200을 사용합니다.
    • 예를 들어 = true이고 glide.import_set_load_batch_size 속성이 설정되지 않은 경우 glide.import_set_load_usebatch 기본 일괄 처리 크기인 1000을 사용합니다.
    • 예를 들어 속성이 설정되지 않고 배치 임포트 사용 필드 = 예인 경우 glide.import_set_load_usebatch배치 크기 필드 값(또는 배치 크기 필드 값이 설정되지 않은 경우 기본값 1000)을 사용합니다
    • 예를 들어 속성 = false이고 glide.import_set_load_usebatch일괄 임포트 사용 필드 = true인 경우 속성이 false로 설정되어 있으므로 일괄 임포트를 사용하지 마십시오.
    애플리케이션 이 기록에 대한 애플리케이션 범위입니다.

    파일 형식 데이터 소스 필드

    이러한 추가 필드는 유형 필드 값이 파일인 경우 데이터 소스 양식에 나타납니다.

    필드 설명
    형식 "Strict Open XML Document"로 저장하지 않는 한 기본 XML 기반 파일 형식(.xlsx)만 지원됩니다.
    압축됨 임포트 파일이 압축된 경우 선택됩니다.
    파일 검색 방법 이 파일에 대한 검색 방법입니다.
    파일 경로 임포트할 파일의 경로입니다.
    ${system.property.name} 형식을 사용하여 이 필드에 시스템 속성 값을 포함할 수 있습니다. 연결이 이루어지면 변수가 지정된 속성 값으로 바뀝니다.
    주:
    HTTP 또는 HTTPS를 사용하여 검색한 파일의 경우 시스템 속성 확장을 glide.ds.file.http.variable_replacement 사용하려면 속성이 true여야 합니다.

    예를 들어 파일 경로/countries.csv?key=${datasource.apikey}를 지정할 수 있습니다. 연결되면 시스템 속성 값이 datasource.apikey 매개 변수 값으로 key 전달됩니다.

    주:
    HTTP 및 HTTPS 프로토콜의 경우 파일 경로는 자동으로 URL로 인코딩됩니다. 이러한 프로토콜 중 하나를 사용할 때 URL로 인코딩된 파일 경로를 지정하지 마십시오.
    CSV 구분 기호 CSV 파일의 구분 기호 문자입니다.
    스크립트 구문 분석 한 줄의 입력을 구문 분석하는 데 사용되는 스크립트입니다. 스크립트를 입력할 때 스크립트 자동 완성 기능이 사용 가능한 선택 항목을 표시합니다. 자세한 내용은 파일 형식 데이터 소스 문서를 참조하십시오.
    시트 번호 데이터를 로드할 Excel 시트 번호입니다.
    헤더 행 열 레이블을 로드할 Excel 행 번호입니다.
    각 행의 경로 임포트 세트 테이블의 행이 될 JSON 객체를 선택하는 데 사용되는 경로 표현식입니다. 경로는 JSON 객체용이어야 합니다.
    배열 취소 JSON 배열을 값으로 버리려면 선택합니다. JSON 배열을 값으로 직렬화하려면 선택 취소합니다.
    하위 노드 확장 XML 노드 또는 JSON 개체의 자식 요소를 추가 열로 변환해야 하는 경우 선택됩니다. 상위 열 값이 XML 또는 JSON 조각이어야 하는 경우 선택 취소합니다. JSON의 경우 이 옵션을 선택하면 배열이 아닌 객체만 확장됩니다. 중첩 배열 지원에 대한 자세한 내용은 을 참조하십시오 JSON 파일 임포트 예시.
    단일 열의 데이터 단일 열에 데이터를 저장하려면 선택합니다.
    각 행에 대한 Xpath 임포트 테이블에서 행이 되는 노드를 선택하는 XPath 식입니다. 선택한 노드의 자식은 행의 열이 됩니다.
    SCP 인증 방법 사용자 이름과 암호 또는 공개 키를 사용하여 인증할지 선택합니다.
    주:
    퍼블릭-프라이빗 키 쌍을 사용하여 데이터 소스를 인증할 수 없습니다. 대신 사용자 이름 및 암호 인증을 사용합니다.
    서버 테이블을 임포트할 서버의 이름입니다.
    포트 지정된 서버에 연결하는 데 사용할 포트입니다. 이 필드는 파일 검색 방법으로 HTTP 또는 HTTPS를 선택하는 경우에 나타납니다.
    사용자 이름 JDBC 서버에서 인증을 위한 사용자 이름입니다.
    암호 JDBC 서버에서 인증을 위한 암호입니다.
    개인 키 파일 레거시 SCP 퍼블릭-프라이빗 키 파일을 사용하는 경우 키 파일입니다.
    주:
    • 퍼블릭-프라이빗 키 쌍을 사용하여 데이터 소스를 인증할 수 없습니다. 대신 사용자 이름 및 암호 인증을 사용합니다.
    • 이 레거시 옵션은 사용하지 마십시오. 사용할 수 있지만 지원되지 않습니다.
    시스템 키 스토어 저장된 모든 인증서에 대해 FTPS 서버의 인증서를 확인하려면 선택합니다. 이 인증서는 인스턴스에서 지원하는 모든 유형일 수 있습니다. 선택하지 않으면 인스턴스가 Java 기본 인증서를 사용하여 FTPS 서버를 검증합니다. 이 필드는 파일 검색 방법 값이 FTPS인 데이터 소스에만 사용할 수 있습니다. 인증 TLS, 인증 SSL, 암시적 SSL 및 암시적 TLS를 포함한 모든 FTPS 파일 검색 방법이 지원됩니다.

    JDBC 유형 데이터 소스 필드

    이러한 추가 필드는 유형 필드 값이 JDBC인 경우 데이터 소스 양식에 나타납니다.

    필드 설명
    MID 서버 사용 이 데이터 소스에 연결하는 데 사용할 MID 서버입니다.
    형식 MySQL, Oracle 또는 SQLServer 형식 중 하나입니다.
    인스턴스 이름 SQL Server와의 동적 포트 연결을 지원하는 데 사용됩니다. 연결을 보장하려면 다시 부팅할 때마다 동적으로 새 포트 번호를 받는 SQL Server의 인스턴스 이름을 제공합니다. 이 필드는 SQLServer 가 데이터 소스 형식으로 선택된 경우에만 나타납니다.
    데이터베이스 이름 데이터베이스 인스턴스의 이름입니다.
    데이터베이스 포트 데이터베이스의 포트 번호입니다. SQL Server와 동적 포트 연결을 사용하는 경우 이 필드를 비워 둡니다.
    통합 인증 사용 JDBC 연결에서 SQL Server 인증을 위해 Windows MID Server 서비스에 대해 구성된 사용자의 ID를 사용할 수 있도록 하려면 선택합니다. 자세한 내용은 JDBC 유형 데이터 소스 문서를 참조하십시오.
    사용자 이름 JDBC 서버에서 인증을 위한 사용자 이름입니다.
    암호 JDBC 서버에서 인증을 위한 암호입니다.
    서버 테이블을 임포트할 서버의 이름입니다.
    쿼리 실행할 쿼리 유형: 테이블 또는 특정 SQL의 모든 행입니다. SQL 문을 실행하도록 선택하면 SQL 문 필드가 나타납니다.
    쿼리 제한 시간 JDBC 드라이버가 쿼리(SELECT)가 완료될 때까지 대기한 시간(초)입니다. 0은 시간 제한이 없음을 의미합니다. 시간 제한을 초과하면 통합에서 JDBC 결과에 접근할 수 없는 것으로 간주하고 결과를 오류 상태로 놓습니다.
    연결 시간 제한 MID 서버 연결 캐시 풀이 닫히고 풀에서 제거되기 전까지의 시간(초)입니다. 0은 시간 제한이 없음을 의미합니다.
    테이블 이름 데이터를 익스포트할 테이블의 이름입니다.
    SQL 문 데이터베이스에서 원하는 데이터를 추출하는 SQL 문입니다.
    마지막 실행 날짜/시간 사용 임포트 실행 중에 데이터베이스에서 검색되는 데이터의 양을 제어합니다. 이 옵션을 선택하지 않으면 지정된 테이블의 모든 행이 매번 임포트됩니다. 일회성 임포트이거나 대상 테이블의 모든 데이터가 새 데이터인 경우 이 설정을 사용할 수 있습니다. 이 옵션을 선택하면 날짜/시간 값을 선택하여 임포트한 데이터를 델타 값으로만 제한할 수 있는 두 개의 추가 필드가 나타납니다.
    마지막 실행 날짜/시간 이 필드의 datetime 값은 아래에서 선택한 데이터베이스 필드에서 자동으로 채워지며 이전 실행의 최신 값을 나타냅니다. 이 값은 데이터 소스의 마지막 런타임 이후 변경된 기록으로 검색되는 기록 수를 제한하는 동적 필터로 작동합니다.
    마지막 실행 데이터베이스 필드 다음 실행에서 필터로 사용될 소스 테이블의 필드 이름입니다. 이 값은 대상 데이터베이스 유형에 따라 대/소문자를 구분해야 할 수 있습니다.
    추가 데이터베이스 매개변수 이 데이터 소스에 대해 작성된 URL의 끝에 추가할 선택적 매개변수입니다. 세미콜론으로 구분된 매개 변수 목록입니다. 이 필드를 보려면 양식을 구성해야 할 수 있습니다.

    LDAP 유형 데이터 소스 필드

    이 추가 필드는 유형 필드 값이 LDAP일 때 데이터 소스 폼에 나타납니다.

    필드 설명
    LDAP 대상 LDAP OU 정의 목록에서 선택한 대상입니다.

    OIDC 유형 데이터 소스 필드

    유형 필드 값이 OIDC인 경우 이 추가 필드가 데이터 소스 양식에 나타납니다.

    필드 설명
    형식 기본값은 -- 없음 -- 이며 변경할 수 없습니다.

    REST(Integration Hub) 유형 데이터 소스 필드

    이러한 추가 필드는 유형 필드 값이 REST(통합 허브)인 경우 데이터 소스 양식에 나타납니다.

    필드 설명
    형식 다음 형식 중 하나: 사용자 지정(스크립트를 통해 구문 분석), JSON 또는 XML.
    요청 작업 데이터를 가져오기 위해 호출할 데이터 소스 요청 작업입니다. 게시된 요청 작업만 선택할 수 있습니다.

    아래 대화 상자의 링크를 클릭하여 에서 새 데이터 소스 요청 작업을 Integration Hub생성/구성합니다. 요청 작업이 에 게시된 Integration Hub후 데이터 소스 기록에서 요청 작업 으로 선택할 수 있습니다. 자세한 내용은 작업 속성 정의 문서를 참조하십시오.

    페이지 매김 지원 요청 작업에 대한 페이지 매김을 사용하려면 선택합니다. 페이지 매김을 사용하면 모든 기록을 한 번에 처리하는 대신 지정된 수의 기록을 한 번에 처리하여 처리 오버헤드를 줄일 수 있습니다.
    제한 페이지당 최대 기록 수입니다. 예를 들어 한 번에 50개 기록을 처리하려면 제한을 50으로 입력합니다.
    오프셋 페이지 매김에 사용되는 초기 오프셋입니다. 오프셋은 시작 기록 번호입니다. 예를 들어 한 번에 50개 기록을 처리하려면 첫 번째 기록부터 시작하여 제한을 50으로 설정하고 오프셋을 0으로 입력합니다.
    스크립트 구문 분석 한 줄의 입력을 구문 분석하는 데 사용되는 스크립트입니다. 스크립트를 입력할 때 스크립트 자동 완성 기능이 사용 가능한 선택 항목을 표시합니다. 자세한 내용은 파일 형식 데이터 소스 문서를 참조하십시오.
    각 행의 경로 임포트 세트 테이블의 행이 될 JSON 객체를 선택하는 데 사용되는 경로 표현식입니다. 경로는 JSON 객체용이어야 합니다.
    배열 취소 JSON 배열을 값으로 버리려면 선택합니다. JSON 배열을 값으로 직렬화하려면 선택 취소합니다.
    하위 노드 확장 XML 노드 또는 JSON 개체의 자식 요소를 추가 열로 변환해야 하는 경우 선택됩니다. 상위 열 값이 XML 또는 JSON 조각이어야 하는 경우 선택 취소합니다. JSON의 경우 이 옵션을 선택하면 배열이 아닌 객체만 확장됩니다. 중첩 배열 지원에 대한 자세한 내용은 을 참조하십시오 JSON 파일 임포트 예시.
    단일 열의 데이터 단일 열에 데이터를 저장하려면 선택합니다.
    각 행에 대한 Xpath 임포트 테이블에서 행이 되는 노드를 선택하는 XPath 식입니다. 선택한 노드의 자식은 행의 열이 됩니다.

    데이터 스트림(Integration Hub) 유형 데이터 소스 필드

    이러한 추가 필드는 유형 필드 값이 데이터 스트림(통합 허브)인 경우 데이터 소스 양식에 나타납니다.

    필드 설명
    유형 데이터 스트림(Integration Hub) 유형 데이터 소스입니다.
    데이터 스트림 작업
    • 데이터 스트림 작업 선택 에서 Integration Hub기존에 게시된 데이터 스트림 작업을 사용하도록 선택됨
    • 게시된 데이터 스트림 작업을 선택하거나 새 데이터 스트림 작업을 만듭니다. 다음 이유 중 하나로 선택됨:
      • 게시된 데이터 스트림 작업을 선택하는 경우 이 단추를 클릭하여 에서 데이터 스트림 작업을 Integration Hub엽니다.
      • 데이터 스트림 작업을 선택하지 않은 경우 이 단추를 클릭하여 새 데이터 스트림 작업을 Integration Hub만들고 게시합니다.
    주:
    데이터 스트림 작업에는 프로덕션에 사용하기 위한 구독이 필요합니다.
    연결

    데이터 스트림 작업에 대한 연결 별칭을 지정합니다. 기본 상위 별칭을 사용하거나 해당 하위 별칭 중 하나를 선택할 수 있습니다. 사용 가능한 하위 별칭이 메뉴에 나열됩니다.

    이 필드는 데이터 스트림 작업이 연결 별칭을 사용하도록 구성된 경우에만 사용할 수 있습니다. 자세한 내용은 연결 및 자격 증명 별칭 만들기를 참조하십시오.

    단일 열의 데이터 단일 열에 데이터를 저장하려면 선택합니다.
    데이터 스트림 작업 입력 데이터 스트림 작업에 정의된 입력에 따라 추가 필드가 나타날 수 있습니다.

    사용자 지정(스크립트를 통해 로드) 유형 데이터 소스 필드

    이 추가 필드는 유형 필드 값이 사용자 지정(스크립트를 통해 로드)인 경우 데이터 소스 양식에 나타납니다.

    필드 설명
    데이터 로더 데이터를 로드하는 데 사용되는 스크립트입니다. 자세한 내용은 사용자 지정(스크립트를 통해 로드) 유형 데이터 소스 문서를 참조하십시오.