MaxCompute:Desarrollo de una tarea de ODPS SQL

Comandos de SQL

Los comandos de MaxCompute SQL emplean una sintaxis similar a la de SQL estándar y admiten instrucciones DDL, DML y DQL, así como sintaxis específica de MaxCompute. Para conocer los requisitos de sintaxis y ver ejemplos de uso de cada comando de SQL, consulte SQL overview. A continuación se muestra un ejemplo sencillo sobre cómo desarrollar y ejecutar comandos de SQL.

• Crear una tabla

  Utilice la instrucción CREATE TABLE para crear una tabla sin particiones, una tabla particionada, una tabla externa o una tabla agrupada (clustered). Para obtener más información, consulte CREATE TABLE. Ejemplo de instrucción de SQL:

  -- Create a partitioned table named test1.
  CREATE TABLE if NOT EXISTS students
  ( id BIGINT,
    name STRING,
    age BIGINT,
    birth DATE)
  partitioned BY (gender STRING); 

• Insertar datos

  Use la instrucción INSERT INTO o INSERT OVERWRITE para insertar o actualizar datos en una tabla de destino. Para obtener más información, consulte Insert or overwrite data (INSERT INTO | INSERT OVERWRITE). Ejemplos de instrucciones de SQL:

  -- Insert data.
  INSERT INTO students PARTITION(gender='boy') VALUES (1,'John',15,DATE '2008-05-15') ;
  INSERT INTO students PARTITION(gender='boy') VALUES (2,'Jack',17,DATE '2006-07-20') ;
  INSERT INTO students PARTITION(gender='girl') VALUES (3,'Alice',20,DATE '2003-04-20') ;
  INSERT INTO students PARTITION(gender='girl') VALUES (4,'Lily',21,DATE '2002-01-08') ;
  INSERT INTO students PARTITION(gender='boy') VALUES (5,'Bob',17,DATE '2006-09-12') ;

  Importante

  Evite usar la instrucción INSERT INTO para insertar datos, ya que podría provocar duplicaciones accidentales. Se recomienda utilizar la instrucción INSERT OVERWRITE en su lugar. Para obtener más información, consulte Insert or overwrite data.

• Consultar datos

  La instrucción SELECT le permite llevar a cabo operaciones como consultas anidadas, consultas agrupadas y ordenamiento. Para obtener más información, consulte SELECT syntax. Ejemplos de instrucciones de SQL:

  -- (Optional) Enable full table scan at the project level. This operation requires high-level permissions.
  -- SETPROJECT odps.sql.allow.fullscan=true;  
  
  -- Enable full table scan at the session level. This setting is valid only for the current session.
  SET odps.sql.allow.fullscan=true; 
  -- Query the information about all boys and sort the results by ID in ascending order.
  SELECT * FROM students WHERE gender='boy' ORDER BY id;

  Nota

  De forma predeterminada, un usuario de RAM no tiene permisos de consulta en las tablas de producción. Para consultar dichas tablas, envíe una solicitud en Security Center. Para conocer los ajustes predefinidos de permisos de datos de MaxCompute y el control de acceso en DataWorks, consulte MaxCompute data permission control details. Para saber cómo otorgar permisos mediante comandos en MaxCompute, consulte Manage user permissions by using commands.

Funciones de SQL

MaxCompute admite funciones integradas y funciones definidas por el usuario (UDF) para el desarrollo y análisis de datos. Para obtener más información sobre las funciones integradas, consulte Overview of built-in functions. Para conocer más acerca de las UDF, consulte MaxCompute UDF overview. En el siguiente ejemplo se muestra cómo usar funciones de SQL.

• Funciones integradas: estas funciones vienen preinstaladas en MaxCompute y se pueden invocar directamente. Tomando como base el ejemplo anterior, utilice la función dateadd para modificar la columna birth con una unidad y un intervalo específicos. Comando de ejemplo:

  -- Enable full table scan at the session level. This setting is valid only for the current session.
  SET odps.sql.allow.fullscan=true; 
  SELECT id, name, age, birth, dateadd(birth,1,'mm') AS birth_dateadd FROM students;

• Funciones definidas por el usuario (UDF): para usar una UDF, debe escribir el código de la función, cargarlo como recurso y registrar la función. Para obtener más información, consulte Create and use a UDF.

Ejecución y resultados

• Los resultados de la ejecución se muestran directamente en formato de hoja de cálculo. Puede realizar operaciones en DataWorks, abrir los resultados en una hoja de cálculo o copiar y pegar el contenido en un archivo de Excel local. Para obtener más información, consulte Debug tasks.

  Nota

  Debido a un ajuste en la información de zona horaria de China publicado por la Organización Internacional de Normalización (ISO), podría presentarse una discrepancia temporal en la visualización de fechas al ejecutar consultas de SQL relevantes en DataWorks. La diferencia es de 5 minutos y 52 segundos para las fechas comprendidas entre 1900 y 1928, y de 9 segundos para las fechas anteriores a 1900.

• Registro de ejecución: haga clic en la pestaña Operational Logs para consultar Logview. Para obtener más información, consulte View job information by using Logview V2.0.

• Resultados devueltos:

  • Consulte la información de todos los niños y ordene los resultados por identificador (ID) de forma ascendente.

    +------------+------------+------------+------------+------------+
    | id         | name       | age        | birth      | gender     |
    +------------+------------+------------+------------+------------+
    | 1          | John       | 15         | 2008-05-15 | boy        |
    | 2          | Jack       | 17         | 2006-07-20 | boy        |
    | 5          | Bob        | 17         | 2006-09-12 | boy        |
    +------------+------------+------------+------------+------------+

  • Modifique la columna birth con una unidad y un intervalo específicos.

    +------------+------------+------------+------------+---------------+
    | id         | name       | age        | birth      | birth_dateadd |
    +------------+------------+------------+------------+---------------+
    | 4          | Lily       | 21         | 2002-01-08 | 2002-02-08    |
    | 3          | Alice      | 20         | 2003-04-20 | 2003-05-20    |
    | 2          | Jack       | 17         | 2006-07-20 | 2006-08-20    |
    | 1          | John       | 15         | 2008-05-15 | 2008-06-15    |
    | 5          | Bob        | 17         | 2006-09-12 | 2006-10-12    |
    +------------+------------+------------+------------+---------------+

  En la página de resultados de la consulta, puede ordenar los datos por un campo específico y descargarlos. Para obtener más información, consulte Process query results.