다음을 통해 공유

jdbctemplate.xml 참조

  • 아티클

 

적용 대상: FAST Search Server 2010

마지막으로 수정된 항목: 2015-03-09

jdbctemplate.xml 의 복사본을 사용하면 FAST Search 데이터베이스 커넥터의 설정을 구성할 수 있습니다.

FAST Search 데이터베이스 커넥터에서는 구성 설정을 사용하여 콘텐츠 추출을 제어합니다. 인스턴스마다 각기 다른 구성 파일을 사용하여 여러 데이터베이스 커넥터 인스턴스를 동시에 실행할 수 있습니다.

jdbctemplate.xml 사용자 지정

참고

구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint이 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.

JDBC 데이터베이스에서 콘텐츠를 추출하여 FAST Search Server 2010 for SharePoint 설치에 공급하려면 먼저 jdbctemplate.xml 파일의 복사본을 만듭니다. 그런 다음 선택한 텍스트 편집기나 XML 편집기(메모장 제외)에서 복사본을 편집하여 해당 환경의 요소 및 설정을 포함합니다.

설정을 테스트하려면 다음을 실행합니다.

%FASTSEARCH%\bin\JDBCConnector.bat testconnections -f <구성 파일>

여기서 *<구성 파일>*은 사용할 구성이 포함된 파일의 경로와 이름이고 *%FASTSEARCH%*는 FAST Search Server 2010 for SharePoint 설치 폴더입니다.

커넥터를 실행하여 콘텐츠를 FAST Search Server 2010 for SharePoint에 공급하려면 다음을 실행합니다.

%FASTSEARCH%\bin\JDBConnector.bat start -f <구성 파일>

매개 변수 그룹 빠른 참조

다음 표에는 jdbctemplate.xml에 있는 매개 변수 그룹의 목록이 나와 있습니다. 이러한 그룹은 어떠한 순서로도 나올 수 있습니다.

매개 변수 그룹 설명

매개 변수 그룹: Input

콘텐츠 원본의 속성을 정의합니다.

매개 변수 그룹: Transformation

FAST Search Server 2010 for SharePoint 항목 모델로 변환되는 콘텐츠와 이러한 변환 방식에 대해 설명합니다.

매개 변수 그룹: FASTSearchSubmit

콘텐츠를 FAST Search Server 2010 for SharePoint로 전송할 때 사용되는 통신 속성에 대해 설명합니다.

매개 변수 그룹: XMLExport

XML 형식 파일로 내보내는 데 사용할 값을 지정합니다.

매개 변수 그룹: ChangeDetection

행 체크섬을 사용하여 마지막 데이터베이스 공급이 수행된 이후 발생한 변경 사항을 감지하는 방법을 지정합니다.

매개 변수 그룹: ConnectorExecution

커넥터를 실행할 때 사용되는 일반 값을 지정합니다.

매개 변수 그룹: General

구성 이름을 지정합니다.

JDBC 서식 파일 형식

jdbctemplate.xml 의 XML 요소는 <로 시작해서 />로 끝납니다. 이 XML은 FastConnectorConfig-1.0.dtd에 정의되어 있습니다.

기본 형식은 다음과 같습니다.

<group name=" 그룹_이름 ">

    <parameter name="매개 변수_이름" type="매개 변수_유형">

        <value>값</value>

    </parameter>

**      </group>**

매개 변수 이름은 대/소문자를 구분하고 매개 변수 유형은 대/소문자를 구분하지 않습니다. 매개 변수 이름과 유형은 따옴표(" ")로 묶어야 합니다.

매개 변수 정의는 여러 줄에 입력할 수 있습니다. 요소 정의에서 공백, 캐리지 리턴, 라인 피드 및 탭 문자는 무시됩니다.

예를 들면 다음과 같습니다.

