Optim High Performance Unload 빅데이터를 위한 구성, Db2, Object Storage 또는 PostgreSQL 대상

이 장에서는 빅데이터, Db2®, Object Storage 또는 PostgreSQL 대상에 필요한 구성 파일 및 매개변수에 대해 설명합니다.

구성 파일 설명

Optim™ High Performance Unload 로 추출한 데이터를 이러한 대상으로 전송하기 위해 LOADDEST 절을 통해 지정된 빅 데이터, Db2, Object Storage 또는 PostgreSQL 대상과 상호 작용할 수 있습니다 Optim High Performance Unload 로 추출한 데이터를 이러한 대상으로 전송합니다. 이러한 상호 작용은 자동 데이터 마이그레이션 또는 나중에 실행할 데이터 전송 명령으로 구성될 수 있습니다. 지원되는 빅데이터 대상 중에는 NoSQL 또는 Hadoop 대상이 있습니다. 지원되는 Db2 대상은 Db2 표준 대상, 로컬로 카탈로그된 원격 데이터베이스 및 Db2 Warehouse 대상입니다. Object Storage 에서 지원하는 대상 중에는 IBM Cloud Object Storage, Amazon EC2, Amazon S3, S3 호환, Swift, Microsoft Azure, 파일 시스템 등이 있습니다.

또 다른 유형의 상호 작용은 Optim High Performance Unload 원격 위치에 있는 데이터 파일을 기반으로 한 Db2 외부 테이블을 준비하기 위한 것입니다. 원격 위치에는 S3 호환 환경, Microsoft Azure 환경 또는 원격 서버가 포함됩니다. Optim High Performance Unload 다음에 그러한 테이블을 생성할 준비가 된 명령을 생성할 수 있습니다: 데이터 파일에 대해 고려할 원격 위치는 FORMAT EXTERNAL 절을 통해 지정할 수 있습니다. Optim High Performance Unload 또한 데이터 파일을 예상 위치에 업로드할 준비가 된 명령을 생성할 수 있습니다: 이 위치는 LOADDEST 절을 통해 지정할 수 있으며, 지원되는 대상은 Amazon S3, Microsoft Azure 및 파일 시스템 대상입니다.

지정된 대상과 상호 작용하는 태스크를 수행하려면 db2hpu.dest 구성 파일을 사용하여 몇 가지 정보를 설정해야 합니다. 이는 고려되는 대상이 다음과 같은 경우에 해당됩니다.
  • 빅 데이터 환경
  • Db2 Warehouse 데이터베이스,
  • 표준 Db2 데이터베이스 및 해당 LOADDEST절에 별명 이름의 스펙이 포함되어 있습니다.
  • 원격 Db2 데이터베이스 및 해당 LOADDEST절에는 노드 이름 또는 해당 WITH STANDARD AUTH 옵션의 스펙이 포함되어 있습니다.
  • Object Storage 환경
  • PostgreSQL 환경의 스펙을 포함합니다.
이 구성 파일은 Optim High Performance Unload 구성 디렉토리.
db2hpu.dest 파일은 섹션으로 구성해야 하며 하나의 섹션은 하나의 대상에 해당합니다. 각 섹션은 다음과 같이 구성해야 합니다.
  • 섹션 이름: 대괄호 사이에 지정하며 연관된 대상을 식별합니다. 섹션 이름 값은 대소문자를 구분합니다. 섹션 이름에 사용 가능한 값은 다음과 같습니다.
    • Db2: 표준 Db2 데이터베이스와 관련된 섹션에 사용할 값입니다.
    • RemoteDB2: 로컬로 카탈로그된 원격 Db2 데이터베이스에 상대적인 섹션에 사용할 값입니다.
    • 웨어하우스: Db2 Warehouse 환경에 상대적인 섹션에 사용할 값입니다.
    • Cloudant: Cloudant 데이터베이스에 해당하는 NoSQL 환경 관련 섹션에 사용할 값입니다.
    • CouchDB: CouchDB 데이터베이스에 해당하는 NoSQL 환경 관련 섹션에 사용할 값입니다.
    • MongoDB: MongoDB 데이터베이스에 해당하는 NoSQL 환경 관련 섹션에 사용할 값입니다.
    • HDFS: HDFS 파일 시스템에 해당하는 Hadoop 환경 관련 섹션에 사용할 값입니다.
    • Hive: Hive 데이터베이스에 해당하는 Hadoop 환경 관련 섹션에 사용할 값입니다.
    • HBase: HBase 데이터베이스에 해당하는 Hadoop 환경 관련 섹션에 사용할 값입니다.
    • MapReduce: Hadoop 환경의 사용자 정의된 MapReduce 유틸리티 관련 섹션에 사용할 값입니다.
    • IBM_COS: 이것은 IBM Cloud Object Storage 환경과 관련된 섹션에 사용되는 값입니다
    • AWS_EC2: Amazon EC2 환경과 관련된 섹션에 사용할 값입니다.
    • AWS_S3: Amazon S3 또는 S3 호환 환경에 관련된 섹션에 사용되는 값입니다
    • Swift: Swift 환경 관련 섹션에 사용할 값입니다.
    • Azure: Microsoft Azure 환경과 관련된 섹션에 사용할 값입니다.
    • FileSystem: 이것은 파일 시스템 환경과 관련된 섹션에 사용되는 값입니다
    • PostgreSQL: 이는 PostgreSQL 환경과 관련된 섹션에 대해 사용되는 값입니다.
  • 매개변수 목록: 일부는 필수이며, 각각 name=value 패턴으로 지정합니다.

LOADDEST절을 지정하지 않고 이러한 파일을 작성하고 채우거나 S3 또는 AZURE 옵션을 사용하여 FORMAT EXTERNAL절을 지정하는 것은 유용하지 않습니다. LOADDEST 절에 지정한 대상에 대해 연관된 데이터 전송 명령을 생성해야 하는 경우, 이 대상에 해당하는 섹션이 db2hpu.dest 파일에 있어야 합니다. S3 또는 AZURE 옵션과 함께 FORMAT EXTERNAL절을 통해 지정된 지정된 대상의 경우 연관된 외부 테이블 작성 명령을 생성해야 하는 경우 이 대상에 해당하는 섹션이 db2hpu.dest 파일에 있어야 합니다.

Db2 의 표준 대상에 대한 특정 매개 변수

