MaxCompute:Guía de uso

• Upload: Carga datos desde un archivo local hacia una tabla de MaxCompute. Cada operación de carga puede escribir datos en una sola tabla o en una única partition. En tablas particionadas, debe especificar la partición de destino. Si la tabla tiene varios niveles de partición, es necesario indicar la partición del nivel más bajo. Para más información, consulte Upload.

• Download: Descarga datos de una tabla de MaxCompute o los resultados de una instancia específica a un archivo local. Cada operación permite descargar una tabla o una partición en un solo archivo. Para tablas particionadas, debe especificar la partición de origen. En tablas con múltiples niveles de partición, indique la partición del nivel más bajo. Para más información, consulte Download.

• Resume: Si una carga falla debido a problemas de red o errores del servicio Tunnel, utilice el comando Resume para continuar con la transferencia del archivo. Este comando reanuda la operación de carga anterior. Actualmente, Resume no admite operaciones de descarga. Para más información, consulte Resume.

• Show: Muestra información sobre tareas históricas. Para más información, consulte Show.

• Purge: Limpia el directorio de sesiones. De forma predeterminada, este comando elimina los registros de los últimos tres días. Para más información, consulte Purge.

• Help: Muestra información de ayuda. Se admiten formatos abreviados para cada comando y opción.

• Upsert: Escribe datos mediante una combinación de semánticas Update e Insert. Este comando solo es compatible con tablas Transaction Table 2.0.

  Si no se encuentran datos coincidentes en la tabla de destino, se insertan nuevos registros. Si los datos ya existen, se actualizan.

Antes de comenzar, prepare un archivo de datos llamado data.txt y guárdelo en d:\data.txt. El archivo contiene los siguientes datos:

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

Los siguientes pasos describen cómo cargar y descargar datos de tablas.

1. En el cliente de MaxCompute, ejecute las siguientes sentencias para crear la tabla particionada sale_detail y agregarle una partición.

   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. Utilice el comando upload para cargar el archivo de datos data.txt en la tabla particionada sale_detail.

   • Comando de ejemplo

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

   • Valor devuelto

     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

     Nota

     Dado que data.txt contiene datos incorrectos, la importación falla. Se devuelve un ID de sesión y un mensaje de error.

3. Ejecute la siguiente sentencia para comprobar los datos.

   • Comando de ejemplo

     select * from sale_detail where sale_date='201312';

   • Valores devueltos

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

     Nota

     La importación de datos falló debido a datos incorrectos, por lo que la tabla quedó vacía.

4. Use el comando show para consultar el ID de sesión de la carga fallida.

   • Comando de ejemplo

     tunnel show history;

   • Resultado devuelto

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

5. Modifique el archivo de datos de ejemplo data.txt para que contenga los siguientes datos, los cuales coinciden con el esquema de la tabla sale_detail.

   shopx,x_id,100
   shopy,y_id,200

6. Ejecute el comando resume para reanudar la carga de datos. En este comando, 20230505xxxxxxxxxxxb0b02dbb6bd corresponde al ID de sesión de la carga fallida.

   • Comando de ejemplo

     tunnel resume 20230505xxxxxxxxxxxb0b02dbb6bd --force;

   • Valor devuelto

     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. Ejecute la siguiente sentencia para verificar los datos. La carga se completó correctamente.

   • Comando de ejemplo

     select * from sale_detail where sale_date='201312';

   • Valor devuelto

     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. Ejecute el comando download para descargar los datos de la tabla sale_detail a un archivo local llamado result.txt.

   Nota

   Las convenciones de nomenclatura para la ruta local path donde se descargan los datos son las siguientes:

   • Para guardar el archivo directamente en el directorio bin del cliente de MaxCompute, establezca path como filename.extension.

   • Para guardar el archivo en otra ruta, como la carpeta test en la unidad D, establezca path como D:\test\filename.extension.

   • Si existe un archivo local con el mismo nombre, se sobrescribe.

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

9. Verifique el contenido del archivo result.txt. El archivo contiene lo siguiente, lo cual indica que la descarga fue exitosa.

   Nota

   El archivo descargado muestra únicamente los valores de los campos que no son de partición.

   shopx,x_id,100.0
   shopy,y_id,200.0