<group name="ConnectorExecution">
    <parameter name="QueueSize" type="integer">
         <value>200</value>
    </parameter>
    <parameter name="WorkFolder" type="string">
         <value>../var/jdbcconnector</value>
    </parameter>
</group>

팁

매개 변수 정의가 긴 경우 값을 여러 줄에 배치하고 들여쓰기를 사용하여 파일을 알아보기 쉽게 만듭니다.

FastConfig 요소는 특수한 경우이며 필수 요소입니다. 다른 요소는 모두 FastConfig 요소에 포함됩니다.

다음은 구성 파일의 예제 코드 조각입니다.

<!DOCTYPE FastConfig SYSTEM "dtd/FastConnectorConfig-1.0.dtd">
<FastConfig>
    <group name="ConnectorExecution">
       <parameter name="QueueSize" type="integer">
             <value>200</value>
        </parameter>
       <parameter name="WorkFolder" type="string">
             <value>../var/jdbcconnector</value>
       </parameter>
    </group>
</FastConfig>

<!--와 -->로 구분하여 어디에든 주석을 추가할 수 있습니다.

예를 들면 다음과 같습니다.

<!DOCTYPE FastConfig SYSTEM "dtd/FastConnectorConfig-1.0.dtd"><FastConfig>
    <!-- The parameter group ConnectorExecution specifies general values
          used when running a connector. -->
    <group name="ConnectorExecution">
       <parameter name="QueueSize" type="integer">
             <value>200</value>
       </parameter>
       <parameter name="WorkFolder" type="string">
             <value>../var/jdbcconnector</value>
       </parameter>
    </group>
</FastConfig>

매개 변수 그룹: Input

이 그룹의 매개 변수는 콘텐츠 원본의 속성을 정의합니다.

매개 변수 유형 값 설명

JDBCDriver

문자열

텍스트

JDBC 드라이버 공급자를 통해 정의되는 JDBC 드라이버 클래스 이름이며 필수 요소입니다.

값 예: com.microsoft.sqlserver.jdbc.SQLServerDriver. 더 많은 예는 jdbctemplate.xml 파일에서 확인할 수 있습니다.

JDBCURL

문자열

텍스트

JDBC 드라이버 공급자를 통해 지정되는 JDBC URL입니다. 이 URL은 서로 다른 JDBC 드라이버마다 다를 수 있으며 필수 요소입니다.

값 예: jdbc:sqlserver://<사용자의 서버>:1433;database=<사용자의 데이터베이스 이름>. 더 많은 예는 jdbctemplate.xml 파일에서 확인할 수 있습니다.

JDBCPreSQL

type="list" separator=";"

텍스트

JDBCSQL 문 이전에 실행되는 SQL 문을 지정합니다. 이 매개 변수는 데이터베이스에 필요한 모든 전처리 작업에 사용합니다.

JDBCSQL

문자열

텍스트

SQL 크롤링 쿼리를 지정합니다. JDBCSQL 또는 JDBCSQLFile을 지정해야 합니다.

타임스탬프 업데이트를 사용하는 경우 이 특성에는 다음 중 하나가 필요합니다.

  • %TIMESTAMP%: 마지막 크롤링 시간이 datetime 값으로 지정됩니다.

  • %TIMESTAMPSEC%: 마지막 크롤링 시간이 Epoch 이후의 경과 시간(초)으로 지정됩니다(Epoch는 1970-01-01T00:00:00Z – 1970년 1월 1일임)

기본값: (없음)

JDBCSQLFile

문자열

텍스트

SQL 크롤링 쿼리가 포함된 절대 경로의 파일 이름을 지정합니다. JDBCSQL 또는 JDBCSQLFile을 지정해야 합니다.

JDBCDeleteSQL

문자열

텍스트

SQL 삭제 쿼리를 지정합니다.