별명
필수 매개변수입니다. 값은 대소문자를 구분합니다. 이 매개변수는 이 별명이 지정된 제어 파일 내의 LOADDEST 절과 관련하여 연관된 섹션이 고려되는 섹션인지 판별하도록 해주는 기준입니다.
dbname
선택적 옵션입니다. Db2 Load에 사용할 데이터베이스 이름을 지정할 수 있습니다. 이 매개변수를 지정하지 않으면 CONNECT 옵션을 통해 GLOBAL 블록에 지정된 데이터베이스 이름이 대신 사용됩니다.
인스턴스
이는 마이그레이션 시나리오에서 필수이며 대신 선택적입니다. Db2 인스턴스의 이름을 지정하려면 이 매개변수를 사용하십시오. 마이그레이션 시나리오에서 이는 대상 Db2 인스턴스의 이름입니다. 언로드 시나리오에서 설정된 경우 데이터 재파티션을 사용할 수 있습니다. 동일한 db2hpu.dest 섹션으로 설정된 ‘host’ 또는 ‘file’ 매개변수가 없는 경우에는 현재 머신에서 이 Db2 인스턴스 이름과 연관된 db2nodes.cfg 파일이 고려됩니다. ‘host’ 또는 ‘file’ 매개변수가 설정되면 고려할 Db2 노드 구성 파일이 다르게 판별됩니다.
호스트
선택적 옵션입니다. ‘instance’ 매개변수가 설정된 경우 이 매개변수를 사용하여 고려할 Db2 노드를 정의하는 파일이 있는 머신의 이름을 지정하십시오. ‘file’ 매개변수가 설정되지 않은 경우, 고려되는 파일은 이름이 ‘instance’ 매개변수로 설정된 Db2 인스턴스와 연관된 이 머신의 db2nodes.cfg 파일입니다. ‘file’ 매개변수가 설정된 경우 해당 값은 이 시스템에서 고려되는 파일입니다. 데이터를 마이그레이션할 때, 여기에 설정된 머신은 Db2 Load API의 호출을 통해 마이그레이션의 데이터 로딩이 실행될 머신입니다. ‘instance’ 매개변수가 설정되지 않은 경우 이 매개변수를 사용하여 생성할 파일이 작성되는 시스템을 지정하십시오.
호스트_iswindows
선택적 옵션입니다. 데이터를 마이그레이션하는 경우에는 유용하지 않습니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 소스 머신 유형에 해당하는 값입니다. 이 매개변수를 사용하여 Db2 Load 명령이 생성되는 시스템의 유형을 지정할 수 있습니다. Unix 인 경우, 매개변수 값을 ‘no’로 설정해야 합니다. Windows인 경우 매개변수 값을 yes로 설정해야 합니다. 제어 파일에 WORKING IN절이 지정되어 있고 이 매개변수도 지정되어 있는 경우에는 그에 따라 값을 설정해야 합니다. Db2 의 Load 명령이 생성되는 머신이 Unix 머신인 경우, WORKING IN 절에 Unix 경로를 명시해야 하며, 이 매개변수 값은 no로 설정되어야 합니다. Db2 의 Load 명령이 생성되는 컴퓨터가 Windows 컴퓨터인 경우, WORKING IN 절에는 Windows 경로를 지정해야 하며 이 매개변수 값은 yes로 설정되어야 합니다. ‘host’ 매개변수가 설정되지 않았거나 현재 시스템으로 설정된 경우에는 이 매개변수를 설정해도 소용이 없습니다.
파일
Db2 노드의 정의를 포함하는 파일 이름을 지정하려면 이 매개변수를 사용하십시오. 이 파일이 있는 시스템은 ‘host’ 매개변수를 사용하여 설정할 수 있습니다. 대상 Db2 인스턴스의 db2nodes.cfg 파일을 직접 지정하거나, 해당 컨텐츠가 Db2 노드 파일에 유효한 경우 선택한 파일을 지정할 수 있습니다. 예를 들어, 대상 데이터베이스 파티션을 정의하는 mynodes.cfg 파일이 /tmp 디렉토리에 있는 경우 다음을 사용하십시오. file=/tmp/mynodes.cfg
repart
이 매개변수는 데이터 재파티션 메커니즘에 영향을 미칠 수 있습니다. 재파티션 기능을 사용하는 경우, 재파티션 기능은 커버 아래에서 호출되는 적절한 Db2 API의 호출에 의존합니다. 호출되는 정확한 API는 관련 파티션 맵의 크기에 따라 다릅니다. 데이터 재파티션 실행에 영향을 미칠 수 있는 방법에는 다음 두 가지가 있습니다.
  • 데이터 처리에서 데이터 재파티션 단계를 사용 안함으로 설정할 수 있습니다. 어떤 이유로든 데이터 마이그레이션의 경우, 이 기능이 유용할 수 있습니다 Optim High Performance Unload 적합하지 않을 것입니다.
  • 데이터 재파티션 단계에서 고려되는 대상 환경에 포함된 파티션 맵의 크기에 대해 적절한 Db2 API의 사용을 강제 실행할 수 있습니다. 데이터 마이그레이션 시 파티션 맵의 크기가 소스 환경과 대상 환경 간에 서로 다를 경우에 이 기능이 유용할 수 있습니다.
세 개의 값을 지정할 수 있습니다.
  • no: 관련 태스크 내에서 재파티션 처리를 사용 안함으로 설정할 수 있습니다. DPF 환경에 대해 자동 마이그레이션을 수행하는 경우 기본적으로 소스 환경에서 읽어들인 데이터가 여러 스트림을 통해 분산됩니다. 이러한 스트림은 대상 환경 토폴로지에 따라 작성되며 대상 환경의 범위에서 실행되는 Db2 Load 유틸리티에 의해 이용됩니다. ‘repart’ 매개변수를 'no' 로 설정하면 재파티션 단계가 사용 안함으로 설정됩니다. 결과적으로 데이터는 고유 스트림을 통해 마이그레이션되고 데이터 재파티션은 Db2 Load 유틸리티 레벨에서 수행됩니다.
  • pmap_4k: 재파티션 단계에서 고려할 파티션 맵의 크기를 4K로 지정할 수 있습니다. 따라서 이 단계는 4K 파티션 맵 사용을 기준으로 데이터 해싱 Db2 API를 사용하여 수행됩니다.
  • pmap_32k: 재파티션 단계에서 고려할 파티션 맵의 크기를 32K로 지정할 수 있습니다. 따라서 이 단계는 32K 파티션 맵 사용을 기준으로 데이터 해싱 Db2 API를 사용하여 수행됩니다. 이 값은 관련 Db2 레벨이 V9.7이상인 경우에만 사용할 수 있습니다.
기본적으로 재파티션 단계에서 고려할 파티션 맵 크기는 데이터가 언로드되는 Db2 환경의 구성에서 판별됩니다. 결과적으로, 재파티션된 데이터는 동일한 크기의 파티션 맵을 기반으로 대상 Db2 환경에 대해 적절하게 준비됩니다. 그러므로 파티션 맵 크기가 다른 대상 환경에 데이터를 로드할 경우 데이터가 예상대로 분산되지 않으므로 로드가 성공하지 않습니다. 이 경우, 대상 Db2 환경에 적합한 파티션 맵 크기 값을 가진 ‘repart’ 매개변수를 사용하는 것이 강제적으로 Optim High Performance Unload 적절한 파티션 맵 크기에 따라 파티션 재분할 단계를 결정합니다.
except_parts
이 매개변수를 사용하여 대상 데이터베이스 파티션 레이아웃에서 제외할 데이터베이스 파티션 번호를 정의하십시오. 대상 출력 파일을 생성하는 경우 db2nodes.cfg 파일에서 정의된 데이터베이스 파티션 번호에서 일부를 제외할 수 있습니다.
예를 들어, ‘except_parts’' 매개변수를 사용하면 카탈로그 데이터베이스 파티션이 데이터를 포함하지 않는 인스턴스 또는 노드 그룹이 인스턴스 데이터베이스 파티션의 서브세트만 포함하는 테이블스페이스로 데이터를 이주하려는 경우에 유용합니다. db2hpu.dest 구성 파일 내에서 ‘except_parts’ 매개변수를 사용하여 이러한 예외를 지정할 수 있습니다.
테넌트
이 매개변수를 사용하여 고려할 대상 테넌트를 선택하십시오 Optim High Performance UnloadDb2 데이터 마이그레이션 또는 Db2 Load 명령의 생성을 위한 환경이 필요한 작업을 위한 것입니다. 이 파라미터가 지정되지 않으면, 기본적으로 SYSTEM이라고 불리는 테넌트가 고려됩니다.
데이터 마이그레이션이 수행되면, 지정된 대상 테넌트가 데이터베이스에 대한 연결을 통해 마이그레이션된 데이터를 다시 로드하기 위해 연결될 대상 테넌트로 설정됩니다. 이 설정을 사용하면 이 데이터를 테넌트의 일부인 테이블에 다시 로드할 수 있습니다.
Db2 Load 명령을 파일로 생성할 때, 지정된 대상 테넌트가 Db2 Load 명령 자체 앞에 SET TENANT 명령을 추가하는 데 사용됩니다. 단, LOADDEST 절에 WITH STANDARD AUTH 옵션이 지정되어 있어야 합니다.

데이터 마이그레이션이 수행되는 경우, 이 매개변수는 대상 Db2 환경이 최소한 V12.1 환경인 경우에만 사용할 수 있습니다.

Db2 원격 대상에 특정한 매개변수

dbname
인증 방법이 제어 파일 내의 LOADDEST절에 지정되는 경우 필수입니다. 그것은 그 대신 쓸모가 없다. Db2 Load에 사용할 데이터베이스 이름을 지정할 수 있습니다.
호스트
선택적 옵션입니다. 데이터를 언로드할 때, 이는 여기 지정된 시스템에서 생성할 파일을 작성할 수 있도록 합니다. 데이터를 마이그레이션할 때 Db2 Load API의 호출을 통해 마이그레이션의 데이터 로딩이 실행될 머신의 이름을 지정할 수 있습니다.
호스트_iswindows
선택적 옵션입니다. 데이터를 마이그레이션하는 경우에는 유용하지 않습니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 소스 머신 유형에 해당하는 값입니다. 이 매개변수를 사용하여 Db2 Load 명령이 생성되는 시스템의 유형을 지정할 수 있습니다. Unix 인 경우, 매개변수 값을 ‘no’로 설정해야 합니다. Windows인 경우 매개변수 값을 yes로 설정해야 합니다. 제어 파일에 WORKING IN절이 지정되어 있고 이 매개변수도 지정되어 있는 경우에는 그에 따라 값을 설정해야 합니다. Db2 의 Load 명령이 생성되는 머신이 Unix 머신인 경우, WORKING IN 절에 Unix 경로를 명시해야 하며, 이 매개변수 값은 no로 설정되어야 합니다. Db2 의 Load 명령이 생성되는 컴퓨터가 Windows 컴퓨터인 경우, WORKING IN 절에는 Windows 경로를 지정해야 하며 이 매개변수 값은 yes로 설정되어야 합니다. ‘host’ 매개변수가 설정되지 않았거나 현재 시스템으로 설정된 경우에는 이 매개변수를 설정해도 소용이 없습니다.
노드
선택적 옵션입니다. 원격 Db2 노드 이름을 사용하여 설정해야 합니다. 값은 대소문자를 구분합니다. 마이그레이션 태스크의 경우 이 매개변수를 설정해야 하며, 연관된 신임 정보를 가져오는 데 사용됩니다. 이 경우 신임 정보 파일에 작성된 원격 유형의 섹션 이름과 해당 매개변수의 값이 일치해야 합니다. Db2 Load 명령 생성의 경우, 노드 이름이 제어 파일 내의 LOADDEST절에 지정되면 노드 이름도 설정해야 합니다. 이 경우 이 매개변수를 기준으로 연관된 섹션이 고려할 섹션인지 판별할 수 있습니다.

