MaxCompute:Opérations sur les projets

Le tableau suivant répertorie les commandes courantes utilisées pour gérer les projets.

MaxCompute ne fournit 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 est distinct d'un espace de travail DataWorks. Vous pouvez obtenir le nom du projet comme suit :

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

Saisissez un projet pour lequel vous disposez des autorisations d'accès. Une fois dans le projet, vous pouvez directement effectuer 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 à l'un de ses objets.

    -- 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é schema 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é schema 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é schema, consultez Opérations sur les schémas.

Consulter les propriétés d'un projet

Vous pouvez consulter les paramètres de propriété au niveau du projet pour le projet actuel. MaxCompute vous permet également de consulter 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 une grande quantité de ressources de calcul. Pour améliorer l'efficacité du traitement, il est recommandé 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 celle-ci 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.	VPC instance ID1,VPC instance ID2[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 avec 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 avec Hive, consultez Édition des types de données compatibles avec 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 Écrire des données dans 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 d'ordre des colonnes dans 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é open source Java. La nouvelle implémentation est basée sur C++, prend en charge les versions ultérieures des fichiers ORC et améliore plusieurs fois les performances d'analyse des données open source.	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 d'origine basée sur Java 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é open source Java. La nouvelle implémentation est basée sur C++ et améliore plusieurs fois les performances d'analyse des données open source. 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 d'origine basée sur Java 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 d'un projet

Vous pouvez définir les propriétés au niveau du projet. La commande de définition des propriétés d'un 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 Consulter les propriétés d'un projet.

• Exemple

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

  SETPROJECT odps.sql.allow.fullscan=true;

Consulter les systèmes de comptes 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;