타임스탬프 업데이트를 사용하는 경우 이 특성에는 다음 중 하나가 필요합니다.

  • %TIMESTAMP%: 마지막 크롤링 시간이 datetime 값으로 지정됩니다.

  • %TIMESTAMPSEC%: 마지막 크롤링 시간이 Epoch 이후의 경과 시간(초)으로 지정됩니다(Epoch는 1970-01-01T00:00:00Z – 1970년 1월 1일임)

기본값: (없음)

JDBCDeleteSQLFile

문자열

텍스트

SQL 삭제 쿼리가 포함된 절대 경로의 파일 이름을 지정합니다.

JDBCPostSQL

type="list" separator=";"

텍스트

추출 문 이후에 실행되는 SQL 문을 지정합니다.

기본값: (없음)

JDBCTimeStampField

문자열

텍스트

업데이트 검색을 기반으로 타임스탬프 사용하는 경우 마지막 크롤링 시간에 대한 원본으로 사용할 타임스탬프 필드를 지정합니다. 값으로는 데이터베이스 타임스탬프 열 이름을 지정합니다. 가장 높은 값이 마지막 크롤링 시간으로 설정됩니다.

참고

이 필드를 사용하려면 타임스탬프가 SQL 문을 통해 추출되어야 합니다.

기본값: (없음)

JDBCTimeType

문자열

date|seconds

날짜 또는 시간(초)을 선택합니다.

기본값: date

JDBCDeleteTimeStampField

문자열

텍스트

삭제를 기반으로 타임스탬프 사용하는 경우 마지막 크롤링 시간에 대한 원본으로 사용할 타임스탬프 필드입니다. 값으로는 데이터베이스 타임스탬프 열 이름을 지정합니다. 가장 높은 값이 마지막 크롤링 시간으로 설정됩니다.

참고

이 필드를 사용하려면 타임스탬프가 SQL 문을 통해 추출되어야 합니다.

기본값: (없음)

JDBCDeleteTimeType

문자열

date|seconds

JDBC 삭제 타임스탬프 파일에 사용되는 시간입니다. 날짜 또는 시간(초)을 선택합니다.

기본값: date

JDBCUpdateTimeStampOnFailure

부울

true|false

FAST Search Server 2010 for SharePoint의 오류 콜백 또는 누락된 콜백을 통해 타임스탬프 파일을 업데이트하려면 true로 설정합니다.

기본값: false

JDBCUpdateTimeStampOnDeletion

부울

true|false

true로 설정하는 경우 FAST Search 데이터베이스 커넥터를 사용하여 FAST Search Server 2010 for SharePoint 인덱스에서 문서가 제거되면 타임스탬프 파일이 업데이트됩니다.

기본값: false

JDBCUsername

문자열

텍스트

데이터베이스 사용자 이름입니다.

Windows 통합 인증을 사용하여 SQL Server에 액세스하는 경우에는 생략될 수도 있습니다.

JDBCPassword

문자열

텍스트

데이터베이스 암호입니다.

Windows 통합 인증을 사용하여 SQL Server에 액세스하는 경우에는 생략될 수도 있습니다.

JDBCFetchSizeHint

정수

0|50 - 2000

행이 추가로 필요한 경우 데이터베이스에서 가져올 행의 수를 JDBC 드라이버에 알려 줍니다. 지정된 행의 수는 이 문을 사용하여 만들어진 결과 집합에만 영향을 미칩니다. 0인 값은 무시되며 범위는 50~2,000입니다.

기본값: 0

JDBCCharacterEncoding

문자열

텍스트

테이블에 문자 데이터(LONGVARCHAR 형식)가 포함된 경우 데이터베이스에 사용되는 인코딩을 지정합니다.

기본값: UTF-8

중요

{JDBCSQL, JDBCSQLFile} 중 하나만 설정하고 필요한 경우 {JDBCDeleteSQL, JDBCDeleteSQLFile} 중 하나만 설정합니다. 동일한 구성 파일에서 이러한 매개 변수를 추가로 설정하면 예기치 않은 결과가 발생할 수 있습니다.