Db2 Warehouse 대상에 특정한 매개변수

별명
선택적 옵션입니다. 값은 대소문자를 구분합니다. 별명이 제어 파일 내의 LOADDEST 절에 지정된 경우에 설정해야 합니다. 이 경우 이 매개변수를 기준으로 연관된 섹션이 고려할 섹션인지 판별할 수 있습니다. 마이그레이션 태스크의 경우 표준 인증 방법이 LOADDEST 절에 지정되는 경우에도 이를 설정해야 합니다. 이 경우 고려되는 대상 유형의 신임 정보 파일에 작성된 섹션의 이름과 해당 매개변수의 값이 일치해야 합니다.
binpath
선택적 옵션입니다. Db2 Load API를 호출하는 데이터를 마이그레이션하는 경우에는 유용하지 않습니다. 업로드 명령을 빌드할 때 사용되는 디렉토리를 지정하는 데 사용됩니다. 효과적인 업로드를 위해, 업로드 명령을 실행할 때 디렉토리를 찾는 데 문제가 없도록 업로드 도구의 이름 앞에 추가합니다. 올바른 절대 경로여야 합니다.
curl
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. ‘curl’ 매개변수가 no로 설정되거나 지정되지 않은 경우, 데이터 로딩은 업로드 명령 생성을 위한 CLPPlus 도구 또는 자동 마이그레이션을 위한 Db2 Load API를 기반으로 합니다. ‘curl’ 그렇지 않으면, yes로 설정된 경우, 업로드 명령 생성 또는 자동 마이그레이션에 사용되는 도구는 cURL, 입니다.
URL
필수 매개변수입니다. 관련 Db2 Warehouse 서버의 URL을 지정할 수 있습니다.
포트
‘curl’ 매개변수가 지정되지 않았거나 no로 설정된 경우에만 필수이며, 대신 사용되지 않습니다. 관련된 Db2 Warehouse 서버의 포트 번호를 지정할 수 있습니다.
dbname
‘curl’ 매개변수가 지정되지 않았거나 no로 설정된 경우에만 필수이며, 대신 사용되지 않습니다. 업로드에 사용할 데이터베이스 이름을 지정할 수 있습니다.
호스트
선택적 옵션입니다. 데이터를 언로드할 때, 이는 여기 지정된 시스템에서 생성할 파일을 작성할 수 있도록 합니다. cURL 도구를 사용하여 마이그레이션하는 경우, 마이그레이션의 데이터 로드는 업로드 명령을 생성하고 실행하여 수행됩니다. cURL 도구를 사용하지 않고 마이그레이션할 때 마이그레이션의 데이터 로드는 Db2 Load API를 호출하여 수행됩니다. 이 매개변수는 마이그레이션의 데이터 로딩이 수행되는 머신의 이름을 지정할 수 있습니다.
호스트_iswindows
선택적 옵션입니다. Db2 Load API를 호출하는 데이터를 마이그레이션하는 경우에는 유용하지 않습니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 소스 머신 유형에 해당하는 값입니다. 이 매개변수를 사용하여 데이터 로딩 명령이 생성되거나 실행되는 시스템의 유형을 지정할 수 있습니다. Unix 인 경우, 매개변수 값을 ‘no’로 설정해야 합니다. Windows인 경우 매개변수 값을 yes로 설정해야 합니다. 제어 파일에 WORKING IN절이 지정되어 있고 이 매개변수도 지정되어 있는 경우에는 그에 따라 값을 설정해야 합니다. 데이터 로딩 머신이 Unix 인 경우, WORKING IN 절에 Unix 경로를 명시해야 하며, 이 매개변수 값은 no로 설정되어야 합니다. 데이터 로딩 시스템이 Windows 시스템인 경우, WORKING IN절은 Windows 경로와 함께 지정되어야 하며 이 매개변수 값은 yes로 설정되어야 합니다. ‘host’ 매개변수가 설정되지 않았거나 현재 시스템으로 설정된 경우에는 이 매개변수를 설정해도 소용이 없습니다. ‘binpath’ 매개변수가 설정되어 있고 이 매개변수도 지정되어 있는 경우 이에 따라 해당 값을 설정해야 합니다. ‘binpath’ 매개변수 값은 데이터 로딩 시스템의 유형에 유효한 절대 경로로 설정되어야 합니다.
ssl
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 해당 값은 no입니다. 이는 자동 마이그레이션을 위해 Db2 Load API의 사용을 고려하는 경우에만 고려되며, 대신 쓸모가 없습니다. Db2 Load API를 사용하여 자동 마이그레이션을 고려할 때, 이 매개변수를 ‘yes’로 설정하면 표준 연결 대신 SSL 연결을 설정할 수 있습니다. 포트 매개변수로 설정된 포트 번호는 SSL 포트 번호를 참조해야 합니다.

CLPPlus 도구 또는 Db2 Load API를 사용할 때 구성할 url, 포트 및 dbname값을 얻으려면 관련 Db2 Warehouse 웹 콘솔에 로그인해야 합니다. 그런 다음 웹 콘솔에서 '연결' 메뉴 항목을 선택하고 '연결 정보' 메뉴 항목을 선택해야 합니다. 검색된 정보는 각각 ‘호스트 이름’, ‘포트 번호’, ‘데이터베이스 이름’ 필드와 연관된 ‘연결(SSL 사용 안함)’ 탭 또는 ‘연결(SSL 사용)’ 탭에서 찾을 수 있습니다.

빅데이터 및 Object Storage 대상에 대한 매개변수

별명
선택적 옵션입니다. 값은 대소문자를 구분합니다. 제어 파일 내에서 S3 또는 AZURE 옵션을 사용하여 LOADDEST절 또는 FORMAT EXTERNAL절에 별명을 지정하는 경우 설정해야 합니다. 이 경우 이 매개변수는 연관된 섹션이 고려할 섹션인지 판별할 수 있는 기준입니다. NoSQL 또는 Swift 대상으로의 마이그레이션 태스크의 경우, 표준 인증 방법이 LOADDEST 절에 지정되는 경우에는 이 또한 설정해야 합니다. IBM Cloud Object Storage, Amazon S3, S3 호환 대상을 대상으로 하는 마이그레이션 작업의 경우, 마이그레이션이 cURL 도구를 기반으로 하는 경우, 이 도구도 설정해야 합니다. Azure 로 마이그레이션하는 경우, 마이그레이션이 cURL 툴을 사용하지 않는 경우, 이 툴도 설정해야 합니다. 이러한 마이그레이션의 경우, 그 값은 대상 유형에 대해 자격 증명 파일에 생성된 섹션의 이름과 일치해야 합니다.
binpath
선택적 옵션입니다. 업로드 명령을 빌드할 때 사용되는 디렉토리를 지정하는 데 사용됩니다. 효과적인 업로드를 위해, 업로드 명령을 실행할 때 디렉토리를 찾는 데 문제가 없도록 업로드 도구의 이름 앞에 추가합니다. 올바른 절대 경로여야 합니다.
호스트
선택적 옵션입니다. 데이터를 언로드할 때, 이는 여기 지정된 시스템에서 생성할 파일을 작성할 수 있도록 합니다. 데이터를 마이그레이션할 때, 이는 데이터 마이그레이션에 사용할 업로드 명령이 생성되고 실행될 시스템의 이름을 지정할 수 있도록 합니다.
호스트_iswindows
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 소스 머신 유형에 해당하는 값입니다. 이 매개변수를 사용하여 업로드 명령이 생성되거나 실행되는 시스템의 유형을 지정할 수 있습니다. Unix 인 경우, 매개변수 값을 ‘no’로 설정해야 합니다. Windows인 경우 매개변수 값을 yes로 설정해야 합니다. 제어 파일에 WORKING IN절이 지정되어 있고 이 매개변수도 지정되어 있는 경우에는 그에 따라 값을 설정해야 합니다. 업로드 머신이 Unix 머신인 경우, WORKING IN 절에 Unix 경로를 명시해야 하며, 이 매개변수 값은 no로 설정되어야 합니다. 업로드 시스템이 Windows 시스템인 경우 Windows 경로를 사용하여 WORKING IN절을 지정해야 하며 이 매개변수 값을 yes로 설정해야 합니다. ‘host’ 매개변수가 설정되지 않았거나 현재 시스템으로 설정된 경우에는 이 매개변수를 설정해도 소용이 없습니다. ‘binpath’ 매개변수가 설정되고 이 매개변수도 지정된 경우 해당 값을 적절히 설정해야 합니다. ‘binpath’ 매개변수 값은 업로드 시스템의 유형에 유효한 절대 경로로 설정해야 합니다.

