Crée un alias pour une ressource.
Utilisez ALIAS dans le code MapReduce ou UDF (fonction définie par l'utilisateur) pour basculer entre différentes versions de ressources sans modifier le code. Attribuez le même alias à des ressources différentes selon les jobs ; le code lira la ressource pointée par l'alias au moment de l'exécution.
Syntaxe
alias <alias>=<real>;Paramètres
| Paramètre | Description |
|---|---|
alias |
Alias à créer pour une ressource. |
real |
Nom d'origine de la ressource. |
Cas d'utilisation d'ALIAS
Recourez à ALIAS lorsque votre code MapReduce ou UDF fait référence à un nom de ressource fixe, mais que la ressource sous-jacente change entre les exécutions — par exemple, des partitions de données quotidiennes chargées en tant que ressources de table distinctes. Plutôt que de mettre à jour le code à chaque fois, réaffectez l'alias avant chaque job.
Exemple
L'exemple suivant montre comment faire basculer un seul alias entre deux ressources de table partitionnées par date sur deux jobs, sans modifier le code JAR.
-- Add resources res_20121208 and res_20121209.
add table sale_detail partition (ds='20121208') as res_20121208;
add table sale_detail partition (ds='20121209') as res_20121209;
-- Create the alias resName for the resource res_20121208 and call this resource.
alias resName=res_20121208;
jar -resources resName -libjars work.jar -classpath ./work.jar com.company.MainClass args ...;
-- Create the alias resName for the resource res_20121209 and call this resource.
alias resName=res_20121209;
jar -resources resName -libjars work.jar -classpath ./work.jar com.company.MainClass args ...;L'alias resName pointe vers une table de ressource différente dans chaque job. Le code JAR lit resName sans aucune modification entre les exécutions.
Instructions connexes
Pour utiliser ALIAS, ajoutez d'abord une ressource à l'aide de l'une des instructions suivantes. Choisissez le type de ressource en fonction des besoins de votre code :
ADD TABLE : ajoute une table en tant que ressource. Utilisez cette option lorsque votre code lit des données structurées depuis des tables MaxCompute.
ADD JAR : ajoute un fichier JAR en tant que ressource. Requis lorsque votre code UDF ou MapReduce dépend d'une bibliothèque JAR.
ADD FILE : ajoute un fichier en tant que ressource. Privilégiez cette approche pour les scripts ou fichiers plats que votre code lit au moment de l'exécution.
ADD ARCHIVE : ajoute un fichier d'archive en tant que ressource.
ADD PY : ajoute un script Python en tant que ressource.
Pour gérer les ressources existantes :
DESC RESOURCE : affiche les informations sur une ressource.
LIST RESOURCES : affiche la liste des ressources.
GET RESOURCE : télécharge une ressource.
DROP RESOURCE : supprime une ressource.