Todos los productos
Search
Centro de documentos

MaxCompute:LOAD

Última actualización: Sep 21, 2026

Utilice la instrucción LOAD para cargar datos desde almacenes externos (por ejemplo, OSS, Hologres, Amazon Redshift o BigQuery) hacia una tabla o partición de MaxCompute.

Descripción general

MaxCompute utiliza el comando LOAD OVERWRITE o LOAD INTO para importar datos en formato CSV u otros formatos de código abierto. Estos datos provienen de un almacenamiento externo, como Hologres, OSS, Amazon Redshift y BigQuery, y se cargan en una tabla o partición de MaxCompute.

  • Antes de cargar los datos de Amazon Redshift y BigQuery en MaxCompute, debe importarlos primero a OSS.

  • MaxCompute emplea particionamiento dinámico para cargar datos en tablas particionadas.

  • El comando LOAD INTO agrega datos a una tabla o partición. Por su parte, el comando LOAD OVERWRITE borra primero la tabla o partición y después inserta los datos nuevos.

Restricciones

Requisitos de permisos

  • Permisos de MaxCompute

    • Permisos CreateTable y Alter: son obligatorios para crear tablas o modificar datos de tablas en un proyecto de MaxCompute. Para obtener instrucciones, consulte MaxCompute permissions.

  • Permisos de almacenamiento externo

    • Permisos de OSS: debe otorgar a MaxCompute los permisos necesarios para acceder a OSS (leer y listar objetos). Para mayor seguridad, utilice el modo STS en la autorización. Para más información, consulte Authorize access in STS mode.

    • Permisos de Hologres: para autorizar a MaxCompute a acceder a Hologres, cree un rol de RAM, asígnele los permisos requeridos y agregue dicho rol a la instancia de Hologres. Para más detalles, consulte Create a Hologres external table (STS mode).

Otras restricciones

  • El comando LOAD no admite parámetros de lista de permitidos ni de lista de denegados.

  • El almacenamiento externo y el proyecto de MaxCompute de destino deben estar en la misma región.

  • Al cargar datos desde OSS:

    El esquema de la tabla particionada de destino (sin incluir las columnas de partición) debe coincidir con el esquema de los datos externos. El esquema de los datos externos no debe contener las columnas de partición.

  • Al cargar datos desde Hologres:

    • No es posible cargar datos de una tabla particionada de Hologres en MaxCompute.

    • MaxCompute no puede cargar datos de una tabla externa de Hologres que utilice el modo de autorización de firma dual.

Carga de datos

OSS y Hologres

Cargar datos desde OSS o Hologres

Sintaxis del comando

{LOAD OVERWRITE|INTO} TABLE <table_name> [PARTITION (<pt_spec>)]
FROM LOCATION <external_location>
STORED BY <StorageHandler>
[WITH SERDEPROPERTIES (<Options>)];

Parámetros

OSS

Haga clic en para ver los detalles de los parámetros

  • table_name: obligatorio.

    Nombre de la tabla de destino. Debe crear esta tabla antes de cargar los datos. Su esquema, sin incluir las columnas de partición, debe coincidir con el formato de los datos externos.

  • pt_spec: opcional.

    Partición de la tabla de destino donde se cargarán los datos. El formato es (partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...).

  • external_location: obligatorio.

    Directorio de OSS del cual se leerán los datos. El formato es 'oss://<oss_endpoint>/<object>'. Para más información, consulte Access OSS by using endpoints and bucket domain names. De forma predeterminada, MaxCompute lee todos los archivos de este directorio.

  • StorageHandler: obligatorio.

    Especifica el nombre del controlador de almacenamiento integrado. Utilice com.aliyun.odps.CsvStorageHandler para archivos CSV. Este parámetro define cómo se leen y escriben los datos CSV. Solo necesita proporcionar su nombre, ya que el sistema se encarga de la lógica de implementación. Su uso es el mismo que para las tablas externas de MaxCompute. Para más información, consulte Create an OSS external table.

  • Options: opcional.

    Especifica los parámetros de la tabla externa. SERDEPROPERTIES admite las mismas propiedades que se usan en las tablas externas de MaxCompute. Para consultar la lista de propiedades compatibles, vea Create an OSS external table.

Hologres