NoSQL 대상에 특정한 매개변수

URL

필수 매개변수입니다. 관련된 NoSQL 대상의 url을 지정하는 데 사용됩니다. 필요한 경우 < url>: < port>패턴을 사용하여 URL뒤에 포트 번호를 추가할 수도 있습니다.

dbname
Cloudant 및 MongoDB 대상에 대한 필수 매개변수이며, 기타 대상에 대해서는 필수 매개변수가 아닙니다. 업로드되는 JSON 문서에 사용될 데이터베이스 이름을 지정하는 데 사용됩니다.
collectionname
MongoDB 대상에만 사용 가능하며 이 대상에 대한 필수 매개변수입니다. 업로드되는 JSON 문서에 사용될 콜렉션 이름을 지정하는 데 사용됩니다.

Hadoop 대상에 특정한 매개변수

hdfspath
어떤 대상 키워드와도 함께 사용할 수 있으며 필수 매개변수입니다. 연관된 HDFS 파일 시스템에서의 위치를 지정하는 데 사용해야 합니다. HDFS 대상 키워드의 경우, 이 위치는 추출된 데이터가 포함된 파일을 복사해야 하는 최종 위치에 해당합니다. 기타 키워드의 경우, 이 위치는 추출된 데이터가 포함된 파일이 차후 이 파일의 사본에 대한 업로드 명령을 위해 복사되는 임시 위치에 해당합니다. 지정된 위치는 복사 단계를 실행하기 전에 존재해야 하며, 그렇지 않은 경우 복사 단계를 수행할 때 HDFS 파일 시스템에서 오류를 리턴합니다. 또한 이 위치는 HDFS 경로를 강제로 UNIX와 유사하게 만드는 절대 HDFS 경로와 일치해야 합니다.
pig
HBASE 대상 키워드와 함께 사용할 경우에만 사용 가능하며 선택적 매개변수입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 no입니다. HBase 대상에 데이터를 업로드하기 위해 사용할 수 있는 두 개의 도구 (hadoop 또는 pig) 가 있습니다. pig MapReduce 매개변수가 no로 설정되어 있거나 지정되지 않은 경우 사용되는 도구는 hadoop 이며, Optim High Performance Unload“HBaseMapReduce.jar"라고 합니다. pig 매개변수를 yes로 설정하면 pig 도구가 사용됩니다.
URL
HIVE 대상 키워드와 함께 사용할 경우에만 사용 가능하며 이 경우에는 필수 매개변수입니다. Hive 데이터베이스에 해당하는 JDBC url을 표시하는 데 사용해야 합니다. 여기에 지정하는 url은 이미 작동 중인 데이터베이스에 해당해야 합니다. 연관된 인증 방법의 지정 여부에 따라 이 url 스펙의 예상 패턴이 달라집니다.
  • 인증이 없는 경우:
    jdbc:hive2://<hivehost>:<port>/<db>
  • Kerberos 인증을 사용하는 경우:
    jdbc:hive2://<hivehost>:<port>/<db>;principal=<Hive_Principal>
이러한 JDBC url 스펙에 대한 세부사항을 얻으려면 Hive 문서를 검토하십시오.
Kerberos 인증이 포함되는 경우에 고려하고 지정하는 서로 다른 두 개의 Kerberos 프린시펄이 있습니다.
  • 업로드 명령 전 예비 인증 단계에 사용되며 db2hpu.dest 구성 파일에 해당 user 매개변수를 통해 지정해야 하는 프린시펄
  • JDBC url 스펙 끝에 있으며 Hive 관리자에 해당하는 프린시펄
command
MAPREDUCE 대상 키워드와 함께 사용할 경우에만 사용 가능하며 이 경우에는 필수 매개변수입니다. 전달되는 선택적 명령행 인수와 함께 고유의 MapReduce 프로그램 사용에 기반한 부분 명령행을 지정하는 데 사용됩니다. 이 문자열 스펙은 유효한 업로드 명령의 생성에 사용됩니다.

IBM Cloud Object Storage 의 목적지별 매개 변수

curl
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. 'curl' 매개변수가 no 또는 unspecified로 설정되어 있을 때, 'ibmcloud' 매개변수의 값에 따라, 고려 대상 도구는 업로드 명령 생성 또는 자동 마이그레이션을 위해 IBM Cloud CLI 또는 AWS CLI일 수 있습니다. 'curl' 그렇지 않으면, yes로 설정된 경우, 업로드 명령 생성 또는 자동 마이그레이션에 사용되는 도구는 cURL, 입니다.
IBM 클라우드
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 이 매개변수가 설정되지 않은 경우 기본적으로 값은 yes입니다. 'ibmcloud' 매개변수가 yes 또는 unspecified로 설정되어 있을 때, 업로드 명령 생성 또는 자동 마이그레이션을 위해 고려되는 도구는 IBM Cloud CLI입니다. 그렇지 않으면, 업로드 명령 생성 또는 자동 마이그레이션을 위해 사용되는 도구는 'ibmcloud' 매개변수가 no로 설정된 경우, AWS CLI입니다.
bucket
필수 매개변수입니다. IBM Cloud Object Storage 의 버킷 이름을 지정할 수 있습니다.
relativepath
선택적 옵션입니다. 생성된 파일이 있는 상대 경로를 지정할 수 있습니다 Optim High Performance Unload 업로드됩니다.
filemaxsize
선택적 옵션입니다. 생성된 출력 파일의 파일 크기 한계를 지정하는 데 사용됩니다. 이 매개변수는 단위가 MB인 숫자 값으로 설정되어야 합니다. 그 값은 4에서 10485760( 10TB ) 사이여야 합니다. 10485760은 IBM Cloud Object Storage 객체 크기의 상한입니다. ulimit 명령을 통해 파일 크기 한계가 설정된 경우, 이 매개변수 값은 설정된 한계보다 작아야 합니다. FILEMAXSIZE 절이 제어 파일에 지정된 경우, 여기에 지정된 값은 이 매개변수 값보다 작아야 합니다.
accesskey
이는 'curl' 매개변수가 yes로 설정된 경우에만 필수이며, 대신 사용되지 않습니다. 사용자 계정의 액세스 키를 지정하는 데 사용됩니다.
버전
'curl' 매개변수가 yes로 설정된 경우에는 선택적 매개변수이며, 대신 사용되지 않습니다. IBM Cloud Object Storage 버킷에 데이터를 업로드하는 데 사용되는 서명 버전에 해당합니다. 해당 값은 2또는 4일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 4입니다. 서명 버전 2를 지정할 때 사용되는 기본 해시 알고리즘은 SHA-1 입니다. 서명 버전이 4이면 SHA-256 알고리즘이 해싱에 사용됩니다.
encrypt
'curl' 매개변수가 yes로 설정되어 있거나, 'ibmcloud' 매개변수가 no로 설정되어 있는 경우에는 선택 사항이고, 그 외의 경우에는 쓸모가 없습니다. IBM Cloud Object Storage 의 서버 사이드 암호화(SSE)에 해당합니다. 'curl' 매개변수가 yes로 설정되어 있을 때, 서명 버전 4와만 일치합니다( 'version' 매개변수 참조). 그 값은 AES256 일 수 있으며 대소문자를 구분합니다.
region
'curl' 매개변수가 yes로 설정되고 'version' 매개변수가 지정되지 않았거나 4로 설정된 경우에만 필수 매개변수입니다. 관련된 버킷 영역 이름을 지정하는 데 사용됩니다.
profile
'curl' 매개변수가 지정되지 않았거나 no로 설정되어 있고, 'ibmcloud' 매개변수가 no로 설정되어 있으면, 이 옵션은 쓸모가 없습니다. AWS CLI 신임 정보에 해당하는 이름 지정된 프로파일을 지정하는 데 사용됩니다.
URL
'curl' 매개변수가 yes로 설정되어 있는 경우 필수입니다. 'ibmcloud' 매개변수가 no로 설정되어 있는 경우 선택 사항입니다. 'ibmcloud' 매개변수가 지정되지 않았거나 yes로 설정되어 있으면 쓸모가 없습니다. IBM Cloud Object Storage 의 대상의 공개 엔드포인트 URL을 지정할 수 있습니다.
IBM Cloud Object Storage 를 대상으로 고려할 때, 인증은 데이터 업로드 또는 데이터 마이그레이션에 사용할 도구에 따라 달라집니다
  • IBM Cloud CLI가 IAM 인증을 통해 구성된 경우, 툴을 실행하기 전에 적절하게 구성해야 합니다 Optim High Performance Unload.
  • 사용된 도구가 HMAC 인증으로 구성된 cURL 또는 IBM Cloud CLI 또는 AWS CLI인 경우, 인증은 액세스 키와 고려 중인 IBM Cloud Object Storage 계정에 연결된 비밀 키라는 두 가지 매개 변수에 의존합니다. 경우에 Optim High Performance UnloadIBM Cloud Object Storage cURL 도구를 기반으로 한 업로드 명령을 생성하기 위해 대상을 실행하려면, 이 키를 구성해야 합니다. 액세스 키는 db2hpu.dest 구성 파일에서 'accesskey' 매개변수를 사용하여 설정해야 합니다. 비밀 키는 자격 증명 파일의 적절한 섹션에 저장해야 합니다. cURL, 가 아닌 도구를 고려하는 경우, Optim High Performance Unload, 업로드 명령을 실행하려는 사용자에 의해. 고려할 도구가 IBM Cloud CLI( IBM Cloud CLI)인 경우, 다음과 같이 'ibmcloud auth config hmac' 명령을 실행하여 이 단계를 수행할 수 있습니다
    ibmcloud cos config hmac
