Ulteriori informazioni sull'uso del comando `cpdctl wx-data` ed esempi

Questo argomento fornisce alcune indicazioni sugli scenari d'uso dell'interfaccia a riga di comando (CLI) di cpdctl wx-data, con vari comandi ed esempi pratici. Sebbene cpdctl offra un modo per gestire le risorse di IBM® watsonx.data, alcuni esempi richiedono aggiustamenti specifici per la piattaforma per un'esecuzione efficace. Questo argomento evidenzia gli scenari chiave in cui gli utenti, in particolare quelli di Windows, devono modificare gli esempi forniti per adattarli al proprio sistema operativo. Inoltre, chiarisce come vengono utilizzate le coppie chiave-valore in formato JSON all'interno di questi comandi e delinea la formattazione necessaria per gli utenti Windows.

Tutti gli esempi in questo argomento fanno riferimento agli esempi ottenuti utilizzando il comando di aiuto spiegato nella sezione "Come utilizzare il comando wx-data --help(-h)"" ".

Scenario 1: Continuazione della linea o inserimento di una nuova linea

macOS e Linux: il carattere backslash (\) utilizzato negli esempi di guida dei comandi cpdctl wx-data è usato per indicare la continuazione della riga nei comandi cpdctl multilinea. Ciò consente di migliorare la leggibilità quando si specificano opzioni di comando complesse.

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

Windows: Il prompt dei comandi di Windows e PowerShell non supportano il backslash () per la continuazione della riga nello stesso modo. Gli utenti devono fornire l'intero comando su una sola riga.

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

Scenario 2: coppie di valori chiave JSON nelle opzioni di comando

È possibile inserire opzioni in formato JSON per i comandi cpdctl wx-data in uno dei due modi elencati:

L'esempio fornito in questo scenario è tratto in parte --help dall'output di Create solo a scopo illustrativo.

Molti comandi cpdctl wx-data utilizzano coppie chiave-valore formattate JSON per specificare una serie complessa di comandi in un unico set. Queste stringhe JSON possono essere incorporate direttamente nella riga di comando, come si vede negli esempi di guida.
```
--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'
```

OPTIONS nell'output di cpdctl CLI --help fornisce le alternative a riga singola per le coppie di valori chiave JSON.

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

Scenario 3: formati di utilizzo delle coppie di valori chiave JSON in diversi sistemi operativi

macOS e Linux: quando si usano coppie di valori-chiave formattate in JSON in macOS e Linux, si possono usare i formati di esempio forniti in --help, come è disponibile.

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

Windows: Quando si utilizzano coppie di valori-chiave formattate in JSON in Windows, la formattazione deve essere adattata per adattarsi al prompt dei comandi e alla gestione delle virgolette di PowerShell's.

Prompt dei comandi di Windows: È necessario sostituire le virgolette singole (') che circondano la stringa JSON con virgolette doppie (") e sfuggire a tutte le virgolette doppie interne (") con un backslash (").
```
--associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"
```

Windows PowerShell: Tutti i doppi apici interni (") devono essere evasi con un backslash (").

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

Scenario 4: Soluzione alternativa per `--api-key` errore di convalida nei comandi sparkjob``tablemaint e

In alcuni casi limite, se il --api-key flag non supera la convalida quando viene utilizzato con i comandi sparkjob create``tablemaint e, è possibile utilizzare in alternativa il flag nascosto --en-apikey per fornire manualmente una chiave API codificata.

Per le watsonx.data distribuzioni software, utilizzare il seguente formato --en-apikey "ZenApiKey <Encoded_API_Key>"

Crea la chiave codificata:

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

Per watsonx.dataSaaS le implementazioni, utilizzare il seguente formato --en-apikey "Basic <Encoded_API_Key>"