cpdctl wx-data 명령어 사용법 및 예제에 대한 추가 정보

이 주제에서는 cpdctl wx-data 명령줄 인터페이스(CLI)에 대한 몇 가지 사용 시나리오 지침을 제공하며, 다양한 명령어와 실제 예제를 다룹니다. cpdctl 에서 IBM® watsonx.data 리소스를 관리하는 방법을 제공하지만, 일부 예제는 플랫폼별로 조정해야 성공적으로 실행할 수 있습니다. 이 주제에서는 특히 Windows를 사용하는 사용자가 운영 체제에 맞게 제공된 예제를 수정해야 하는 주요 시나리오를 중점적으로 설명합니다. 또한 이러한 명령 내에서 JSON 형식의 키-값 쌍이 어떻게 활용되는지 설명하고 Windows 사용자에게 필요한 서식을 간략하게 설명합니다.

이 주제의 모든 예제는 "wx-data 명령어 사용 --help(-h)"" 방법" 섹션에서 설명된 help 명령어를 사용하여 얻은 예제를 기준으로 참조됩니다.

시나리오 1: 회선 계속 또는 새 회선 입력

macOS 및 Linux: cpdctl wx-data 명령의 도움말 예제에서 사용된 백슬래시(\) 문자는 여러 줄로 된 cpdctl 명령에서 줄 연속을 나타내는 데 사용됩니다. 이렇게 하면 복잡한 명령 옵션을 지정할 때 가독성이 향상됩니다.

./cpdctl wx-data engine attach \
    --id presto785 \
    --catalog-names icebergCatalog \
    --name presto \
    --instance-id 1234567890

Windows: Windows 명령 프롬프트와 PowerShell 는 줄 연속을 위한 백슬래시()를 같은 방식으로 지원하지 않습니다. 사용자는 전체 명령을 한 줄에 입력해야 합니다.

cpdctl wx-data engine attach --id presto785 --catalog-names icebergCatalog --name presto --instance-id 1234567890

시나리오 2: 명령 옵션의 JSON 키 값 쌍

나열된 두 가지 방법 중 하나를 사용하여 cpdctl wx-data 명령에 JSON 형식의 옵션을 입력할 수 있습니다:

이 시나리오에서 제공된 예시는 설명 목적으로만 Create의 출력 --help 결과 일부를 발췌한 것입니다.

  • 많은 cpdctl wx-data 명령은 JSON 형식의 키 값 쌍을 사용하여 복잡한 명령 집합을 단일 집합으로 지정합니다. 도움말 예제에서 볼 수 있듯이 이러한 JSON 문자열은 명령줄에 직접 통합할 수 있습니다.

    --associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'

  • Cpdctl CLI --help 출력의 OPTIONS는 JSON 키 값 쌍에 대한 한 줄 대체 값을 제공합니다.

    --associated-catalog-name "hivecos" --associated-catalog-tags ["tag_1", "tag_2"] --associated-catalog-type "hive-hadoop2"

시나리오 3: 서로 다른 운영 체제의 JSON 키 값 쌍 사용 형식

macOS 및 Linux: macOS 및 Linux 에서 JSON 형식의 키 값 쌍을 사용하는 경우 제공된 --help 예제 형식을 그대로 사용할 수 있습니다.

--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'

Windows: Windows에서 JSON 형식의 키 값 쌍을 사용하는 경우 명령 프롬프트 및 따옴표의 PowerShell's 처리에 맞게 서식을 조정해야 합니다.

  • Windows 명령 프롬프트: JSON 문자열을 둘러싼 작은따옴표(')를 큰따옴표(")로 바꾸고 내부 큰따옴표(")는 모두 백슬래시(")로 이스케이프 처리해야 합니다.

    --associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"

  • Windows PowerShell: 모든 내부 큰따옴표(")는 백슬래시(")로 이스케이프 처리해야 합니다.

    --associated-catalog '{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}'

시나리오 4: 및 tablemaint sparkjob 명령어의 유효성 검사 --api-key 실패에 대한 해결 방법

일부 특수한 경우에, --api-key 플래그가 및 tablemaint sparkjob create 명령어와 함께 사용될 때 유효성 검사에 실패하면, 대신 숨겨진 플래그 를 --en-apikey 사용하여 인코딩된 API 키를 수동으로 제공할 수 있습니다.

소프트웨어 배포 watsonx.data 시 다음 형식을 사용하십시오. --en-apikey "ZenApiKey <Encoded_API_Key>"

인코딩된 키 생성:

echo -n "username:<CPD_API_KEY>" | base64

배포 watsonx.dataSaaS 시에는 다음 형식을 사용하십시오 --en-apikey "Basic <Encoded_API_Key>"

인코딩된 키 생성:

echo -n "ibmlhapikey_<username>:<SAAS_API_KEY>" | base64