Access key ()> USER_ACCESS_KEY
Secret key ()> USER_SECRET_KEY
OK
Successfully saved HMAC Credentials to file.
    고려할 도구가 AWS CLI인 경우, 다음과 같이 'aws configure' 명령을 실행하여 이 단계를 수행할 수 있습니다
    aws configure
AWS Access Key ID [None]: USER_ACCESS_KEY
AWS Secret Access Key [None]: USER_SECRET_KEY
Default region name [None]: BUCKET_REGION_NAME
Default output format [None]:
참고: cURL 도구를 사용하여 IBM Cloud Object Storage 에 데이터를 업로드하려는 경우, 몇 가지 규칙 또는 요구 사항이 있습니다
  • Windows 플랫폼용으로 이러한 업로드 명령을 생성하는 것은 지원되지 않습니다.
  • 서명 버전이 4이면 업로드 명령이 실행될 머신에 openssl 명령이 설치되어 있고 PATH 환경 변수를 통해 액세스할 수 있어야 합니다.
  • 서명 버전이 2이면 업로드 명령이 실행될 머신에 openssl 및 base64 명령이 설치되어 있고 PATH 환경 변수를 통해 액세스할 수 있어야 합니다.

Amazon EC2 대상에 특정한 매개변수

사용자
필수 매개변수입니다. 관련 Amazon EC2 인스턴스의 사용자를 지정할 수 있습니다.
URL
필수 매개변수입니다. 관련 Amazon EC2 인스턴스의 공용 URL을 지정할 수 있습니다.
privatekey
필수 매개변수입니다. 관련 Amazon EC2 인스턴스의 키 쌍과 연관된 개인 키의 경로를 지정할 수 있습니다. 개인 키 파일 형식은 pem 형식이어야 합니다. 공개 키는 Amazon EC2 인스턴스에서 적절하게 구성되어야 합니다. 업로드를 실행할 시스템이 Windows 시스템인 경우 이 매개변수에 설정된 값은 올바른 Windows 경로여야 합니다.
경로
선택적 옵션입니다. 이 기능을 사용하면 Optim High Performance Unload 업로드됩니다.
참고 : 이 매개변수를 생략하면, Optim High Performance Unload'user' 매개변수를 통해 생성된 파일을 언급된 사용자의 홈 디렉토리에 업로드합니다
IsWindows
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. Amazon EC2 인스턴스가 Windows 인스턴스인지 여부를 지정할 수 있습니다. 이 매개변수가 yes로 설정되고 'path' 매개변수도 설정된 경우, 설정된 값이 올바른 Windows 경로에 해당하는지 확인하기 위해 'path' 매개변수의 스펙에 대한 제어가 수행됩니다.

Amazon EC2 대상을 고려할 때 개인 키 파일 사용으로 인해 인증 고려사항이 없습니다.

Amazon S3 또는 S3 호환 대상에 대한 특정 매개 변수

curl
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. 'curl' 매개변수가 no로 설정되거나 지정되지 않은 경우, 고려되는 도구는 업로드 명령 생성 또는 자동 마이그레이션 모두에 대해 AWS CLI입니다. 'curl' 매개변수를 yes로 설정하면 업로드 명령 생성 및 자동 마이그레이션 모두에 cURL 도구가 사용됩니다.
bucket
필수 매개변수입니다. 해당 버킷의 이름을 지정할 수 있습니다.
relativepath
선택적 옵션입니다. 생성된 파일이 있는 상대 경로를 지정할 수 있습니다 Optim High Performance Unload 업로드됩니다.
filemaxsize
선택적 옵션입니다. 생성된 출력 파일의 파일 크기 한계를 지정하는 데 사용됩니다. 이 매개변수는 단위가 MB인 숫자 값으로 설정되어야 합니다. 이 매개변수의 값은 4 - 5242880(5TB) 사이여야 하며, 5242880(5TB)은 Amazon S3 오브젝트 크기의 상한입니다. ulimit 명령을 통해 파일 크기 한계가 설정된 경우, 이 매개변수 값은 설정된 한계보다 작아야 합니다. FILEMAXSIZE 절이 제어 파일에 지정된 경우, 여기에 지정된 값은 이 매개변수 값보다 작아야 합니다.
accesskey
이는 'curl' 매개변수가 yes로 설정된 경우에만 필수이며, 대신 사용되지 않습니다. 사용자 계정의 액세스 키를 지정하는 데 사용됩니다.
버전
'curl' 매개변수가 yes로 설정된 경우에는 선택적 매개변수이며, 대신 사용되지 않습니다. 버킷으로 데이터를 업로드할 때 사용되는 서명 버전과 일치합니다. 해당 값은 2또는 4일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 4입니다. 서명 버전 2를 지정할 때 사용되는 기본 해시 알고리즘은 SHA-1 입니다. 서명 버전이 4이면 SHA-256 알고리즘이 해싱에 사용됩니다.
참고: 고려되는 버킷의 작성 날짜에 따라 서명 버전 2가 반드시 지원되는 것은 아닙니다. Amazon S3 의 경우, 이에 대한 자세한 내용은 공식 문서를 참조하시기 바랍니다.
encrypt
서버 사이드 암호화(SSE)에 해당하는 선택 사항입니다. 'curl' 매개변수가 yes로 설정되면 서명 버전 4와만 일치합니다 ( 'version' 매개변수 참조). 값은 AES256 또는 aws:kms이며 대소문자가 구분됩니다.
region
'curl' 매개변수가 yes로 설정되고 'version' 매개변수가 지정되지 않았거나 4로 설정된 경우에만 필수 매개변수입니다. 관련된 버킷 영역 이름을 지정하는 데 사용됩니다.
profile
'curl' 매개변수가 지정되지 않았거나 no로 설정된 경우에는 선택적 매개변수이며, 대신 사용되지 않습니다. AWS CLI 신임 정보에 해당하는 이름 지정된 프로파일을 지정하는 데 사용됩니다.
URL
선택적 옵션입니다. 아마존이 아닌 S3 와 호환되는 대상인지 명시해야 합니다. S3 와 호환되는 대상의 공개 URL을 지정할 수 있습니다.
Amazon S3 또는 S3 호환 대상을 고려할 때, 인증은 고려 중인 계정과 관련된 액세스 키와 비밀 키라는 두 가지 매개 변수에 의존합니다. 경우에 Optim High Performance UnloadcURL 도구를 기반으로 Amazon S3 또는 S3 호환 대상에 대한 업로드 명령을 생성하도록 구성되어 있거나, S3 호환 객체 저장소에 있는 파일을 기반으로 외부 테이블을 생성하는 명령을 생성하도록 실행되는 경우, 이 키를 구성해야 합니다. 액세스 키는 db2hpu.dest 구성 파일에서 'accesskey' 매개변수를 사용하여 설정해야 합니다. 비밀 키는 자격 증명 파일의 적절한 섹션에 저장해야 합니다. AWS CLI를 고려하는 도구의 경우, Optim High Performance Unload, 업로드 명령을 실행하려는 사용자에 의해. 이 단계는 다음과 같이 'aws configure' 명령을 실행하여 수행할 수 있습니다.
aws configure
AWS Access Key ID [None]: USER_ACCESS_KEY
AWS Secret Access Key [None]: USER_SECRET_KEY
Default region name [None]: BUCKET_REGION_NAME
Default output format [None]:
참고:
  • cURL 도구를 사용하여 Amazon S3 또는 S3 호환 대상에 데이터를 업로드하려는 경우, 몇 가지 규칙 또는 요구 사항이 있습니다
    • Windows 플랫폼용으로 이러한 업로드 명령을 생성하는 것은 지원되지 않습니다.
    • 서명 버전이 4이면 업로드 명령이 실행될 머신에 openssl 명령이 설치되어 있고 PATH 환경 변수를 통해 액세스할 수 있어야 합니다.
    • 서명 버전이 2이면 업로드 명령이 실행될 머신에 openssl 및 base64 명령이 설치되어 있고 PATH 환경 변수를 통해 액세스할 수 있어야 합니다.
  • S3 와 호환되는 객체 저장소의 파일을 기반으로 외부 테이블 생성 명령을 생성하려는 경우, 다음의 매개변수만 고려됩니다: 'bucket', 'accesskey' 및 'region'.

