Exécutez des commandes sur le client MaxCompute pour basculer vers un projet, inspecter ses propriétés et gérer les systèmes de comptes. Cette rubrique couvre les opérations suivantes :
|**Opération**
|
**Rôle requis**
| | --- | --- | |
Bascule vers un projet
|
Tout utilisateur disposant d'autorisations d'accès au projet
| |
Affichage des propriétés du projet
|
Propriétaire du projet
| |
Définition des propriétés du projet
|
Propriétaire du projet
| |
Affichage des systèmes de comptes
|
Propriétaire du projet
| |
Ajout du système d'utilisateurs RAM
|
Propriétaire du projet
| |
Suppression du système d'utilisateurs RAM
|
Propriétaire du projet
|
MaxCompute ne fournit pas de commandes pour créer ou supprimer des projets. Pour créer un projet, consultez la rubrique Créer un projet MaxCompute .
Obtention du nom de votre projet
Un projet MaxCompute est distinct d'un espace de travail DataWorks et possède son propre nom.
Connectez-vous à la console MaxCompute et sélectionnez une région dans le coin supérieur gauche.Console MaxCompute
Dans le volet de navigation de gauche, choisissez Manage Configurations > Projects.
Sur la page Projects, repérez le nom de votre projet MaxCompute.
Bascule vers un projet
USE <project_name>;Paramètre
|**Paramètre**
|
**Description**
| | --- | --- | |
`project_name`
|
Nom du projet vers lequel basculer. Une erreur est renvoyée si le projet n'existe pas ou si vous ne disposez pas des autorisations d'accès nécessaires.
|
Après avoir basculé vers un projet, les noms d'objets non qualifiés dans les commandes suivantes se résolvent par défaut vers ce projet. Le tableau suivant résume la résolution des noms d'objets en fonction du contexte actuel :
|**Contexte**
|
**Méthode de référence d'un objet**
| | --- | --- | |
Aucun projet sélectionné
|
Utilisez le nom complet : `
Affichage des propriétés du projet
SETPROJECT;Cette commande affiche les paramètres actuels des propriétés au niveau du projet. Les propriétés au niveau de la session (définies avec set) peuvent remplacer les valeurs au niveau du projet pour la session actuelle et ne sont pas reflétées dans cette sortie. Pour afficher les propriétés au niveau de la session, utilisez la commande SHOW FLAGS.
Le tableau suivant répertorie les propriétés courantes du projet :
|**Propriété**
|
**Description**
|
**Valeurs**
|
**Par défaut**
| | --- | --- | --- | --- | |
`odps.sql.allow.fullscan`
|
Contrôle l'autorisation des analyses complètes de tables. Les analyses complètes consomment d'importantes ressources de calcul.
|
`true` | `false`
|
—
| |
`odps.table.lifecycle`
|
Contrôle si la clause `LIFECYCLE` est requise lors de la création d'une table.
|
`optional` : la clause est facultative ; les tables sans cycle de vie n'expirent jamais. `mandatory` : la clause est obligatoire. `inherit` : les tables sans cycle de vie héritent de la valeur de `odps.table.lifecycle.value`.
|
—
| |
`odps.table.lifecycle.value`
|
Cycle de vie par défaut des tables, en jours. S'applique lorsque `odps.table.lifecycle` est défini sur `inherit`.
|
1–37231
|
37231
| |
`odps.security.ip.whitelist`
|
Liste d'autorisation d'adresses IP pour l'accès Internet au projet. Pour plus de détails, consultez la rubrique [Gérer les listes d'autorisation d'adresses IP](t1839869.dita#task_2330709).
|
Adresses IP séparées par des virgules
|
—
| |
`odps.security.vpc.whitelist`
|
Liste d'autorisation d'adresses IP pour l'accès VPC (Virtual Private Cloud) au projet. Pour plus de détails, consultez la rubrique [Gérer les listes d'autorisation d'adresses IP](t1839869.dita#task_2330709).
|
`VPC instance ID1,VPC instance ID2[IP address list]`
|
—
| |
`READ_TABLE_MAX_ROW`
|
Nombre maximal de lignes qu'une instruction `SELECT` peut renvoyer.
|
1–10000
|
10000
| |
`odps.sql.type.system.odps2`
|
Active les types de données MaxCompute V2.0. Pour plus de détails, consultez la rubrique [Éditions des types de données (V2.0)](t1879720.dita#concept_2454988).
|
`true` | `false`
|
—
| |
`odps.sql.hive.compatible`
|
Active le mode compatible Hive, qui ajoute la prise en charge de la syntaxe spécifique à Hive telle que `inputRecordReader`, `outputRecordReader` et `Serde`. Pour plus de détails, consultez la rubrique [Édition des types de données compatibles Hive](t1879819.dita#concept_2454988).
|
`true` | `false`
|
—
| |
`odps.sql.decimal.odps2`
|
Active le type de données `DECIMAL(precision,scale)` de MaxCompute V2.0. Pour plus de détails, consultez la rubrique [Éditions des types de données (V2.0)](t1879720.dita#concept_2454988).
|
`true` | `false`
|
—
| |
`odps.sql.metering.value.max`
|
Consommation de calcul maximale autorisée pour une seule instruction SQL. Pour plus de détails, consultez la rubrique [Contrôle de la consommation](t1846005.dita#concept_2349452).
|
—
|
—
| |
`odps.sql.timezone`
|
Fuseau horaire du projet. Pour plus de détails, consultez la rubrique [Configurations du fuseau horaire](t683766.dita#concept_844666).
|
—
|
—
| |
`odps.sql.unstructured.oss.commit.mode`
|
Active le chargement multipartie lors de l'écriture de données dans des tables externes OSS. Pour plus de détails, consultez la rubrique [Écrire des données dans OSS](t12075.dita#concept_wsw_nnb_wdb).
|
`true` | `false`
|
—
| |
`odps.sql.groupby.orderby.position.alias`
|
Traite les constantes entières dans les clauses `GROUP BY` et `ORDER BY` comme des positions ordinales de colonnes dans la liste `SELECT`.
|
`true` | `false`
|
—
| |
`odps.forbid.fetch.result.by.bearertoken`
|
Empêche l'onglet **Result** dans Logview d'afficher les résultats des tâches, protégeant ainsi la sécurité des données.
|
`true` : résultats masqués | `false` : résultats affichés
|
—
| |
`odps.cupidhistory.inprogress.remain.days`
|
Période de conservation des journaux historiques des tâches Spark on MaxCompute en cours d'exécution, en jours.
|
1–7
|
7
| |
`odps.cupidhistory.remain.days`
|
Période de conservation des journaux historiques des tâches Spark on MaxCompute, en jours.
|
1–3
|
3
| |
`odps.ext.oss.orc.native`
|
Remplace l'analyse des fichiers ORC pour les tables externes de l'implémentation open source Java d'origine par une implémentation native C++, qui prend en charge les versions ORC ultérieures et améliore les performances d'analyse.
|
`true` : implémentation C++ | `false` : implémentation Java
|
—
| |
`odps.ext.parquet.native`
|
Remplace l'analyse des fichiers Parquet pour les tables externes de l'implémentation open source Java d'origine par une implémentation native C++, ce qui améliore les performances d'analyse. Si votre table externe contient de nombreux petits fichiers Parquet et de nombreuses colonnes, le nombre de requêtes vers la source de données peut augmenter. Utilisez la clause [with serdeproperties](t12074.dita#section_ah9_vto_xoy) avec `parquet.file.cache.size` et `parquet.io.buffer.size` pour augmenter la mise en cache par requête.
|
`true` : implémentation C++ | `false` : implémentation Java
|
—
| |
`odps.security.enabledownloadprivilege`
|
Active le contrôle des autorisations de téléchargement, vous permettant de restreindre les rôles ou utilisateurs pouvant utiliser Tunnel pour télécharger des tables et des instances. Pour plus de détails, consultez la rubrique [Contrôle des autorisations de téléchargement](t2159750.dita#concept_2159750).
|
`true` : activé | `false` : désactivé
|
—
| |
`odps.security.ip.whitelist.services`
|
Liste d'autorisation de services permettant à des services Alibaba Cloud spécifiés d'accéder au projet sans nécessiter d'adresses IP individuelles. Couramment utilisé avec des services Alibaba Cloud tels que DataHub et [LogShipper](t2177380.dita#task_2177380) (Simple Log Service (SLS)). La valeur pour SLS est `AliyunLogSLRService,AliyunLogDefaultService`.
|
Noms de services séparés par des virgules (doivent être enregistrés dans MaxCompute au préalable)
|
—
|
Pour odps.sql.groupby.orderby.position.alias, l'activation de cette propriété au niveau du projet peut affecter la façon dont les tâches existantes sont analysées et exécutées. Avant de modifier cette propriété, vérifiez que les tâches existantes s'exécutent correctement avec le nouveau comportement. Si ce n'est pas le cas, définissez la propriété au niveau de la session.
Définition des propriétés du projet
SETPROJECT <KEY>=<VALUE>;Paramètres
|**Paramètre**
|
**Description**
| | --- | --- | |
`KEY`
|
Nom de la propriété. Consultez le tableau des propriétés dans la section [Affichage des propriétés du projet](#section_zxr_fq8_6v5) pour connaître les clés disponibles.
| |
`VALUE`
|
Valeur de la propriété.
|
Les modifications de propriétés prennent effet dans un délai de 0 à 5 minutes. Attendez 5 minutes avant de vérifier le résultat. Pour définir des propriétés uniquement pour la session actuelle, utilisez la commande SET .
Exemple
Autorisez les analyses complètes de tables dans le projet :
SETPROJECT odps.sql.allow.fullscan=true;Gestion des systèmes de comptes
Par défaut, un projet MaxCompute reconnaît uniquement le système de comptes Alibaba Cloud (ALIYUN), et non le système d'utilisateurs RAM. Utilisez les commandes suivantes pour afficher et modifier les systèmes de comptes.
Affichage des systèmes de comptes
LIST accountproviders;Renvoie les systèmes de comptes pris en charge par le projet actuel. Les systèmes pris en charge sont ALIYUN et RAM.
Ajout du système d'utilisateurs RAM
ADD accountprovider ram;Suppression du système d'utilisateurs RAM
REMOVE accountprovider ram;