Información adicional sobre el uso comando `cpdctl wx-data` y ejemplos

En este tema se ofrecen algunas orientaciones sobre los escenarios de uso de la interfaz de línea de comandos (CLI) de cpdctl wx-data, que abarcan varios comandos y sus ejemplos prácticos. Aunque cpdctl ofrece una forma de gestionar los recursos de IBM® watsonx.data, algunos ejemplos requieren ajustes específicos de la plataforma para su correcta ejecución. En este tema se destacan las situaciones clave en las que los usuarios, especialmente los de Windows, deben modificar los ejemplos proporcionados para adaptarlos a su sistema operativo. Además, aclara cómo se utilizan los pares clave-valor con formato JSON en estos comandos y describe el formato necesario para los usuarios de Windows.

Todos los ejemplos de este tema se basan en los ejemplos que se obtienen utilizando el comando de ayuda explicado en la sección «Cómo utilizar --help(-h)" comando comando wx-data».

Escenario 1: Continuación de línea o entrada de nueva línea

macOS y Linux: El carácter de barra invertida (\) utilizado en los ejemplos de ayuda de los comandos cpdctl wx-data se utiliza para indicar la continuación de línea en los comandos multilínea cpdctl. Esto permite mejorar la legibilidad al especificar opciones de comando complejas.

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

Windows: El símbolo del sistema de Windows y PowerShell no admiten la barra invertida () para la continuación de línea del mismo modo. Los usuarios deben proporcionar el comando completo en una sola línea.

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

Escenario 2: Pares clave-valor JSON en opciones de comandos

Puede introducir opciones con formato JSON para los comandos cpdctl wx-data de una de las 2 formas indicadas:

El ejemplo proporcionado en este escenario se ha extraído parcialmente de la --help salida de Create con fines ilustrativos únicamente.

Muchos comandos wx-data de cpdctl utilizan pares clave-valor con formato JSON para especificar conjuntos complejos de comandos en un único conjunto. Estas cadenas JSON pueden incorporarse directamente a la línea de comandos, como se ve en los ejemplos de ayuda.
```
--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'
```

Las OPCIONES en el cpdctl CLI --help salida da las alternativas de una sola línea para los pares clave-valor JSON.

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

Escenario 3: Formatos de uso de pares clave-valor JSON en diferentes sistemas operativos

macOS y Linux: Cuando se utilicen pares clave-valor con formato JSON en macOS y Linux, se pueden utilizar los formatos de ejemplo proporcionados en --help.

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

Windows: Cuando se utilizan pares clave-valor con formato JSON en Windows, el formato debe ajustarse para adaptarse al símbolo del sistema y al manejo de las comillas en PowerShell's.

Símbolo del sistema de Windows: Debe sustituir las comillas simples (') que rodean la cadena JSON por comillas dobles (") y escapar todas las comillas dobles internas (") con una barra invertida (").
```
--associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"
```

Windows PowerShell: Todas las comillas dobles internas (") deben escaparse con una barra invertida (").

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

Escenario 4: Solución alternativa para el `--api-key` fallo de validación en comandos sparkjob``tablemaint comandos y

En algunos casos extremos, si la --api-key bandera falla la validación cuando se utiliza con los sparkjob create comandos tablemaint y, puede utilizar alternativamente la bandera oculta --en-apikey para proporcionar manualmente una clave API codificada.

Para watsonx.data implementaciones de software, utilice el siguiente formato --en-apikey "ZenApiKey <Encoded_API_Key>"

Crear la clave codificada:

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

Para watsonx.dataSaaS implementaciones, utilice el siguiente formato --en-apikey "Basic <Encoded_API_Key>"