MaxCompute:Gérer les connexions aux projets

Prérequis

Vous avez correctement installé MaxCompute Studio.

Étape 1 : Créer un projet MaxCompute Studio

1. Démarrez IntelliJ IDEA. Dans le menu principal, sélectionnez File > New > Project.

2. Dans le volet de navigation de gauche de la boîte de dialogue New Project, sélectionnez MaxCompute Studio puis cliquez sur Next.

3. Saisissez un Project name et cliquez sur Finish pour créer le projet.

   Remarque

   Si un projet est déjà ouvert, une invite vous demande si vous souhaitez ouvrir le nouveau projet dans la fenêtre actuelle. Cliquez sur This Window pour fermer le projet existant et ouvrir le nouveau.

Étape 2 : Créer une connexion à un projet MaxCompute

1. Dans le menu principal, sélectionnez View > Tool Windows > Project Explorer.

2. Dans l'angle supérieur gauche, cliquez sur + et sélectionnez Add project from accessId/Key.

3. Dans la boîte de dialogue Add MaxCompute project, configurez les paramètres sous l'onglet Connection.

   Les paramètres à configurer sont Properties File, AK Account, AccessKey ID (obligatoire), AccessKey Secret (obligatoire), Project Name (obligatoire) et Endpoint (obligatoire).

   Remarque

   • Cliquez sur l'icône située dans l'angle inférieur gauche de la boîte de dialogue pour consulter la documentation en ligne.

   • En cas d'erreur de délai d'expiration, accédez à l'onglet Setting et modifiez les paramètres de synchronisation des données :

     • sync one table timeout(s) : délai d'expiration pour la synchronisation des tables. Valeur par défaut : 5 s.

     • sync one function timeout(s) : délai d'expiration pour la synchronisation des fonctions définies par l'utilisateur (UDF). Valeur par défaut : 30 s.

   • Remplissage automatique des paramètres à partir d'un fichier de configuration.

     Parameter	Description
     Properties File	Importez le fichier de configuration odps_config.ini du client MaxCompute (odpscmd). Pour plus d'informations, consultez la rubrique Installer et configurer le client MaxCompute. Ce fichier initialise les paramètres AccessKey ID, AccessKey Secret, Project Name et Endpoint.
     AK Account	Compte Alibaba Cloud utilisé pour se connecter au projet MaxCompute. Cliquez sur + à droite et sélectionnez un compte existant sur la page Accounts. Remarque Si aucun compte n'est répertorié, cliquez sur + > Aliyun Account By AccessKey sur la page Accounts pour ajouter un compte, soit automatiquement à partir d'un fichier de configuration, soit manuellement. Pour plus d'informations sur la configuration des comptes, consultez la rubrique Options de configuration des comptes.

   • Configuration manuelle des paramètres.

     Parameter	Description
     AccessKey ID	ID de clé d'accès (AccessKey ID) utilisé pour se connecter au projet MaxCompute.
     AccessKey Secret	Clé secrète d'accès (AccessKey Secret) utilisée pour se connecter au projet MaxCompute.
     Project Name	Nom du projet MaxCompute cible. Remarque Ce paramètre spécifie le nom d'un projet MaxCompute existant, et non celui d'un espace de travail DataWorks. Connectez-vous à la console MaxCompute et accédez à la page Workspace > Projects pour afficher les noms de vos projets MaxCompute ou en créer un nouveau.
     Endpoint	Endpoint de la région où se trouve le projet MaxCompute. Notez que si vous vous connectez depuis l'extérieur du réseau interne d'Alibaba Cloud (par exemple, depuis votre ordinateur local), vous devez utiliser un endpoint public.

4. Une fois la configuration terminée, cliquez sur OK. Le panneau Project Explorer sur la gauche affiche les informations du projet MaxCompute, y compris ses tables, vues, fonctions définies par l'utilisateur (UDF) et ressources.

Étape 3 : Modifier une connexion à un projet MaxCompute

1. Dans le panneau Project Explorer, cliquez avec le bouton droit sur le projet MaxCompute que vous souhaitez modifier et sélectionnez Modify project properties.

2. Dans la boîte de dialogue Modify MaxCompute project, modifiez la configuration du projet.

Étapes suivantes

Une fois connecté au projet MaxCompute, vous pouvez :

• Gérer et consulter les données et ressources du projet. Pour plus d'informations, consultez la rubrique Gérer les données et les ressources.

• Développer des programmes SQL dans MaxCompute Studio. Pour plus d'informations, consultez la rubrique Développer des programmes SQL.

• Développer des programmes Java dans MaxCompute Studio. Pour plus d'informations, consultez la rubrique Développer des programmes Java.

• Développer des programmes Python dans MaxCompute Studio. Pour plus d'informations, consultez la rubrique Développer des programmes Python.

Dépannage

Les erreurs courantes suivantes peuvent survenir après avoir configuré les paramètres sous l'onglet Connection et cliqué sur OK :

• Erreur : Test connection fail: ODPS-0420111: Project not found - '<project_name>'. ou Test connection fail:ODPS-0130013:Authorization exception - Authorization Failed [4002], You don't exist in project <project_name>. Context ID:<context ID>. --->Tips: Principal:ALIYUN$<account_name> | RAM$[<account_name>:]<RAM_user_name>;.

  • Causes possibles :

    • Le projet cible n'existe pas ou le nom du projet est incorrect.

    • Le compte Alibaba Cloud ou l'utilisateur RAM associé à l'AccessKey ID n'a pas été ajouté au projet cible.

  • Solutions :

    • Connectez-vous à la console MaxCompute. Sur la page Workspace > Projects, récupérez le nom correct du projet MaxCompute, puis modifiez le paramètre Project Name.

    • Si d'autres utilisateurs doivent se connecter au projet, le propriétaire du projet doit les ajouter. Pour plus d'informations, consultez les rubriques Ajouter un compte Alibaba Cloud (niveau projet) ou Ajouter un utilisateur RAM (niveau projet).

• Erreur : Test connection fail: connect timed out, the possible reason is that the endpoint '<endpoint>' is wrong, please check your endpoint.

  • Cause possible : Vous avez saisi une valeur incorrecte pour le paramètre Endpoint. Par exemple, vous vous connectez depuis votre ordinateur local via Internet public, mais vous avez spécifié un endpoint de réseau interne.

  • Solution : Consultez la documentation relative aux Endpoints et sélectionnez un endpoint correspondant à la région de votre projet et à votre environnement réseau.

• Erreur : Test connection fail: The specified project or table name is not valid or missing. .

  • Cause possible : Les endpoints sont utilisés pour les services MaxCompute, tandis que les endpoints Tunnel sont utilisés pour les services MaxCompute Tunnel. Vous avez probablement spécifié un endpoint Tunnel pour le paramètre Endpoint.

  • Solution : Consultez la documentation relative aux Endpoints. Sélectionnez un endpoint correspondant à la région de votre projet et à votre environnement réseau. N'utilisez pas d'endpoint Tunnel.