有關 `cpdctl wx-data` 指令用法和範例的其他資訊

本主題針對 cpdctl wx-data 指令行介面 (CLI) 提供一些使用情境指南，涵蓋各種指令及其實用範例。雖然 cpdctl 提供了管理 IBM® watsonx.data 資源的方法，但有些範例需要特定平台的調整才能成功執行。本主題強調使用者（特別是 Windows 使用者）需要修改所提供範例以符合其作業系統的關鍵情境。此外，它還說明了在這些指令中如何使用 JSON 格式的關鍵值對，並概述了 Windows 使用者所需的格式。

本主題中的所有範例皆參照您使用「如何使用 wx-data 指令 (-h)"--help」章節中說明的 help 指令所取得的範例。

情況 1：延續線路或輸入新線路

macOS 和 Linux: 命令的幫助範例中使用的反斜線 ( ) 字元，在多行命令中用來表示換行。cpdctl wx-data``\ cpdctl 這可提高指定複雜命令選項時的可讀性。

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

視窗： Windows 命令提示符和 PowerShell 不以相同的方式支援用於換行的反斜線 ()。使用者必須在單一行中提供整個指令。

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

情況 2：指令選項中的 JSON 鍵值對

您可以用下列 2 種方式之一，為 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: 在和中使用 JSON 格式的關鍵值對時，可使用所提供的示例格式。macOS Linux --help

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

視窗： 在 Windows 中使用 JSON 格式的關鍵值對時，必須調整格式以適應命令提示和 PowerShell's 對引號的處理。

Windows Command Prompt：您必須以雙引號 (")取代 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``--api-key 指令 `sparkjob` 驗證失敗的解決方案

在某些邊緣情況下，若在搭配和 tablemaint sparkjob create 指令使用時，旗標 --api-key 未能通過驗證，您可改用隱藏旗標手動提供經編碼 --en-apikey 的 API 金鑰。

針對 watsonx.data 軟體部署，請採用以下格式 --en-apikey "ZenApiKey <Encoded_API_Key>"

建立編碼後的金鑰：

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

部署 SaaSwatsonx.data 時，請使用以下格式 --en-apikey "Basic <Encoded_API_Key>"