Swift 대상 관련 매개변수

auth_version
선택적 옵션입니다. 사용될 인증 버전에 해당합니다. 가능한 값은 1, 2및 3입니다. 이 파라미터가 설정되어 있지 않으면, Optim High Performance Unload "ST_AUTH_VERSION" 환경 변수의 값을 얻으려고 시도합니다. 이 환경 변수도 설정되지 않은 경우 기본적으로 인증 버전 3이 사용됩니다.
참고: 인증 버전 1은 Swift TempAuth 메커니즘에 해당하고 인증 버전 2및 3은 Swift Keystone Auth 메커니즘에 해당합니다.
URL
선택적 옵션입니다. Swift 서버 url을 지정할 수 있습니다. 선택한 인증 버전에 따라 이 url을 지정해야 합니다. 인증 버전에 따른 패턴은 다음과 같습니다.
  • 버전 1: http://<url>:<port>/auth/v1.0
  • 버전 2: http://<url>:<port>/v2.0
  • 버전 3: http://<url>:<port>/v3
이 파라미터가 설정되어 있지 않으면, Optim High Performance Unload 인증 버전 1을 사용할 때는 "ST_AUTH" 환경 변수의 값을, 인증 버전 2 또는 3을 사용할 때는 "OS_AUTH_URL" 환경 변수의 값을 가져오려고 합니다.
container
필수 매개변수입니다. 그것은 Optim High Performance Unload 출력 파일이 업로드됩니다.
프로젝트
선택적 옵션입니다. 인증 버전 2 및 3의 경우에만 지정할 수 있으며 그 외에는 필요하지 않습니다. 이 매개변수 값의 특성은 ‘project_id’ 매개변수의 설정에 따라 다릅니다. ‘project_id’ 매개변수가 설정되지 않았거나 아니오로 설정된 경우 해당 네이처는 이름입니다. ‘project_id’ 매개변수가 yes로 설정된 경우 해당 특성은 ID입니다. 인증 버전에 따라 이 매개변수에는 여러 가지 의미가 있습니다.
  • 버전 2의 경우 swift 테넌트 이름 또는 swift 테넌트 ID ( ‘project_id’ 매개변수 설정에 따라 다름) 에 해당합니다.
  • 버전 3의 경우 swift 프로젝트 이름 또는 swift 프로젝트 ID ( ‘project_id’ 매개변수 설정에 따라 다름) 에 해당합니다.
이 파라미터가 설정되어 있지 않고, ‘project_id’ (사용자 이름) 파라미터가 설정되어 있지 않거나 no로 설정되어 있는 경우, Optim High Performance Unload 인증 버전 2를 사용할 때는 "OS_TENANT_NAME" 환경 변수의 값을, 인증 버전 3을 사용할 때는 "OS_PROJECT_NAME" 환경 변수의 값을 얻으려고 합니다.
‘project_id’ 이 파라미터가 설정되어 있지 않고, yes로 설정된 경우, Optim High Performance Unload 인증 버전 2를 사용할 때는 "OS_TENANT_ID" 환경 변수의 값을, 인증 버전 3을 사용할 때는 "OS_PROJECT_ID" 환경 변수의 값을 얻으려고 합니다.
project_id
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 인증 버전 2 및 3의 경우에만 지정할 수 있으며 그 외에는 필요하지 않습니다. 예로 설정된 경우 ‘project’ 매개변수의 네이처는 테넌트 ID 또는 프로젝트 ID여야 합니다 (인증 버전이 2또는 3인지 여부에 따라 다름). 이것이 설정되지 않았거나 no로 설정된 경우 'project' 매개변수의 속성은 테넌트 이름 또는 프로젝트 이름이어야 합니다(인증 버전이 2 또는 3인 경우에 따라).
user_domain
선택적 옵션입니다. 인증 버전 3에만 지정할 수 있습니다. 이 매개변수 값의 특성은 ‘user_domain_id’ 매개변수의 설정에 따라 다릅니다. ‘user_domain_id’ 매개변수가 설정되지 않았거나 아니오로 설정된 경우 해당 네이처는 이름입니다. ‘user_domain_id’ 매개변수가 yes로 설정된 경우 해당 특성은 ID입니다. 사용자 도메인 이름 또는 사용자 도메인 ID ( ‘user_domain_id’ 매개변수 설정에 따라 다름) 에 해당합니다.
이 파라미터가 설정되어 있지 않고, ‘user_domain_id’ 파라미터가 설정되어 있지 않거나 no로 설정되어 있는 경우, Optim High Performance Unload "OS_USER_DOMAIN_NAME" 환경 변수의 값을 얻으려고 시도합니다.
‘user_domain_id’ 이 파라미터가 설정되어 있지 않고, yes로 설정된 경우, Optim High Performance Unload "OS_USER_DOMAIN_ID" 환경 변수의 값을 얻으려고 시도합니다.
user_domain_id
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 인증 버전 3에만 지정할 수 있습니다. 예로 설정된 경우 ‘user_domain’ 매개변수의 특성은 사용자 도메인 ID여야 합니다. 설정되지 않았거나 no로 설정된 경우 ‘user_domain’ 매개변수의 네이처는 사용자 도메인 이름이어야 합니다.
project_domain
선택적 옵션입니다. 인증 버전 3에만 지정할 수 있습니다. 이 매개변수 값의 특성은 ‘project_domain_id’ 매개변수의 설정에 따라 다릅니다. ‘project_domain_id’ 매개변수가 설정되지 않았거나 아니오로 설정된 경우 해당 네이처는 이름입니다. ‘project_domain_id’ 매개변수가 yes로 설정된 경우 해당 특성은 ID입니다. 프로젝트 도메인 이름 또는 프로젝트 도메인 ID ( ‘user_domain_id’ 매개변수 설정에 따라 다름) 에 해당합니다.
이 파라미터가 설정되어 있지 않고, ‘project_domain_id’ 파라미터가 설정되어 있지 않거나 no로 설정되어 있는 경우, Optim High Performance Unload "OS_PROJECT_DOMAIN_NAME" 환경 변수의 값을 얻으려고 시도합니다.
‘project_domain_id’ 이 파라미터가 설정되어 있지 않고, yes로 설정된 경우, Optim High Performance Unload "OS_PROJECT_DOMAIN_ID" 환경 변수의 값을 얻으려고 시도합니다.
project_domain_id
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 인증 버전 3에만 지정할 수 있습니다. 예로 설정된 경우 ‘project_domain’ 매개변수의 네이처는 프로젝트 도메인 ID여야 합니다. 설정되지 않았거나 no로 설정된 경우 ‘project_domain’ 매개변수의 네이처는 프로젝트 도메인 이름이어야 합니다.
도메인
선택적 옵션입니다. 인증 버전 3에만 지정할 수 있습니다. 이는 프로젝트, 사용자 및 그룹의 상위 레벨 컨테이너에 해당합니다. 이 파라미터가 설정되어 있지 않고, ‘domain_id’ 파라미터가 설정되어 있지 않거나 no로 설정되어 있는 경우, Optim High Performance Unload "OS_DOMAIN_NAME" 환경 변수의 값을 얻으려고 시도합니다.
‘domain_id’ 이 파라미터가 설정되어 있지 않고, yes로 설정된 경우, Optim High Performance Unload "OS_DOMAIN_ID" 환경 변수의 값을 얻으려고 시도합니다.
'user_domain' 또는 'project_domain' 매개변수가 설정되지 않은 경우, ‘domain’ 매개변수는 설정되지 않은 매개변수 대신 고려됩니다.
domain_id
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 인증 버전 3에만 지정할 수 있습니다. 예로 설정된 경우 ‘domain’ 매개변수의 특성은 도메인 ID여야 합니다. 설정되지 않았거나 no로 설정된 경우 ‘domain’ 매개변수의 네이처는 도메인 이름이어야 합니다.
region
선택적 옵션입니다. 인증 버전 2 및 3의 경우에만 지정할 수 있으며 그 외에는 필요하지 않습니다. 이는 오브젝트가 저장되는 영역에 해당합니다. 이 파라미터가 설정되어 있지 않으면, Optim High Performance Unload "OS_REGION_NAME" 환경 변수의 값을 얻으려고 시도합니다.
user_id
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 인증 버전 3에만 지정할 수 있습니다. 예로 설정된 경우 ‘user’ 매개변수의 네이처는 사용자 ID여야 합니다. 이것이 설정되지 않았거나 no로 설정된 경우 'user' 매개변수의 속성은 사용자 이름이어야 합니다.
filemaxsize
선택적 옵션입니다. 생성된 출력 파일의 파일 크기 한계를 지정하는 데 사용됩니다. 기본적으로 Swift 대상에 대한 파일에 적용되는 크기 한계는 5GB입니다. 이 매개변수는 단위가 MB인 숫자 값으로 설정되어야 합니다. 값은 4 - 5120(5GB) 사이여야 하며, 5120(5GB)은 Swift 오브젝트 크기의 상한입니다. ulimit 명령을 통해 파일 크기 한계가 설정된 경우, 이 매개변수 값은 설정된 한계보다 작아야 합니다. FILEMAXSIZE 절이 제어 파일에 지정된 경우, 여기에 지정된 값은 이 매개변수 값보다 작아야 합니다.
SegmentSize
선택적 옵션입니다. 해당 값은 최대 5368709120 (5GB) 의 숫자 값으로 설정되어야 합니다. 이를 통해 업로드 처리 중에 업로드할 파일을 원하는 크기의 세그먼트로 자동으로 분할하고 컨테이너에 파일 세그먼트를 업로드할 수 있습니다.

