Informações adicionais sobre o uso do comando `cpdctl wx-data` e exemplos

Este tópico fornece algumas orientações sobre o cenário de uso da interface de linha de comando (CLI) do site cpdctl wx-data, abrangendo vários comandos e seus exemplos práticos. Embora o site cpdctl ofereça uma maneira de gerenciar os recursos do IBM® watsonx.data, alguns exemplos exigem ajustes específicos da plataforma para uma execução bem-sucedida. Este tópico destaca os principais cenários em que os usuários, especialmente os do Windows, precisam modificar os exemplos fornecidos para se alinharem ao seu sistema operacional. Além disso, ele esclarece como os pares de valores-chave formatados em JSON são utilizados nesses comandos e descreve a formatação necessária para os usuários do Windows.

Todos os exemplos neste tópico são referenciados com base nos exemplos obtidos usando o comando de ajuda explicado na seção “Como --help(-h)" usar o comando wx-data”.

Cenário 1: Continuação de linha ou entrada de nova linha

macOS e Linux: O caractere de barra invertida (\) usado nos exemplos de ajuda dos comandos cpdctl wx-data é usado para indicar a continuação da linha em comandos cpdctl de várias linhas. Isso permite uma melhor legibilidade ao especificar opções de comando complexas.

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

Windows: O prompt de comando do Windows e o site PowerShell não suportam a barra invertida () para continuação de linha da mesma forma. Os usuários devem fornecer o comando inteiro em uma única linha.

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

Cenário 2: pares de valores-chave JSON em opções de comando

Você pode inserir opções formatadas em JSON para os comandos cpdctl wx-data de uma das duas maneiras listadas:

O exemplo fornecido neste cenário foi extraído parcialmente da --help saída do Create apenas para fins ilustrativos.

Muitos comandos cpdctl wx-data utilizam pares de valores-chave formatados em JSON para especificar um conjunto complexo de comandos em um único conjunto. Essas cadeias de caracteres JSON podem ser incorporadas diretamente à linha de comando, como visto nos exemplos de ajuda.
```
--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'
```

As OPTIONS na saída do cpdctl CLI --help fornecem as alternativas de linha única para os pares de valores-chave JSON.

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

Cenário 3: formatos de uso de pares de valores-chave JSON em diferentes sistemas operacionais

macOS e Linux: Ao usar pares de valores-chave formatados em JSON em macOS e Linux, os formatos de exemplo fornecidos em --help podem ser usados conforme disponíveis.

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

Windows: Ao usar pares de valores-chave formatados em JSON no Windows, a formatação deve ser ajustada para acomodar o prompt de comando e o manuseio de aspas no site PowerShell's.

Prompt de comando do Windows: Você deve substituir as aspas simples (') ao redor da cadeia de caracteres JSON por aspas duplas (") e escapar de todas as aspas duplas internas (") com uma barra invertida (").
```
--associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"
```

Windows PowerShell: Todas as aspas duplas internas (") devem ser escapadas com uma barra invertida (").

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

Cenário 4: Solução alternativa para `--api-key` falha de validação nos `sparkjob` comandos `tablemaint` e

Em alguns casos extremos, se o --api-key sinalizador falhar na validação quando usado com os sparkjob create comandos tablemaint e, você pode usar o sinalizador --en-apikey oculto para fornecer manualmente uma chave API codificada.

Para watsonx.data implantações de software, use o seguinte formato --en-apikey "ZenApiKey <Encoded_API_Key>"

Crie a chave codificada:

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

Para watsonx.dataSaaS implantações, use o seguinte formato --en-apikey "Basic <Encoded_API_Key>"