MaxCompute:Guide d'utilisation

• Upload : charge les données d'un fichier local vers une table MaxCompute. Chaque opération de chargement écrit les données dans une seule table ou une seule partition. Pour une table partitionnée, spécifiez la partition de destination. Pour une table à partitions multiples, spécifiez la partition de niveau le plus bas. Pour plus d'informations, consultez Upload.

• Download : télécharge les données d'une table MaxCompute ou les résultats d'une instance spécifique vers un fichier local. Chaque opération de téléchargement permet de télécharger une table ou une partition dans un seul fichier. Pour une table partitionnée, spécifiez la partition source. Pour une table à partitions multiples, spécifiez la partition de niveau le plus bas. Pour plus d'informations, consultez Download.

• Resume : si un chargement échoue en raison de problèmes réseau ou d'erreurs du service Tunnel, utilisez la commande Resume pour reprendre le chargement du fichier. Cette commande reprend l'opération de chargement précédente. La commande Resume ne prend pas actuellement en charge les opérations de téléchargement. Pour plus d'informations, consultez Resume.

• Show : affiche les informations relatives aux tâches historiques. Pour plus d'informations, consultez Show.

• Purge : vide le répertoire de session. Par défaut, cette commande supprime les journaux des trois derniers jours. Pour plus d'informations, consultez Purge.

• Help : affiche l'aide. Des formats de commande abrégés sont pris en charge pour chaque commande et option.

• Upsert : écrit les données en combinant les sémantiques Update et Insert. Cette commande est uniquement prise en charge pour les tables Transaction Table 2.0.

  Si aucune donnée correspondante n'est trouvée dans la table de destination, les nouvelles données sont insérées. Si les données existent déjà, elles sont mises à jour.

Avant de commencer, préparez un fichier de données nommé data.txt et enregistrez-le sous d:\data.txt. Le fichier contient les données suivantes.

shopx,x_id,100
shopy,y_id,200
shopz,z_id

Les étapes suivantes décrivent comment charger et télécharger les données d'une table.

1. Dans le client MaxCompute, exécutez les instructions suivantes pour créer la table partitionnée sale_detail et lui ajouter une partition.

   CREATE TABLE IF NOT EXISTS sale_detail(
         shop_name     STRING,
         customer_id   STRING,
         total_price   DOUBLE)
   PARTITIONED BY (sale_date STRING,region STRING);
   
   alter table sale_detail add partition (sale_date='201312', region='hangzhou');

2. Utilisez la commande upload pour charger le fichier de données data.txt dans la table partitionnée sale_detail.

   • Exemple de commande

     tunnel upload d:\data.txt sale_detail/sale_date=201312,region=hangzhou -s false;

   • Valeur de retour

     Upload session: 20230505xxxxxxxxxxxb0b02dbb6bd
     Start upload:d:\data.txt
     Using \r\n to split records
     Upload in strict schema mode: true
     Total bytes:42   Split input to 1 blocks
     2023-05-05 10:11:35     upload block: '1'
     ERROR: column mismatch -,expected 3 columns, 2 columns found, please check data or delimiter

     Remarque

     Étant donné que le fichier data.txt contient des données incorrectes, l'importation des données échoue. Un ID de session et un message d'erreur sont renvoyés.

3. Exécutez l'instruction suivante pour vérifier les données.

   • Exemple de commande

     select * from sale_detail where sale_date='201312';

   • Valeurs de retour

     ID = 20230505xxxxxxxxxxxvc61z5
     +-----------+-------------+-------------+-----------+--------+
     | shop_name | customer_id | total_price | sale_date | region |
     +-----------+-------------+-------------+-----------+--------+
     +-----------+-------------+-------------+-----------+--------+

     Remarque

     L'importation des données a échoué en raison de données incorrectes, laissant la table vide.

4. Utilisez la commande show pour interroger l'ID de session du chargement ayant échoué.

   • Exemple de commande

     tunnel show history;

   • Résultat renvoyé

     20230505xxxxxxxxxxxb0b02dbb6bd  failed  'upload d:\data.txt sale_detail/sale_date=201312,region=Hangzhou -s false'

5. Modifiez le fichier de données exemple data.txt afin qu'il contienne les données suivantes, qui correspondent au schéma de table de sale_detail.

   shopx,x_id,100
   shopy,y_id,200

6. Exécutez la commande resume pour reprendre le chargement des données. Dans cette commande, 20230505xxxxxxxxxxxb0b02dbb6bd correspond à l'ID de session du chargement ayant échoué.

   • Exemple de commande

     tunnel resume 20230505xxxxxxxxxxxb0b02dbb6bd --force;

   • Valeur de retour

     start resume
     20230505xxxxxxxxxxxb0b02dbb6bd
     Upload session: 20230505xxxxxxxxxxxb0b02dbb6bd
     Start upload:d:\data.txt
     Using \r\n to split records
     Upload in strict schema mode: true
     Resume 1 blocks 
     2023-05-05 10:32:39     upload block: '1'
     2023-05-05 10:32:40     upload block complete, block id: 1
     upload complete, average speed is 0 bytes/s
     OK

7. Exécutez l'instruction suivante pour vérifier les données. Le chargement est réussi.

   • Exemple de commande

     select * from sale_detail where sale_date='201312';

   • Valeur de retour

     ID = 20230505xxxxxxxxxxxx7afc9qcg
      +-----------+-------------+-------------+-----------+--------+
      | shop_name | customer_id | total_price | sale_date | region |
      +-----------+-------------+-------------+-----------+--------+
      | shopx     | x_id        | 100.0       | 201312    | hangzhou|
      | shopy     | y_id        | 200.0       | 201312    | hangzhou|
      +-----------+-------------+-------------+-----------+--------+

8. Exécutez la commande download pour télécharger les données de la table sale_detail vers un fichier local nommé result.txt.

   Remarque

   Les conventions de nommage pour le chemin local path où les données sont téléchargées sont les suivantes :

   • Pour enregistrer le fichier directement dans le répertoire bin du client MaxCompute, définissez path sur filename.extension.

   • Pour enregistrer le fichier dans un autre chemin, tel que le dossier test sur le lecteur D, définissez path sur D:\test\filename.extension.

   • Si un fichier local portant le même nom existe déjà, il est écrasé.

   tunnel download sale_detail/sale_date=201312,region=hangzhou result.txt;

9. Vérifiez le contenu du fichier result.txt. Le fichier contient le contenu suivant, ce qui indique que le téléchargement est réussi.

   Remarque

   Le fichier téléchargé affiche uniquement les valeurs des champs non partitionnés.

   shopx,x_id,100.0
   shopy,y_id,200.0