MaxCompute:Présentation des fonctions intégrées

Types de fonctions

Les fonctions intégrées de MaxCompute se répartissent en trois grandes catégories :

• Fonctions scalaires : elles opèrent sur une seule ligne et renvoient une valeur par appel. Cette catégorie inclut les fonctions de date et heure, mathématiques, de chaîne, de chiffrement, réseau, ainsi que celles dédiées aux types ARRAY, MAP, STRUCT, JSON et au traitement des données non structurées.

• Fonctions d'agrégation : elles prennent plusieurs lignes en entrée et renvoient une seule valeur en sortie.

• Fonctions de fenêtrage : elles opèrent sur un sous-ensemble de lignes défini dans une fenêtre et renvoient une valeur par ligne.

Pour obtenir la correspondance entre les fonctions intégrées de MaxCompute et leurs équivalents open source, consultez la rubrique Correspondance entre les fonctions intégrées de MaxCompute, Hive, MySQL et Oracle.

Consignes d'utilisation

Tenez compte des points suivants lors de l'utilisation des fonctions intégrées :

• Paramètres d'entrée : le type, le nombre et le format des paramètres d'entrée doivent respecter la syntaxe spécifiée. Dans le cas contraire, MaxCompute ne peut pas analyser la fonction et l'instruction SQL échoue.

• Data types 2,0 : si une fonction intégrée utilise les types Data types 2,0 (TINYINT, SMALLINT, INT, FLOAT, VARCHAR, TIMESTAMP ou BINARY), vous devez activer Data types 2,0 avant d'exécuter la fonction. Sinon, une erreur est signalée. Activez Data types 2,0 à l'un des niveaux suivants :

  • Niveau de la session (s'applique uniquement à l'instruction SQL actuelle) : ajoutez l'instruction suivante avant votre instruction SQL et soumettez-les ensemble.

    SET odps.sql.type.system.odps2=true;

  • Niveau du projet (s'applique à toutes les instructions SQL suivantes, prend effet en 10 à 15 minutes) : le propriétaire du projet exécute la commande suivante.

    SETPROJECT odps.sql.type.system.odps2=true;

• Conversions de type implicites désactivées : lorsque Data types 2,0 est activé, les conversions de type implicites suivantes sont désactivées pour éviter toute perte de précision ou erreur : STRING vers BIGINT, STRING vers DATETIME, DOUBLE vers BIGINT, DECIMAL vers DOUBLE et DECIMAL vers BIGINT. Utilisez la fonction CAST pour des conversions explicites, ou désactivez Data types 2,0.

• Conflits de noms entre UDF et fonctions intégrées : si une fonction définie par l'utilisateur (UDF) porte le même nom qu'une fonction intégrée, l'UDF est prioritaire. Par exemple, si une UDF nommée CONCAT existe dans un projet, le système appelle l'UDF au lieu de la fonction intégrée CONCAT. Pour appeler la fonction intégrée, préfixez le nom de la fonction avec :: :

  SELECT ::CONCAT('ab', 'c');

• Propriétés globales : les résultats des fonctions intégrées peuvent varier selon les propriétés globales configurées pour le projet MaxCompute. Exécutez SETPROJECT; pour afficher les propriétés globales actuelles.

Limites des fonctions JSON

Limites des fonctions STRING

Les fonctions de chaîne suivantes ne prennent en charge que les caractères anglais :

• TRIM / RTRIM / LTRIM : le paramètre trimChars ne prend en charge que les caractères anglais.

• REVERSE : ne prend en charge que les caractères anglais en mode Hive.

• SOUNDEX : convertit uniquement les caractères anglais.

• TOLOWER : convertit les lettres majuscules anglaises en minuscules.

• TOUPPER : convertit les lettres minuscules anglaises en majuscules.

• INITCAP : convertit la première lettre anglaise de chaque mot en majuscule et le reste en minuscule.