MaxCompute:Commandes de projet

Le tableau suivant répertorie les commandes courantes pour les opérations sur les projets.

MaxCompute ne propose pas de commandes pour créer ou supprimer des projets. Pour plus d'informations, consultez Créer un projet MaxCompute.

Obtenir le nom d'un projet

Un projet MaxCompute diffère d'un espace de travail DataWorks. Procédez comme suit pour obtenir le nom du projet :

1. Connectez-vous à la console MaxCompute et sélectionnez une région dans le coin supérieur gauche.

2. Dans le volet de navigation de gauche, choisissez Manage Configurations > Projects.

3. Sur la page Projects, récupérez le nom du projet MaxCompute.

Accéder à un projet

Accédez à un projet pour lequel vous disposez d'autorisations. Une fois dans le projet, vous pouvez effectuer directement des opérations sur les objets qu'il contient.

• Syntaxe de la commande

  -- Enter a project.
  USE <project_name>;

• Paramètres

  project_name : nom du projet auquel vous souhaitez accéder. Une erreur est renvoyée si le projet n'existe pas ou si vous ne disposez pas des autorisations nécessaires pour y accéder.

• Exemples

  • Exemple 1 : Accédez à un projet et à un objet qui s'y trouve.

    -- The current project is my_project. The project to be accessed is my_project_test. You have permissions to access my_project_test.
    odps@ my_project>USE my_project_test;
    -- After you enter the project, you can perform other operations. For example, you can query the test_src table in the my_project_test project.
    odps@ my_project_test>SELECT * FROM test_src;

    MaxCompute recherche automatiquement la table dans le projet my_project_test. Si la table existe, les données qu'elle contient sont renvoyées. Sinon, une erreur est retournée.

  • Exemple 2 : Pour accéder à un objet situé dans un autre projet, vous devez disposer des autorisations requises sur cet objet et spécifier le nom du projet.

    • Voici ce qui se produit lorsque la fonctionnalité de schéma est désactivée dans MaxCompute :

      -- Access the test_src table in the my_project2 project from the my_project_test project.
      odps@ my_project_test>SELECT * FROM my_project2.test_src;

    • L'exemple suivant s'applique lorsque la fonctionnalité de schéma est activée pour MaxCompute :

      -- Access the test_src table in the my_project2 project from the my_project_test project. The default schema of my_project2 is Default.
      odps@ my_project_test>SELECT * FROM my_project2.default.test_src;

      Remarque

      • Pour plus d'informations sur l'octroi d'autorisations sur les objets d'un projet de destination, consultez Gestion des projets.

      • Pour plus d'informations sur la fonctionnalité de schéma, consultez Opérations sur les schémas.

Afficher les propriétés du projet

Vous pouvez consulter les paramètres de propriété au niveau du projet pour le projet actuel. MaxCompute vous permet également d'afficher les propriétés au niveau de la session. Pour plus d'informations, consultez SHOW FLAGS.

• Syntaxe de la commande

  SETPROJECT;