예

다음은 Microsoft SQL Server와 관련된 예입니다.

<group name="Input">
    
    <parameter name="JDBCDriver" type="string">
        <value>com.microsoft.sqlserver.jdbc.SQLServerDriver</value>
    </parameter>
    
    <parameter name="JDBCURL" type="string">
        <value>jdbc:sqlserver://192.168.1.100\SP:1433;DatabaseName=test</value>
    </parameter>
    
    <parameter name="JDBCSQL" type="string">
        <value>select * from employees</value>
    </parameter>
    
    <parameter name="JDBCUsername" type="string">
        <value>john</value>
    </parameter>
    
    <parameter name="JDBCPassword" type="string">
        <value>AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAAmJRnYSadmEqSBy8q5KCI5QQAAAACAAAAAAADZgAAqAAAABAAAAClpb+U+s2eE9l7Nx34wd</value>
    </parameter>
    
</group>

매개 변수 그룹: Transformation

이 그룹의 매개 변수는 FAST Search Server 2010 for SharePoint로 변환할 콘텐츠와 변환 세부 정보를 지정합니다.

매개 변수 유형 값 설명

JDBCPrimaryKeyField

문자열

텍스트

데이터베이스 뷰/테이블 기본 키이며 필수 요소입니다. 항목 ID를 만드는 데 사용됩니다. 대/소문자를 구분하므로 해당 SELECT 문과 일치해야 합니다.

JDBCDeletePrimaryKeyField

문자열

텍스트

데이터베이스 뷰/테이블 기본 키이며 항목 ID를 삭제하는 데 사용됩니다.

JDBCUseBytesForString

부울

true|false

true로 설정하면 문자열이 문자열이 아닌 비트 배열로 처리됩니다.

기본값: false

UseMultiRowNormalizer

부울

true|false

true로 설정한 경우 동일한 ID가 포함된 레코드 열 값이 병합됩니다.

기본값: false

JDBCAttributeColumn

문자열

텍스트

정규화된 테이블의 경우 특성 이름이 포함된 열을 지정합니다.

JDBCValueColumn

문자열

텍스트

정규화된 테이블의 경우 특성 값이 포함된 열을 지정합니다.

JDBCMultiValueIncludeFields

문자열

텍스트

출력에서 연결해야 하는 세미콜론(;)으로 구분된 열 이름 목록입니다. 이 필드는 JDBCMultiValueSkipFields에 대한 모든 설정을 재정의합니다.

JDBCMultiValueSkipFields

문자열

텍스트

각 행의 값이 같으며 출력에서 반복되지 않아야 하는 세미콜론(;)으로 구분된 열 이름 목록입니다.

참고

JDBCPrimaryKeyField와 JDBCDeletePrimaryKeyField를 동시에 사용해서는 안 됩니다.

예

<group name="Transformation">
    <parameter name="JDBCPrimaryKeyField" type="string">
        <value>ID</value>
    </parameter>
</group>

매개 변수 그룹: FASTSearchSubmit

이 그룹의 매개 변수는 콘텐츠를 FAST Search Server 2010 for SharePoint에 전송하는 데 사용되는 통신 속성을 설명합니다.

매개 변수 유형 값 설명

Collection

문자열

텍스트

대상 모음의 필수 이름입니다.

ActuallyPublish

부울

true|false

true로 설정하면 항목을 FAST Search Server 2010 for SharePoint로 전송합니다.

기본값: true

예

<group name="FASTSearchSubmit">
    <parameter name="Collection" type="string">
        <value>collectionname</value>
    </parameter>
</group>

매개 변수 그룹: XMLExport

이 그룹의 매개 변수는 FASTXML 형식 파일로의 내보내기를 지정합니다.

매개 변수 유형 값 설명

ExportToXML

부울

true|false

true로 설정하면 모든 항목을 XMLExport로 내보냅니다.

