데이터 소스 필드

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분
  • 공통 필드 외에도 유형 필드의 값에 따라 데이터 소스 양식에 다른 필드가 나타납니다.

    공통 데이터 소스 필드

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

    필드 설명
    이름 이 데이터 소스의 고유 이름입니다.
    임포트 세트 테이블 레이블 사용할 임포트 세트 스테이징 테이블의 레이블입니다.
    임포트 세트 테이블 이름 입력한 ServiceNow AI Platform 레이블을 사용하여 고유한 테이블 이름을 구성합니다. 이렇게 하면 이미 존재하는 테이블과의 네임스페이스 충돌을 방지할 수 있습니다.
    유형 임포트하려는 데이터의 유형입니다.
    • 원격 파일에서
    • JDBC 데이터베이스에서
    • LDAP 사용
    • OIDC 사용
    • REST를 사용하여통합 허브
    • 데이터 스트림 작업에서통합 허브
    • 사용자 지정 스크립트 사용
    일괄 임포트 사용 이 옵션을 선택하면 데이터 로드 또는 20개 기록 로드 테스트를 클릭할 때 데이터 로드가 일괄 처리되도록 지정합니다.
    배치 크기 배치 크기를 지정합니다. 배치 임포트 사용 필드가 선택된 경우에만 나타납니다.
    glide.import_set_load_usebatch and glide.import_set_load_batch_size 속성은 이러한 필드에 영향을 줍니다. 속성 및 필드의 우선순위 순서는 다음과 같습니다. 속성이 설정된 경우 속성 값을 사용합니다. 그렇지 않은 경우 필드 값을 사용합니다. 두 속성이 모두 설정되지 않은 경우 기본 배치 크기인 1000을 사용합니다.
    • 예를 들어 glide.import_set_load_usebatch = trueglide.import_set_load_batch_size = 200이면 필드 값에 관계없이 배치 크기로 200을 사용합니다.
    • 예를 들어, = true이고 glide.import_set_load_batch_size 속성이 설정되지 않은 경우 glide.import_set_load_usebatch 기본 배치 크기인 1000을 사용합니다.
    • 예를 들어 속성이 설정되지 않고 배치 임포트 사용 필드 = true인 경우 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 시스템 속성 확장을 사용하려면 속성이 예여야 합니다.

    예를 들어 파일 경로/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 서버 서비스에 대해 구성된 사용자 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(통합 허브) 유형 데이터 소스 필드

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

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

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

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

    데이터 스트림()통합 허브 유형 데이터 소스 필드

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

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

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

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

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

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

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

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