Haga clic en para ver los detalles de los parámetros

  • table_name: obligatorio.

    Nombre de la tabla de destino. Debe crear esta tabla antes de cargar los datos. Su esquema, sin incluir las columnas de partición, debe coincidir con el formato de los datos externos.

  • pt_spec: opcional.

    Partición de la tabla de destino donde se cargarán los datos. El formato es (partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...).

  • external_location: obligatorio.

    URL de conexión JDBC para Hologres. El formato es '<jdbc:postgresql://<endpoint>:<port>/<database>?ApplicationName=MaxCompute&[currentSchema=<schema>&][useSSL={true|false}&]table=<holo_table_name>/>'.

    • endpoint: obligatorio.

      El nombre de dominio de red clásica de la instancia de Hologres. Para saber cómo obtenerlo, consulte Instance Details.

      Importante

      MaxCompute solo puede conectarse a Hologres mediante un nombre de dominio de red clásica. No se admiten conexiones que usen un nombre de dominio de red VPC.

    • port: obligatorio.

      Puerto de red de la instancia de Hologres. Para saber cómo obtenerlo, consulte Instance Details.

    • database: obligatorio.

      Nombre de la base de datos de Hologres a la que se conectará. Para más información sobre las bases de datos de Hologres, consulte CREATE DATABASE.

    • ApplicationName: obligatorio.

      De forma predeterminada, el valor es MaxCompute y no requiere modificaciones.

    • schema: opcional.

      Puede omitir este parámetro si el nombre de la tabla es único dentro de la base de datos de Hologres o si la tabla de origen está en el esquema predeterminado. Para más información sobre los esquemas, consulte CREATE SCHEMA.

    • holo_table_name: obligatorio.

      Nombre de la tabla de origen en Hologres. Para más información sobre las tablas de origen de Hologres, consulte CREATE TABLE.

  • StorageHandler: obligatorio.

    Define cómo se consulta la tabla externa de Hologres. Este valor es fijo: com.aliyun.odps.jdbc.JdbcStorageHandler.

  • Options: obligatorio.

    Especifica los parámetros relacionados con la tabla externa. Las propiedades que admite SERDEPROPERTIES son las mismas que se usan en las tablas externas de MaxCompute.

    • mcfed.mapreduce.jdbc.driver.class: obligatorio.

      Especifica el controlador para conectarse a la base de datos de Hologres. El valor es fijo: org.postgresql.Driver.

    • odps.federation.jdbc.target.db.type: obligatorio.

      Especifica el tipo de base de datos a la que se conectará. El valor es fijo: holo.

    • odps.federation.jdbc.colmapping: opcional.

      Especifica la asignación de columnas entre la tabla externa de MaxCompute y la tabla de origen de Hologres. Utilice este parámetro si necesita asignar solo un subconjunto de columnas o si los nombres de las columnas difieren.

      • Si no configura este parámetro, las columnas se asignan por nombre.

      • Si configura este parámetro pero especifica la asignación solo para un subconjunto de columnas, las columnas restantes se asignan por nombre. Se reporta un error si alguna columna sin asignar tiene nombres o tipos de datos distintos.

      • Si configura este parámetro y el nombre de una columna en Hologres contiene letras mayúsculas, debe encerrar dicho nombre entre comillas dobles (""). El formato es: MaxCompute_column1:"Hologres_column1"[,MaxCompute_column2:"Hologres_column2",...].

        Nota

        La tabla de origen de Hologres tiene las columnas c bool, map_B string, a bigint. La tabla externa de Hologres tiene las columnas a bigint, x string, c bool.

        Si establece este parámetro en 'x:"map_B"', los datos se pueden asignar y consultar correctamente.

    • mcfed.mapreduce.jdbc.input.query: opcional. Especifica una consulta SQL personalizada para leer datos de la tabla de origen de Hologres. El esquema del conjunto de resultados de la consulta (incluidos los nombres de columna y los tipos de datos) debe coincidir con el esquema de la tabla externa de MaxCompute. Si usa alias en la consulta, estos deben coincidir con los nombres de columna de la tabla externa. El formato de select_sentence es SELECT xxx FROM <holo_database_name>.<holo_schema_name>.<holo_table_name>.

Ejemplos

OSS

