DataWorks:Requête et analyse SQL (héritée)

Sources de données prises en charge

La fonctionnalité de requête SQL prend en charge les sources de données suivantes : MaxCompute, Hologres, EMR, CDH, StarRocks, ClickHouse, SelectDB, Doris, AnalyticDB for MySQL 3.0, AnalyticDB for PostgreSQL, Tablestore, MySQL, PostgreSQL, Oracle et SQL Server.

Autorisations relatives aux sources de données

Accéder à la fonctionnalité

Connectez-vous à DataWorks Data Analysis, basculez vers la région cible, puis cliquez sur Enter Data Analysis.

• Si vous voyez Switch to New DataAnalysis dans la barre de navigation, vous avez accédé à la page héritée de Data Analysis.

• (Non recommandé) Si vous voyez Return to Legacy DataAnalysis dans la barre de navigation, cliquez dessus pour revenir à la page héritée de Data Analysis.

Étape 1 : Ajouter des répertoires

Ajoutez des tables issues des répertoires recommandés par le système et des sources de données autorisées à votre répertoire. Une fois le répertoire ajouté, vous pouvez afficher rapidement les tables qu'il contient, consulter leurs schémas et générer des requêtes SQL.

1. Sur la page d'analyse SQL, cliquez sur le bouton situé à droite de la zone de recherche au-dessus du répertoire pour ajouter un répertoire.

   • DataMap - Metadata : Métadonnées de table collectées dans Data Map. Chaque source de données ou ressource de calcul peut être ajoutée en tant que jeu de données.

   • DataMap - Data Album : Collections de données qui regroupent les tables de sujets spécifiques dans Data Map. Chaque collection de données peut être ajoutée en tant que jeu de données.

   • My Favorites : Tables que vous avez ajoutées à vos favoris dans Data Map.

   • My MaxCompute Tables : Toutes les tables MaxCompute dont le compte de connexion actuel est le propriétaire.

   • Public Data : Jeux de données publics fournis par MaxCompute, utilisables pour générer rapidement des données de test.
   Remarque

   Vous pouvez ajouter jusqu'à 12 jeux de données. Les jeux de données inutilisés peuvent être supprimés.

Étape 2 : Créer une requête SQL

Étape 3 : Configurer le moteur de requête et exécuter la requête

1. Cliquez sur le bouton situé dans le coin supérieur droit de la page de détails SQL pour configurer le moteur de requête SQL.

   Paramètre	Description
   Workspace	L'espace de travail où réside le moteur d'exécution. Important Assurez-vous de disposer des autorisations d'accès à l'espace de travail. Sinon, contactez l'administrateur de l'espace de travail pour vous ajouter en tant que membre de l'espace de travail.
   Datasource Type	Le type et le nom du moteur d'exécution. Important Si aucun projet spécifique n'est indiqué dans l'instruction SQL, le moteur d'exécution sert de source de données par défaut.
   Data Source Name
   Access Identity Mode	Sélectionnez le mode d'accès pour les requêtes SQL : Executor Identity : Pris en charge uniquement pour les moteurs MaxCompute et Hologres. Ce mode est recommandé lorsque vous êtes membre du projet MaxCompute ou de l'instance Hologres et que vous disposez des autorisations SELECT. Data Source Default Access Identity : Si votre compte actuel diffère de l'identité d'accès par défaut configurée lors de la création de la source de données, accordez cette identité à votre compte actuel.

2. Une fois l'instruction SQL rédigée, exécutez l'intégralité du script ou sélectionnez une partie pour une exécution partielle. Cliquez sur l'icône déroulante située à côté du bouton d'exécution pour changer de mode d'exécution. Sélectionnez différents modes selon les scénarios.

   Avant l'exécution d'une instruction SQL MaxCompute, le coût estimé s'affiche. Vous pouvez également cliquer sur More > Estimate Costs dans la barre d'outils au-dessus du fichier SQL pour estimer le coût.

   Mode d'exécution	Scénario	Condition de déclenchement	Moteurs applicables
   Mode de requête (LIMIT 10000)	Aperçu rapide des données et vérification de la logique de requête. Ce mode convient aux scénarios où vous souhaitez uniquement visualiser un petit échantillon de résultats pour une exploration préliminaire des données.	Le résultat de la requête affiche ≤ 10 000 lignes et ≤ 10 Mo.	Aucune limite
   Mode de requête (données complètes)	Obtention de l'ensemble complet des résultats pour analyse ou exportation. Basculez vers ce mode lorsque vous devez traiter et visualiser toutes les données.	Le résultat de la requête affiche > 10 000 lignes ou > 10 Mo.	MaxCompute, Hologres, StarRocks, ClickHouse, MySQL
   Mode de table temporaire	Réutilisation des résultats dans des requêtes complexes en plusieurs étapes. Utilisez la sortie d'une requête comme entrée de la suivante pour améliorer l'efficacité du développement et du débogage.	Le résultat de la requête affiche ≤ 10 000 lignes et ≤ 10 Mo, et est automatiquement écrit dans une table temporaire.	Uniquement MaxCompute

