Informations complémentaires sur l'utilisation de la commande `cpdctl wx-data` et exemples

Cette rubrique propose quelques scénarios d'utilisation de l'interface de ligne de commande (CLI) de cpdctl wx-data, couvrant diverses commandes et leurs exemples pratiques. Si cpdctl permet de gérer IBM® watsonx.data ressources, certains exemples nécessitent des ajustements spécifiques à la plateforme pour une exécution réussie. Cette rubrique présente des scénarios clés dans lesquels les utilisateurs, en particulier ceux qui utilisent Windows, doivent modifier les exemples fournis pour les adapter à leur système d'exploitation. En outre, il clarifie la manière dont les paires clé-valeur au format JSON sont utilisées dans ces commandes et décrit le formatage requis pour les utilisateurs de Windows.

Tous les exemples présentés dans cette rubrique sont référencés à partir des exemples obtenus à l'aide de la commande d'aide expliquée dans la section « Comment utiliser --help(-h)" la commande wx-data ».

Scénario 1 : Continuation de la ligne ou entrée d'une nouvelle ligne

macOS et Linux: Le caractère barre oblique inverse (\) utilisé dans les exemples d'aide des commandes cpdctl wx-data est utilisé pour indiquer la continuation de la ligne dans les commandes multilignes cpdctl. Cela permet d'améliorer la lisibilité lors de la spécification d'options de commande complexes.

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

Windows : L'invite de commande de Windows et PowerShell ne prennent pas en charge de la même manière la barre oblique inverse () pour le retour à la ligne. Les utilisateurs doivent fournir la commande complète sur une seule ligne.

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

Scénario 2 : paires de clés et de valeurs JSON dans les options de commande

Vous pouvez saisir des options au format JSON pour les commandes cpdctl wx-data de l'une des deux manières suivantes :

L'exemple fourni dans ce scénario est extrait en partie du --help résultat de Create à des fins d'illustration uniquement.

De nombreuses commandes cpdctl wx-data utilisent des paires clé-valeur formatées en JSON pour spécifier un ensemble complexe de commandes en un seul ensemble. Ces chaînes JSON peuvent être directement incorporées dans la ligne de commande, comme le montrent les exemples d'aide.
```
--associated-catalog '{
    "catalog_name": "hivecos",
    "catalog_tags": ["tag_1", "tag_2"],
    "catalog_type": "hive-hadoop2"
  }'
```

Les OPTIONS dans la sortie de cpdctl CLI --help donnent les alternatives d'une seule ligne pour les paires clé/valeur JSON.

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

Scénario 3 : formats d'utilisation des paires de clés et de valeurs JSON dans différents systèmes d'exploitation

macOS et Linux: Lors de l'utilisation de paires clé-valeur formatées en JSON dans macOS et Linux, les formats d'exemple --help fournis peuvent être utilisés tels qu'ils sont disponibles.

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

Windows : Lors de l'utilisation de paires clé-valeur formatées JSON sous Windows, le formatage doit être ajusté pour s'adapter à l'invite de commande et à la gestion des guillemets par PowerShell's.

Invite de commande Windows : Vous devez remplacer les guillemets simples (') entourant la chaîne JSON par des guillemets doubles (") et échapper à tous les guillemets doubles internes (") par une barre oblique inverse (").
```
--associated-catalog "{\"catalog_name\": \"hivecos\", \"catalog_tags\": [\"tag_1\", \"tag_2\"], \"catalog_type\": \"hive-hadoop2\"}"
```

Windows PowerShell: Tous les guillemets internes (") doivent être échappés par une barre oblique inverse (").

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

Scénario 4 : Solution de contournement pour `--api-key` l'échec de la validation dans les `tablemaint` commandes `sparkjob` et

Dans certains cas particuliers, si le --api-key drapeau échoue à la validation lorsqu'il est utilisé avec les sparkjob create commandes tablemaint et, vous pouvez utiliser à la place le drapeau --en-apikey caché pour fournir manuellement une clé API encodée.

Pour les watsonx.data déploiements de logiciels, utilisez le format suivant --en-apikey "ZenApiKey <Encoded_API_Key>"

Créer la clé codée :

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

Pour watsonx.dataSaaS les déploiements, utilisez le format suivant --en-apikey "Basic <Encoded_API_Key>"