Este ejemplo muestra cómo cargar datos mediante un extractor integrado (StorageHandler). Supone que MaxCompute y OSS pertenecen a la misma cuenta de Alibaba Cloud, y demuestra cómo cargar datos del archivo vehicle.csv en MaxCompute a través de la red interna de Alibaba Cloud.

  1. Haga clic aquí para la autorización con un solo clic.

  2. Guarde el archivo vehicle.csv en el directorio mc-test/data_location/ de un bucket de OSS en la región oss-cn-hangzhou. Después, construya la ruta del directorio de OSS. Para más información sobre cómo crear un bucket de OSS, consulte Create a bucket.

    La ruta del directorio de OSS se construye con la información del bucket, la región y el endpoint, de la siguiente manera:

    oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/
  3. Inicie sesión en MaxCompute client (odpscmd) para crear la tabla de destino ambulance_data_csv_load. Comando de ejemplo:

    CREATE TABLE ambulance_data_csv_load (
    vehicleId INT,
    recordId INT,
    patientId INT,
    calls INT,
    locationLatitude DOUBLE,
    locationLongitude DOUBLE,
    recordTime STRING,
    direction STRING );
    
  4. Ejecute el comando load overwrite para cargar el archivo vehicle.csv de OSS en la tabla de destino. Comando de ejemplo:

    LOAD OVERWRITE TABLE ambulance_data_csv_load
    FROM
    LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/'
    STORED BY 'com.aliyun.odps.CsvStorageHandler'
    WITH SERDEPROPERTIES (
        -- The ARN of AliyunODPSDefaultRole. You can obtain it on the RAM role management page.
        'odps.properties.rolearn'='acs:ram::xxxxx:role/aliyunodpsdefaultrole',
        'odps.text.option.delimiter'=','
    );
    

    Para consultar el ARN de un rol, vea View a RAM role.

  5. Compruebe los datos de la tabla de destino ambulance_data_csv_load. Comando de ejemplo:

    -- Enable a full table scan. This setting is valid only for the current session.
    set odps.sql.allow.fullscan=true;
    SELECT * FROM ambulance_data_csv_load;
    
    -- The following result is returned:
    +------------+------------+------------+------------+------------------+-------------------+------------+------------+
    | vehicleid  | recordid   | patientid  | calls      | locationlatitude | locationlongitude | recordtime | direction  |
    +------------+------------+------------+------------+------------------+-------------------+------------+------------+
    | 1          | 1          | 51         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          |
    | 1          | 2          | 13         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         |
    | 1          | 3          | 48         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         |
    | 1          | 4          | 30         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | W          |
    | 1          | 5          | 47         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          |
    | 1          | 6          | 9          | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          |
    | 1          | 7          | 53         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | N          |
    | 1          | 8          | 63         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | SW         |
    | 1          | 9          | 4          | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         |
    | 1          | 10         | 31         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | N          |
    +------------+------------+------------+------------+------------------+-------------------+------------+------------+

Hologres

  1. Escenario

    Ya se crearon una instancia y una base de datos de Hologres, además de una tabla dentro de dicha base de datos.

    Se creó una tabla externa de Hologres en MaxCompute. Puede consultar los datos de la tabla de Hologres mediante esta tabla externa.

    -- Query the Hologres external table:
    SELECT * FROM holo_ext;
    
    -- The following result is returned:
    +------------+------+
    | id         | name |
    +------------+------+
    | 1          | abc  |
    | 2          | ereg |
    +------------+------+
  2. A continuación se muestra cómo usar el comando LOAD para cargar datos de esta tabla de Hologres en una tabla interna de MaxCompute.

    1. Cree una tabla interna de MaxCompute.

      -- Create an internal table.
      CREATE TABLE from_holo(id BIGINT, name STRING);
    2. Utilice el comando LOAD para cargar los datos en MaxCompute.

      -- Load data from the Hologres table into a MaxCompute internal table.
      LOAD INTO TABLE from_holo 
      FROM LOCATION 'jdbc:postgresql://hgprecn-cn-wwo3ft0l****-cn-beijing-internal.hologres.aliyuncs.com:80/<YOUR_HOLO_DB_NAME>?application_name=MaxCompute&currentSchema=public&useSSL=false&table=<YOUR_HOLOGRES_TABLE_NAME>/' 
      STORED BY 'com.aliyun.odps.jdbc.JdbcStorageHandler' 
      WITH SERDEPROPERTIES (
        'odps.properties.rolearn'='acs:ram::18927322887*****:role/hologresrole',
        'mcfed.mapreduce.jdbc.driver.class'='org.postgresql.Driver', 
        'odps.federation.jdbc.target.db.type'='holo'
      );
      
  3. Consulte la tabla para ver el resultado.

    SELECT * FROM from_holo;
    
    -- The following result is returned:
    +------------+------+
    | id         | name |
    +------------+------+
    | 2          | ereg |
    | 1          | abc  |
    +------------+------+

