Tous les produits
Search
Centre de documentation

MaxCompute:ADD TABLE

Dernière mise à jour :Aug 10, 2026

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 :

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.