• Description des propriétés

  Voici les propriétés courantes d'un projet.

  Nom de la propriété (KEY)	Description	Plage de valeurs (VALUE)
  odps.sql.allow.fullscan	Indique si les analyses complètes de table sont autorisées dans le projet. Les analyses complètes de table consomment beaucoup de ressources de calcul. Pour améliorer l'efficacité du traitement, nous vous recommandons de ne pas activer cette fonctionnalité.	true : les analyses complètes de table sont autorisées. false : les analyses complètes de table ne sont pas autorisées.
  odps.table.lifecycle	Indique si un cycle de vie doit être configuré pour les tables du projet.	optional : la clause Lifecycle est facultative lors de la création d'une table. Si vous ne configurez pas de cycle de vie pour une table, celle-ci n'expire jamais. mandatory : la clause Lifecycle est obligatoire. Vous devez configurer un cycle de vie pour la table. inherit : si vous ne configurez pas de cycle de vie lors de la création d'une table, le cycle de vie de la table correspond à la valeur de odps.table.lifecycle.value.
  odps.table.lifecycle.value	Cycle de vie d'une table. Unité : jours.	De 1 à 37231. La valeur par défaut est 37231.
  odps.security.ip.whitelist	Liste blanche d'adresses IP autorisées à accéder au projet via Internet. Pour plus d'informations, consultez Gérer les listes blanches d'adresses IP.	Liste d'adresses IP séparées par des virgules (,).
  odps.security.vpc.whitelist	Liste blanche d'adresses IP autorisées à accéder au projet via un VPC. Pour plus d'informations, consultez Gérer les listes blanches d'adresses IP.	ID d'instance VPC1,ID d'instance VPC2[liste d'adresses IP].
  READ_TABLE_MAX_ROW	Nombre d'enregistrements de données qu'une instruction SELECT peut renvoyer.	De 1 à 10000. La valeur par défaut est 10000.
  odps.sql.type.system.odps2	Active ou désactive les nouveaux types de données de MaxCompute V2.0. Pour plus d'informations sur les types de données V2.0, consultez Éditions des types de données (V2.0).	true : activé false : désactivé
  odps.sql.hive.compatible	Active ou désactive le mode compatible Hive. Une fois ce mode activé, MaxCompute prend en charge diverses syntaxes spécifiques à Hive, telles que inputRecordReader, outputRecordReader et Serde. Pour plus d'informations sur les types de données compatibles Hive, consultez Édition des types de données compatibles Hive.	true : activé false : désactivé
  odps.sql.decimal.odps2	Active ou désactive le type de données DECIMAL(precision,scale) de MaxCompute V2.0. Pour plus d'informations, consultez Éditions des types de données (V2.0).	true : activé false : désactivé
  odps.sql.metering.value.max	Consommation maximale d'une seule instruction SQL. Pour plus d'informations, consultez Contrôle de la consommation pour la surveillance et les alertes.	Aucun.
  odps.sql.timezone	Fuseau horaire du projet MaxCompute. Pour plus d'informations sur les fuseaux horaires, consultez Configurations des fuseaux horaires.	Aucun.
  odps.sql.unstructured.oss.commit.mode	Indique si le téléchargement multipartie doit être activé pour écrire des données dans les tables externes OSS. Pour plus d'informations, consultez Tables externes OSS.	true : activé false : désactivé
  odps.sql.groupby.orderby.position.alias	Indique si les constantes entières dans les clauses group by et order by doivent être traitées comme les numéros ordinaux des colonnes de la liste SELECT. Remarque Pour un projet existant, si vous activez ce paramètre au niveau du projet, l'analyse et l'exécution des tâches existantes peuvent être affectées. Avant de modifier ce paramètre, assurez-vous que les tâches existantes peuvent s'exécuter correctement selon la logique d'origine après sa définition. Sinon, définissez ce paramètre au niveau de la session.	true : activé false : désactivé
  odps.forbid.fetch.result.by.bearertoken	Indique s'il faut empêcher l'onglet Result de Logview d'afficher les résultats d'exécution des tâches. Ce paramètre sert à protéger la sécurité des données.	true : les résultats d'exécution des tâches ne sont pas affichés. false : affiche les résultats de l'exécution de la tâche.
  odps.cupidhistory.inprogress.remain.days	Période de conservation des journaux historiques pour les tâches Spark on MaxCompute en cours d'exécution. Unité : jours.	De 1 à 7. La valeur par défaut est 7.
  odps.cupidhistory.remain.days	Période de conservation des journaux historiques pour les tâches Spark on MaxCompute. Unité : jours.	De 1 à 3. La valeur par défaut est 3.
  odps.ext.oss.orc.native	Indique s'il faut mettre à niveau l'implémentation pour l'analyse des fichiers de données ORC lorsqu'une tâche du projet lit une table externe. L'implémentation d'origine repose sur la communauté Java open source. La nouvelle implémentation est basée sur C++, prend en charge les versions ultérieures des fichiers ORC et améliore les performances d'analyse des données open source de plusieurs fois.	true : la nouvelle implémentation native basée sur C++ est utilisée pour analyser les fichiers de données ORC lors de la lecture d'une table externe. false : l'implémentation Java d'origine issue de la communauté open source est utilisée pour analyser les fichiers de données ORC lors de la lecture d'une table externe.
  odps.ext.parquet.native	Indique s'il faut mettre à niveau l'implémentation pour l'analyse des fichiers de données PARQUET lorsqu'une tâche du projet lit une table externe. L'implémentation d'origine repose sur la communauté Java open source. La nouvelle implémentation est basée sur C++ et améliore les performances d'analyse des données open source de plusieurs fois. Après la mise à niveau, s'il existe de nombreux petits fichiers PARQUET et beaucoup de colonnes de données, le nombre de demandes d'accès à la source de données peut augmenter. Lors de la création d'une table, vous pouvez utiliser la clause with serdeproperties avec les paramètres parquet.file.cache.size et parquet.io.buffer.size pour augmenter la quantité de données mises en cache pour chaque accès à la source de données.	true : la nouvelle implémentation native basée sur C++ est utilisée pour analyser les fichiers de données PARQUET lors de la lecture d'une table externe. false : l'implémentation Java d'origine issue de la communauté open source est utilisée pour analyser les fichiers de données PARQUET lors de la lecture d'une table externe.
  odps.security.enabledownloadprivilege	Indique s'il faut activer la solution de contrôle des autorisations de téléchargement pour le projet. Une fois cette fonctionnalité activée, vous pouvez contrôler les actions des rôles ou des utilisateurs qui utilisent Tunnel pour télécharger des tables et des instances. Cela améliore la sécurité des données et prévient les fuites de données. Pour plus d'informations, consultez Contrôle des autorisations de téléchargement.	true : active le contrôle des autorisations de téléchargement. false : désactive le contrôle des autorisations de téléchargement.
  odps.security.ip.whitelist.services	Liste blanche des services. Ce paramètre permet d'éviter de configurer une liste blanche d'adresses IP lorsque les utilisateurs utilisent des services Alibaba Cloud tels que DataHub et SLS pour accéder aux projets MaxCompute.	Format : service1,service2. Le nom du service doit être enregistré au préalable dans MaxCompute. Ce paramètre est souvent utilisé pour le service LogShipper. La valeur pour Service est AliyunLogSLRService,AliyunLogDefaultService.

Définir les propriétés du projet

Vous pouvez définir les propriétés au niveau du projet. La commande de définition des propriétés du projet présente une latence de 0 à 5 minutes. Une fois la commande exécutée avec succès, attendez 5 minutes avant de vérifier le résultat. MaxCompute vous permet également de définir des propriétés au niveau de la session. Pour plus d'informations, consultez SET.

• Syntaxe de la commande

  SETPROJECT <KEY>=<VALUE>;

• Paramètres

  • KEY : nom de la propriété.

  • VALUE : valeur de la propriété. Pour plus d'informations sur les propriétés, consultez Afficher les propriétés du projet.

• Exemple

  Autorisez les analyses complètes de table dans le projet.

  SETPROJECT odps.sql.allow.fullscan=true;

Afficher les systèmes de compte d'un projet

LIST accountproviders;

Ajouter le système d'utilisateurs RAM

ADD accountprovider ram;

Supprimer le système d'utilisateurs RAM

REMOVE accountprovider ram;