Otros formatos de código abierto

Cargar datos en otros formatos de código abierto

El tamaño de un solo archivo que se va a cargar no puede superar los 3 GB. Si un archivo es demasiado grande, divídalo antes de cargarlo.

Sintaxis del comando

{LOAD OVERWRITE|INTO} TABLE <table_name> [PARTITION (<pt_spec>)]
FROM LOCATION <external_location>
[ROW FORMAT SERDE '<serde_class>'
  [WITH SERDEPROPERTIES (<Options>)]
]
STORED AS <file_format>;

Parámetros

Haga clic en para ver los detalles de los parámetros

  • table_name: obligatorio.

    Nombre de la tabla de destino. Debe crear esta tabla antes de cargar los datos. Su esquema, sin incluir las columnas de partición, debe coincidir con el formato de los datos externos.

  • pt_spec: opcional.

    Partición de la tabla de destino donde se cargarán los datos. El formato es (partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...).

  • external_location: obligatorio.

    Directorio de OSS del cual se leerán los datos. El formato es 'oss://<oss_endpoint>/<object>'. Para más información, consulte Access OSS by using endpoints and bucket domain names. De forma predeterminada, MaxCompute lee todos los archivos de este directorio.

  • serde_class: opcional.

    Puede omitir este parámetro si utiliza el valor predeterminado. Su uso es el mismo que para las tablas externas de MaxCompute. Para más información, consulte Create an OSS external table.

  • Options: opcional.

    Puede omitir este parámetro si utiliza el valor predeterminado. Especifica los parámetros de la tabla externa. SERDEPROPERTIES admite las mismas propiedades que se usan en las tablas externas de MaxCompute. Para consultar la lista de propiedades compatibles, vea Create an OSS external table.

  • file_format: obligatorio.

    Formato del archivo de datos que se va a cargar, como ORC, PARQUET, RCFILE, SEQUENCEFILE o TEXTFILE. Su uso es el mismo que para las tablas externas de MaxCompute. Para más información, consulte Create an OSS external table.

Ejemplos

Misma cuenta

Propiedad de la misma cuenta

Este ejemplo muestra cómo cargar datos del archivo vehicle.textfile en MaxCompute a través de la red interna de Alibaba Cloud.

Nota

Si MaxCompute y OSS pertenecen a cuentas de Alibaba Cloud distintas, consulte Authorization in STS mode.

  1. Haga clic aquí para la autorización con un solo clic.

  2. Guarde el archivo vehicle.textfile en el directorio mc-test/data_location/ de un bucket de OSS en la región oss-cn-hangzhou. Después, construya la ruta del directorio de OSS. Para más información sobre cómo crear un bucket de OSS, consulte Create a bucket.

    La ruta del directorio de OSS se construye con la información del bucket, la región y el endpoint, de la siguiente manera:

    oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/
  3. Inicie sesión en MaxCompute client (odpscmd) para crear la tabla de destino ambulance_data_textfile_load_pt. Comando de ejemplo:

    CREATE TABLE ambulance_data_textfile_load_pt (
      vehicleId STRING,
      recordId STRING,
      patientId STRING,
      calls STRING,
      locationLatitude STRING,
      locationLongitude STRING,
      recordTime STRING,
      direction STRING
    )
    PARTITIONED BY (
      ds STRING
    );
  4. Ejecute el comando load overwrite para cargar el archivo vehicle.textfile de OSS en la tabla de destino. Comando de ejemplo:

    LOAD OVERWRITE TABLE ambulance_data_textfile_load_pt PARTITION(ds='20200910')
    FROM
      LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/'
    ROW FORMAT SERDE 'org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe'
    WITH SERDEPROPERTIES ('field.delim' = ',')
    STORED AS TEXTFILE;
  5. Compruebe los datos de la tabla de destino ambulance_data_textfile_load_pt. Comando de ejemplo:

    -- Enable a full table scan. This setting is valid only for the current session.
    SET odps.sql.allow.fullscan=true;
    SELECT * FROM ambulance_data_textfile_load_pt;
    
    -- The following result is returned:
    +-----------+----------+-----------+-------+------------------+-------------------+----------------+-----------+----------+
    | vehicleid | recordid | patientid | calls | locationlatitude | locationlongitude | recordtime     | direction | ds       |
    +-----------+----------+-----------+-------+------------------+-------------------+----------------+-----------+----------+
    | 1         | 1        | 51        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | S         | 20200910 |
    | 1         | 2        | 13        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE        | 20200910 |
    | 1         | 3        | 48        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE        | 20200910 |
    | 1         | 4        | 30        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | W         | 20200910 |
    | 1         | 5        | 47        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | S         | 20200910 |
    | 1         | 6        | 9         | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | S         | 20200910 |
    | 1         | 7        | 53        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | N         | 20200910 |
    | 1         | 8        | 63        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | SW        | 20200910 |
    | 1         | 9        | 4         | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE        | 20200910 |
    | 1         | 10       | 31        | 1     | 46.81006         | -92.08174         | 9/14/2014 0:00 | N         | 20200910 |
    +-----------+----------+-----------+-------+------------------+-------------------+----------------+-----------+----------+

