Après avoir développé et débogué un programme Java, empaquetez-le dans un fichier JAR, téléversez ce fichier en tant que ressource dans un projet MaxCompute et enregistrez-le en tant que fonction définie par l'utilisateur (UDF) MaxCompute afin de pouvoir l'appeler dans Data Development. MaxCompute Studio vous permet d'effectuer ces trois étapes en un seul clic.
Prérequis
Le programme Java est développé et débogué. Pour plus d'informations, consultez les rubriques Développer des UDF, Développer MapReduce ou Développer Graph.
Description de la fonctionnalité
MaxCompute Studio vous permet d'empaqueter un programme Java dans un fichier JAR, de téléverser ce fichier sur MaxCompute et d'enregistrer une UDF en un seul clic. Cette méthode est recommandée.
Vous pouvez également effectuer manuellement les trois opérations suivantes dans MaxCompute Studio :
Empaquetez le programme Java dans un fichier JAR. Pour plus d'informations, consultez la rubrique Générer un fichier JAR.
Téléversez le fichier JAR sur MaxCompute. Pour plus d'informations, consultez la rubrique Ajouter des ressources.
Enregistrez l'UDF MaxCompute. Pour plus d'informations, consultez la rubrique Enregistrer des fonctions.
Procédure
Dans IntelliJ IDEA, cliquez sur Project dans le volet de navigation de gauche. Accédez au dossier source du module, situé sous . Cliquez avec le bouton droit sur le programme Java compilé et sélectionnez Deploy to server….
-
Dans la boîte de dialogue Package a jar, submit resource and register function, configurez les paramètres.
Nom du paramètre
Description
MaxCompute Project
Projet MaxCompute de destination. Par défaut, il s'agit du projet dans lequel se trouve le programme Java.
Resource file
Chemin local du fichier JAR après l'empaquetage du programme Java par MaxCompute Studio.
Resource name
Nom de la ressource attribué au fichier JAR dans le projet MaxCompute.
Resource comment
Commentaire associé à la ressource JAR.
Extra resources
Autres fichiers de ressources requis pour l'enregistrement de l'UDF MaxCompute. Dans la liste des ressources, cliquez sur les fichiers cibles. Pour sélectionner plusieurs fichiers, maintenez la touche Ctrl enfoncée et cliquez sur chaque fichier. La liste affiche les ressources déjà téléversées dans votre projet MaxCompute. Pour plus d'informations sur l'ajout de ressources, consultez la rubrique Ajouter des ressources.
Main class
Classe définie dans votre programme Java pour la nouvelle UDF.
Function name
Nom utilisé pour appeler cette UDF dans les instructions SQL.
Force update if already exists
Remplace toute fonction ou ressource existante portant le même nom dans le projet MaxCompute.
-
Cliquez sur OK pour empaqueter le programme, téléverser la ressource et enregistrer l'UDF MaxCompute.
Une fois ces étapes terminées, vous pouvez appeler l'UDF dans les instructions SQL.
Étapes suivantes
Après avoir enregistré l'UDF Java, vous pouvez l'appeler à l'aide de MaxCompute SQL :
Appeler l'UDF depuis le projet dans lequel elle est enregistrée : utilisez l'UDF de la même manière qu'une fonction intégrée.
Appeler l'UDF depuis un autre projet : par exemple, appelez une UDF enregistrée dans le projet B depuis le projet A.
SELECT B:<udf_name> (<arg0>, <arg1>) FROM <table_name>;. Pour plus d'informations sur le partage interprojets, consultez la rubrique Accéder aux ressources entre projets à l'aide de packages.
Références
Pour résoudre les problèmes courants liés au développement et à l'appel des UDF Java, consultez la rubrique FAQ sur les UDF Java MaxCompute.
Pour consulter des exemples de développement d'UDF, voir la rubrique Exemples de développement d'UDF.