3. Une fois l'instruction SQL exécutée, consultez le journal d'exécution, les résultats et l'instruction SQL correspondante sur la page des résultats de la requête.

   Cliquez sur les boutons situés dans le coin supérieur droit de la zone des résultats de la requête pour basculer la mise en page de la page entre côte à côte et haut-bas.

Étape 4 : Visualiser les résultats de la requête

Dans la barre d'outils à gauche des résultats de la requête, cliquez sur le bouton pour générer automatiquement des graphiques visuels à partir des résultats.

Étape 5 : Exporter et partager

Les résultats des requêtes SQL peuvent être exportés sous les formes suivantes :

• Fichier local : Téléchargez les résultats de la requête sur votre machine locale au format CSV, TXT ou XLS. Les informations clés sont les suivantes :

  Élément	Description
  Limites de téléchargement	Seuls les moteurs MaxCompute et EMR sont pris en charge. Pour plus d'informations, consultez les limites du nombre de lignes téléchargeables. Si le projet MaxCompute a activé les restrictions de téléchargement de données (le téléchargement de données est interdit), le téléchargement de données via Data Analysis échouera. Important Si cette option n'apparaît pas, consultez la FAQ pour résoudre le problème.
  Scope	Vous pouvez choisir de télécharger Only Data Displayed in Table ou All Data. Only Data Displayed in Table : Télécharge uniquement les données affichées sur la page actuelle, soit par défaut jusqu'à 10000 lignes. All Data : Exporte toutes les données de résultat interrogées dans la limite de téléchargement.
  Méthode de téléchargement	Deux méthodes de téléchargement sont prises en charge : Download After Approval et Download Without Approval. Téléchargement après approbation : Configurez des règles d'identification des risques pour identifier les risques liés aux opérations de téléchargement de données. Lors du téléchargement de données, soumettez une demande d'approbation de téléchargement afin de garantir la conformité et la sécurité des données. Remarque Seule l'édition Enterprise de DataWorks prend en charge la configuration et l'activation des règles d'identification des risques. Téléchargement sans approbation : Par défaut, les téléchargements ne nécessitent pas d'approbation. Aucune demande d'autorisation n'est nécessaire pendant le processus de téléchargement.

• OSS : Exportez les résultats de la requête dans un format spécifié (tel que CSV ou Parquet) vers Alibaba Cloud Object Storage Service (OSS). Cette méthode convient à l'archivage de grands volumes de données ou à l'intégration avec d'autres services cloud.

  Lors de la première utilisation de cette fonctionnalité, autorisez DataWorks à accéder à vos ressources OSS. Dans la liste déroulante File Path , cliquez sur le lien Authorize dans l'invite et suivez les instructions pour compléter l'autorisation RAM.

  Paramètre	Description
  Chemin du fichier	Cliquez sur le bouton de dossier à droite pour sélectionner le bucket OSS et le répertoire où vous souhaitez stocker le fichier de résultat.
  Nom du fichier	Un nom de fichier est généré automatiquement. Vous pouvez également le modifier manuellement.
  Type de fichier	Sélectionnez le format du fichier d'exportation. Les formats pris en charge incluent csv, text, orc et parquet.
  Délimiteur	Spécifiez le délimiteur entre les colonnes. Le délimiteur par défaut est une virgule (,).
  Encodage	Sélectionnez le format d'encodage du fichier, tel que UTF-8 ou GBK.
  CU	Configurez le nombre d'unités de calcul (CU) pour cette tâche d'exportation. La valeur par défaut est de 1 CU.
  Groupe de ressources	Sélectionnez le groupe de ressources serverless pour exécuter cette tâche d'exportation. Si aucun groupe de ressources n'est sélectionné, le groupe de ressources Data Integration configuré dans Data Analysis > System Management est utilisé par défaut.

  Une fois la configuration terminée, cliquez sur OK pour démarrer la tâche d'exportation. Consultez la progression de l'exportation, le journal d'exécution et les détails de la configuration sur la page d'exécution de la tâche. Une fois la tâche réussie, accédez à la console OSS pour télécharger le fichier exporté sur votre machine locale.

• Table MaxCompute : Exportez les résultats de la requête directement vers une table MaxCompute sans avoir à télécharger les données sur votre machine locale au préalable. Définissez le cycle de vie de la table selon vos besoins.

  Cette option est disponible uniquement lorsque vous interrogez le contenu du moteur MaxCompute.

• Feuille de calcul : Enregistrez les résultats dans une feuille de calcul pour approfondir l'analyse des données. Vous pouvez également partager les derniers résultats d'analyse avec d'autres personnes.

Autres opérations

FAQ