MaxCompute SQL prend en charge deux catégories de fonctions : les fonctions intégrées et les fonctions définies par l'utilisateur (UDF). Les fonctions intégrées couvrent nativement les tâches courantes de traitement et d'agrégation des données. Si elles ne répondent pas à vos besoins, utilisez les API Java ou Python pour créer des UDF dotées d'une logique personnalisée.
Fonctions intégrées
Les fonctions intégrées sont prêtes à l'emploi dans toute instruction MaxCompute SQL, sans configuration préalable. Elles gèrent des tâches courantes telles que la manipulation de chaînes, les opérations mathématiques, le traitement des dates et l'agrégation.
Pour consulter la liste complète, reportez-vous à la rubrique Fonctions intégrées.
Fonctions définies par l'utilisateur (UDF)
Les UDF étendent les capacités de MaxCompute grâce à une logique personnalisée écrite en Java ou en Python. Utilisez-les lorsque les fonctions intégrées ne couvrent pas vos exigences spécifiques.
MaxCompute prend en charge trois types de UDF :
| Type | Description |
|---|---|
| Fonction scalaire définie par l'utilisateur (UDF) | Prend une ligne en entrée et renvoie une ligne en sortie. Utilisez-la pour les transformations au niveau des lignes. |
| Fonction d'agrégation définie par l'utilisateur (UDAF) | Opère sur plusieurs lignes en entrée et renvoie un seul résultat. Utilisez-la pour une logique d'agrégation personnalisée, telle que les moyennes pondérées ou des calculs statistiques complexes. |
| Fonction table définie par l'utilisateur (UDTF) | Prend une ligne en entrée et renvoie zéro ou plusieurs lignes en sortie. Utilisez-la lorsqu'une seule ligne en entrée doit produire plusieurs lignes en sortie. |
Une fois enregistrée, appelez une UDF comme une fonction intégrée, en indiquant son nom et ses paramètres dans une instruction SQL.
Développer et enregistrer une UDF
Pour rendre une UDF disponible dans MaxCompute SQL :
Écrivez le code de la UDF en utilisant l'API UDF de MaxCompute.
Empaquetez le code en le compilant dans un package JAR (pour les UDF Java).
Téléchargez le package vers MaxCompute en tant que ressource.
Enregistrez la UDF dans MaxCompute avec un nom et la référence de la ressource.
Pour des instructions détaillées, consultez la rubrique Créer une UDF.