BinaryFields

부울

데이터

이진 필드의 세미콜론(;)으로 구분된 필드 이름 목록입니다. XMLExport에는 BASE64 인코딩을 사용합니다.

FASTXML은 %FASTSEARCH%\var\jdbcconnector\<collection name>\fastxml 폴더에 저장됩니다.

*%FASTSEARCH%*는 FAST Search Server 2010 for SharePoint 설치 폴더입니다.

예

다음 예에서는 FASTXML 내보내기를 사용하지 않도록 설정합니다.

<group name="XMLExport">
    <parameter name="ExportToXML" type="boolean">
        <value>false</value>
    </parameter>
</group>

매개 변수 그룹: ChangeDetection

이 그룹의 매개 변수는 행 체크섬을 사용하여 데이터베이스에서 마지막 공급 이후 적용된 데이터베이스 변경 사항을 검색하는 방법을 지정합니다.

매개 변수 유형 값 설명

Enabled

부울

true|false

변경 검색을 사용하도록 설정하려면 true로 설정합니다.

기본값: false

ChangeDBPurge

부울

true|false

시작 시 체크섬 데이터베이스의 모든 항목을 삭제하려면 true로 설정합니다.

기본값: false

ChangeDBAbortPercent

정수

백분율

체크섬 기반 변경 검색을 사용하는 경우 이 값은 원본에서 허용되는 삭제된 레코드의 최대 비율을 정의합니다. 실행 시 삭제 항목의 비율이 높은 것으로 감지되면 오류가 발생하고 모음이 변경되지 않습니다.

기본값: 10

ChangeDBIncludeFields

문자열

텍스트

체크섬 계산에 포함되는 세미콜론(;)으로 구분된 필드 이름의 목록입니다. 기본적으로 모든 필드가 포함됩니다.

ChangeDBExcludeFields

문자열

텍스트

체크섬 계산에서 제외되는 세미콜론(;)으로 구분된 필드 이름의 목록입니다.

이러한 필드는 포함 필드 목록보다 우선합니다. 예를 들어 이진 콘텐츠가 아닌 항목의 메타데이터만 변경될 수 있는 경우에는 계산에서 데이터 요소를 제외합니다.

기본적으로 아무 필드도 제외되지 않습니다.

예

<group name="ChangeDetection">
    <parameter name="Enabled" type="boolean">
        <value>false</value>
    </parameter>
</group>

매개 변수 그룹: ConnectorExecution

이 그룹의 매개 변수는 커넥터가 실행되는 동안 사용되는 일반 값을 지정합니다.

매개 변수 유형 값 설명

QueueSize

정수

1 - 10000

내부 항목 큐의 크기입니다.

기본값: 200

EnableStatusTracker

부울

true|false

상태 추적기에서 항목 크롤링 상태를 기록합니다. 이 상태 추적을 사용하지 않도록 설정하려면 false로 설정합니다.

WorkFolder

문자열

텍스트

로그 파일 및 XMLExport 파일이 포함된 모든 파일 출력의 작업 폴더입니다. 기본 위치: ..\var\jdbcconnector

예

<group name="ConnectorExecution">
    <parameter name="QueueSize" type="integer">
        <value>200</value>
    </parameter>
</group>

매개 변수 그룹: General

이 매개 변수는 속성 집합에 대한 선택적 접두사를 정의하여 구성 이름을 지정합니다. 비워 두는 경우 구성에서는 미리 정의된 propset를 사용합니다.

매개 변수 유형 값 설명

이름

문자열

이름

구성 이름 및 propset에 대한 접두사를 지정합니다. 이름은 고유해야 하고 최대 길이는 32자여야 하며 a~f 및 0~9 범위에 있어야 합니다.

예

<group name="General">
    <parameter name="Name" type="string">
        <value>abcdef01</value>
    </parameter>
</group>

See Also

Reference

jdbcconnector.bat 참조