Particiones dinámicas

Cargar datos mediante particiones dinámicas

Nota

Puede utilizar particiones dinámicas para cargar datos cuando los subdirectorios de OSS tienen nombres basados en pares clave-valor de partición, como ds=20200909/.

  1. Haga clic aquí para la autorización con un solo clic.

  2. Guarde los archivos vehicle1.csv y vehicle2.csv en los directorios mc-test/data_location/ds=20200909/ y mc-test/data_location/ds=20200910/ de un bucket de OSS en la región oss-cn-hangzhou, respectivamente. Después, construya las rutas de los directorios de OSS. Para más información sobre cómo crear un bucket de OSS, consulte Create a bucket.

    Las rutas de los directorios de OSS se construyen con la información del bucket, la región y el endpoint, de la siguiente manera:

    oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/ds=20200909/'
    oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/ds=20200910/'
  3. Inicie sesión en MaxCompute client (odpscmd) para crear la tabla de destino ambulance_data_csv_load_dynpt. Comando de ejemplo:

    CREATE TABLE ambulance_data_csv_load_dynpt (
      vehicleId STRING,
      recordId STRING,
      patientId STRING,
      calls STRING,
      locationLatitude STRING,
      locationLongitude STRING,
      recordTime STRING,
      direction STRING
    )
    PARTITIONED BY (
      ds STRING
    );
  4. Ejecute el comando load overwrite para cargar los archivos de OSS en la tabla de destino. Comando de ejemplo:

    LOAD OVERWRITE TABLE ambulance_data_csv_load_dynpt PARTITION(ds)
    FROM
      LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/mc-test/data_location/'
    ROW FORMAT SERDE 'org.apache.hadoop.hive.serde2.OpenCSVSerde'
    STORED AS TEXTFILE;
    
  5. Compruebe los datos de la tabla de destino ambulance_data_csv_load_dynpt. Comando de ejemplo:

    -- Enable a full table scan. This setting is valid only for the current session.
    SET odps.sql.allow.fullscan=true;
    SELECT * FROM ambulance_data_csv_load_dynpt;
    
    -- The following result is returned:
    +------------+------------+------------+------------+------------------+-------------------+----------------+------------+------------+
    | vehicleid  | recordid   | patientid  | calls      | locationlatitude | locationlongitude | recordtime     | direction  | ds         |
    +------------+------------+------------+------------+------------------+-------------------+----------------+------------+------------+
    | 1          | 7          | 53         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | N          | 20200909   |
    | 1          | 8          | 63         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | SW         | 20200909   |
    | 1          | 9          | 4          | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         | 20200909   |
    | 1          | 10         | 31         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | N          | 20200909   |
    | 1          | 1          | 51         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          | 20200910   |
    | 1          | 2          | 13         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         | 20200910   |
    | 1          | 3          | 48         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | NE         | 20200910   |
    | 1          | 4          | 30         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | W          | 20200910   |
    | 1          | 5          | 47         | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          | 20200910   |
    | 1          | 6          | 9          | 1          | 46.81006         | -92.08174         | 9/14/2014 0:00 | S          | 20200910   |
    +------------+------------+------------+------------+------------------+-------------------+----------------+------------+------------+

Facturación

El comando LOAD carga datos externos en el almacén de datos. Con el modelo pay-as-you-go no se cobra por el volumen de datos importados, y con el modelo de suscripción no se cobran tareas individuales. Sin embargo, todas las tareas LOAD consumen recursos de cómputo de su resource group.

Referencias

Para exportar datos de un proyecto de MaxCompute a un almacenamiento externo, como OSS o Hologres, y que otros motores de cómputo los utilicen, consulte UNLOAD.