Weitere Informationen zur Verwendung des Befehls `cpdctl wx-data` und Beispiele

Dieses Thema enthält einige Anleitungen für die Verwendung der Befehlszeilenschnittstelle (CLI) cpdctl wx-data, die verschiedene Befehle und deren praktische Beispiele abdecken. Während cpdctl eine Möglichkeit bietet, IBM® watsonx.data Ressourcen zu verwalten, erfordern einige Beispiele plattformspezifische Anpassungen für eine erfolgreiche Ausführung. In diesem Thema werden die wichtigsten Szenarien hervorgehoben, in denen Benutzer, insbesondere Windows-Benutzer, die bereitgestellten Beispiele ändern müssen, um sie an ihr Betriebssystem anzupassen. Außerdem wird erläutert, wie JSON-formatierte Schlüssel-Wert-Paare in diesen Befehlen verwendet werden, und es wird die erforderliche Formatierung für Windows-Benutzer beschrieben.

Alle Beispiele in diesem Thema beziehen sich auf die Beispiele, die Sie mit dem Befehl „help“ erhalten, der im Abschnitt „Verwendung --help(-h)" des Befehls wx-data“ erläutert wird.

Szenario 1: Zeilenfortsetzung oder neue Zeileneintragung

macOS und Linux: Das Backslash-Zeichen (\), das in den Hilfebeispielen der cpdctl wx-data-Befehle verwendet wird, dient zur Anzeige der Zeilenfortsetzung in mehrzeiligen cpdctl-Befehlen. Dies ermöglicht eine bessere Lesbarkeit bei der Angabe von komplexen Befehlsoptionen.

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

Windows: Die Windows-Eingabeaufforderung und PowerShell unterstützen den Backslash () für die Zeilenfortsetzung nicht in gleicher Weise. Der Benutzer muss den gesamten Befehl in einer einzigen Zeile eingeben.

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

Szenario 2: JSON-Schlüssel-Wert-Paare in Befehlsoptionen

Sie können JSON-formatierte Optionen für cpdctl wx-data-Befehle auf eine der beiden aufgeführten Arten eingeben:

Das in diesem Szenario angeführte Beispiel wurde teilweise aus der --help Ausgabe von Create zu Illustrationszwecken extrahiert.

Viele cpdctl wx-data-Befehle verwenden JSON-formatierte Schlüssel-Wert-Paare, um komplexe Befehlssätze in einem einzigen Satz anzugeben. Diese JSON-Strings können direkt in die Befehlszeile eingefügt werden, wie in den Hilfebeispielen zu sehen ist.
```
--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'
```

Die OPTIONS in der Ausgabe von cpdctl CLI --help geben die einzeiligen Alternativen für die JSON-Schlüssel-Wert-Paare an.

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

Szenario 3: Verwendungsformate von JSON-Schlüssel-Wert-Paaren in verschiedenen Betriebssystemen

macOS und Linux: Bei der Verwendung von JSON-formatierten Schlüssel-Wert-Paaren in macOS und Linux können die bereitgestellten --help-Beispielformate verwendet werden, da sie verfügbar sind.

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

Windows: Bei der Verwendung von JSON-formatierten Schlüssel-Wert-Paaren unter Windows muss die Formatierung angepasst werden, um die Eingabeaufforderung und die PowerShell's Handhabung von Anführungszeichen zu berücksichtigen.

Windows-Eingabeaufforderung: Sie müssen die einfachen Anführungszeichen ('), die die JSON-Zeichenfolge umgeben, durch doppelte Anführungszeichen (") ersetzen und alle internen doppelten Anführungszeichen (") durch einen umgekehrten Schrägstrich (") ersetzen.
```
--associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"
```

Windows PowerShell: Alle internen Anführungszeichen (") müssen mit einem Backslash (") maskiert werden.

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

Szenario 4: Workaround für `--api-key` Validierungsfehler in `sparkjob` und `tablemaint` Befehlen

In einigen Randfällen, wenn das --api-key Flag bei Verwendung mit den Befehlen sparkjob create``tablemaint und die Validierung nicht besteht, können Sie alternativ das versteckte Flag verwenden --en-apikey, um manuell einen verschlüsselten API-Schlüssel anzugeben.

Verwenden Sie für watsonx.data Softwarebereitstellungen das folgende Format --en-apikey "ZenApiKey <Encoded_API_Key>"

Erstellen Sie den verschlüsselten Schlüssel:

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

Verwenden Sie für watsonx.dataSaaS Bereitstellungen das folgende Format --en-apikey "Basic <Encoded_API_Key>"