Microsoft Azure 대상에 특정한 매개변수

curl
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. 'curl' 매개변수가 no로 설정되거나 지정되지 않은 경우, 고려되는 도구는 업로드 명령 생성 또는 자동 마이그레이션 모두에 대한 Azure CLI입니다. 'curl' 그렇지 않으면, yes로 설정된 경우, 업로드 명령 생성 또는 자동 마이그레이션에 사용되는 도구는 cURL, 입니다.
계정
필수 매개변수입니다. 사용할 Azure 계정 이름을 지정할 수 있습니다.
SAStoken
'curl' 매개변수가 yes로 설정된 경우 필수 매개변수이며, 대신 사용되지 않습니다. Azure SAS (Shared Access Signature) 를 지정할 수 있습니다.
Blob
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본값은 '예'입니다. Azure 오브젝트 스토리지에 파일을 업로드할 때 고려할 Azure 오브젝트 유형을 지정할 수 있습니다. 해당 값이 yes로 설정되면 파일이 Azure 컨테이너에 BLOB 오브젝트 유형으로 업로드됩니다. 해당 값이 no로 설정되면 파일은 Azure 파일 공유를 향해 파일 오브젝트 유형으로 업로드됩니다.
container
출력 형식이 EXTERNAL 형식이 아니고 'blob' 매개변수가 지정되지 않았거나 예로 설정된 경우 필수입니다. 외부 테이블 작성 명령을 생성할 때 필수입니다. 그것은 그 대신 쓸모가 없다. 이는 파일이 업로드되는 컨테이너에 해당합니다.
shareName
'blob' 매개변수가 no로 설정되어 있는 경우 필수 매개변수이며, 그 대신에 사용되지 않습니다. 이는 파일이 업로드될 파일 공유 이름에 해당합니다.
relativepath
선택적 옵션입니다. 파일을 업로드할 상대 경로를 지정할 수 있습니다.
참고: Microsoft Azure 환경에 있는 파일을 기반으로 외부 테이블 생성 명령을 생성하려는 경우, 다음의 매개변수만 고려됩니다: 'container', 'account' 및 'relativepath'.
Microsoft Azure 대상을 고려할 때 인증을 관리하는 다양한 방법이 있습니다. 값은 다음과 같을 수 있습니다.
  • 계정 키는 자격 증명 파일의 적절한 섹션에 저장할 수 있습니다. 계정 키는 Microsoft Azure 포털의 스토리지 계정에서 찾을 수 있습니다. Security + networking 에서 액세스 키를 선택한 다음, Show 를 선택하여 액세스 키를 표시하고 거기에서 키를 복사할 수 있습니다.
  • 또는 'sastoken' 매개변수를 통해 지정할 수 있는 Azure SAS 토큰입니다. 적절한 Azure 리소스 및 서비스에 대한 충분한 권한으로 생성되어야 합니다. SAS 토큰을 생성하는 방법에는 여러 가지가 있습니다. 이에 대한 자세한 정보는 공식 Microsoft Azure 문서를 참조하십시오.

파일 시스템 환경에 특정한 매개변수

사용자
선택적 옵션입니다. 데이터 복사를 수행할 때 인증을 위해 고려할 대상 시스템의 사용자를 지정할 수 있습니다. 기본적으로 고려되는 사용자는 실행 사용자입니다.
URL
필수 매개변수입니다. 데이터를 복사할 대상 서버 이름을 지정할 수 있습니다.
경로
선택적 옵션입니다. 이 기능을 사용하면 Optim High Performance Unload 업로드됩니다.
참고 : 이 매개 변수를 생략하면, Optim High Performance Unload 생성된 파일을 대상 서버에서 인증할 사용자의 홈 디렉토리에 업로드합니다.
IsWindows
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수를 설정하지 않으면 값은 no입니다. 'url' 매개변수에 지정된 대상 서버가 Windows 서버인지 여부를 지정할 수 있습니다. 이 매개변수가 yes로 설정되고 'path' 매개변수도 설정된 경우, 설정된 값이 올바른 Windows 경로에 해당하는지 확인하기 위해 'path' 매개변수의 스펙에 대한 제어가 수행됩니다.
privatekey
선택적 옵션입니다. 대상 서버에서 인증에 대해 고려되는 사용자의 키 쌍과 연관된 개인 키의 경로를 지정할 수 있습니다. 개인 키 파일 형식은 pem 형식이어야 합니다. 업로드를 실행할 시스템이 Windows 시스템인 경우 이 매개변수에 설정된 값은 올바른 Windows 경로여야 합니다. 대상 서버에서 인증을 고려하는 사용자에 대해 대상 서버에서 공개 키를 적절하게 구성해야 합니다.
  • 수행된 태스크가 데이터 전송 명령 생성을 수반하는 표준 언로드인 경우 및 이 매개변수가 구성된 경우 데이터 전송 명령을 실행할 때 비밀번호가 프롬프트되지 않습니다. 그러나 이 매개변수가 구성되지 않은 경우 데이터 전송 명령은 실행 시 비밀번호를 묻는 프롬프트를 표시합니다.
  • 수행된 태스크가 자동 마이그레이션 태스크이고 이 매개변수가 구성되지 않은 경우, 대상 서버에서 인증을 위해 고려되는 사용자의 공개 키가 대상 서버에서 적절하게 구성되어야 합니다.

PostgreSQL 대상의 고유 매개변수

