Enregistre une table MaxCompute en tant que ressource afin que les tâches SQL et MapReduce puissent y faire référence lors de l'exécution.
Il s'agit d'une instruction CMD. Exécutez-la uniquement sur le client MaxCompute (odpscmd).
Limites
Les tables externes ne peuvent pas être ajoutées en tant que ressources.
L'évolution du schéma n'est pas prise en charge pour les tables enregistrées en tant que ressources. Si le schéma d'une table évolue après son ajout, supprimez la ressource, puis ajoutez-la à nouveau.
Chaque fichier de ressource ne doit pas dépasser 2 048 Mo.
La taille totale des ressources référencées par une seule tâche SQL ou MapReduce ne doit pas dépasser 2 048 Mo.
Syntaxe
add table <table_name> [partition (<spec>)] [as <alias>] [comment '<comment>'] [-f];
Paramètres
| Paramètre | Obligatoire | Description |
|---|---|---|
table |
Oui | Type de ressource. Pour plus d'informations sur les types de ressources, consultez la section Resource. |
table_name |
Oui | Nom de la table MaxCompute à enregistrer en tant que ressource. |
spec |
Obligatoire pour les tables partitionnées | Partition à enregistrer. Seule la partition spécifiée est enregistrée, et non la table entière. Utilisez le format partition_column='value', par exemple ds='20150602'. |
alias |
Non | Nom de la ressource. Par défaut, le nom du fichier est utilisé si aucun alias n'est spécifié. Non pris en charge pour les ressources JAR ou les scripts Python. |
comment |
Non | Description de la ressource. |
-f |
Non | Écrase la ressource existante si une ressource portant le même nom existe déjà. Sans cet indicateur, l'ajout d'une ressource avec un nom dupliqué échoue. |
Exemples
Ajouter une table partitionnée en tant que ressource
Enregistrez une seule partition de la table sale_detail en tant que ressource nommée sale.res, et forcez l'écrasement si la ressource existe déjà :
add table sale_detail partition (ds='20150602') as sale.res comment 'sale detail on 20150602' -f;
Sortie attendue :
OK: Resource 'sale.res' have been updated.
Étapes suivantes
Après avoir enregistré une table en tant que ressource, faites-y référence par son nom dans les tâches MapReduce ou les UDF. Pour gérer vos ressources, consultez les instructions suivantes :
DESC RESOURCE : Consultez les détails d'une ressource.
LIST RESOURCES : Répertorie toutes les ressources du projet.
ALIAS : Créez un alias pour une ressource.
GET RESOURCE : Téléchargez une ressource.
DROP RESOURCE : Supprimez une ressource.
Instructions ADD connexes :
ADD ARCHIVE : Ajoutez un fichier d'archive en tant que ressource.
ADD FILE : Ajoutez un fichier en tant que ressource.
ADD JAR : Ajoutez un fichier JAR en tant que ressource.
ADD PY : Ajoutez du code Python en tant que ressource.