별명
선택적 옵션입니다. 값은 대소문자를 구분합니다. 별명이 제어 파일 내의 LOADDEST 절에 지정된 경우에 설정해야 합니다. 이 경우 이 매개변수를 기준으로 연관된 섹션이 고려할 섹션인지 판별할 수 있습니다. 마이그레이션 태스크의 경우에는 이 매개변수를 설정해야 합니다. 이 경우 고려되는 대상 유형의 신임 정보 파일에 작성된 섹션의 이름과 해당 매개변수의 값이 일치해야 합니다.
binpath
선택적 옵션입니다. 이는 유효 업로드를 위해 업로드 명령을 실행하려 할 때 이를 찾지 못하는 문제점을 방지하기 위해, psql 도구의 이름 앞에 디렉토리를 추가하여 업로드 명령을 빌드할 때 사용되는 디렉토리를 지정할 수 있게 해 줍니다. 올바른 절대 경로여야 합니다.
dbname
필수 매개변수입니다. 업로드에 사용할 데이터베이스 이름을 지정할 수 있습니다.
호스트
선택적 옵션입니다. 데이터를 언로드할 때, 이는 여기 지정된 시스템에서 생성할 파일을 작성할 수 있도록 합니다. 데이터를 마이그레이션할 때, 이는 데이터 마이그레이션에 사용할 업로드 명령이 생성되고 실행될 시스템의 이름을 지정할 수 있도록 합니다.
호스트_iswindows
선택적 옵션입니다. 해당 값은 yes 또는 no일 수 있습니다. 기본적으로 이 매개변수가 설정되지 않은 경우 값은 소스 머신 유형에 해당하는 값입니다. 이 매개변수를 사용하여 업로드 명령이 생성되거나 실행되는 시스템의 유형을 지정할 수 있습니다. Unix 인 경우, 매개변수 값을 ‘no’로 설정해야 합니다. Windows인 경우 매개변수 값을 yes로 설정해야 합니다. 제어 파일에 WORKING IN절이 지정되어 있고 이 매개변수도 지정되어 있는 경우에는 그에 따라 값을 설정해야 합니다. 업로드 머신이 Unix 머신인 경우, WORKING IN 절에 Unix 경로를 명시해야 하며, 이 매개변수 값은 no로 설정되어야 합니다. 업로드 시스템이 Windows 시스템인 경우 Windows 경로를 사용하여 WORKING IN절을 지정해야 하며 이 매개변수 값을 yes로 설정해야 합니다. 'host' 매개변수가 설정되지 않았거나 현재 시스템으로 설정된 경우에는 이 매개변수를 설정해도 소용이 없습니다. 'binpath' 매개변수가 설정되고 이 매개변수도 지정된 경우 해당 값을 적절히 설정해야 합니다. 'binpath' 매개변수 값은 업로드 시스템의 유형에 유효한 절대 경로로 설정해야 합니다.
포트
선택적 옵션입니다. 이는 관련된 PostgreSQL 서버의 포트 번호를 지정할 수 있게 해 줍니다. 지정되지 않은 경우에는 기본 포트 번호 5432가 사용됩니다.
URL
필수 매개변수입니다. 이는 관련된 PostgreSQL 서버의 URL을 지정할 수 있게 해 줍니다.

인증 매개변수 - 표준 인증 방법

이 인증 방법에 의존하려면 LOADDEST 절에 WITH STANDARD AUTH 옵션을 지정해야 합니다. 고려되는 대상에 대한 인증이 사용자 및 그와 연관된 비밀번호의 사용을 기반으로 하는 경우에는 이 표준 방법을 사용해야 합니다. 이는 Db2 대상, Cloudant 및 CouchDB NoSQL 대상, Swift 대상 및 PostgreSQL 대상에 지정할 수 있는 고유한 방법입니다. MongoDB 대상에 대해서도 이를 지정할 수 있습니다.
사용자
고려할 사용자를 지정하는 데 사용됩니다. 이 사용자는 예상 데이터 전송 명령을 수행하는 데 적합한 권한이 있어야 하며 해당 명령을 생성할 때 고려됩니다.
  • 표준 언로드의 경우 Db2 Load 명령 생성과 함께 표준 Db2 또는 원격 Db2 대상과 호환 가능합니다. 이 매개변수는 선택사항입니다. 연관된 LOADDEST절에 WITH STANDARD AUTH 옵션의 스펙이 포함된 경우 Db2 Load 명령 자체 전에 생성된 예비 연결 단계에 사용됩니다.
  • 표준 언로드의 경우, WITH STANDARD AUTH 옵션의 스펙을 포함하는 연관된 LOADDEST절이 있는 업로드 명령 생성과 함께 Db2 Warehouse 또는 PostgreSQL 대상인 Big Data와 호환 가능합니다. 이 매개변수는 필수입니다. 업로드 명령은 비밀번호의 난독화된 프롬프트에 대해 작성된 예비 단계와 함께 생성됩니다. 해당 명령을 실행할 때 먼저 비밀번호를 입력해야 합니다. 그러면 입력된 비밀번호를 고려하여 유효한 업로드 명령이 실행됩니다.
  • 자동 마이그레이션: 이 매개변수는 필수입니다. 기본 데이터 전송 처리는 내부적으로 비밀번호의 사용에 의존해야 합니다. 이 비밀번호는 자동 마이그레이션을 실행하는 사용자와 연관된 신임 정보 파일에서 읽혀집니다. 선택된 대상이 표준 Db2 유형, 원격 Db2 유형, Db2 Warehouse 유형, Cloudant 유형, CouchDB 유형, MongoDB 유형인지 여부에 따라 로컬, 원격, 웨어하우스, cloudant, couchdb, mongodb, swift및 postgresql 유형과 같은 적절한 유형의 신임 정보 섹션을 작성하여 이 파일에 미리 저장해야 합니다. Swift 1또는 PostgreSQL 입니다. 대상이 표준 Db2 또는 원격 Db2 또는 Db2 Warehouse 대상인 경우, 지정된 사용자는 고려되는 신임 정보 섹션의 user 매개변수에 설정된 사용자와 동일해야 합니다.
  • Swift 대상: 여러 규칙이 이 매개변수에 적용됩니다. 선택적 옵션입니다. 대부분의 경우 사용자 이름을 사용하여 이 매개변수를 설정해야 합니다. 그러나 ‘user_id’ 매개변수가 yes로 설정되고 선택된 인증 버전이 3인 경우 이 매개변수는 사용자 ID로 설정되어야 합니다. 이 파라미터가 설정되어 있지 않으면, Optim High Performance Unload 선택된 인증 버전에 따라 환경 변수의 값을 얻으려고 시도합니다. 선택한 인증 버전이 1인 경우 고려되는 환경 변수는 "ST_USER"입니다. 선택된 인증 버전이 2이거나 선택된 인증 버전이 3이고 ‘user_id’ 매개변수가 yes로 설정되지 않은 경우 고려되는 환경 변수는 " OS_USERNAME입니다. 선택된 인증 버전이 3이고 ‘user_id’ 매개변수가 yes로 설정된 경우 고려되는 환경 변수는 " OS_USER_ID 1입니다.
    참고: Swift 환경에서는 인증 버전 1의 경우 "ST_KEY, 인증 버전 2또는 3의 경우" OS_PASSWORD 환경 변수를 통해 사용자와 연관된 비밀번호를 설정할 수 있습니다. 그러나, 이러한 환경 변수는 Optim High Performance Unload 자동 마이그레이션을 수행할 때. 이러한 비밀번호는 반드시 Optim High Performance Unload 인증 파일 대신에.

인증 매개변수 - Kerberos 인증 방법

이 인증 방법을 사용하려면 LOADDEST 절에 WITH KERBEROS AUTH 옵션을 지정해야 합니다. 고려되는 대상에 대한 인증이 Kerberos 프린시펄의 사용을 기반으로 하는 경우에는 이 Kerberos 방법을 사용해야 합니다. 이 인증 방법은 MongoDB 대상에 대해 지정할 수 있으며 모든 Hadoop 대상에 대해 지정할 수 있는 고유한 방법입니다.
사용자
고려할 Kerberos 프린시펄을 지정하는 데 사용됩니다. 이 Kerberos 프린시펄은 예상 데이터 전송 명령을 수행할 수 있는 적합한 권한을 갖고 있어야 합니다. 데이터 전송 명령을 생성할 때 이 프린시펄이 Kerberos 티켓을 얻기 위한 예비 단계를 추가하는 방식으로 고려됩니다. 이 단계는 Kerberos 클라이언트의 일부인 kinit 명령을 기반으로 합니다. 이는 티켓을 얻으려고 시도하기 전에 설치되어 있어야 합니다. 이러한 티켓을 얻으려면 비밀번호도 사용해야 합니다. 이 비밀번호가 처리되는 방법은 수행되는 태스크에 따라 다릅니다.
  • 수행된 태스크가 데이터 전송 명령 생성을 수반하는 표준 언로드 태스크인 경우 연관된 keytab 매개변수도 구성할 수 있습니다. 이 매개변수를 구성하면, 구성된 키탭(keytab) 파일을 직접 참조하도록 Kerberos 티켓을 얻기 위한 예비 단계가 생성됩니다. 이 매개변수를 구성하지 않으면, 실행 시 비밀번호를 프롬프트하도록 예비 단계가 생성됩니다.
  • 수행되는 태스크가 자동 마이그레이션 태스크인 경우 연관된 keytab 매개변수를 구성해야 합니다.
keytab
고려할 프린시펄의 비밀번호가 미리 저장되어 있어야 하는 키탭(keytab) 파일의 절대 경로를 지정하는 데 사용됩니다.